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)

Para criar um fluxo de trabalho automatizado que integra vários serviços de nuvem, este guia de início rápido mostra como criar um fluxo de trabalho de exemplo que integra os seguintes serviços, um feed RSS para um site e uma conta de email. O fluxo de trabalho de exemplo usa o conector RSS e o conector do Outlook do Office 365. O conector RSS fornece um gatilho que você pode usar para verificar um RSS feed, com base na programação especificada. O conector do Office 365 Outlook fornece uma ação que envia um email para cada novo item RSS.

A captura de tela a seguir mostra o fluxo de trabalho de exemplo de alto nível:

Screenshot shows example workflow with RSS trigger named When a feed item is published, and with the Outlook action named Send an email.

Este exemplo cria especificamente um recurso e fluxo de trabalho do aplicativo lógico de consumo que é executado em Aplicativos Lógicos do Azure multilocatário. 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. Os conectores neste exemplo são apenas 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.

À medida que avança neste guia de início rápido, você aprenderá as seguintes etapas básicas:

  • Crie um recurso de aplicativo lógico de consumo hospedado em Aplicativos Lógicos do Azure multilocatário.
  • Selecione o modelo de fluxo de trabalho do aplicativo lógico em branco.
  • Adicione um gatilho que especifique quando executar o fluxo de trabalho.
  • Adicione uma ação que execute uma tarefa depois que o gatilho for acionado.
  • Execute seu fluxo de trabalho.

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

Pré-requisitos

Criar um recurso de aplicativo lógico de consumo

  1. Na caixa de pesquisa do portal do Azure, insira aplicativos lógicos e selecione Aplicativos lógicos.

    Screenshot shows Azure portal search box with the words, logic apps, and shows the selection, Logic apps.

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

  3. Na página Criar Aplicativo Lógico, selecione primeiro o Tipo de plano para o recurso do aplicativo lógico. Dessa forma, apenas as opções para esse tipo de plano aparecem.

    1. Na seção Plano, para Tipo de plano, selecione Consumo para exibir apenas as configurações de recursos do aplicativo lógico de consumo.

      O tipo Plano não especifica apenas o tipo de recurso do aplicativo lógico, mas também o modelo de cobrança.

      Tipo de plano Description
      Standard Este recurso de aplicativo lógico é a seleção padrão e suporta vários fluxos de trabalho. Esses fluxos de trabalho são executados em Aplicativos Lógicos do Azure de locatário único e usam o modelo de cobrança Padrão.
      Consumo Esse tipo de recurso de aplicativo lógico é a seleção alternativa e suporta apenas um único fluxo de trabalho. Esse fluxo de trabalho é executado em Aplicativos Lógicos do Azure multilocatários e usa o modelo de cobrança de Consumo.
  4. Forneça as seguintes informações para o recurso do aplicativo lógico:

    Propriedade Necessário Valor Description
    Subscrição Sim <Azure-subscrição-nome> Seu nome de assinatura do Azure.
    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-resource-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 armazenar as informações do seu aplicativo. Este exemplo implanta o aplicativo lógico de exemplo na região Oeste dos EUA no Azure.
    Habilite a análise de log Sim Não Essa opção aparece e se aplica somente quando você seleciona o tipo de aplicativo Lógica de consumo .

    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

    Se você selecionou uma região do Azure que dá suporte à redundância da zona de disponibilidade, a seção Redundância de zona será habilitada automaticamente. Esta seção de visualização oferece a opção de habilitar a redundância da zona de disponibilidade para seu aplicativo lógico. No entanto, as regiões do Azure atualmente suportadas não incluem West US, portanto, você pode ignorar esta seção para este exemplo. Para obter mais informações, consulte Proteger aplicativos lógicos contra falhas de região com redundância de zona e zonas de disponibilidade.

    Quando terminar, suas configurações serão semelhantes ao exemplo a seguir:

    Screenshot shows Azure portal and logic app resource creation page with details for new logic app.

  5. Quando estiver pronto, selecione Rever + Criar.

  6. Na página de validação exibida, confirme todas as informações fornecidas e selecione Criar.

Selecione o modelo em branco

  1. 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 digitando o nome na caixa de pesquisa do Azure.

    Screenshot shows the resource deployment page and selected button named Go to resource.

    A página de modelo do designer é aberta para mostrar um vídeo de introdução e gatilhos comumente usados.

  2. Role para baixo após o vídeo e a seção chamada Iniciar com um gatilho comum.

  3. Em Modelos, selecione Aplicação Lógica em Branco.

    Screenshot shows the template gallery and selected template named Blank Logic App.

    Depois de selecionar o modelo, o designer mostra o designer de fluxo de trabalho vazio.

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 quaisquer ações subsequentes 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. No gatilho, forneça as seguintes informações:

    Propriedade 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 Não Data de publicação A propriedade que determina quais itens são novos.
    Intervalo Sim 1 O número de intervalos a aguardar entre as verificações de alimentação.

    Este exemplo usa 1 como intervalo.
    Frequência Sim Minute A unidade de frequência a utilizar para cada intervalo.

    Este exemplo usa Minute como a frequência.

    Screenshot shows the RSS trigger settings, including RSS URL, frequency, and interval.

  3. Oculte as informações do gatilho por enquanto, selecionando dentro da barra de título para recolher a janela de detalhes.

    Screenshot that shows the collapsed trigger shape.

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

    Esta etapa publica instantaneamente o fluxo de trabalho do aplicativo lógico 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.

    Nota

    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.

    Nota

    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, consulte a seguinte documentação:

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

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

      Para este exemplo, use seu endereço de e-mail.

      Nota

      Quando você seleciona dentro da caixa Para ou outras caixas de edição, a lista Adicionar conteúdo dinâmico é exibida. Esta lista mostra todas as saídas de operações anteriores que você pode selecionar e usar como entradas para a ação atual. Você pode ignorar esta lista 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:

        Screenshot shows the action named Send an email, with the cursor inside the box named Subject.

      2. Na lista Adicionar conteúdo dinâmico exibida, 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.

        Screenshot shows the box named Subject, with open dynamic content list and selected trigger output named Feed title.

        Gorjeta

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

        Screenshot shows open dynamic content list and selected option, See more.

      Quando terminar, o assunto do e-mail se parece com o exemplo a seguir:

      Screenshot shows action named Send an email, with example email subject and included value for property named Feed title.

      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, na barra de título do loop, selecione o botão de reticências (...) e, em seguida, selecione Excluir.

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

      Neste exemplo, o corpo inclui as seguintes propriedades, precedidas de texto descritivo para cada propriedade. Para adicionar linhas em branco a uma caixa de edição, prima Shift + Enter.

      Texto descritivo Propriedade 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

      Screenshot shows action named Send an email, with selected properties inside the box named Body.

  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 depois de verificar o RSS feed com base na programação especificada ou executar manualmente o fluxo de trabalho.

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

    Screenshot shows workflow designer toolbar with selected option named Run.

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 e-mail 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.

Screenshot shows Outlook and sample email received for new RSS feed item, along with item title, date published, and link.

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 publicou itens desde a última verificação agendada ou manual.

Clean up resources (Limpar recursos)

Quando terminar este início rápido, exclua o recurso de aplicativo lógico de exemplo e todos os 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.

    Screenshot shows Azure portal search box with search term, resource groups.

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

    Screenshot shows Azure portal with selected resource group and button for Delete resource group.

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

    Screenshot shows Azure portal with confirmation pane and entered resource group name to delete.

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: