Ir para o conteúdo

Horários

No Jitterbit, as operações podem ser executadas de várias maneiras, como manualmente, automaticamente por meio de uma chamada de API ou automaticamente por meio de uma programação. Esta página abrange a configuração de uma programação para executar sua operação automaticamente.

Os agendamentos contêm informações sobre quando uma operação será ativada automaticamente. O Jitterbit permite que você defina praticamente qualquer tipo de programação de que você precisa, como toda sexta-feira às 17h, a última sexta-feira de cada trimestre ou a cada hora durante um dia.

Criar um Cronograma

Você pode optar por criar uma nova programação por conta própria ou dentro de uma operação existente. Os agendamentos devem ser atribuídos a uma operação para serem aplicáveis a essa operação. Para obter mais informações sobre como criar operações, consulte Criar uma operação.

Dica

A partir da versão 9.0, outro local onde você pode criar e aplicar agendamentos é no Management Console. As alterações de cronograma feitas por meio do Management Console entram em vigor imediatamente, sem a necessidade de reimplantar o projeto no Harmony. Para mais informações, consulte Projetos.

Criar Nova Programação

Há várias maneiras de criar um novo cronograma como um item de projeto independente no Design Studio:

  • Vá para Arquivo > Novo > Novo Agendamento.
  • Na árvore à esquerda, clique com o botão direito do mouse em Agendamentos e selecione Novo agendamento.
  • Na barra de ferramentas superior, clique no ícone de agendamento anexo.

Nota

Se você criar um agendamento por meio de um dos métodos acima, observe que ele não está associado a nenhuma operação. Para usar a programação em uma operação, siga Use Existing Schedule in an Existing Operation abaixo.

Criar Nova Programação em uma Operação Existente

Você também pode criar um novo cronograma como um item de projeto que já está atribuído a uma operação no Design Studio. Para fazer isso:

  • Dentro de uma operação, clique na seta para baixo anexo ou clique com o botão direito do mouse no plano de fundo da operação e selecione Cronograma > Selecionar cronograma > Criar novo cronograma.

Usar Programação Existente em uma Operação Existente

Se você já tiver uma operação e um cronograma criados, há várias maneiras de adicionar um cronograma existente a uma operação existente no Design Studio:

  • Dentro de uma operação, clique na seta para baixo anexo ou clique com o botão direito do mouse no plano de fundo da operação e selecione Cronograma > Selecionar cronograma e escolha o cronograma existente.
  • Dentro da operação, clique duas vezes no título da operação para abrir a janela Configurar operação. Expanda a seção Cronograma, use o menu suspenso Cronograma para selecionar o cronograma existente.
  • Arraste o cronograma existente da árvore à esquerda e solte-o no fundo da operação.

Cuidado

Se você estiver usando uma programação existente em várias operações, tenha cuidado ao editar a programação, pois as alterações na programação afetarão todas as operações que usam essa programação.

Editar Programação

Depois de criar um novo cronograma, a tela de configuração será aberta na visualização principal do Design Studio. Você pode voltar à tela de configuração a qualquer momento de uma das seguintes maneiras:

  • Clique duas vezes no cronograma na árvore à esquerda.
  • Dentro da operação, clique no ícone de agendamento anexo e selecione Editar agendamento.
  • Dentro da operação, clique na seta para baixo anexo ou clique com o botão direito do mouse no plano de fundo da operação e selecione Cronograma > Editar cronograma.

Configuração Básica

A tela de configuração deve ser semelhante ao exemplo abaixo. Cada opção configurável é explicada a seguir.

