Cronogramas de operação no Jitterbit Integration Studio

Introdução

Cada operação pode ser configurada para ser executada automaticamente aplicando uma programação. As programações contêm informações sobre quando uma operação será ativada automaticamente. Você pode definir praticamente qualquer tipo de programação que precisar, como toda sexta-feira às 17h, a última sexta-feira de cada trimestre ou a cada hora de um único dia.

Se uma operação em execução em um cronograma tiver configurado ações de operações, todas as operações abaixo também são executadas adequadamente.

Os cronogramas podem ser criados e aplicados diretamente no Integration Studio, conforme abordado nesta página, ou podem ser criados e aplicados a partir dos Projetos página no Management Console, onde você também pode ver uma lista de todos os agendamentos atribuídos às operações dentro de um projeto, ou habilitar ou desabilitar agendamentos.

Ao implantar um cronograma já implantado na nuvem Harmony, você terá opções para selecionar quais cronogramas usar. Isso é abordado em Selecionar cronogramas e variáveis do projeto em Implantação do projeto.

Outras maneiras de executar operações incluem executá-las manualmente ou usar um gatilho de API, conforme abordado em Implantação e execução de operações.

Crie uma nova programação ou abra uma programação existente

Os cronogramas de operação podem ser acessados no painel do projeto, nas configurações da operação ou na quadro de design, dependendo se você estiver criando um novo cronograma ou editando um cronograma existente. Após criar um cronograma ou abrir um cronograma existente para edição, consulte Configurar cronogramas de operação mais adiante nesta página para configuração.

Um novo cronograma pode ser criado na aba Componentes do painel do projeto usando a opção Criar novo na categoria Cronogramas (consulte menu de ações da aba Componentes na aba Componentes do painel Projeto). Novas programações são criadas com o nome padrão Nova Programação. Novas programações subsequentes com nomes padrão são anexadas com um número incrementado entre parênteses.

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

Para editar uma programação existente que já esteja atribuída a uma operação, clique em ícone de agendamento na barra de ação da operação para exibir a aba Agendamentos das configurações da operação.

A aba Agendamentos da operação Configurações também pode ser acessada nestes locais:

• A aba Workflows do painel do projeto (consulte menu de ações do componente na aba Workflows do painel Projeto).
• A aba Componentes do painel do projeto (consulte menu de ações da aba Componentes e menu de ações do componente na aba Componentes do painel Projeto).
• A quadro de design (veja menu de ações do componente em Tela de design).

Configurar cronogramas de operação

Na aba Agendamentos das configurações de operação, os agendamentos existentes criados no Integration Studio ou no Management Console podem ser aplicados às operações. Aqui, você também pode criar novos agendamentos, editar agendamentos existentes e dissociar agendamentos das operações. Cada opção é descrita abaixo.

• Condição: O primeiro menu já deve exibir a seleção como No Cronograma, indicando que a condição na 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 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 o cronograma selecionado à operação. Observe que apenas um cronograma pode ser aplicado a cada operação e que o cronograma atribuído não entrará em vigor até que o projeto seja 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 O ícone de agendamento aparece na operação na quadro de design, que quando clicado reabre a tela de agendamentos de operação.

  Dica

  Ao aplicar 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 e-email sobre a operação agendada.

  

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

  • Sempre executar: Selecione para executar a operação conforme o agendamento caso uma operação anterior ainda esteja em andamento. Esta opção deve ser selecionada somente se você tiver uma necessidade especial para isso. Ao usar esta opção, certifique-se de que ter operações simultâneas não seja prejudicial, possivelmente processando os mesmos registros de dados de origem várias vezes.

  • Ignorar se já estiver em execução: Selecione para ignorar uma execução agendada da operação caso uma execução anterior da mesma operação ainda esteja em execução (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 a programação atribuída, 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 no painel do projeto. Na aba Componentes, para editar uma programação, passe o mouse sobre o nome da programação e clique no botão ícone do menu de ações e no menu selecione Exibir/Editar.

    Nota

    Se a mesma programação for atribuída a outras operações, as edições afetarão a programação de todas as operações às quais ela for atribuída.

  • Remover: Para dissociar o agendamento da operação, clique no ícone de remoção. Observe que a programação em si não é excluída, mas simplesmente desatribuída da operação.

• Criar Nova Agenda: Para criar uma nova agenda, clique no link Criar Nova Agenda. Isso abrirá a tela de configuração da agenda.

  Nota

  A programação só será criada depois que você configurar e salvar a nova programação. Após a criação da programação, você precisará selecioná-la no menu Programação Disponível e clicar em Atribuir para aplicá-la à operação.

  

  • Nome do agendamento: Insira um nome para o agendamento. Você pode dar ao agendamento um nome que reflita a frequência do agendamento ou, se usado para uma operação específica, que reflita a finalidade do agendamento (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 a programação deve iniciar a(s) operação(ões) em que está atribuída:

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

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

    • Semanal: O agendamento ativará a operação durante um conjunto específico de dias da semana. Quando esta opção é selecionada, estes 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 deseja que a operação seja executada. Pelo menos um dia deve ser selecionado.

    • Mensal: O agendamento ativará a operação mensalmente. Ao selecionar esta opção, escolha uma das duas opções disponíveis para configuração:

      • Dia [#] de cada [#] mês(es): Insira o dia do mês e o número de meses 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 o dia do mês e insira o número de meses entre as execuções da operação.

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

    • **Ocorre uma vez às [hhss] AM/PM:** A programação ativará a operação apenas uma vez no horário especificado. Especifique o horário inserindo a hora e o minuto (em HH:MM formato) e o período de tempo.

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

      Nota

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

  • Duração: Configure as datas de duração do agendamento.

    Nota

    As datas de início e término em uma programação são inclusivas, o que significa que a programação estará ativa durante o restante do dia, tanto na data de início quanto na data de término.

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

  • Salvar: Clique para salvar e fechar a configuração de agendamento.

Fusos horários de operação

Ao configurar um agendamento, 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 a operação, a menos que a configuração Substituir Fuso Horário do Agente Agendado esteja habilitada nas políticas da sua organização:

• Fuso horário do Agente

  • Agentes de nuvem: Todos os agentes de 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 em execução no mesmo fuso horário, ou os horários em que uma programação configurada inicia a operação podem ser imprevisíveis, dependendo do agente específico em uso.

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

  • Quando uma programação de uma vez por dia for definida entre 2h e 3h, a operação programada será executada às 3h do segundo domingo de março.

  • Quando uma programação diária é definida entre 1h e 2h, a operação programada será executada na segunda ocorrência de 1h do primeiro domingo de novembro.

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

  Dica

  Para consistência de agendamento, é recomendável usar um fuso horário que não observe o horário de verão, como UTC (os 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 todas as programações atuais e futuras de uma organização serão executadas.

Menu de ações programadas

Após a criação de um cronograma, as ações de menu para esse cronograma ficam acessíveis na aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

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

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

Use scripts para agendar operações

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

Por exemplo, um caso de uso comum pode ser criar um cronograma para executar a operação no último dia do mês. Estas etapas explicam esse caso de uso:

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

2. Configure o script como um Jitterbit Script contendo lógica de script que verifica 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 deseja executar na programação.

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

3. Crie uma programação que seja executada todos os dias no horário desejado e aplique-a à operação que contém o script que você acabou de criar.

4. A cadeia de operação deverá ser semelhante a esta quando estas etapas forem concluídas:

   

Habilitar ou desabilitar agendamentos

Ao criar e aplicar um agendamento a uma operação, ele é habilitado por padrão. Usando o Management Console, você pode escolher desabilitar ou reabilitar uma programação (se desabilitada) remotamente em Projetos página.

Na página Projetos, isso pode ser feito na aba Operações ou Cronogramas, usando a alternância na coluna Status da Operação para habilitar ou desabilitar um cronograma em uma única operação, ou usando a alternância na coluna Status do Cronograma para habilitar ou desabilitar um cronograma em todas as operações que o tenham aplicado. Observe que desabilitar um cronograma no nível do projeto faz com que o Status Efetivo seja desabilitado mesmo que o cronograma esteja habilitado para uma operação individual. Para obter instruções detalhadas, consulte Projetos (Management Console).

Solucionar problemas de agendamento

Se uma programação não estiver funcionando conforme o esperado, verifique estes itens ao solucionar o problema:

• Você implementou a operação à qual o cronograma está atribuído?
  No Integration Studio, os agendamentos devem ser atribuídos a uma operação e, em seguida, implantados para que sejam acionados. Depois de atribuir um agendamento a uma operação no Integration Studio, ele só entrará em vigor após ser implantado. (Por outro lado, os agendamentos atribuídos a uma operação por meio do Management Console entram em vigor imediatamente, sem a necessidade de reimplantar o projeto no Harmony.)

• A programação está habilitada?
  Os agendamentos só podem ser desabilitados e reabilitados no Management Console. Verifique os Projetos nas abas Operações e Programações para garantir que a programação esteja habilitada.

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

• Se você estiver usando um agente particular, o serviço de agendamento está funcionando?
  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 por meio do Gerenciador de Tarefas em Processos. No Linux e no Docker, use o jitterbit status comando.

• Se você estiver usando um agente particular, as agendas agressivas estão sobrecarregando o grupo de agentes?
  Se forem utilizados agentes privados, uma avaliação adicional deve ser feita para garantir que muitas programações em um curto período de tempo não sobrecarreguem o grupo de agentes, causando um acúmulo de operação.

  Os agentes privados, por padrão, conseguem executar até o dobro da capacidade de CPU de cada máquina do 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 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, operações mais críticas poderão 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, compare isso com a prioridade de negócios e a duração do tempo de execução das operações agendadas.