Ir para o conteúdo

Invocar Operação (Beta) ferramenta no Jitterbit Studio

Introdução

A ferramenta Invocar Operação (Beta) é um componente de projeto que é utilizado como um passo em uma operação para executar uma operação especificada que existe no projeto atual. Pode ser usada como um passo de operação em qualquer lugar onde um script pode ser utilizado como um passo de operação.

Nota

Para fornecer feedback sobre este recurso beta, entre em contato com a Equipe de Produto Jitterbit.

Informação

As funções RunOperation, RaiseError e CancelOperationChain fornecem a funcionalidade subjacente para esta ferramenta.

Dica

Se você precisar executar uma operação que existe em um projeto diferente, pode expô-la como uma API do Gerenciador de API e, em seguida, chamá-la a partir do projeto atual. Alternativamente, você pode usar importação seletiva para importar a operação para o seu projeto atual.

Criar uma instância de Invocar Operação

Uma nova instância da ferramenta Invocar Operação (Beta) pode ser criada a partir destes locais:

Uma ferramenta Invocar Operação (Beta) existente pode ser editada a partir destes locais:

Configurar uma ferramenta de Invocar Operação

A tela de configuração da Invocar Operação (Beta) inclui os seguintes campos e ações:

configuração de invocar operação

  • Nome: Insira um nome para identificar a instância da ferramenta Invocar Operação (Beta).

  • Usar nome da operação: Quando selecionado, o nome da instância da ferramenta Invocar Operação (Beta) corresponde ao nome da operação selecionada no campo Operação. O campo Nome fica desativado e ajusta-se automaticamente ao nome da operação quando alterado:

    correspondência de invocar operação

    Nota

    Se várias instâncias da ferramenta Invocar Operação (Beta) invocarem a mesma operação, apenas uma pode usar o nome exato da operação. Isso se deve às regras de validação de componentes do projeto do Studio. A opção Usar nome da operação será desativada em outras instâncias da ferramenta que chamam a mesma operação. Um tooltip descreve o motivo.

  • Operação: Use o menu para selecionar uma operação no projeto atual.

  • Tipo de execução: Selecione se as operações subsequentes serão executadas sincronamente ou assíncronamente:

    • Sincronamente: Quando selecionado, a operação invocada (filha) ou cadeia de operações é executada sequencialmente a partir da operação invocadora (mãe).

    • Assíncronamente: Quando selecionado, a operação invocada (filha) ou cadeia de operações é executada simultaneamente com a operação invocadora (mãe).

    Para mais informações, veja Sincronicidade.

  • Tratamento de erros: Essas opções de tratamento de erros são ativadas quando Sincrono é selecionado como o Tipo de execução:

  • Levantar erro se a operação falhar: Quando selecionado e a operação invocada falhar, a operação iniciadora (na qual a ferramenta Invoke Operation (Beta) está) falha e para o processamento. O processamento continuará para quaisquer ações de operação On Fail configuradas na operação iniciadora.

    Um erro fatal é registrado nas mensagens de log da operação iniciadora, que podem ser visualizadas nos [logs da operação](/pt/integration-studio/design/operations/logs/) ou na [aba Mensagens](/pt/management-console/runtime-operations/#messages-tab) da página [Operações em Tempo de Execução](/pt/management-console/runtime-operations/):
    
    ```
    Fatal Error <message> Este erro foi levantado por uma chamada à função RaiseError.
    ```
    
  • Cancelar cadeia de operações se a operação falhar: Quando selecionado e a operação invocada falhar, a operação iniciadora (na qual a ferramenta Invoke Operation (Beta) está) continua o processamento. O processamento será interrompido na conclusão dessa operação e não continuará para quaisquer ações de operação On Fail ou On Success configuradas na operação iniciadora.

    Importante

    Se ambas as opções de tratamento de erro estiverem habilitadas, um erro é levantado para a operação iniciadora e nenhum processamento adicional ocorre na operação iniciadora ou nas operações encadeadas pelas ações On Fail configuradas.

  • Salvar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para salvar e fechar a configuração.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Uma vez configurada, a instância Invoke Operation (Beta) é nomeada da mesma forma que o nome da operação que está chamando.

Nota

Uma cadeia de operações criada usando a ferramenta Invoke Operation (Beta) não possui uma referência de operação visual ou linha no canvas de design.

Ações

A barra de ações para uma ferramenta Invocar Operação (Beta) possui as seguintes ações:

invocar operação

Ícone Descrição
Ir para a Operação invocada navega até o fluxo de trabalho onde a operação especificada reside. A operação é exibida com uma borda azul contornando a operação.
Editar abre a tela de configuração.
Recortar coloca uma cópia do componente na sua área de transferência e exclui o componente original do projeto (veja Reutilização de Componentes).
Copiar coloca uma cópia do componente na sua área de transferência (veja Reutilização de Componentes).
Remover remove o componente como um passo da operação.

Sincronização

Operações chamadas usando a ferramenta Invocar Operação (Beta) ou a função RunOperation são executadas de forma síncrona por padrão, mas podem ser configuradas para serem executadas de forma assíncrona como parte de uma cadeia de operações quando necessário.

  • Sincronamente: A cadeia de operações (filha) invocada é executada sequencialmente a partir da operação invocadora (pai). O grupo de agentes aguardará a conclusão da cadeia de operações invocada antes de processar os próximos passos na cadeia de operações invocadora:

    Operation AOperation AOperation BOperation AOperation BOperation AOperation AOperation BOperation BOperation AOperation AOperation Bstart sync invoke when complete end

  • Assincronamente: A cadeia de operações (filha) invocada é executada simultaneamente com a operação invocadora (pai). O grupo de agentes continuará processando os passos na cadeia de operações invocadora enquanto processa de forma independente a cadeia de operações invocada. Não há garantia de qual operação ou cadeia será concluída primeiro:

    Operation AOperation BOperation AOperation BOperation AOperation AOperation BOperation BOperation AOperation Bstart async invoke end

Quando há dois ou mais agentes em um grupo, múltiplos agentes no grupo podem estar envolvidos no processamento de cadeias de operações inteiras. Para aproveitar a economia de tempo que chamadas assíncronas podem trazer para os fluxos de trabalho, são necessários dois ou mais agentes.

Importante

A sincronicidade depende do contexto da operação e pode ser combinada conforme necessário para atender a vários casos de uso. O diagrama abaixo é um exemplo dessa complexidade:

Operation AOperation BOperation BOperation COperation AOperation BOperation COperation AOperation AOperation BOperation BOperation COperation COperation AOperation BOperation BOperation Cstart async invoke sync invoke when complete end

Opções de configuração

Certas opções relacionadas à sincronicidade da cadeia de operações podem ser configuradas na seção [Operation Engine] do arquivo jitterbit.conf.

Além disso, a variável jitterbit.operation.max_async_chain_length pode ser usada para substituir o valor MaxAsyncOperationChainLength do arquivo jitterbit.conf, desde que MaxAsyncOperationChainLengthOverrideAllowed esteja definido como true.