Agendas de operações no Jitterbit Integration Studio

Introdução

Configure operações para serem executadas automaticamente usando agendas que definem quando elas são executadas. Você pode criar agendas flexíveis, como toda sexta-feira às 17h, a última sexta-feira de cada trimestre ou a cada hora em dias específicos.

Quando uma operação agendada inclui ações de operação, quaisquer operações subsequentes são executadas automaticamente também.

Crie e gerencie agendas diretamente no Integration Studio ou através da página de Projetos no Console de Gerenciamento, onde você pode visualizar todas as agendas de projetos e habilitá-las ou desabilitá-las conforme necessário.

Ao implantar uma agenda que já foi implantada na nuvem Harmony, você é apresentado a opções para selecionar quais agendas usar. Isso é abordado em Selecionar agendas e variáveis de projeto em Implantação de projeto.

Outras maneiras de executar operações incluem a execução manual de operações ou o uso de um gatilho de API, conforme abordado em Implantação e execução de operações.

Criar uma nova agenda ou abrir uma agenda existente

As agendas de operações podem ser acessadas a partir do painel de projeto, das configurações da operação ou da tela de design, dependendo se você está criando uma nova agenda ou editando uma agenda existente. Após criar uma agenda ou abrir uma agenda existente para editar, consulte Configurar agendas de operações mais adiante nesta página para configuração.

Uma nova agenda pode ser criada na aba Componentes do painel de projeto usando a opção Criar Novo na categoria Agendas (veja Menu de ações da aba Componentes na Aba Componentes do painel de projeto). Novas agendas são criadas com o nome padrão Nova Agenda. Agendas subsequentes com nomes padrão são acrescidas de um número incrementado entre parênteses.

Um cronograma existente pode ser editado na aba Componentes do painel do projeto usando a opção Visualizar/Editar em um componente de cronograma (veja o menu de ações do componente na aba Componentes do painel do projeto).

Para editar um cronograma existente que já está atribuído a uma operação, clique no ícone de cronograma na barra de ações da operação para exibir a aba Cronogramas das configurações da operação.

A aba Cronogramas das Configurações da operação também pode ser acessada a partir destes locais:

• A aba Fluxos de Trabalho do painel do projeto (veja o menu de ações do componente na aba Fluxos de Trabalho do painel do projeto).
• A aba Componentes do painel do projeto (veja o menu de ações da aba Componentes e o menu de ações do componente na aba Componentes do painel do projeto).
• A tela de design (veja o menu de ações do componente na Tela de Design).
• A tela de design clicando duas vezes na operação (abre Configuração diretamente).

Configurar cronogramas de operação

Na aba Cronogramas das configurações da operação, cronogramas existentes que foram criados tanto no Integration Studio quanto no Management Console podem ser aplicados às operações. A partir daqui, você também pode criar novos cronogramas, editar cronogramas existentes e dissociar cronogramas das operações. Cada opção é descrita abaixo.

• Condição: O primeiro menu deve mostrar a seleção como Em Agenda, indicando que a condição pela qual a operação será acionada é um agendamento. Não há outras condições que possam ser definidas neste momento.

• Agendamento: Use este menu para selecionar o agendamento existente que você deseja aplicar à operação. Se o agendamento que você deseja usar ainda não existir, clique no link Criar Novo Agendamento para criar um novo agendamento. Esta opção é abordada abaixo.

• Atribuir: Clique em Atribuir para aplicar o agendamento selecionado à operação. Observe que apenas um agendamento pode ser aplicado a cada operação, e que o agendamento atribuído não terá efeito até que o projeto tenha sido implantado.

  Quando uma operação tem um agendamento atribuído, os campos Agendamento, Atribuir e Criar Novo Agendamento são substituídos por opções para definir a política de agendamento e um resumo do agendamento atribuído. Além disso, um ícone de de agendamento aparece na operação na tela de design, que, ao ser clicado, reabre a tela de agendamentos da operação.

  Dica

  Ao aplicar um agendamento a uma operação, é uma prática recomendada definir uma ação de operação em falha para acionar uma notificação por email na operação agendada.

  

• Política de agendamento: Defina a política de agendamento, uma das opções Sempre executar ou Pular se já estiver em execução:

  • Sempre executar: Selecione para executar a operação conforme o agendamento no caso de uma execução anterior da operação ainda estar em andamento. Esta opção deve ser selecionada apenas se você tiver um requisito especial para fazê-lo. Ao usar esta opção, certifique-se de que ter operações concorrentes não será prejudicial, processando potencialmente os mesmos registros de dados de origem várias vezes.

  • Pular se já estiver em execução: Selecione para pular uma execução agendada da operação no caso de uma execução anterior da mesma operação ainda estar em andamento (padrão).

• Cronograma atribuído: Quando uma operação tem um cronograma atribuído, um resumo do cronograma atribuído é exibido com estas opções:

  • Editar: Para editar o cronograma atribuído, clique no ícone de edição para abrir a tela de configuração do cronograma e fazer as alterações necessárias. Cronogramas existentes também podem ser acessados a partir do painel de projeto. Na aba Componentes, para editar um cronograma, passe o mouse sobre o nome do cronograma, depois clique no ícone do menu de ações e, no menu, selecione Visualizar/Editar.

    Nota

    Se o mesmo cronograma estiver atribuído a outras operações, as edições afetarão o cronograma de todas as operações às quais ele está atribuído.

  • Remover: Para dissociar o cronograma da operação, clique no ícone de remoção . Observe que o cronograma em si não é excluído, mas simplesmente desassociado da operação.

• Criar Novo Cronograma: Para criar um novo cronograma, clique no link para Criar Novo Cronograma. Isso abre a tela de configuração do cronograma.

  Nota

  O cronograma não é criado até que você tenha configurado e salvo o novo cronograma. Após o cronograma ser criado, você precisará selecioná-lo no menu Cronograma Disponível e clicar em Atribuir para aplicá-lo à operação.

  

  • Nome do cronograma: Insira um nome para o cronograma. Você pode querer dar ao cronograma um nome que reflita a frequência do cronograma ou, se usado para uma operação específica, que reflita o propósito do cronograma (por exemplo, "A Cada 5 Minutos" ou "Sincronização de Contatos"). O nome não deve começar ou terminar com um espaço.

  • Ocorrência: Use o menu para selecionar uma das três opções para os dias em que o cronograma deve iniciar a(s) operação(ões) à qual(is) está atribuído:

    • Diariamente: O cronograma ativará a operação todos os dias ou a cada poucos dias. Quando esta opção é selecionada, esses campos ficam disponíveis para configuração:

      • Todo [#] Dia(s): Insira um número de dia(s) entre as execuções da operação.

    • Semanal: O cronograma ativará a operação durante um conjunto específico de dias da semana. Quando esta opção é selecionada, esses campos ficam disponíveis para configuração:

      • Todo [#] Semana(s): Insira um número de semana(s) entre as execuções da operação.
      • [Dom, Seg, Ter, Qua, Qui, Sex, Sáb]: Clique para selecionar o(s) dia(s) da semana em que deseja que a operação seja executada. Pelo menos um dia deve ser selecionado.

    • Mensal: O cronograma ativará a operação mensalmente. Quando esta opção é selecionada, escolha uma das duas opções que ficam disponíveis para configuração:

      • Dia [#] de Todo [#] Mês(es): Insira o dia do mês e o número de mês(es) entre as execuções da operação.
      • O [1º, 2º, 3º, 4º ou Último] [Dia da Semana] de Todo [#] Mês: Use os menus para selecionar qual dia do mês e insira o número de mês(es) entre as execuções da operação.

  • Frequência: Selecione uma das duas opções para os horários em que o cronograma deve iniciar a operação nos dias em que é executado:

    • Ocorre Uma Vez às [hh:mm:ss] [AM/PM]: O cronograma ativará a operação apenas uma vez no horário especificado. Especifique o horário inserindo a hora e o minuto (no formato HH:MM) e o período do dia (AM ou PM).

    • Ocorre a Cada [#] [Minuto(s)/Hora(s)] Começando às [hh:mm:ss] [AM/PM] e Terminando às [hh:mm:ss] [AM/PM]: O cronograma reativará repetidamente a operação pelo intervalo e período de tempo especificados ao longo do dia. Especifique o intervalo e o período de tempo que deseja limitar a execução da operação. Insira a hora e o minuto (no formato HH:MM) e o período do dia (AM ou PM).

      Nota

      Os fusos horários são discutidos abaixo em Fusos horários da operação.

  • Duração: Configure as datas de duração para o cronograma.

    Nota

    As datas de início e fim em um cronograma são inclusivas, o que significa que o cronograma estará ativo durante a parte restante do dia tanto na data de início quanto na data de fim.

    • Data de Início: Por padrão, o cronograma estará ativo a partir da data atual. Se você quiser que o cronograma comece em outro dia, use o seletor de data/hora para selecionar a data de início desejada.
    • Adicionar Data de Fim: Por padrão, a(s) operação(ões) às quais o cronograma está atribuída será(ão) executada(s) indefinidamente de acordo com o cronograma. Se você quiser especificar uma data de fim, primeiro clique no link para Adicionar Data de Fim para adicionar o campo Data de Fim. Em seguida, use o seletor de data/hora para definir uma data em que você deseja que o cronograma termine. O cronograma estará ativo até o final da data de fim.
    • Remover Data de Fim: Este link aparece uma vez que o campo Data de Fim é adicionado. Para remover o campo Data de Fim, clique no link para Remover Data de Fim.

  • Salvar: Clique para salvar e fechar a configuração do cronograma.

Fusos horários das operações

Ao configurar um cronograma, o campo Frequência não exibe o fuso horário em que a operação será executada. O fuso horário em que a operação será executada depende do agente que está executando a operação, a menos que a configuração Substituir Fuso Horário do Agente do Cronograma esteja habilitada nas políticas da sua organização:

• Fuso Horário do Agente

  • Agentes em nuvem: Todos os agentes em nuvem estão em UTC.
  • Agentes privados: Os fusos horários dos agentes privados são determinados pelo fuso horário do sistema operacional do agente privado. É altamente recomendável que todos os agentes em um grupo de agentes privados estejam operando no mesmo fuso horário, ou os horários em que um cronograma configurado inicia a operação podem ser imprevisíveis, dependendo do agente específico que está sendo utilizado.

  Ao usar a versão do agente 10.85 / 11.23 ou posterior, e o agente estiver usando um fuso horário que observa o horário de verão, essas ações ocorrem durante uma mudança de horário de verão:

  • Quando um agendamento diário é definido entre 2 - 3 AM, a operação agendada será executada às 3 AM no segundo domingo de março.

  • Quando um agendamento diário é definido entre 1 - 2 AM, a operação agendada será executada na segunda instância de 1 AM no primeiro domingo de novembro.

  Um problema conhecido existe para os cenários acima ao usar a versão do agente 10.84 / 11.22 e anteriores.

  Dica

  Para consistência no agendamento, recomenda-se usar um fuso horário que não observe o horário de verão, como UTC (agentes em nuvem usam UTC por padrão). Se estiver usando um agente privado, você pode usar a configuração Substituir Fuso Horário do Agente de Agendamento e selecionar Etc/UTC.

• Substituir Fuso Horário do Agente de Agendamento

  • Se a configuração Substituir Fuso Horário do Agente de Agendamento estiver habilitada nas políticas da sua organização, o fuso horário selecionado determinará o fuso horário em que todos os agendamentos atuais e futuros em uma organização serão executados.

Menu de ações de agendamento

Após a criação de um agendamento, as ações do menu para esse agendamento estão acessíveis na aba Componentes do painel do projeto (veja Menu de ações de componentes na aba Componentes do painel do projeto).

Cada uma dessas ações de menu está disponível:

Item do Menu	Descrição
	Ver/Edit abre a tela de configuração do agendamento (veja Configurar agendamentos de operação mais acima nesta página). Nota As edições de agendamento entram em vigor em todas as operações às quais estão atribuídas.
	Recortar coloca uma cópia do agendamento na sua área de transferência e exclui o agendamento original do projeto (veja Reutilização de componentes).
	Copiar coloca uma cópia do agendamento na sua área de transferência (veja Reutilização de componentes).
	Duplicar cria um novo agendamento não referenciado usando a mesma configuração do componente original (veja Reutilização de componentes).
	Renomear posiciona o cursor no nome do agendamento para que você possa fazer as edições necessárias.
	Ver Dependências altera a visualização no painel do projeto para exibir quaisquer outras partes do projeto das quais o agendamento depende (veja Dependências de componentes, exclusão e remoção).
	Adicionar ao Grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou adicionar o agendamento a um grupo existente (veja Grupos de componentes).
	Excluir exclui permanentemente o agendamento (veja Dependências de componentes, exclusão e remoção).
	Remover não está funcional atualmente.

Use scripts to schedule operations

Se as opções disponíveis na interface do usuário, conforme descrito em Configurar horários de operações, não atenderem às suas necessidades, você pode criar horários mais complexos usando scripts.

Como exemplo, um caso de uso comum pode ser criar um horário para executar a operação no último dia do mês. Estes passos detalham esse caso de uso:

1. Crie uma operação contendo um único script como um componente do projeto.

2. Configure o script como um Script Jitterbit contendo a lógica do script que verifica se é o último dia do mês e executa uma operação se for verdadeiro. Certifique-se de substituir a referência da operação pela da operação que você deseja executar no horário.

   <trans>
   if(DayOfMonth(LastDayOfMonth(Now()))==DayOfMonth(Now()),
   RunOperation("<TAG>operation:Scheduled Operation</TAG>");
   );
   </trans>
   

3. Crie um horário que execute todos os dias no horário desejado e aplique-o à operação contendo o script que você acabou de criar.

4. A cadeia de operações deve parecer semelhante a isto uma vez que esses passos estejam completos:

   

Manage operation schedules

Quando você aplica um horário a uma operação, o horário é habilitado por padrão. Você pode desabilitar ou reabilitar horários remotamente através do Console de Gerenciamento na página Projetos.

Habilitar e desabilitar cronogramas

A página Projetos oferece duas maneiras de controlar o status do cronograma. Você pode usar a aba Operações ou a aba Cronogramas:

• Operações individuais: Na aba Operações, use o botão de alternância na coluna Status da Operação para habilitar ou desabilitar um cronograma para uma única operação.

• Todas as operações: Na aba Cronogramas, use o botão de alternância na coluna Status do Cronograma para habilitar ou desabilitar um cronograma em todas as operações que utilizam esse cronograma.

Quando você desabilita um cronograma no nível do projeto, isso substitui as configurações de operações individuais. O Status Efetivo é exibido como desabilitado, mesmo quando você habilitou o cronograma para operações específicas. Para instruções detalhadas, consulte os Projetos do Console de Gerenciamento.

Indicadores visuais

Operações com cronogramas habilitados exibem um ícone Configurações da operação do cronograma:

Quando você passa o mouse sobre este ícone, uma visão geral do cronograma aparece:

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

Solucionar problemas de cronogramas

Se um cronograma não estiver funcionando como esperado, verifique estes itens ao solucionar o problema:

• Você implantou a operação à qual o cronograma está atribuído?
  No Integration Studio, os cronogramas devem ser atribuídos a uma operação e, em seguida, implantados para que possam ser acionados. Uma vez que você tenha atribuído um cronograma a uma operação no Integration Studio, ele não terá efeito até que tenha sido implantado. (Em contraste, os cronogramas atribuídos a uma operação através do Console de Gerenciamento entram em vigor imediatamente, sem necessidade de reimplantar o projeto no Harmony.)

• O agendamento está habilitado?
  Os agendamentos podem ser desativados e reativados apenas a partir do Console de Gerenciamento. Verifique a página Projetos nas abas Operações e Agendamentos para garantir que o agendamento esteja habilitado.

• Você sabe em qual fuso horário seu agendamento está?
  Os fusos horários são discutidos em Fusos horários de operação.

• Se você estiver usando um agente privado, o serviço de agendamento está em execução?
  Na máquina onde o agente privado está instalado, verifique se o Jitterbit Scheduler e o Jitterbit Scheduler Service estão em execução. No Windows, isso pode ser verificado através do Gerenciador de Tarefas na aba Processos. No Linux e Docker, use o comando jitterbit status.

• Se você estiver usando um agente privado, os agendamentos agressivos estão sobrecarregando o grupo de agentes?
  Se estiver usando agentes privados, uma avaliação adicional deve ser feita para garantir que muitos agendamentos em um curto período de tempo não sobrecarreguem o grupo de agentes, causando um backlog de operações.

  Os agentes privados têm como padrão a capacidade de executar até duas vezes a contagem de CPUs para cada máquina de agente. Por exemplo, se a máquina do agente privado tiver 4 núcleos de CPU, você poderá processar até 8 operações simultâneas.

  Ao avaliar os requisitos, algumas das operações podem ser mais dependentes do tempo do que outras. Se várias operações não críticas acumularem na fila do agente, então operações mais críticas podem ser afetadas. Para evitar isso, determine o número de operações que o grupo de agentes pode processar simultaneamente (usando os cálculos de contagem de CPU descritos acima) e, em seguida, equilibre isso com a prioridade de negócios e a duração de execução das operações agendadas.