Guia de início rápido: criar um exemplo de fluxo de trabalho do aplicativo lógico de consumo usando o portal do Azure

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

Este guia de início rápido mostra como criar um fluxo de trabalho de exemplo que é executado em Aplicativos Lógicos do Azure multilocatários e executa tarefas com vários serviços de nuvem. O fluxo de trabalho verifica um feed RSS para novos artigos, com base em uma programação específica, e envia um e-mail para cada novo item RSS. Especificamente, você cria um recurso e fluxo de trabalho do aplicativo lógico de consumo que usa os seguintes itens:

• O conector RSS , que fornece um gatilho para verificar um feed RSS.
• O conector do Office 365 Outlook , que fornece uma ação para enviar email.

Quando terminar, o fluxo de trabalho terá a seguinte aparência do seguinte exemplo de alto nível:

As operações neste exemplo são de dois conectores entre 1000+ conectores que você pode usar em um fluxo de trabalho. Embora este exemplo seja baseado na nuvem, os Aplicativos Lógicos do Azure dão suporte a fluxos de trabalho que conectam aplicativos, dados, serviços e sistemas em ambientes de nuvem, locais e híbridos.

Para criar e gerenciar um fluxo de trabalho do aplicativo lógico de consumo usando outras ferramentas, consulte os seguintes inícios rápidos:

• Criar e gerenciar fluxos de trabalho de aplicativos lógicos no Visual Studio Code
• Criar e gerenciar fluxos de trabalho de aplicativos lógicos no Visual Studio
• Criar e gerenciar fluxos de trabalho de aplicativos lógicos usando a CLI do Azure

Para criar um fluxo de trabalho de aplicativo lógico padrão que é executado em aplicativos lógicos do Azure de locatário único, consulte Criar um exemplo de fluxo de trabalho de aplicativo lógico padrão usando o portal do Azure.

Pré-requisitos

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

• Uma conta de email de um serviço que funciona com Aplicativos Lógicos do Azure, como o Office 365 Outlook ou Outlook.com. Para outros provedores de email com suporte, consulte Conectores para Aplicativos Lógicos do Azure.

  Este guia de início rápido usa o Office 365 Outlook com uma conta corporativa ou de estudante. Se você usar uma conta de email diferente, as etapas gerais permanecerão as mesmas, mas sua interface do usuário poderá ser ligeiramente diferente. Se utilizar Outlook.com, utilize a sua conta Microsoft pessoal para iniciar sessão.

  Nota

  Se pretender utilizar o conector do Gmail, apenas as contas do G Suite podem utilizar este conector sem restrições nas Aplicações Lógicas do Azure. Se você tiver uma conta de consumidor do Gmail, só poderá usar esse conector com serviços específicos aprovados pelo Google, a menos que crie um aplicativo cliente do Google para usar para autenticação com o conector do Gmail. Para obter mais informações, consulte Políticas de segurança e privacidade de dados para conectores do Google em Aplicativos Lógicos do Azure.

• Se tiver uma firewall que limite o tráfego a endereços IP específicos, certifique-se de que configurou a firewall para permitir o acesso aos endereços IP de entrada e de saída que as Aplicações Lógicas do Azure utilizam na região do Azure onde cria o fluxo de trabalho da aplicação lógica.

  Este exemplo usa os conectores RSS e Office 365 Outlook , que são hospedados e executados no Azure multilocatário global e gerenciados pela Microsoft. Esses conectores exigem que você configure seu firewall para permitir o acesso a todos os endereços IP de saída do conector gerenciado na região do Azure para seu recurso de aplicativo lógico.

Criar um recurso de aplicativo lógico de consumo

1. No portal do Azure, entre com sua conta do Azure.

2. Na caixa de pesquisa do portal do Azure, insira aplicativo lógico e selecione Aplicativos lógicos.

   

