Guia de início rápido: criar um exemplo de fluxo de trabalho de 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 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:
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:
- Criar e gerenciar fluxos de trabalho no Visual Studio Code
- Criar e gerenciar fluxos de trabalho no Visual Studio
- Criar e gerenciar fluxo de trabalho de aplicativos lógicos usando a CLI do Azure
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 de email de um serviço que funciona com os Aplicativos Lógicos do Azure, como o Outlook do Office 365 ou o Outlook.com. Para ver outros fornecedores de email compatíveis, confira Conectores para Aplicativos Lógicos do Azure.
Observação
Caso deseje usar o conector do Gmail, somente as contas do G Suite podem usar esse conector sem restrição nos Aplicativos Lógicos do Azure. Se você tiver uma conta do Gmail de consumidor, poderá usar esse conector somente com serviços aprovados pelo Google específicos ou poderá criar um aplicativo cliente do Google para usar para fazer autenticação com o conector do Gmail. Para obter mais informações, confira Políticas de privacidade e segurança de dados para os conectores do Google nos Aplicativos Lógicos do Azure.
Se você tiver um firewall que limita o tráfego a endereços IP específicos, configure-o para permitir o acesso dos endereços IP de entrada e saída usados pelos Aplicativos Lógicos do Azure na região do Azure em que o você criar o fluxo de trabalho de aplicativo lógico.
Este exemplo usa os conectores RSS e Office 365 Outlook, que são executados no Azure global e gerenciados pela Microsoft. Esses conectores exigem a configuração do firewall para permitir o acesso a todos os endereços IP de saída do conector gerenciado na região do Azure do recurso do aplicativo lógico.
Criar um recurso de aplicativo lógico de consumo
Na caixa de pesquisa do portal do Azure, insira aplicativos lógicos e selecione Aplicativos lógicos.
Na barra de ferramentas da página Aplicativos lógicos, selecione Adicionar.
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.
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.
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:
Quando estiver pronto, selecione Examinar + Criar.
Na página de validação exibida, confirme todas as informações fornecidas e selecione Criar.
Selecionar o modelo em branco
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.
A página modelo do designer é aberta para mostrar um vídeo de introdução e os gatilhos comumente usados.
Role para baixo até o vídeo e a seção chamada Iniciar com um gatilho comum.
Em Modelos, selecione Aplicativo lógico em branco.
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.
No designer de fluxo de trabalho, siga estas etapas gerais para adicionar o gatilho RSS chamado Quando um item de feed é publicado.
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.Oculte as informações do gatilho por enquanto selecionando dentro da barra de título para recolher a janela de detalhes.
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.
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.
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:
Na ação Enviar um email, forneça as seguintes informações a serem incluídas no email.
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.
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:
Insira o seguinte texto com um espaço em branco à direita:
New RSS item:
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.
Dica
Se nenhuma saída aparecer disponível em Quando um item de feed for publicado, selecione Ver mais.
Quando você tiver acabado, o assunto do email deve ser semelhante ao exemplo a seguir:
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.
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
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.
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.
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.
Na caixa de busca do Azure, insira os grupos de recursos e selecione Grupos de recursos.
Localize e selecione o grupo de recursos de seu aplicativo lógico. No painel Visão geral, selecione Excluir grupo de recursos.
Quando o painel de confirmação for exibido, insira o nome do grupo de recursos e selecione Excluir.
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: