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

  • Artigo

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 feed RSS, com base na programação especificada. O conector do Outlook do Office 365 fornece uma ação que envia um email para cada novo item RSS.

A seguinte captura de tela mostra o exemplo de fluxo de trabalho 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 de aplicativo lógico de consumo e um fluxo de trabalho 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 conectores 1000+ que você pode usar em um fluxo de trabalho. Embora esse exemplo seja baseado em nuvem, os Aplicativos Lógicos do Azure dão suporte a fluxos de trabalho que conectam aplicativos, dados, serviços e sistemas entre ambientes de nuvem, locais e híbridos.

Conforme você percorrer este guia de início rápido, 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 aplicativo lógico em branco.
  • Adicionar um gatilho que especifica quando o fluxo de trabalho será executado.
  • Adicionar uma ação que executa uma tarefa depois que o gatilho é disparado.
  • Executar seu fluxo de trabalho.

Para criar e gerenciar um fluxo de trabalho de aplicativo lógico de Consumo usando outras ferramentas, confira os seguintes guias de início rápido:

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, primeiro selecione o Tipo de plano para seu recurso de aplicativo lógico. Dessa forma, somente as opções para esse tipo de plano são exibidas.

    1. Na seção Plano, em Tipo de plano, selecione Consumo para exibir apenas as configurações de recurso do aplicativo Lógica de consumo.

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

      Tipo de plano Descrição
      Standard Esse recurso de aplicativo lógico é a seleção padrão e dá suporte a 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 dá suporte a 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 de aplicativo lógico:

    Propriedade Obrigatório Valor Descrição
    Assinatura Sim <Azure-subscription-name> Seu nome da assinatura do Azure.
    Grupo de Recursos Sim <Azure-resource-group-name> O grupo de recursos do Azure em que o seu aplicativo lógico e os recursos relacionados são criados. O nome desse recurso precisa ser exclusivo em todas as regiões e pode conter somente letras, números, hífens (-), sublinhados (_), parênteses (()) e pontos (.).

    Esse exemplo cria um grupo de recursos chamado Consumption-RG.
    Nome do Aplicativo Lógico Sim <logic-app-resource-name> O nome do recurso do aplicativo lógico, que precisa ser exclusivo em todas as regiões e pode conter somente letras, números, hifens (-), sublinhados (_), parênteses ((, )) e pontos (.).

    Esse 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 na qual as informações sobre o aplicativo são armazenadas. Esse exemplo implanta o aplicativo lógico de amostra na região Oeste dos EUA no Azure.
    Habilitar a análise de logs Sim Não Essa opção aparece e se aplica somente quando você seleciona o tipo de aplicativo lógico de Consumo.

    Altere essa opção somente quando desejar habilitar o log de diagnósticos. Para esse início rápido, mantenha a seleção padrão.

    Observação

    Se você tiver selecionado uma região do Azure com suporte para redundância de zona de disponibilidade, a seção Redundância de zona será habilitada automaticamente. Essa seção em versão prévia oferece a opção de habilitar a redundância das zonas de disponibilidade do aplicativo lógico. No entanto, as regiões do Azure com suporte atualmente não incluem o Oeste dos EUA, portanto, você pode ignorar esta seção para este exemplo. Para obter mais informações, confira Proteger aplicativos lógicos contra falhas de região com redundância de zonas e zonas de disponibilidade.

    Quando terminar, as configurações serão semelhante à imagem a seguir:

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

  5. Quando estiver pronto, selecione Examinar + Criar.

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

Selecionar o modelo em branco

  1. Após o Azure implantar o recurso de aplicativo lógico com êxito, selecione Ir para o recurso. Ou, então, encontre 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 modelo do designer é aberta para mostrar um vídeo de introdução e os gatilhos comumente usados.

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

  3. Em Modelos, selecione Aplicativo lógico 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 só gatilho, que especifica a condição a ser atendida antes da execução de qualquer ação posterior 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 será criada nem executada.

