Ir para o conteúdo

Cronogramas de Operação

Introdução

Cada operação pode ser configurada para ser executada automaticamente aplicando um agendamento. As programações contêm informações sobre quando uma operação será ativada automaticamente. Você pode definir praticamente qualquer tipo de programação necessária, 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 agendamento tiver configurado ações de operações, quaisquer operações abaixo também serão executadas adequadamente.

Os cronogramas podem ser criados e aplicados diretamente no Cloud Studio, conforme abordado nesta página, ou podem ser criados e aplicados em Projetos na página Management Console, onde você também pode ver uma lista de todos os cronogramas atribuídos às operações em um projeto ou ativar ou desativar cronogramas.

Ao implementar um agendamento que já foi implementado na nuvem Harmony, serão apresentadas opções para selecionar quais agendamentos usar. Isso é abordado em Selecionar Cronogramas e Variáveis do Projeto em Implantação do Projeto.

Outras maneiras de executar operações incluem executar operações 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 de operação ou na quadro de design, dependendo se você estiver criando um novo cronograma ou editando um cronograma existente. Depois de criar um agendamento ou abrir um agendamento existente para edição, consulte Configurar agendamentos de operação posteriormente 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 Programações (consulte Menu de ações da guia Componentes em Guia Componentes do painel do projeto). Novos agendamentos são criados com o nome padrão Novo agendamento. Os novos planejamentos subsequentes com nomes padrão são anexados 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 Visualizar/Editar em um componente do cronograma (consulte Menu Ações do Componente em Guia Componentes do painel do projeto).

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

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

Nota

As edições de agendamento entram em vigor em todas as operações às quais estão atribuídas.

Configurar Cronogramas de Operação

Na aba Programações das configurações de operação, as programações existentes que foram criadas no Cloud Studio ou no Management Console podem ser aplicadas às operações. A partir daqui você também pode criar novos agendamentos, editar agendamentos existentes e dissociar agendamentos de operações. Cada opção é descrita abaixo.

configurações de horários

  • Condição: O primeiro menu já deverá mostrar a seleção como On Schedule, indicando que a condição na qual a operação será acionada é um agendamento. Não há outras condições que possam ser definidas neste momento.

  • Programação: Utilize este menu para selecionar a programação 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 a programação selecionada à operação. Observe que somente 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 Agendar, 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 agendamento aparece na operação na quadro de design, que quando clicado reabre a tela de cronogramas de operação.

    Dica

    Ao aplicar uma programação a uma operação, é uma prática recomendada definir uma ação de operação On Fail para acionar uma notificação email sobre a operação agendada.

    horários atribuídos

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

    • Sempre executar: Selecione para executar a operação dentro do cronograma caso uma execução anterior da operação ainda esteja em execução. Esta opção deve ser selecionada somente se você tiver um requisito especial para fazê-lo. Ao usar esta opção, certifique-se de que ter operações simultâneas não será prejudicial ao processar potencialmente 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).

  • Agenda atribuída: Quando uma operação tem uma agenda atribuída, um resumo da agenda 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 de agendamento e fazer as alterações necessárias. Os 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 ícone do menu de ações e no menu selecione Visualizar/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 está atribuída.

    • Remover: Para dissociar o agendamento da operação, clique no ícone remover . Observe que o agendamento em si não é excluído, mas simplesmente não é atribuído à operação.

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

    Nota

    A programação não é criada até que você tenha configurado e salvo a nova programação. Após a criação da programação, você precisará selecioná-la no menu Agenda disponível e clicar em Atribuir para aplicá-la à operação.

    caixa de diálogo de agendamento

    • 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 contato"). O nome não deve começar ou terminar com espaço.

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

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

        • Todos [#] Dia(s): Insira um número de dias entre as execuções da operação.
      • Semanalmente: A programação 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 semanas 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 a operação a ser executada. Pelo menos um dia deve ser selecionado.
      • Mensalmente: O agendamento ativará a operação mensalmente. Quando esta opção for selecionada, escolha uma das duas opções que ficam disponíveis para configuração:

        • Dia [#] de cada [#] mês(es): Insira o dia do mês e o número do(s) mês(es) entre eles operação é executada.
        • O [1º, 2º, 3º, 4º ou último] [Dia da semana] de cada [#] mês: Use o menus para selecionar qual dia do mês e inserir o(s) número(s) de mês(es) entre as execuções da operação.
    • Frequência: Selecione uma das duas opções de horários em que a programação deve iniciar a operação nos dias em que ela for executada:

      • Ocorre uma vez às [hh:mm:ss] [AM/PM]: A programação ativará a operação apenas uma vez no horário especificado. Especifique a hora usando o controle deslizante superior para ajustar a hora ou o controle deslizante inferior para ajustar os minutos.

      • Ocorre a cada [#] [Minuto(s)/Hora(s)] Começando em [hh:mm:ss] [AM/PM] e Terminando às [hh:mm:ss] [AM/PM]: A programação reativará repetidamente a operação durante o período de tempo especificado ao longo do dia. Especifique os horários do dia em que deseja limitar a execução da operação usando o controle deslizante superior para ajustar a hora ou o controle deslizante inferior para ajustar os minutos.

        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 de uma programação são inclusivas.

      • Data de início: Por padrão, a programação estará ativa a partir da data atual. Se desejar que a programação 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) nas quais o agendamento é atribuído serão executadas indefinidamente de acordo com o agendamento. Se você quiser especificar uma data de término, primeiro clique 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 a programação termine.
      • Remover data de término: Este link aparece quando o campo Data de término é adicionado. Para remover o campo Data de término, clique no link para Remover data de término.
    • Salvar: Clique para salvar e fechar a configuração do 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 no qual a operação será executada depende do agente que a operação, a menos que a configuração Substituir fuso horário do Agente 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 do Agente Privado são determinados pelo fuso horário do sistema operacional do Agente Privado. É altamente recomendado 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.

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

    • Quando uma programação diária é 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 instância da 1h do primeiro domingo de novembro.

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

    Dica

    Para consistência do cronograma, é recomendado usar um fuso horário que não observe o horário de verão, como o UTC (os Agentes em Nuvem usam o UTC por padrão). Se estiver usando um Agente Privado, você pode usar a configuração Substituir fuso horário do Agente agendado e selecionar Etc/UTC.

  • Substituir fuso horário do Agente agendado

    • 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 no qual todas as programações atuais e futuras de uma organização serão executadas.

Menu Agendar Ações

Depois que um cronograma é criado, as ações de menu desse cronograma ficam acessíveis na aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).

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

Item do menu
Descrição
visualizar edição Visualizar/Editar abre a tela de configuração de cronograma (consulte Configurar cronogramas de operação anteriormente nesta página).

Nota

As edições de agendamento entram em vigor em todas as operações às quais estão atribuídas.

corte Cut coloca uma cópia do cronograma na área de transferência e exclui o cronograma original do projeto (consulte Reutilização de componentes).
cópia de Copiar coloca uma cópia da programação na área de transferência (consulte Reutilização de componentes).
duplicado Duplicado cria um agendamento novo e sem referência usando a mesma configuração do componente original (consulte Reutilização de componente).
renomear Renomear posiciona o cursor no nome do agendamento para você fazer as edições necessárias.
ver dependências Visualizar dependências altera a visualizaçã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 Adicionar ao grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou para adicionar a programação a um grupo existente (consulte Grupos de componentes).
excluir Excluir exclui permanentemente o agendamento (consulte Dependências, exclusão e remoção de componentes).
remover 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 cronogramas de operação não atenderem às suas necessidades, você poderá criar programações mais complexas usando scripts.

Nota

Se você tiver a configuração Substituir fuso horário do Agente ativada nas políticas da sua organização, quaisquer scripts que usem 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. Estas etapas percorrem este caso de uso:

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

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

    <trans>
    if(DayOfMonth(LastDayOfMonth(Now()))==DayOfMonth(Now()),
    RunOperation("<TAG>operation:Scheduled Operation</TAG>");
    );
    </trans>
    
  3. Crie um agendamento que seja executado todos os dias no horário desejado e aplique-o à 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:

    programação da cadeia de operação

Habilitar Ou Desabilitar Agendamentos

Quando você cria e aplica um agendamento a uma operação, ele é habilitado por padrão. Usando o Management Console, você pode optar por desativar ou reativar um agendamento (se desativado) remotamente em Projetos página.

Em Projetos, isso pode ser feito na aba Operações ou Programações usando o botão de alternância na coluna Status da operação para ativar ou desativar um agendamento em uma única operação ou usando o botão de alternância a coluna Status do agendamento para ativar ou desativar um agendamento em todas as operações que têm o agendamento 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).

Nota

Na interface do Cloud Studio, não há indicação de quais agendamentos estão habilitados ou desabilitados, e não é possível no Cloud Studio desabilitar um agendamento ou reativar um agendamento que foi desabilitado. Portanto, é importante lembrar se você desabilita um agendamento, pois a única maneira de saber se ele está desabilitado ou reativá-lo é através do Management Console.

Solucionar Problemas de Agendamentos

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

  • Você implantou a operação à qual o cronograma está atribuído?
    No Cloud Studio, as programações devem ser atribuídas a uma operação e, em seguida, implantadas para serem acionadas. Depois de atribuir uma programação a uma operação no Cloud Studio, ela não entrará em vigor até que seja implantada. (Em contraste, os cronogramas 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 podem ser desativados e reativados somente no Management Console. Verifique os Projetos nas guias Operações e Agendamentos para garantir que o 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á 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 em Processos.

  • 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ção.

    Os Agentes Privados têm como padrão a capacidade de executar até duas vezes a contagem 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 depender mais do tempo do que outras. Se várias operações não críticas acumulassem na fila do agente, então operações mais críticas poderiam 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 em relação à prioridade de negócios e à duração do tempo de execução das operações agendadas.