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:
-
A aba Componentes do painel do projeto usando o menu Criar Novo (veja o menu de ações da aba Componentes na aba Componentes do painel do projeto).
-
A aba Ferramentas da paleta de componentes de design (veja Ferramentas na paleta de componentes de design).
Uma ferramenta Invocar Operação (Beta) existente pode ser editada a partir destes locais:
-
A tela de design (veja o menu de ações do componente na tela de design).
-
A aba Componentes do painel do projeto (veja o menu de ações do componente na aba Componentes do painel do projeto).
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:
-
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:
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:
Í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:
-
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:
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:
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
.