Partilhar via

Configurar ações de switch para executar diferentes caminhos de ação com base em valores específicos em fluxos de trabalho do Azure Logic Apps.

Aplica-se a: Azure Logic Apps (Consumo e Standard)

Para executar caminhos de ação diferentes com base nos valores de objetos, expressões ou tokens, adicione uma ação de alternância ao seu fluxo de trabalho. Essa ação avalia o objeto, a expressão ou o token, escolhe o caso que corresponde ao resultado e executa o caminho da ação que você define para esse caso. Quando a ação de switch é executada, apenas um caso deve corresponder ao resultado.

Por exemplo, suponha que você queira um fluxo de trabalho que execute diferentes caminhos de ação com base em uma opção selecionada no email. Neste exemplo, o fluxo de trabalho usa um gatilho RSS para verificar se há novo conteúdo no feed RSS de um site. Quando um novo item aparece no feed RSS, o fluxo de trabalho envia um e-mail para um aprovador. Com base na seleção de Aprovar ou Rejeitar, o fluxo de trabalho executa ações diferentes.

Gorjeta

As ações de comutação suportam apenas operadores de igualdade. Se você precisar de outros operadores relacionais, como maior que, use uma ação de condição. Para garantir um comportamento determinístico, os casos devem conter um valor exclusivo e estático em vez de tokens ou expressões dinâmicas.

Pré-requisitos

  • Uma conta Azure e uma assinatura. Se não tiver uma subscrição, inscreva-se numa conta do Azure gratuita.

  • Para seguir o exemplo neste artigo, crie o exemplo de fluxo de trabalho do aplicativo lógico de consumo com uma conta Outlook.com ou uma conta corporativa ou de estudante.

    1. Ao adicionar a ação para enviar e-mail, localize e selecione esta ação: Enviar e-mail de aprovação.

    2. Forneça as seguintes informações:

      Parâmetro Obrigatório Valor Description
      Para Yes < endereço de email do aprovador> O endereço de e-mail da pessoa que toma a decisão de aprovação. Para testar o exemplo, use seu próprio endereço de e-mail para testar.
      Assunto Não < assunto do e-mail> O assunto da solicitação de aprovação por e-mail.
      Opções do Utilizador Não Aprovar, Rejeitar Embora opcional, deixe os valores padrão para este exemplo.

      A captura de tela mostra a ação Enviar e-mail de aprovação com parâmetros onde você pode inserir um endereço e valores de Opções do Usuário.

Adicionar uma ação de comutação

Para alterar o caminho de execução do fluxo de trabalho com base nas opções selecionadas no e-mail de aprovação, adicione uma ação de alternância no final do fluxo de trabalho de exemplo.

  1. No designer, siga estas etapas gerais para adicionar a ação Controle chamada Alternar ao seu fluxo de trabalho.

    A ação Alternar aparece com um caso padrão vazio. Uma ação Switch requer pelo menos um caso mais o caso padrão. Você adicionará mais casos mais tarde.

    A captura de tela mostra uma ação Switch com um Caso padrão vazio.

  2. Se a ação Alternar não estiver selecionada para que o painel de informações esteja aberto, selecione a barra de título Alternar .

  3. Na guia Parâmetros , selecione dentro da caixa Ativado e, em seguida, selecione o ícone de relâmpago para abrir a lista de conteúdo dinâmico. Nessa lista, em Enviar e-mail de aprovação, selecione o campo SelectedOption .

    O campo SelectedOption armazena o valor selecionado pelo aprovador e determina o caso com as ações a serem executadas.

    A captura de tela mostra a lista de conteúdo dinâmico com o valor SelectedOption realçado.

  4. Para lidar com os casos em que o aprovador seleciona Aprovar ou Rejeitar, adicione um caso para cada opção. Ao lado de Caso padrão , selecione o sinal de adição (+) e, em seguida, selecione Adicionar um caso.

    A captura de tela mostra a ação Switch com dois casos adicionados e o caso padrão.

  5. Adicione estas ações aos casos correspondentes:

    Caixa # OpçãoSelecionada Ação
    Incidente Aprovar Adicionar o Outlook Enviar uma ação de email para enviar detalhes sobre o item RSS somente quando o aprovador selecionou Aprovar.
    Caso 2 Rejeitar Adicionar o Outlook Enviar uma ação de email para notificar outros aprovadores de que o item RSS foi rejeitado.
    Predefinição Nenhuma Nenhuma ação necessária. Neste exemplo, o caso Default está vazio porque SelectedOption tem apenas duas opções.

    A captura de tela mostra a ação Alternar com dois casos e o caso padrão. Cada caso adicionado contém uma ação Enviar um e-mail para executar.

  6. Salve seu fluxo de trabalho.

  7. Para testar este exemplo, na barra de ferramentas do designer, selecione Executar>execução até que o gatilho detete um novo item RSS e envie um e-mail de aprovação. Selecione Aprovar para observar os resultados.

Definição JSON

Agora que você criou um fluxo de trabalho com a ação Alternar , revise a definição de código JSON (JavaScript Object Notation) por trás dessa ação.

"Switch": {
   "type": "Switch",
   "expression": "@body('Send_approval_email')?['SelectedOption']",
   "cases": {
      "Case": {
         "actions": {
           "Send_an_email": {}
         },
         "case" : "Approve"
      },
      "Case_2": {
         "actions": {
           "Send_an_email_2": {}
         },
         "case": "Reject"
      }
   },
   "default": {
      "actions": {}
   },
   "runAfter": {
      "Send_approval_email": [
         "Succeeded"
      ]
   }
}
Label Description
"Switch" O nome padrão da Switch ação, que você pode renomear para descrever melhor a finalidade da ação.
"type": "Switch" Especifica o tipo de ação, que é uma Switch ação.
"expression" Neste exemplo, especifica a opção selecionada pelo aprovador que a ação Switch avalia em cada caso, conforme declarado posteriormente na definição.
"cases" Define qualquer número de casos. Para cada caso, "Case_*" é o nome padrão para esse caso, que você pode renomear para descrever melhor a finalidade do caso.
"case" Especifica o valor do caso, que deve ser um valor constante e exclusivo que a Switch ação usa para comparação. Se nenhum caso corresponder ao resultado da expressão de comutação, as "default" ações na seção serão executadas.

Conteúdo relacionado

  • Last updated on