Programar gatilho

O gatilho do acionador permite executar a integração periodicamente em intervalos de tempo específicos. Esse acionador é útil quando você quer executar a integração automaticamente, sem qualquer intervenção manual. Por exemplo, considere o uso do gatilho do acionador para os tipo de tarefas a seguir:

  • Fazer upload de arquivos de um sistema para outro em intervalos regulares
  • Como enviar lembretes periódicos por e-mail
  • Sincronização do banco de dados em intervalos regulares

Antes de começar

Atribua o papel de IAM Invocador de integração da Apigee ao agente de serviço da Apigee ( service-PROJECT_ID @gcp-sa-apigee.iam.gserviceaccount.com ) no seu projeto do Google Cloud.

Para mais informações sobre como atribuir papéis do IAM, consulte Como gerenciar o acesso no Google Cloud.

Adicionar um gatilho de programação

Para adicionar um acionador de programação a uma integração nova ou atual, siga as etapas a seguir:
  1. Na IU da Apigee, selecione sua organização da Apigee.
  2. Clique em Desenvolver > Integrações.
  3. Selecione uma integração existente ou clique em Criar integração.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Digite um nome e uma descrição na caixa de diálogo Criar integração.
    2. Selecione uma Região para a integração na lista de regiões compatíveis.
    3. Clique em Criar.

    Isso abre a integração na página do designer de integração.

  4. Na barra de navegação do designer de integração, clique em +Adicionar uma tarefa/gatilho > Gatilhos para ver a lista de gatilhos disponíveis.
  5. Clique e arraste o elemento Gatilho da programação para o designer.

Configurar um gatilho de programação

Clique no elemento gatilho de programação no editor de integração para visualizar o painel de configuração de gatilho.

Configure o gatilho de programação usando um dos seguintes modos:

  • Básico: fornece uma interface do usuário para configurar a frequência da execução.
  • Avançado: usa uma expressão cron para configurar a frequência da execução.

No modo Básico, é possível optar por executar a integração em um momento específico ou em intervalos por tempo. Se você quiser executar a integração em um momento específico, selecione Executar em um horário específico na lista suspensa Horários e defina as propriedades a seguir:

  • Horário: o horário (no formato de 24 horas) em que a integração precisa ser executada.
  • Dias: os dias em que a integração deve ser executada. É possível executar a integração todos os dias, em dias específicos da semana, em um dia específico do mês etc.
  • Meses: os meses em que a integração será executada. É possível executar a integração todo mês ou escolher meses específicos.

No modo Avançado, é possível especificar a frequência da execução usando uma expressão cron. A expressão cron tem cinco valores que precisam ser especificados na seguinte ordem:

  • Minuto (0-59)
  • Hora (0-23)
  • Dia do mês (1-31)
  • Mês, com um dos seguintes valores:
    • Um número de 1-a 12
    • Uma abreviação de mês de três letras (por exemplo, jan, fev, mar etc.)
  • Dia da semana, qualquer um dos seguintes valores:
    • Um número de 0 a 6, com domingo como 0
    • Uma abreviação de três letras de um dia (por exemplo, segunda, terça, quarta-feira etc.)

Por exemplo, para executar a integração no primeiro dia de cada mês, use a expressão cron * * 1 * *.

Práticas recomendadas

Como prática recomendada, desative os gatilhos de programação quando eles não forem mais necessários. Se você deixar um gatilho de programação redundante ativo, ele continuará a acionar a integração automaticamente.

Para desativar um gatilho de programação, siga um destes procedimentos:

  • Cancele a publicação da integração que contém o gatilho de programação. A integração não estará mais ativa, e o gatilho não será executado.
  • Substitua o gatilho de programação por outro e publique a integração novamente. A versão ativa da integração republicada não usará o gatilho de programação.
  • Excluir a versão atual da integração. Você pode encontrar a opção Excluir na lista de versões, ao lado do nome da integração.