Ir para o conteúdo

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

Introdução

A ferramenta Invocar Operação (Beta) é um componente de projeto que é usado como um passo em uma operação para executar uma operação especificada que existe no projeto atual. Pode ser utilizada como um passo de operação em qualquer lugar onde um script pode ser usado 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.

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 Operação de Invocação

A tela de configuração da Operação de Invocação (Beta) inclui estes campos e ações:

configuração da operação de invocação

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

  • Usar nome da operação: Quando selecionado, o nome da instância da ferramenta Operação de Invocaçã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 da operação de invocação

    Nota

    Se várias instâncias da ferramenta Operação de Invocaçã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 Integration 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 Síncrono é selecionado como o Tipo de execução:

    • Gerar erro se a operação falhar: Quando selecionado e a operação invocada falha, a operação iniciadora (na qual a ferramenta Operação de Invocação (Beta) está) falha e para o processamento. O processamento continuará para quaisquer ações de Operação em Falha configuradas na operação iniciadora.

      Um erro fatal é registrado nos logs da operação iniciadora, que podem ser visualizados nos logs da operação ou na aba Mensagens da página de Operações em Tempo de Execução:

      Fatal Error <message> Este erro foi gerado 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 configuradas na operação iniciadora para On Fail ou On Success.

    Importante

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

  • 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 solicita que você confirme que deseja descartar as alterações.

Uma vez configurada, a instância da 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 Invoke Operation (Beta) possui as seguintes ações:

invoke operation

Í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 da operação.

Sincronização

As operações chamadas usando a ferramenta Invoke Operation (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.

  • Síncrono: A cadeia de operações invocada (filha) é 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 (filho) invocada é executada simultaneamente com a operação invocadora (pai). O grupo de agentes continuará processando as etapas 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.