Tutorial: Criar fluxos de trabalho automatizados baseados em aprovação usando os Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo)

Este tutorial mostra como criar um fluxo de trabalho de aplicativo lógico de exemplo que automatiza um fluxo de trabalho baseado em aprovação. Especificamente, este fluxo de trabalho de aplicativo de exemplo processa as solicitações de assinatura para uma lista de distribuição gerenciada pelo serviço MailChimp. Esse fluxo de trabalho inclui várias etapas, que começam monitorando uma conta de email para solicitações, enviam essas solicitações para aprovação, verificam se a solicitação é ou não aprovada, adicionam membros aprovados à lista de distribuição e confirmam se novos membros são adicionados ou não à lista.

Neste tutorial, você aprenderá como:

Quando terminar, o fluxo de trabalho ficará parecido com esta versão em alto nível:

Pré-requisitos

• Uma conta e uma assinatura do Azure. Se você não tem uma assinatura, inscreva-se em uma conta gratuita do Azure.

• Uma conta do MailChimp em que você anteriormente criou uma lista chamada "test-members-ML", à qual o aplicativo lógico pode adicionar endereços de email para membros aprovados. Se você não tiver uma conta, inscreva-se em uma conta gratuita e, em seguida, saiba como criar uma lista do MailChimp.

• Uma conta de email de qualquer provedor de email compatível com os Aplicativos Lógicos do Azure, como o Outlook do Office 365, o Outlook.com ou o Gmail. Para outros provedores, revise a lista de conectores aqui. Este início rápido usa o Outlook do Office 365 com uma conta corporativa ou de estudante. Se você usar uma conta de email diferente, as etapas gerais serão as mesmas, mas a interface do usuário será ligeiramente diferente.

• Uma conta de email no Office 365 Outlook ou no Outlook.com, que dê suporte aos fluxos de trabalho de aprovação. Este tutorial usa o Office 365 Outlook. Se você usar uma conta de email diferente, as etapas gerais serão as mesmas, mas a interface do usuário poderá parecer um pouco diferente.

• Se o fluxo de trabalho do aplicativo lógico precisar se comunicar por um firewall que limita o tráfego a endereços IP específicos, esse firewall precisará permitir o acesso tanto para os endereços IP de entrada quanto para os de saída usados pelos Aplicativos Lógicos do Azure na região do Azure em que o recurso do aplicativo lógico existe. Se o aplicativo lógico também usar conectores gerenciados, como o conector Outlook do Office 365 ou do SQL, ou usar conectores personalizados, o firewall também precisará permitir o acesso para todos os endereços IP de saída do conector gerenciado na região do Azure do aplicativo lógico.

Criar seu recurso de aplicativo lógico

1. Entre no portal do Azure com suas credenciais da conta do Azure. Na página inicial do Azure, selecione Criar um recurso.

2. No menu do Azure Marketplace, selecione Integração>Aplicativo Lógico.

   

3. No painel Aplicativo Lógico, forneça as informações descritas aqui sobre o recurso do aplicativo lógico que você deseja criar.

   

   Propriedade	Valor	Descrição
   Assinatura	<Azure-subscription-name>	Seu nome da assinatura do Azure. Este exemplo usa o Pay-As-You-Go.
   Grupo de recursos	LA-MailingList-RG	O nome do grupo de recursos do Azure, usado para organizar os recursos relacionados. Esse exemplo cria um grupo de recursos chamado LA-MailingList-RG.
   Nome	LA-MailingList	O nome do seu aplicativo lógico, que pode conter apenas letras, números, hifens (-), sublinhados (_), parênteses ((, )) e pontos (.). Este exemplo usa o LA-MailingList.
   Localidade	Oeste dos EUA	A região em que as informações de seu aplicativo lógico serão armazenadas. Este exemplo usa o West US.
   Tipo de plano	Consumo
   Log Analytics	Desativado	Mantenha a configuração Desligado para o log de diagnósticos.

4. Quando terminar, selecione Review + create. Depois que o Azure validar as informações sobre seu aplicativo lógico, selecione Criar.

5. Após o Azure implantar o aplicativo, selecione Ir para o recurso.

   O Azure abre o painel de seleção de modelo, que mostra um vídeo de introdução, gatilhos comumente usados e padrões de modelo de aplicativo lógico.

6. Role para baixo após o vídeo e as seções de gatilhos comuns até a seção Modelos e selecione Aplicativo Lógico em Branco.

   

Em seguida, adicione um gatilho do Outlook que escuta emails de entrada com solicitações de assinatura. Cada aplicativo lógico precisa começar com um gatilho, disparado quando um evento específico ocorre ou quando novos dados atendem a uma condição específica. Para obter mais informações, consulte Início Rápido: Criar um exemplo de fluxo de trabalho de aplicativo lógico de Consumo nos Aplicativos Lógicos do Azure multilocatário.

Adiciona gatilho para monitorar emails

1. Na caixa de pesquisa do fluxo de trabalho, insira when email arrives e selecione o gatilho chamado Quando um novo email for recebido.

   • Para as contas corporativas ou de estudante do Azure, selecione o Outlook do Office 365.
   • Para contas pessoais da Microsoft, selecione Outlook.com.

   Este exemplo continua selecionando o Outlook do Office 365.

   

2. Se você ainda não tiver uma conexão, entre e autentique o acesso à sua conta de email quando solicitado.

   Os Aplicativos Lógicos do Azure criam uma conexão à sua conta de email.

3. No gatilho, forneça os critérios para verificar novos emails.

   1. Especifique a pasta para verificar emails e mantenha as outras propriedades definidas para os próprios valores padrão.

      

   2. Adicione a propriedade Filtro de Assunto do gatilho para que você possa filtrar emails com base na linha do assunto. Abra a lista Adicionar novo parâmetro e selecione Filtro de Assunto.

      

      Para obter mais informações sobre as propriedades desse gatilho, confira a referência do conector do Office 365 Outlook ou a referência do conector do Outlook.com.

   3. Depois que a propriedade for exibida no gatilho, insira este texto: subscribe-test-members-ML

      

4. Por enquanto, para ocultar os detalhes do gatilho, recolha a forma clicando na barra de título dela.

   

5. Salve o fluxo de trabalho do aplicativo lógico. Selecione Salvar na barra de ferramentas do designer.

Seu aplicativo lógico agora está ativo, mas ele não faz nada além de verificar o recebimento de emails. Portanto, adicione uma ação que responde quando o gatilho é acionado.

Enviar email de aprovação

Agora que você tem um gatilho, adicione uma ação que envia um email para aprovar ou rejeitar a solicitação.

1. No fluxo de trabalho, no gatilho Quando um novo email for recebido, selecione Nova etapa.

2. Na caixa de pesquisa Escolha uma operação, insira send approval e selecione a ação nomeada Enviar email de aprovação.

   

3. Agora, insira os valores para as propriedades especificadas mostradas e descritas aqui. deixando todos os outros com os valores padrão. Para obter mais informações sobre essas propriedades, confira a referência do conector do Office 365 Outlook ou a referência do conector do Outlook.com.

   

   Propriedade	Valor	Descrição
   Para	<approval-email-address>	Endereço de email do aprovador. Para fins de teste, você pode usar seu próprio endereço. Este exemplo usa o endereço de email fictício sophiaowen@fabrikam.com.
   Assunto	Approve member request for test-members-ML	Um assunto de email descritivo
   Opções de Usuário	Approve, Reject	Verifique se essa propriedade especifica as opções de resposta que o aprovador pode selecionar, que são Aprovar ou Rejeitar por padrão.

   Observação

   Quando você clica dentro de algumas caixas de edição, a lista de conteúdo dinâmico é exibida, que você pode ignorar por enquanto. O conteúdo dinâmico mostra as saídas de ações anteriores que estão disponíveis para você selecionar como entradas de ações subsequentes no fluxo de trabalho.

4. Salve o fluxo de trabalho do aplicativo lógico.

Em seguida, adicione uma condição que verifica a resposta selecionada do aprovador.

Verificar resposta de aprovação

1. Na ação Enviar email de aprovação, selecione Nova etapa.

2. Em Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira condition e selecione a ação nomeada Condição.

   

3. Na barra de título Condição, selecione o botão de reticências ( ... ) e selecione Renomear. Renomeie a condição com esta descrição:If request approved

   

4. Crie uma condição que verifica se o aprovador selecionou Aprovar.

   1. No lado esquerdo da condição, clique dentro da caixa Escolha um valor.

   2. Na lista de conteúdo dinâmico exibida, em Enviar email de aprovação, selecione a propriedade SelectedOption.

      

   3. Na caixa de comparação intermediária, selecione o operador é igual a.

   4. Na caixa Escolha um valor à direita da condição, insira o texto Approve.

      Quando terminar, a condição será semelhante a este exemplo:

      

5. Salve o fluxo de trabalho do aplicativo lógico.

Em seguida, especifique a ação que seu aplicativo lógico executará quando o revisor aprovar a solicitação.

Adicionar membros à lista do MailChimp

Agora adicione uma ação que adiciona o membro aprovado à sua lista de endereçamento.

1. No branch Verdadeiro da condição, selecione Adicionar uma ação.

2. Na caixa de pesquisa Escolha uma operação, selecione Tudo. Na caixa de pesquisa, insira mailchimp e selecione a ação chamada Adicionar membro à lista.

   

3. Se você ainda não tiver uma conexão com sua conta do MailChimp, você deverá se conectar.

4. Na ação Adicionar membro à lista, forneça as informações conforme mostrado e descrito aqui:

   

   Propriedade	Obrigatório	Valor	Descrição
   ID da lista	Sim	<mailing-list-name>	Selecione o nome da sua lista de distribuição do MailChimp. Este exemplo usa o test-members-ML.
   Endereço de Email	Sim	<new-member-email-address>	Na lista de conteúdo dinâmico aberta, na seção Quando um novo email for recebido, selecione De, que é a saída do gatilho e especifique o endereço de email do novo membro.
   Status	Sim	<member-subscription-status>	Selecione o status da assinatura para definir o novo membro. Esse exemplo seleciona subscribed. Para saber mais, confira Gerenciar assinantes com a API do MailChimp.

   Para obter mais informações sobre as propriedades da ação Adicionar membro à lista, confira a referência do conector do MailChimp.

5. Salve o fluxo de trabalho do aplicativo lógico.

Em seguida, adicione uma condição para que você possa verificar se o novo membro ingressou na lista de endereçamento com êxito. Dessa forma, seu aplicativo lógico pode notificar se essa operação foi bem-sucedida ou apresentou falha.

Verificar êxito ou falha

1. No branch Verdadeiro, na ação Adicionar membro à lista, selecione Adicionar uma ação.

2. Em Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira condition e selecione a ação nomeada Condição.

3. Renomeie a condição com esta descrição:If add member succeeded

4. Crie uma condição que verifica se o membro aprovado teve êxito ou falha ao ingressar na lista de endereçamento:

   1. No lado esquerdo da condição, clique dentro da caixa Escolha um valor. Na lista conteúdo dinâmico exibida, na seção Adicionar membro à lista, selecione a propriedade Status.

      Por exemplo, sua condição é semelhante a este exemplo:

      

   2. Na caixa de comparação intermediária, selecione o operador é igual a.

   3. Na caixa Escolher um valor à direita da condição, insira este texto: subscribed

      Quando terminar, a condição será semelhante a este exemplo:

      

Em seguida, configure os emails para envio quando o membro aprovado tem êxito ou falha ao ingressar na lista de distribuição.

Enviar email se o membro foi adicionado

1. Na condição Se adicionar membro com êxito, no branch Verdadeiro, selecione Adicionar uma ação.

   

2. Na caixa de pesquisa Escolha uma operação, insira outlook send email e selecione a ação nomeada Enviar um email.

   

3. Renomeie a ação com esta descrição:Send email on success

4. Na ação Enviar email em caso de êxito, forneça as informações conforme mostrado e descrito aqui:

   

   Propriedade	Obrigatório	Valor	Descrição
   Corpo	Sim	<success-email-body>	O conteúdo do corpo do email de êxito. Neste tutorial, siga estas etapas: 1. Insira este texto com um espaço à direita: New member has joined "test-members-ML": 2. Na lista de conteúdo dinâmico exibida, selecione a propriedade Endereço de Email. Observação: Se essa propriedade não for exibida, ao lado da seção Adicionar membro à lista, selecione Ver mais. 3. Na próxima linha, insira este texto com um espaço à direita: Member opt-in status: 4. Na lista conteúdo dinâmico, em Adicionar membro à lista, selecione a propriedade Status.
   Assunto	Sim	<success-email-subject>	O assunto do email de êxito. Neste tutorial, siga estas etapas: 1. Insira este texto com um espaço à direita: Success! Member added to "test-members-ML": 2. Na lista conteúdo dinâmico, em Adicionar membro à lista, selecione a propriedade Endereço de Email.
   Para	Sim	<your-email-address>	O endereço de email para onde enviar o email de êxito. Para fins de teste, você pode usar seu próprio endereço de email.

5. Salve o fluxo de trabalho do aplicativo lógico.

Enviar email se membro não foi adicionado

1. Na condição Se adicionar membro com êxito, no branch Falso, selecione Adicionar uma ação.

   

2. Na caixa de pesquisa Escolha uma operação, insira outlook send email e selecione a ação nomeada Enviar um email.

   

3. Renomeie a ação com esta descrição:Send email on failure

4. Forneça informações sobre essa ação, conforme mostrado e descrito aqui:

   

   Propriedade	Obrigatório	Valor	Descrição
   Corpo	Sim	<body-for-failure-email>	O conteúdo do corpo do email de falha. Para este tutorial, digite este texto: Member might already exist. Check your MailChimp account.
   Assunto	Sim	<subject-for-failure-email>	O assunto do email de falha. Neste tutorial, siga estas etapas: 1. Insira este texto com um espaço à direita: Failed, member not added to "test-members-ML": 2. Na lista conteúdo dinâmico, em Adicionar membro à lista, selecione a propriedade Endereço de Email.
   Para	Sim	<your-email-address>	O endereço de email para onde enviar o email de falha. Para fins de teste, você pode usar seu próprio endereço de email.

5. Salve o fluxo de trabalho do aplicativo lógico.

Em seguida, teste o fluxo de trabalho, que agora se parece com este exemplo:

Execute o fluxo de trabalho do seu aplicativo lógico

1. Envie uma solicitação de email a si mesmo para ingressar na lista de endereçamento. Aguarde até que a solicitação seja exibida na caixa de entrada.

2. Para iniciar manualmente o fluxo de trabalho, na barra de ferramentas do designer, selecione Executar Gatilho>Executar.

   Se seu email tiver uma entidade que corresponde ao filtro de assunto do disparador, o fluxo de trabalho envia um email para aprovar a solicitação de assinatura.

3. No email de aprovação que você receber, selecione Aprovar.

4. Se o endereço de email do assinante não existe na sua lista de endereçamento, o fluxo de trabalho adiciona o endereço de email dessa pessoa e envia um email como neste exemplo:

   

   Se seu fluxo de trabalho não consegue adicionar o assinante, você recebe um email como neste exemplo:

   

Parabéns, você criou e executou um fluxo de trabalho de aplicativo lógico que integra informações entre serviços Azure, Microsoft e outros aplicativos SaaS.

Limpar os recursos

O aplicativo lógico continuará sendo executado até que você desabilite ou exclua o recurso do aplicativo lógico. Quando você não precisar mais do aplicativo lógico de exemplo, exclua o grupo de recursos que contém o aplicativo lógico e os recursos relacionados.

1. Na caixa de pesquisa do portal do Azure, digite o nome do grupo de recursos que você criou. Nos resultados, em Grupos de Recursos, selecione o grupo de recursos.

   Este exemplo cria o grupo de recursos chamado LA-MailingList-RG.

   

   Dica

   Se a página inicial do Azure mostrar o grupo de recursos em Recursos recentes, você poderá selecionar o grupo na página inicial.

2. No menu do grupo de recursos, verifique se a Visão Geral está selecionada. Na barra de ferramentas do painel Visão Geral, selecione Excluir grupo de recursos.

   

3. No painel de confirmação exibido, insira o nome do grupo de recursos e selecione Excluir.

Próximas etapas

Neste tutorial, você criou um fluxo de trabalho de aplicativo lógico que manipula as aprovações para solicitações de lista de distribuição. Agora, aprenda a criar um fluxo de trabalho de aplicativo lógico que processa e armazena anexos de email integrando serviços do Azure, como o Armazenamento do Azure e o Azure Functions.