Este exemplo usa um gatilho RSS que verifica um feed RSS de acordo com um agendamento específico. Se houver um novo item no feed, o gatilho será acionado e uma nova instância de fluxo de trabalho é criada e executada. Se houver 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 Obrigatório Valor Descrição
    A URL do RSS feed Sim <RSS-feed-URL> A URL do RSS feed a ser monitorada.

    Este exemplo usa o RSS feed 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 a autorização HTTP. Escolha um RSS feed publicado com frequência, de modo que possa testar o fluxo de trabalho com facilidade.
    A propriedade escolhida será usada para determinar Não PublishDate A propriedade que determina quais itens são novos.
    Intervalo Sim 1 O número de intervalos de espera entre as verificações do feed.

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

    Este exemplo usa Minuto como 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. Selecione Salvar na barra de ferramentas do designer.

    Esta etapa publica instantaneamente o fluxo de trabalho do aplicativo lógico ativo no portal do Azure. No entanto, o gatilho verifica apenas o feed RSS sem executar nenhuma outra ação. Portanto, você precisa adicionar uma ação para especificar o que deseja que aconteça quando o gatilho for acionado.

Adicionar uma ação

Após um gatilho, uma ação é uma etapa posterior que executa uma 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 várias 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 Outlook do Office 365 que envia um email toda vez que o gatilho é acionado para um novo item de RSS feed. Se houver vários novos itens entre as verificações, você receberá vários emails.

  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 Outlook do Office 365 chamada Enviar um email.
    • Se você tiver uma conta pessoal da Microsoft, adicione a ação do conector de Outlook.com chamada Enviar um email.

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

    Observação

    Se você usar outro serviço de email compatível no fluxo de trabalho, a interface do usuário poderá parecer um pouco diferente. No entanto, os conceitos básicos para se conectar a outro serviço de email permanecem os mesmos.

  2. Se o serviço de email selecionado solicitar que você se conecte e autentique sua identidade, conclua esta etapa agora.

    Observação

    Muitos conectores exigem que você primeiro crie uma conexão e autentique sua identidade antes de continuar. Este exemplo usa a autenticação manual do conector do Outlook do Office 365. No entanto, outros serviços podem dar suporte a tipos de autenticação diferentes ou usá-los. De acordo com o seu cenário, você pode lidar com a autenticação de conexão de várias maneiras.

    Para saber mais, consulte a seguinte documentação:

  3. Na ação Enviar um email, forneça as seguintes informações a serem incluídas no email.

    1. Na caixa Para, insira o endereço de email do destinatário.

      Para este exemplo, use seu endereço de email.

      Observação

      Quando você seleciona dentro da caixa Para ou de 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. Ignore-a por enquanto. A próxima etapa usará 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.

        Dica

        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 você tiver acabado, o assunto do email deve ser semelhante ao exemplo a seguir:

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

      Observação

      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 na matriz.

      Para remover o loop, na barra de título do loop, selecione o botão de reticências (...) e selecione Excluir.

    3. Na caixa Corpo, insira o conteúdo do email.

      Para este exemplo, o corpo inclui as propriedades a seguir, precedidas por um texto descritivo para cada propriedade. Para adicionar linhas em branco em uma caixa de edição, pressione Shift + Enter.

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

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

  4. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Testar seu fluxo de trabalho

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

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

    Screenshot shows workflow designer toolbar with selected option named Run.

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

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

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

Solução de problemas

Se você não receber emails do fluxo de trabalho conforme o esperado:

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

  • Verifique se o RSS feed que você está usando tem itens publicados desde a última verificação agendada ou manual.

Limpar os recursos

Quando terminar este guia de início rápido, exclua o exemplo de recurso de aplicativo lógico e todos os recursos relacionados excluindo o grupo de recursos criado para este exemplo.

  1. Na caixa de busca do Azure, insira os 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 de 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 for exibido, 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óximas etapas

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

Verificar o tráfego com um fluxo de trabalho de aplicativo lógico baseado em agendamento