3. Na barra de ferramentas da página Aplicativos lógicos , selecione Adicionar.

   A página Criar Aplicativo Lógico é exibida e mostra as seguintes opções:

   Plano	Descrição
   Consumo	Cria um recurso de aplicativo lógico que dá suporte a apenas um fluxo de trabalho executado em Aplicativos Lógicos do Azure multilocatário e usa o modelo de Consumo para cobrança.
   Standard	Cria um recurso de aplicativo lógico que oferece suporte a vários fluxos de trabalho. Você tem as seguintes opções: - Plano de Serviço de Fluxo de Trabalho: os fluxos de trabalho são executados em Aplicativos Lógicos do Azure de locatário único e usam o modelo Standard para cobrança. - Ambiente do Serviço de Aplicativo V3: os fluxos de trabalho são executados em Aplicativos Lógicos do Azure de locatário único e usam um plano de Ambiente do Serviço de Aplicativo para cobrança.

4. Na página Criar Aplicativo Lógico, selecione Consumo (Multilocatário).

5. Na guia Noções básicas, forneça as seguintes informações sobre o recurso do aplicativo lógico:

   Property	Necessário	Valor	Description
   Subscrição	Sim	<Azure-subscrição-nome>	Seu nome de assinatura do Azure. Este exemplo usa Pay-As-You-Go.
   Grupo de Recursos	Sim	<Azure-recurso-grupo-nome>	O grupo de recursos do Azure onde você cria seu aplicativo lógico e recursos relacionados. Esse nome deve ser exclusivo entre regiões e pode conter apenas letras, números, hífenes (-), sublinhados (_), parênteses (()) e pontos (.). Este exemplo cria um grupo de recursos chamado Consumption-RG.
   Nome da Aplicação Lógica	Sim	<logic-app-name>	O nome do recurso do aplicativo lógico, que deve ser exclusivo entre regiões e pode conter apenas letras, números, hífenes (-), sublinhados (_), parênteses (()) e pontos (.). Este exemplo cria um recurso de aplicativo lógico chamado My-Consumption-Logic-App.
   Região	Sim	<Azure-region>	A região do datacenter do Azure para seu aplicativo lógico. Este exemplo usa West US.
   Habilite a análise de log	Sim	Não	Altere essa opção somente quando quiser habilitar o log de diagnóstico. Para este início rápido, mantenha a seleção padrão. Nota: Esta opção só está disponível com aplicações lógicas de consumo.

   Nota

   As zonas de disponibilidade são automaticamente habilitadas para fluxos de trabalho de aplicativos lógicos de consumo novos e existentes em regiões do Azure que dão suporte a zonas de disponibilidade. Para obter mais informações, consulte Confiabilidade no Azure Functions e Proteger aplicativos lógicos contra falhas de região com redundância de zona e zonas de disponibilidade.

   Depois de terminar, as configurações serão semelhantes ao exemplo a seguir:

   

6. Quando estiver pronto, selecione Rever + criar. Na página de validação exibida, confirme todas as informações fornecidas e selecione Criar.

7. Depois que o Azure implantar com êxito seu recurso de aplicativo lógico, selecione Ir para recurso. Ou localize e selecione seu recurso de aplicativo lógico usando a caixa de pesquisa do Azure.

   

Adicionar o gatilho

Um fluxo de trabalho sempre começa com um único gatilho, que especifica a condição a ser atendida antes de executar qualquer ação subsequente no fluxo de trabalho. Sempre que o gatilho é acionado, os Aplicativos Lógicos do Azure criam e executam uma instância de fluxo de trabalho. Se o gatilho não for acionado, nenhuma instância de fluxo de trabalho será criada ou executada.

Este exemplo usa um gatilho RSS que verifica um RSS feed, com base na programação especificada. Se existir um novo item no feed, o gatilho será acionado e uma nova instância de fluxo de trabalho será criada e executada. Se existirem vários novos itens entre as verificações, o gatilho será acionado para cada item e uma nova instância de fluxo de trabalho separada será executada para cada item. Por padrão, as instâncias de fluxo de trabalho criadas ao mesmo tempo também são executadas ao mesmo tempo ou simultaneamente.

1. No designer de fluxo de trabalho, siga estas etapas gerais para adicionar o gatilho RSS chamado Quando um item de feed é publicado.

2. Na caixa de gatilho, forneça as seguintes informações:

   Property	Necessário	Valor	Description
   O URL do feed RSS	Sim	<RSS-feed-URL>	O URL do feed RSS a monitorizar. Este exemplo usa o feed RSS do Wall Street Journal em https://feeds.a.dj.com/rss/RSSMarketsMain.xml. No entanto, você pode usar qualquer feed RSS que não exija autorização HTTP. Escolha um feed RSS que publique com frequência, para que possa testar facilmente o seu fluxo de trabalho.
   A propriedade escolhida será usada para determinar quais itens são novos	Não	Data de publicação	A propriedade que determina quais itens são novos.
   Intervalo	Sim	30	O número de intervalos a aguardar entre as verificações de alimentação. Este exemplo usa 30 como intervalo porque esse valor é o intervalo mínimo para o gatilho RSS.
   Frequência	Sim	Minute	A unidade de frequência a utilizar para cada intervalo. Este exemplo usa Minute como a frequência.
   Fuso Horário	Não	<Fuso horário>	O fuso horário a utilizar para verificar o feed RSS
   Hora de Início	Não	<hora de início>	A hora de início a utilizar para verificar o feed RSS

   

3. Salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

   Esta etapa publica instantaneamente seu recurso de aplicativo lógico e fluxo de trabalho ao vivo no portal do Azure. No entanto, o gatilho apenas verifica o feed RSS sem tomar quaisquer outras ações. Então, você precisa adicionar uma ação para especificar o que você deseja que aconteça quando o gatilho disparar.

Adicionar uma ação

Após um gatilho, uma ação é qualquer etapa subsequente que executa alguma operação no fluxo de trabalho. Qualquer ação pode usar as saídas das operações anteriores, que incluem o gatilho e quaisquer outras ações. Você pode escolher entre muitas ações diferentes, incluir várias ações até o limite por fluxo de trabalho e até mesmo criar caminhos de ação diferentes.

Este exemplo usa uma ação do Office 365 Outlook que envia um email sempre que o gatilho é acionado para um novo item de feed RSS. Se existirem vários novos itens entre as verificações, você receberá vários e-mails.

1. No designer de fluxo de trabalho, siga estas etapas gerais para adicionar uma ação de conector que você pode usar para enviar email, por exemplo:

   • Se você tiver uma conta corporativa ou de estudante da Microsoft, adicione a ação do conector do Office 365 Outlook chamada Enviar um email.
   • Se você tiver uma conta pessoal da Microsoft, adicione a ação do conector Outlook.com chamada Enviar um email.

   Este exemplo continua com a ação do conector do Office 365 Outlook chamada Enviar um email.

   Se você usar um serviço de email suportado diferente em seu fluxo de trabalho, a interface do usuário poderá parecer ligeiramente diferente. No entanto, os conceitos básicos para se conectar a outro serviço de e-mail permanecem os mesmos.

2. Se o serviço de e-mail selecionado solicitar que você entre e autentique sua identidade, conclua essa etapa agora.

   Muitos conectores exigem que você primeiro crie uma conexão e autentique sua identidade antes de poder continuar. Este exemplo usa a autenticação manual para se conectar ao Office 365 Outlook. No entanto, outros serviços podem suportar ou usar diferentes tipos de autenticação. Com base no seu cenário, você pode lidar com a autenticação de conexão de várias maneiras.

   Para obter mais informações, veja a seguinte documentação:

   • Parâmetros de modelo para implantação
   • Autorizar conexões OAuth
   • Autenticar o acesso com identidades gerenciadas
   • Autenticar conexões para implantação de aplicativo lógico

3. Na ação Enviar um e-mail, forneça as seguintes informações para incluir no email.

   1. Na caixa Para, introduza o endereço de e-mail do destinatário. Para este exemplo, use seu endereço de e-mail.

      Quando você seleciona dentro da caixa Para ou de outras caixas de edição, as opções para abrir a lista de conteúdo dinâmico (ícone relâmpago) ou o editor de expressões (ícone de fórmula) aparecem. A lista de conteúdo dinâmico mostra todas as saídas de operações anteriores que você pode selecionar e usar como entradas para a ação atual. O editor de expressões fornece uma maneira de usar funções e saídas para manipular a manipulação de dados. Você pode ignorar essas opções por enquanto. A próxima etapa usa a lista de conteúdo dinâmico.

   2. Na caixa Assunto, insira o assunto do e-mail.

      Para este exemplo, inclua a saída do gatilho para mostrar o título do item RSS seguindo estas etapas:

      1. Insira o seguinte texto com um espaço em branco à direita: New RSS item:

      2. Com o cursor ainda na caixa Assunto , selecione a lista de conteúdo dinâmico (ícone relâmpago).

         

      3. Na lista de conteúdo dinâmico que é aberta, em Quando um item de feed é publicado, selecione Título do feed, que é uma saída de gatilho que faz referência ao título do item RSS.

         

         Se nenhuma saída aparecer disponível em Quando um item de feed for publicado, selecione Ver mais.

         

         Depois de terminar, o assunto do e-mail se parece com o seguinte exemplo:

         

         Nota

         Se você selecionar uma saída que faça referência a uma matriz, o designer adicionará automaticamente um Para cada loop em torno da ação que faz referência à saída. Dessa forma, seu fluxo de trabalho processa a matriz executando a mesma ação em cada item da matriz.

         Para remover o loop, arraste a ação filho para fora do loop e, em seguida, exclua o loop.

   3. Na caixa Corpo, insira o conteúdo do e-mail.

      Para este exemplo, inclua cada linha de texto descritivo, seguida pelas saídas correspondentes do gatilho RSS. Para adicionar linhas em branco a uma caixa de edição, prima Shift + Enter.

      Texto descritivo	Property	Description
      Title:	Título do feed	O título do item
      Date published:	Feed publicado em	A data e hora de publicação do item
      Link:	Ligação principal do feed	O URL do item

      

4. Salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

Testar o fluxo de trabalho

Para verificar se o fluxo de trabalho é executado corretamente, você pode aguardar o disparo do gatilho com base na agenda especificada ou executar manualmente o fluxo de trabalho.

• Na barra de ferramentas do designer, no menu Executar, selecione Executar.

Se o feed RSS tiver novos itens, seu fluxo de trabalho enviará um e-mail para cada novo item. Caso contrário, o fluxo de trabalho aguardará até o próximo intervalo para verificar o feed RSS novamente.

A captura de tela a seguir mostra um exemplo de email enviado pelo fluxo de trabalho de exemplo. O e-mail inclui os detalhes de cada saída de gatilho que você selecionou, além do texto descritivo que você incluiu para cada item.

Resolução de problemas

Se você não receber e-mails do fluxo de trabalho como esperado:

• Verifique a pasta de lixo eletrônico ou spam da sua conta de e-mail, caso a mensagem tenha sido filtrada incorretamente.

• Certifique-se de que o feed RSS que está a utilizar publica itens desde a última verificação agendada ou manual.

Clean up resources (Limpar recursos)

Quando concluir este início rápido, exclua o recurso de aplicativo lógico de exemplo e quaisquer recursos relacionados excluindo o grupo de recursos que você criou para este exemplo.

1. Na caixa de pesquisa do Azure, insira grupos de recursos e selecione Grupos de recursos.

   

2. Localize e selecione o grupo de recursos do seu aplicativo lógico. No painel Visão geral, selecione Excluir grupo de recursos.

   

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

   

Próximos passos

Neste início rápido, você criou um fluxo de trabalho de aplicativo lógico de consumo no portal do Azure para verificar um feed RSS e enviar um email para cada novo item. Para saber mais sobre fluxos de trabalho agendados avançados, consulte o seguinte tutorial: