Ir para o conteúdo

Implantar e executar uma operação no Jitterbit Studio

Introdução

Esta página descreve como implantar operações na nuvem Harmony. Após implantar uma operação e suas dependências, você pode executar essas operações. É possível executar uma operação usando dependências já implantadas ou ter dependências implantadas automaticamente no momento da execução.

Para informações sobre como resolver certos erros que podem ocorrer ao executar uma operação, consulte Solução de problemas de operação.

Indicações visuais de operações com alterações não implantadas

Operações com alterações não implantadas exibem dois indicadores visuais:

  • O nome da operação aparece em azul na aba Componentes do painel do projeto. Para mais informações, consulte Nome do componente em Aba Componentes do painel do projeto.

  • Um ícone Não implantado e um sublinhado azul aparecem na seção inferior esquerda de uma operação.

Implantar uma operação

Você pode implantar operações usando três métodos:

  • Implantar: Implanta uma operação diretamente. Quando você seleciona esta opção, o sistema implanta imediatamente a operação e suas dependências ou relata erros de validação que impedem a implantação.
  • Implantar e Executar: Funciona da mesma forma que a opção Implantar, exceto que, após uma implantação bem-sucedida, o sistema também executa a operação e quaisquer operações subsequentes. Para mais informações, consulte Executar uma operação mais adiante nesta página.
  • Implantação Configurável: Implanta operações selecionadas. Quando você seleciona esta opção, uma tela de configuração de implantação é aberta, onde você pode escolher quais operações implantar.

Nota

Quando você renomeia um projeto que foi implantado anteriormente, o novo nome do projeto é automaticamente implantado e atualizado no Harmony. Nenhuma outra parte do projeto é implantada automaticamente.

Deploy

Você pode acessar a opção Deploy para uma operação a partir dos seguintes locais:

Quando você seleciona Deploy, a operação e suas dependências são implantadas imediatamente. Para que a implantação seja bem-sucedida, a operação deve ser válida. Se a operação for inválida, um diálogo exibirá os erros de validação específicos. Para documentação sobre cada erro e como resolvê-lo, veja Validade da operação.

Deploy and run

A opção Deploy and Run está acessível a partir destes locais:

Quando você seleciona Deploy and Run, a operação e suas dependências são imediatamente implantadas. Para que a implantação seja bem-sucedida, a operação deve ser válida. Se a operação for inválida, um diálogo exibirá os erros de validação específicos. Para documentação sobre cada erro e como resolvê-lo, consulte Validade da operação.

Se a implantação for bem-sucedida, a operação e quaisquer operações subsequentes também serão executadas. Para detalhes, veja Executar uma operação mais adiante nesta página.

Implantação configurável

Você pode acessar a opção Implantação Configurável a partir das seguintes localizações. Esta opção abre uma tela de configuração de implantação com a operação e suas dependências selecionadas por padrão.

Quando você seleciona Implantação Configurável, uma tela de configuração de implantação é aberta onde você pode definir uma tag e um comentário e escolher quais workflows ou operações implantar.

implantação configurável

  • Informações do Projeto: O topo da tela exibe o nome do projeto e a organização e ambiente Harmony onde o projeto existe.

  • Tag: Insira uma tag para rotular o evento de implantação. A tag aparece como um rótulo no evento de implantação e é registrada nos detalhes da implantação acessíveis a partir do histórico do projeto. Este campo pode ser obrigatório dependendo das configurações de implantação em nível de projeto.

  • Comentário: Insira um comentário para descrever o evento de implantação. O comentário é registrado nos detalhes da implantação acessíveis a partir do histórico do projeto. Este campo pode ser obrigatório dependendo das configurações de implantação em nível de projeto.

  • Selecionar Fluxos de Trabalho e Operações: Selecione os fluxos de trabalho ou operações a serem implantados. A operação e suas dependências são selecionadas por padrão. Você deve selecionar pelo menos um item para habilitar o botão Implantar.

    Quando você seleciona um fluxo de trabalho ou operação, quaisquer fluxos de trabalho ou operações dependentes também são selecionados e não podem ser desmarcados.

    Para colapsar ou expandir fluxos de trabalho e operações, use os caret exibidos à esquerda do nome do fluxo de trabalho ou operação.

    Fluxos de trabalho ou operações inválidos aparecem em texto itálico vermelho. Você deve selecionar apenas itens válidos para habilitar o botão Implantar.

  • Implantar: Clique para implantar os fluxos de trabalho ou operações selecionados.

Executar uma operação

Após implantar uma operação e suas dependências, você pode executar essas operações. Você pode executar uma operação usando dependências implantadas existentes ou pode ter dependências implantadas automaticamente no momento da execução. Quando você executa uma operação, quaisquer operações downstream (vinculadas) também são executadas.

Você pode executar operações manualmente no tempo de design, usando um script (tanto no Studio quanto no Design Studio), a partir de uma linha de comando em um agente, usando um gatilho de API, usando um listener ou usando um agendamento. Após executar operações, você pode validar o comportamento adequado verificando os logs de operação.

Para informações sobre o uso de um agendamento em comparação com uma abordagem orientada a eventos, veja Processamento em lote e orientado a eventos.

Executar manualmente

A execução manual de uma operação é comumente utilizada durante o desenvolvimento de projetos para testar operações selecionadas ou o projeto inteiro. Você pode executar operações manualmente no Studio, conforme descrito abaixo, ou na página de Projetos do Console de Gerenciamento para operações que você já implantou.

Você pode executar a maioria das operações manualmente, com as seguintes exceções:

Você tem duas opções para a execução manual da operação:

  • Executar: Se você já implantou uma operação e suas dependências, esta opção executa imediatamente a operação e quaisquer operações subsequentes usando as dependências implantadas existentes. As operações executadas não incluem quaisquer alterações de design feitas após a última implantação. Para executar a operação com as últimas alterações de design, use Implantar e Executar.
  • Implantar e Executar: Esta opção implanta imediatamente a operação e todas as suas dependências (ou relata erros de validação que impedem a implantação), em seguida, executa a operação e quaisquer operações subsequentes usando as novas dependências implantadas.

As operações que você executa manualmente por qualquer um dos métodos exibem o status da operação em tempo real na tela de design, conforme descrito em Status da operação abaixo.

Executar

Você pode acessar a opção Executar a partir das seguintes localizações:

Quando você seleciona Executar, se já tiver implantado uma operação e suas dependências, a operação e quaisquer operações subsequentes vinculadas a ações de operação também são iniciadas com base nas condições configuradas.

Se você ainda não implantou uma operação ou suas dependências, uma mensagem indica que a operação falhou ao ser executada:

Texto do diálogo

Falha ao executar a operação
A operação específica não foi implantada ou foi excluída.

Clique em Continuar para retornar à tela anterior. Para implantar a operação e suas dependências, bem como executar a operação, use a opção Implantar e Executar.

Se você implantou uma operação ou suas dependências, mas fez alterações no designer de projetos do Studio desde a última implantação, um aviso indica que há alterações não implantadas:

Texto do diálogo

A operação possui alterações não implantadas
Esta operação ou seus componentes dependentes possuem alterações não implantadas. Clique em Continuar para executar a última versão implantada desta operação.

Clique em Continuar para reconhecer que há alterações não implantadas que não serão implantadas e para executar a última versão implantada da operação e suas dependências sem as alterações mais recentes feitas no designer de projetos do Studio.

Se você não quiser executar a última versão implantada, clique em Cancelar para retornar à tela anterior. Para implantar a versão mais recente da operação e suas dependências, bem como executar a operação, use a opção Implantar e Executar.

Implantar e executar

Você pode acessar a opção Implantar e Executar a partir dos seguintes locais:

Quando você seleciona Implantar e Executar, a operação e suas dependências são imediatamente implantadas. A implantação deve ser bem-sucedida para que a operação seja executada, conforme descrito anteriormente nesta página em Implantar.

Se a implantação for bem-sucedida, a operação e quaisquer operações subsequentes (filhas) encadeadas com ações de operação também são iniciadas com base nas condições configuradas.

Status da operação

Se uma operação foi enviada com sucesso para a fila de operações, o status da operação em tempo real é relatado no canto inferior esquerdo de uma operação:

status da operação

O status da operação é exibido para as primeiras 6 operações que são executadas dentro de uma cadeia de operações. Você pode visualizar o status de quaisquer operações restantes nos logs de operações.

O status relatado corresponde aos status descritos na página de Logs de Operações sob Status das Operações. Clique no status da operação para visualizar informações detalhadas do log. A tela de log da operação é aberta automaticamente em uma nova aba para que você possa continuar trabalhando enquanto as operações estão em execução (veja Logs de Operações).

Após você executar manualmente a operação, o status da operação é exibido em um projeto aberto por 24 horas e não é afetado por implantações adicionais ou pela execução da operação de outra forma. Somente ao reexecutar manualmente a operação o status da operação será atualizado para as operações e suas operações filhas. O status da operação é limpo quando você fecha o projeto.

Para operações que estão em status Enviado, Recebido, Pendente ou Executando, um botão Cancelar é exibido ao lado do status. Clicar em Cancelar envia uma solicitação ao agente para parar a operação e um status Cancelamento Solicitado é exibido ao lado do status da operação em tempo real:

cancel operation

Nota

Operações que têm um status de Cancelamento Solicitado podem ainda ser executadas.

Passe o mouse sobre o status de execução para ver a última vez que o status foi atualizado (reportado no horário local do navegador).

A cor do ícone à esquerda do status reportado indica a categoria do status da operação correspondente àquela exibida nos logs de operação. Quando as operações estão na visualização colapsada, apenas os ícones coloridos que indicam a categoria do status da operação são exibidos.

Use um script

Para executar uma operação a partir de um script, chame a função RunOperation em um script, conforme descrito na documentação da função.

Para chamar outra operação no mesmo projeto, arraste-a para o script. A função completa é criada automaticamente:

RunOperation("<TAG>operation:Operation 2</TAG>");

Para chamar uma operação em outro projeto, obtenha o GUID da operação executando um script simples nessa operação (usando teste de script) que utiliza o caminho de referência da operação para exibir o GUID da operação:

<trans>"<TAG>operation:Example Operation</TAG>";</trans>

Depois de ter o GUID de uma operação, você pode remover o script. O resultado do teste de script é semelhante a op.52c3eaa8-bc45-491f-b77f-cfeff994cf31.

Você pode então usá-lo com a função RunOperation na forma op.<guid> onde <guid> é o GUID da operação do outro projeto:

RunOperation("op.52c3eaa8-bc45-491f-b77f-cfeff994cf31");

Para chamar uma operação do Design Studio a partir do Studio, passe o parâmetro operationId para a função na forma op.<guid> onde <guid> é o GUID da operação do Design Studio. Você pode obter isso dentro do Design Studio conforme mostrado em Chamar uma operação a partir de uma linha de comando:

RunOperation("op.52c3eaa8-bc45-491f-b77f-cfeff994cf31");

Para chamar uma operação do Studio a partir do Design Studio, você precisa dos nomes do projeto e da operação. Depois de implantar operações do Studio, os projetos do Design Studio podem chamá-las pelo nome do projeto e da operação. Veja a função RunOperationFromProject do Design Studio:

RunOperationFromProject("<TAG>Projects/MyCloudStudioProject/Operations/MyCloudStudioOperation</TAG>");

Use uma linha de comando de um agente

Você também pode chamar operações a partir de uma linha de comando em um agente no ambiente onde você implantou o projeto. Para mais detalhes, veja Chamar uma operação a partir de uma linha de comando.

Use um gatilho de API

Para chamar a operação de um aplicativo externo, use o API Manager para configurar uma API personalizada e atribuir a operação para ser acionada por solicitação. Para mais informações, consulte a documentação do API Manager.

Operações chamadas a partir de APIs exibem um ícone de API :

operation api

Quando você passa o mouse sobre este ícone, a visão geral do serviço de API aparece:

operation schedule overview

A partir dessa visão geral, você pode clicar em Copiar URL do serviço para adicionar a URL do serviço da API à sua área de transferência.

Use um ouvinte

Os ouvintes de eventos permitem que operações sejam executadas automaticamente quando acionadas por eventos específicos. Você pode controlar se uma operação responde a esses acionadores ativando ou desativando sua capacidade de escuta de eventos.

Quando você implanta uma operação contendo uma atividade de ouvinte, a escuta de eventos é desativada por padrão e um ícone de ouvinte desativado é exibido na operação.

Para habilitar a escuta de eventos para a operação, clique no ícone de ouvinte desativado e use o interruptor:

visão geral do cronograma de operações

Operações acionadas por eventos exibem um ícone de ouvinte ativo :

ouvinte de operação

Para mais informações, consulte Ver ou habilitar / desabilitar ouvintes na página Projetos do Console de Gerenciamento.

Usar um cronograma

Para executar a operação automaticamente em um cronograma, você deve primeiro configurar um cronograma e, em seguida, aplicá-lo a uma operação. Você pode criar e aplicar cronogramas diretamente no Studio, conforme descrito abaixo. Você também pode criar e aplicar cronogramas a partir da página Projetos no Console de Gerenciamento.

Nota

Após aplicar um cronograma a uma operação, você pode desabilitá-lo ou reabilitá-lo a partir da página Projetos no Console de Gerenciamento.

Você adiciona cronogramas na aba Cronogramas das configurações da operação. Você pode acessar a opção Configurações a partir das seguintes localizações:

Para informações detalhadas de configuração, consulte Cronogramas de operações.

Operações com agendamentos habilitados exibem um ícone Configurações da operação agendada:

operação com agendamento

Ao passar o mouse sobre este ícone, uma visão geral do agendamento aparece:

visão geral do agendamento da operação

A partir desta visão geral, você pode clicar em Editar agendamento para modificar as configurações ou em Remover agendamento para remover o agendamento da operação.

Requisitos de implantação

Você pode configurar os requisitos de implantação para cada projeto durante a criação e configuração do projeto.

Se as configurações de implantação em nível de projeto exigirem uma tag ou comentário, um diálogo aparecerá quando você iniciar uma implantação ou implantar e executar, para que você possa inserir as informações necessárias. A tela de implantação configurável também fornece esses campos.

Texto do diálogo

Requisitos de Implantação
Sua organização exige um comentário e uma tag ao implantar.

  • Tag

  • Comentário

  • Tag: Insira uma tag para rotular o evento de implantação. A tag aparece como um rótulo no evento de implantação e é registrada nos detalhes da implantação acessíveis a partir do histórico do projeto.
  • Comentário: Insira um comentário para descrever o evento de implantação. O comentário é registrado nos detalhes da implantação acessíveis a partir do histórico do projeto.
  • Adicionar Comentário e Tag: Clique para adicionar a tag, o comentário ou ambos, e continue com a implantação da operação.
  • Cancelar: Clique para fechar o diálogo e retornar à tela anterior sem implantar.

Cancelar uma operação executada

Se você precisar parar uma operação executada que está com status Enviada, Recebida, Pendente ou Em Execução, você pode fazê-lo a partir dos seguintes locais: