Agendas de operação no Jitterbit 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 Studio ou através da página de Projetos no Console de Gerenciamento, onde você pode visualizar todas as agendas de projetos e ativá-las ou desativá-las conforme necessário.

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ção podem ser acessadas a partir do painel de projetos, 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 edição, consulte Configurar agendas de operação mais adiante nesta página para configuração.

Uma nova agenda pode ser criada na aba Componentes do painel de projetos usando a opção Criar Novo na categoria Agendas (veja Menu de ações da aba Componentes na Aba Componentes do painel de Projetos). 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.

Uma agenda existente pode ser editada na aba Componentes do painel de projetos usando a opção Visualizar/Editar em um componente de agenda (veja Menu de ações do componente na Aba Componentes do painel de Projetos).

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 Studio quanto no Console de Gerenciamento 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 já mostrar a seleção como No Cronograma, indicando que a condição pela qual a operação será acionada é um cronograma. Não há outras condições que possam ser definidas neste momento.

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

• Atribuir: Clique em Atribuir para aplicar a programação selecionada à operação. Observe que apenas uma programação pode ser aplicada a cada operação, e que a programação atribuída não terá efeito até que o projeto tenha sido implantado.

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

  Dica

  Quando você aplica uma programação a uma operação, é uma prática recomendada definir uma ação de operação em caso de falha para acionar uma notificação por email na operação programada.

  

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

  • Sempre executar: Selecione para executar a operação conforme programado 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 programada da operação no caso de uma execução anterior da mesma operação ainda estar em andamento (padrão).

• Programação atribuída: Quando uma operação tem uma programação atribuída, um resumo da programação atribuída é exibido com estas opções:

  • Editar: Para editar a programação atribuída, clique no ícone de edição para abrir a tela de configuração da programação e fazer as alterações necessárias. As programações existentes também podem ser acessadas a partir do painel do projeto. Na aba Componentes, para editar uma programação, passe o mouse sobre o nome da programação, em seguida, clique no ícone do menu de ações e, no menu, selecione Ver/Editar.

    Nota

    Se o mesmo cronograma estiver atribuído a outras operações, as edições afetam 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 remover . 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 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:

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

    • Semanalmente: 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:

      • A Cada [#] 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 você deseja que a operação seja executada. Pelo menos um dia deve ser selecionado.

    • Mensalmente: 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 Cada [#] Mês: 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 Cada [#] 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 você 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) à qual o cronograma está atribuído 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 de operação

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 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 cronograma diário é definido entre 2 - 3 AM, a operação agendada será executada às 3 AM no segundo domingo de março.

  • Quando um cronograma 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 do cronograma, é recomendável 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 do Cronograma e selecionar Etc/UTC.

• Substituir Fuso Horário do Agente do Cronograma

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

Menu de ações do 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 do componente na Aba Componentes do painel do projeto).

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

Item do Menu	Descrição
	Ver/Editar abre a tela de configuração do agendamento (veja Configurar agendamentos de operação mais acima nesta página). Nota As edições do 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 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 para 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 no momento.

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 descrevem esse caso de uso:

1. Crie uma operação contendo um único script como um componente de 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 aparece como desabilitado mesmo quando você habilitou o cronograma para operações específicas. Para instruções detalhadas, consulte os Projetos da Console de Gerenciamento.

Indicadores visuais

Operações com cronogramas habilitados exibem um ícone de 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 Studio, os cronogramas devem ser atribuídos a uma operação e, em seguida, implantados para que sejam acionados. Uma vez que você tenha atribuído um cronograma a uma operação no Studio, ele não terá efeito até que tenha sido implantado. (Em contraste, os cronogramas atribuídos a uma operação através da Console de Gerenciamento têm efeito imediato sem precisar 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 de 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 causarem um backlog 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.