anexo

  • Nome: digite um nome para sua nova programação. Você pode querer dar ao agendamento um nome que reflita a frequência do agendamento ou, se usado para uma operação específica, reflita a finalidade do agendamento (por exemplo, "A cada 5 minutos" ou "Sincronização de contato").

  • Ocorrência: Selecione uma das três opções para os dias em que o agendamento deverá iniciar a(s) operação(ões) a que está atribuído:

    • Diário: A programação ativará a operação todos os dias ou a cada poucos dias. Quando esta opção é selecionada, o seguinte fica disponível para configuração:

      • Cada [#] Dia(s): Insira um número de dia(s) entre as execuções da operação.
    • Semanalmente: A programação ativará a operação durante um conjunto especificado de dias da semana. Quando esta opção é selecionada, o seguinte fica disponível para configuração:

      • 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]: Marque as caixas ao lado do(s) dia(s) da semana em que deseja a operação para correr.
    • Mensal: O agendamento ativará a operação mensalmente. Quando esta opção for selecionada, escolha uma das duas opções que ficam disponíveis para configurar:

      • Dia [#] de cada [#] mês(es): Insira o dia do mês e o(s) número(s) 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 suspensos para selecionar qual dia do mês e insira o(s) número(s) de mês(es) entre as execuções da operação.
  • Frequência Diária: Selecione uma das duas opções para os horários em que o agendamento deve iniciar a operação nos dias em que for executado:

    • Ocorre uma vez às [hh:mm] [AM/PM]: A programação ativará a operação apenas uma vez no horário especificado. Use os menus suspensos para selecionar a(s) hora(s), minuto(s) e hora do dia em que deseja que a operação seja executada.

    • Ocorre a cada [#] [Minuto(s)/Hora(s)] Começando em [hh:mm] [AM/PM] e Terminando em [hh: mm] [AM/PM]: A programação reativará repetidamente a operação para o período de tempo especificado ao longo do dia. Insira um número para corresponder à seleção suspensa de minuto(s) ou hora(s) em que você deseja que a operação seja executada, junto com as seleções suspensas de qualquer horário ao longo do dia em que você deseja limitar a execução da operação.

      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.

    • A partir de: Por padrão, a data atual será selecionada. Se desejar especificar uma data de início diferente, clique no ícone de calendário anexo para abrir um seletor de datas do calendário e selecionar a data desejada.
    • Terminando em: Por padrão, a(s) operação(ões) em que o agendamento é atribuído serão executadas indefinidamente de acordo com o agendamento. Se desejar especificar uma data final, clique no ícone de calendário anexo para abrir um seletor de datas de calendário para selecionar a data desejada.

Dica

Depois de configurar um agendamento e atribuí-lo a uma operação, é uma prática recomendada colocar uma mensagem e-mail On Failure na operação agendada. Consulte Criar uma mensagem E-mail Para maiores informações.

Fusos Horários de Operação

Ao configurar um agendamento, o campo Frequência Diária não exibe o fuso horário em que a operação será executada. O fuso horário no qual 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 de agendamento esteja habilitada nas políticas da 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 Agente Privado 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 um agendamento configurado inicia a operação podem ser imprevisíveis, dependendo do agente específico que está sendo usado.
  • Substituir fuso horário do Agente de agendamento

    • Se a configuração Substituir fuso horário do Agente de agendamento estiver ativada nas políticas da organização, o fuso horário selecionado determinará o fuso horário no qual todos os agendamentos atuais e futuros em uma organização serão executados.

Configuração Avançada com Script

Se as opções disponíveis na interface do usuário conforme descrito acima em Configuração básica não atendem às suas necessidades de negócios, você pode executar configurações adicionais do planejamento usando scripts.

Nota

Se você tiver a configuração Substituir fuso horário do Agente de agendamento ativada nas políticas da organização, qualquer scripts que use funções de data e hora conforme descrito aqui não será substituído pelo fuso horário selecionado.

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

  1. Crie um novo agendamento e configure-o para ser executado todos os dias no horário apropriado, conforme descrito anteriormente nesta página.

  2. Crie uma nova operação com um item de projeto de script Jitterbit conforme descrito em Criar um Script.

  3. Atribua o agendamento à operação de script que você acabou de criar.

  4. Abra o script e insira o seguinte para verificar o último dia do mês e executar uma operação se verdadeiro:

    <trans>
    if(DayOfMonth(LastDayOfMonth(Now()))==DayOfMonth(Now()),
    RunOperation("<TAG>Operations/Some Operation to Run</TAG>")
    );
    </trans>
    
  5. As operações devem ser semelhantes às seguintes depois que essas etapas forem concluídas:

    anexo

Definir Política de Agendamento

Sempre que um novo agendamento é criado, ele é definido por padrão para que qualquer operação seja ignorada caso uma instância agendada anteriormente da mesma operação ainda esteja em execução. Essa é a melhor prática recomendada na maioria das situações, mas pode ser alterada para permitir que uma operação seja iniciada mesmo se uma instância agendada anteriormente ainda estiver em execução.

Isso deve ser feito apenas se você tiver um requisito especial para fazê-lo. Se você fizer essa alteração, certifique-se de que ter operações simultâneas não será prejudicial ao processar os mesmos registros de dados de origem várias vezes.

Esta configuração pode ser acessada desde a operação das seguintes formas:

  • Dentro da operação, clique no ícone de agendamento anexo e selecione Schedule Policy > Ignorar a execução se a operação agendada anteriormente ainda estiver em execução ou Iniciar mesmo se a operação agendada anteriormente ainda estiver em execução.
  • Dentro da operação, clique na seta para baixo anexo ou clique com o botão direito do mouse no plano de fundo da operação e selecione Schedule > Schedule Policy > Ignore a execução se a operação agendada anteriormente ainda estiver running ou Iniciar mesmo se a operação agendada anteriormente ainda estiver em execução.
  • Dentro da operação, clique duas vezes no título da operação para abrir a janela Configurar operação. Expanda a seção Cronograma, use o menu suspenso Cronograma para selecionar o cronograma apropriado e selecione Ignorar execução se a operação agendada anteriormente ainda estiver em execução ou Iniciar mesmo se a operação agendada anteriormente ainda estiver em execução correndo.

Se estiver usando Agentes Privados, avaliações adicionais devem ser feitas para garantir que agendamentos agressivos não irão sobrecarregar seu Grupo de Agentes, causando um atraso na operação.

O padrão dos Agentes Privados é poder executar até duas vezes sua contagem de CPU por máquina do agente. Portanto, se sua máquina Agente Privado tiver 4 núcleos de CPU, você poderá processar até 8 operações simultâneas.

Ao avaliar seus requisitos de negócios, algumas de suas 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, suas operações mais críticas poderão ser afetadas. Para evitar isso, simplesmente determine o número de operações que seu Grupo de Agentes pode processar simultaneamente e, em seguida, equilibre-o com a prioridade comercial e a duração do tempo de tempo de execução de suas operações agendadas.

Ativar Ou Desativar Agendamento

Depois de atribuir uma programação a uma operação, você pode optar por desativá-la ou reativá-la (se desabilitada) remotamente por meio do Management Console dos Projetos página.

Aviso

Lembre-se de desativar sua programação, pois essa funcionalidade está disponível apenas no Management Console e pode não ser óbvio no Design Studio que a programação foi desativada remotamente.

Na página Projetos, selecione uma linha na tabela Projetos para exibir guias adicionais na parte inferior da página. Você pode habilitar ou desabilitar um cronograma para uma única operação ou para todo o projeto da seguinte maneira:

  • Operações: na aba Operações, a coluna Status exibe o status de quaisquer agendamentos atribuídos à operação. Clique no botão de alternância para ativar ou desativar uma programação existente, ativando ou desativando efetivamente a programação para essa operação.

  • Cronogramas: na aba Cronogramas, a coluna Programado exibe o status de quaisquer cronogramas atribuídos a operações dentro do projeto. Clique no botão de alternância para ativar ou desativar uma programação existente, ativando ou desativando efetivamente a programação de todo o projeto.

    Cuidado

    A ativação ou desativação de uma programação usada em várias operações afetará todas as operação que usam a programação.

Remover Programação

Se você tiver um agendamento atribuído a uma operação, poderá removê-lo da operação das seguintes maneiras. Isso não excluirá o cronograma como um item do projeto, mas simplesmente cancelará sua atribuição da operação.

  • Dentro da operação, clique no ícone de agendamento anexo e selecione Remover agendamento.
  • Dentro da operação, clique na seta para baixo anexo ou clique com o botão direito do mouse no plano de fundo da operação e selecione Agendamento > Remover agendamento.
  • Dentro da operação, clique duas vezes no título da operação para abrir a janela Configurar operação. Expanda a seção Agendamento, use o menu suspenso Agendamento para selecionar (nenhum).

Cronograma de Solução de Problemas

Se sua programação não estiver funcionando conforme o esperado, verifique os seguintes itens para ajudar a diagnosticar e resolver problemas o problema:

  • Você implantou a operação à qual o cronograma está atribuído?
    Os agendamentos devem ser atribuídos a uma operação para serem acionados. Depois de salvar uma programação em uma operação, ela não entrará em vigor até que seja implantada.

  • Sua agenda está habilitada?
    As programações podem ser desativadas e reativadas somente no Management Console da web. Verifique a página Projetos nas guias Operações e Agendamentos para garantir que seu agendamento esteja ativado.

  • Você sabe em que fuso horário está sua programação?
    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á 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.

  • Se você estiver usando um Agente Privado, os horários agressivos estão sobrecarregando seu Grupo de Agentes?
    Se estiver usando Agentes Privados, avaliações adicionais devem ser feitas para garantir que agendamentos agressivos não irão sobrecarregar seu Grupo de Agentes, causando um backlog de operação.

    O padrão dos Agentes Privados é poder executar até duas vezes sua contagem de CPI por máquina do agente. Portanto, se sua máquina Agente Privado tiver 4 núcleos de CPU, você poderá processar até 8 operações simultâneas.

    Ao avaliar seus requisitos de negócios, algumas de suas 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, suas operações mais críticas poderão ser afetadas. Para evitar isso, simplesmente determine o número de operações que seu Grupo de Agentes pode processar simultaneamente e, em seguida, equilibre-o com a prioridade comercial e a duração do tempo de tempo de execução de suas operações agendadas.