Tarefa "Aprovação"

A tarefa Approval permite configurar integrações baseadas em aprovação. Também permite controlar o fluxo de uma integração.

Use a tarefa de aprovação para enviar e-mails de solicitação de aprovação a um ou mais usuários de integração. O e-mail inclui um link para a integração em que os usuários podem aprovar ou recusar manualmente a solicitação.

Durante uma execução de integração, quando o controle acessa a tarefa de aprovação, a execução é interrompida e todas as tarefas posteriores à tarefa de aprovação são suspensas. A integração retoma a execução apenas quando um usuário aprova ou rejeita a solicitação de aprovação.

Uma tarefa de aprovação pode ser usada para as seguintes finalidades:

  • Para suspender e ramificar uma integração com base na aprovação ou rejeição do usuário.
  • Para suspender uma integração até uma duração especificada.
  • Usar como ponto de interrupção para depurar a integração.

Comparação entre tarefas de aprovação, de suspensão e de timer

As três tarefas (Aprovação, Suspensão e Cronômetro) executam uma função semelhante de pausar e retomar uma integração. No entanto, há diferenças sutis entre elas. A tabela a seguir descreve as diferenças entre as três tarefas.

Tarefa "Aprovação" Suspender tarefa Tarefa cronômetro
Não é compatível com a retomada automática de uma integração e exige intervenção manual para retomar a integração. Aceita a retomada manual e automática de uma integração. Se não houver uma intervenção manual para revogar a suspensão, a integração retomará a execução automaticamente após o término do limite de tempo de suspensão. Aceita apenas a retomada automática de uma integração. A execução da integração será retomada automaticamente após o término do limite de tempo de suspensão.
Não é possível retomar uma integração por meio de uma chamada de API. Resolva manualmente a suspensão usando a IU de integrações. Pode retomar uma integração usando a API Suspensions para integrações. Aceita apenas a retomada automática de uma integração.
Os usuários recebem uma notificação quando uma integração é pausada (suspensa). Os usuários não recebem nenhuma notificação quando uma integração é pausada (suspensa). Os usuários não recebem nenhuma notificação quando uma integração é pausada (suspensa).
Aceita uma variável de saída (booleana), que permite realizar verificações condicionais antes de retomar uma integração. No entanto, a variável de saída só pode ter o valor de true ou false. Aceita uma variável de saída (string), que permite realizar verificações condicionais antes de retomar uma integração. É possível definir qualquer valor para a variável de saída. Não é compatível com nenhuma variável de saída.

Configurar a tarefa "Aprovação"

Para configurar a tarefa Aprovação:

  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> Tarefas para conferir a lista de tarefas disponíveis.
  5. Clique e coloque o elemento de tarefa Approval no editor de integração.
  6. Clique no elemento da tarefa Aprovação no designer para ver o painel de configuração da tarefa Aprovação.
  7. Configure os campos exibidos usando as propriedades de configuração da tarefa, conforme detalhado na tabela abaixo.

    As alterações nas propriedades são salvas automaticamente.

Propriedades de configuração

A tabela a seguir descreve as propriedades de configuração da tarefa de aprovação.

Propriedade Tipo de dado Descrição
Recipients Matriz de strings Endereços de e-mail para os quais a notificação é enviada quando a tarefa é suspensa. Insira vários endereços de e-mail separados por vírgula.
Custom notification message String Mensagem personalizada a ser incluída na notificação por e-mail quando a tarefa é suspensa. O valor pode ser um literal ou uma variável. Se a mensagem personalizada estiver disponível em uma variável, clique em VAR e selecione a variável.
Reminder frequency (in hours) Inteiro Com que frequência as notificações de lembretes são exibidas.

Se a suspensão estiver em um estado não resolvido, você poderá enviar notificações por e-mail de lembrete solicitando que os usuários autorizados resolvam a suspensão.

Time until expiration (in hours) Inteiro Período da suspensão.

Se a suspensão não for resolvida no tempo, ela será rejeitada por padrão.

On expiration Booleano Medidas a serem tomadas após a suspensão expirar.

Você pode rejeitar a suspensão ou cancelar a suspensão. Por padrão, a suspensão é recusada.

isApproved (Approval) Booleano Variável de saída que tem o status da suspensão após a resolução.

A variável isApproved será definida como True se a suspensão for aprovada e definida como False se a suspensão for rejeitada.

Estratégia de solução de erros

A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.