Quickstart: Criar um fluxo de trabalho de integração com Azure Logic Apps multi-inquilinos e o portal Azure

Este quickstart mostra como criar um fluxo de trabalho automatizado exemplo que integra dois serviços, um feed RSS para um site e uma conta de e-mail, quando você usa multi-inquilino Azure Logic Apps. Embora este exemplo seja baseado em nuvem, Azure Logic Apps suporta fluxos de trabalho que conectam apps, dados, serviços e sistemas através da nuvem, nas instalações e ambientes híbridos. Para obter mais informações sobre o multi-inquilino versus Azure Logic Apps de inquilino único, reveja o ambiente de inquilino único versus multi-inquilino e ambiente de serviço de integração.

Neste exemplo, cria-se um recurso de aplicação lógica e fluxo de trabalho que utiliza o conector RSS e o conector Office 365 Outlook. O recurso funciona em Azure Logic Apps multi-inquilinos e baseia-se no modelo de preços de consumo. O conector RSS tem um gatilho que verifica um feed RSS, com base num horário. O conector Office 365 Outlook tem uma ação que envia um e-mail para cada novo item. Os conectores neste exemplo são apenas dois entre as centenas de conectores que pode utilizar num fluxo de trabalho.

A imagem que se segue mostra o fluxo de trabalho de exemplo de alto nível:

Screenshot mostrando o fluxo de trabalho exemplo com o gatilho RSS, "Quando um item de feed é publicado" e a ação Outlook, "Enviar um e-mail".

À medida que progredires neste arranque rápido, aprenderás estes passos básicos:

  • Crie um recurso de aplicativo lógico que funciona no ambiente de Azure Logic Apps multi-inquilinos.
  • Selecione o modelo de aplicação lógica em branco.
  • Adicione um gatilho que especifica quando executar o fluxo de trabalho.
  • Adicione uma ação que execute uma tarefa após o disparo.
  • Faça o seu fluxo de trabalho.

Para criar e gerir um recurso de aplicação lógica utilizando outras ferramentas, reveja estas outras Azure Logic Apps quickstarts:

Pré-requisitos

Criar um recurso de aplicação lógica

  1. Inicie sessão no portal do Azure com a sua conta do Azure.

  2. Na caixa de pesquisa Azure, insira logic apps e selecione aplicações Lógicas.

    Screenshot que mostra a caixa de pesquisa do portal Azure com "apps lógicas" como o termo de pesquisa e "Logic Apps" como o resultado selecionado.

  3. Na página de aplicações Lógica, selecione Adicionar.

    Screenshot mostrando o portal Azure e a página de serviço de Aplicações Lógicas e a opção "Adicionar" selecionada.

  4. No painel Create Logic App, selecione a subscrição Azure para usar, crie um novo grupo de recursos para o seu recurso de aplicação lógica e forneça detalhes básicos sobre o recurso da sua aplicação lógica.

    Propriedade Valor Descrição
    Subscrição <Nome de subscrição Azure> O nome da sua assinatura Azure.
    Grupo de Recursos <Nome de grupo Azure-recursos> O nome do grupo de recursos Azure, que deve ser único em todas as regiões. Este exemplo usa "My-First-LA-RG".
    Tipo Consumo O tipo de recurso de aplicação lógica e o modelo de faturação para usar para o seu recurso:

    - Consumo: Este tipo de recurso de aplicativo lógica funciona em Azure Logic Apps global e multi-inquilino e utiliza o modelo de faturação de consumo. Este exemplo utiliza este modelo de Consumo.

    - Standard: Este tipo de recurso de aplicativo lógica funciona em Azure Logic Apps de inquilino único e utiliza o modelo de faturação Standard.

    Nome da Aplicação Lógica <lógica-app-nome> O nome do seu recurso de aplicativo lógico, que deve ser único em todas as regiões. Este exemplo utiliza "My-First-Logic-App".

    Importante: Este nome só pode conter letras, números, hífens - (), sublinhados _ ( , parênteses ( ( , ) e ) períodos . ().

    Região <Região de Azure> A região do datacenter Azure onde armazenar as informações da sua aplicação. Este exemplo usa "West US".

    Nota: Se a sua subscrição estiver associada a um ambiente de serviço de integração,esta lista inclui esses ambientes.

    Ativar a análise de registos Não Altere esta opção apenas quando pretender ativar a sessão de diagnóstico. Para este exemplo, deixe esta opção por seleção.

    Screenshot mostrando o portal Azure e a página de criação de recursos de aplicativos logicos com detalhes para nova aplicação lógica.

  5. Quando estiver pronto, selecione Review + Create. Na página de validação, confirme os detalhes que forneceu e selecione Criar.

Selecione o modelo em branco

  1. Depois de a Azure implementar com sucesso a sua aplicação, selecione Ir para o recurso. Ou, encontre e selecione o seu recurso de aplicação lógica digitando o nome na caixa de pesquisa Azure.

    Screenshot mostrando a página de implementação de recursos e botão selecionado, "Ir para o recurso".

    O designer de workflow abre e mostra uma página com um vídeo de introdução e gatilhos comumente usados.

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

    Screenshot mostrando o designer de fluxo de trabalho, galeria de modelos e modelo selecionado, "Blank Logic App".

    Depois de selecionar o modelo, o designer mostra agora uma superfície de fluxo de trabalho vazia.

Adicione o gatilho

Um fluxo de trabalho começa sempre com um único gatilho,que especifica a condição para cumprir antes de executar quaisquer ações no fluxo de trabalho. Cada vez que o gatilho dispara, Azure Logic Apps cria e executa uma instância de fluxo de trabalho. Se o gatilho não disparar, nenhum caso é criado nem executado. Pode iniciar um fluxo de trabalho escolhendo entre vários gatilhos diferentes.

Este exemplo utiliza um gatilho RSS que verifica um feed RSS, com base num horário. Se existir um novo item no feed, o gatilho dispara e uma nova instância de fluxo de trabalho começa a funcionar. Se existirem vários novos itens entre verificações, o gatilho dispara para cada item e uma nova instância de fluxo de trabalho separada corre para cada item.

  1. No designer de fluxo de trabalho, sob a caixa de pesquisa, selecione All.

  2. Para encontrar o gatilho RSS, na caixa de pesquisa, insira rss . Na lista 'Gatilhos', selecione o gatilho RSS, quando for publicado um item de alimentação.

    Screenshot mostrando o designer de fluxo de trabalho com "rss" na caixa de pesquisa e o gatilho RSS selecionado, "Quando um item de alimentação é publicado".

  3. Nos detalhes do gatilho, forneça as seguintes informações:

    Propriedade Necessário Valor Descrição
    O URL do feed RSS Yes <RSS-feed-URL> O URL de alimentação RSS para monitorizar.

    Este exemplo utiliza o feed RSS do Wall Street Journal em https://feeds.a.dj.com/rss/RSSMarketsMain.xml . No entanto, pode utilizar qualquer feed RSS que não necessite de autorização HTTP. Escolha um feed RSS que publique com frequência, para que possa testar facilmente o seu fluxo de trabalho.

    Propriedade escolhida será usada para determinar No PublishDate A propriedade que determina quais itens são novos.
    Intervalo Yes 1 O número de intervalos a esperar entre as verificações de alimentação.

    Este exemplo usa 1 como intervalo.

    Frequência Yes Minuto A unidade de frequência a utilizar para cada intervalo.

    Este exemplo usa Minute como frequência.

    Screenshot mostrando as definições do gatilho RSS, incluindo URL RSS, frequência e intervalo.

  4. Desmaie os detalhes do gatilho por enquanto clicando dentro da sua barra de título.

    Screenshot que mostra a forma do gatilho colapsado.

  5. Quando terminar, guarde a sua aplicação lógica, que entra instantaneamente em direto no portal Azure. Na barra de ferramentas do designer, selecione Save.

    O gatilho não fará outra coisa senão verificar a alimentação RSS. Por isso, tens de adicionar uma ação que defina o que acontece quando o gatilho dispara.

Adicionar uma ação

Seguindo um gatilho, uma ação é um passo subsequente que executa alguma operação no fluxo de trabalho. Qualquer ação pode utilizar as saídas do passo anterior, que pode ser o gatilho ou outra ação. Pode escolher entre muitas ações diferentes, adicionar múltiplas ações até ao limite por fluxo de trabalho,e até mesmo criar diferentes caminhos de ação.

Este exemplo usa uma ação Office 365 Outlook que envia um e-mail cada vez que o gatilho dispara para um novo item de alimentação RSS. Se existirem vários novos itens entre verificações, recebe vários e-mails.

  1. Sob o gatilho Quando um item de alimentação é publicado, selecione Novo passo.

    Screenshot mostrando o gatilho do fluxo de trabalho e o botão selecionado, "Novo passo".

  2. Em 'Escolha uma operação e a caixa de pesquisa', selecione All.

  3. Na caixa de pesquisa, send an email insira para que possa encontrar conectores que ofereçam esta ação. Para filtrar a lista de Ações para uma aplicação ou serviço específico, selecione primeiro essa aplicação ou serviço.

    Por exemplo, se tiver uma conta de trabalho ou escola da Microsoft e quiser usá Office 365 Outlook, selecione Office 365 Outlook. Ou, se tiver uma conta pessoal da Microsoft, selecione Outlook.com. Este exemplo continua com Office 365 Outlook.

    Nota

    Se utilizar um serviço de e-mail suportado diferente no seu fluxo de trabalho, a interface do utilizador pode parecer ligeiramente diferente. No entanto, os conceitos básicos de ligação a outro serviço de e-mail permanecem os mesmos.

    Screenshot mostrando a lista "Escolha uma operação" com o serviço de e-mail selecionado, "Office 365 Outlook".

    Agora pode agora encontrar e selecionar mais facilmente a ação que deseja, por exemplo, Enviar um e-mail:

    Screenshot mostrando ações filtradas para o serviço de e-mail, "Office 365 Outlook".

  4. Se o seu serviço de e-mail selecionado lhe pedir para iniciar sômentou e autenticar a sua identidade, complete esse passo agora.

    Muitos conectores exigem que crie primeiro uma ligação e autente a sua identidade antes de poder continuar.

    Screenshot que mostra o pedido de inscrição para Office 365 Outlook.

    Nota

    Este exemplo mostra a autenticação manual para a ligação a Office 365 Outlook. No entanto, outros serviços podem suportar ou utilizar diferentes tipos de autenticação. Com base no seu cenário, pode lidar com a autenticação de ligação de várias maneiras.

    Por exemplo, se utilizar modelos do Gestor de Recursos Azure para implantação, pode aumentar a segurança nas entradas que mudam frequentemente por valores de parametrização, tais como detalhes de ligação. Para mais informações, reveja estes tópicos:

  5. No Enviar uma ação por e-mail, especifique as informações a incluir no e-mail.

    1. Na caixa 'Para' inserir o endereço de e-mail do recetor. Para este exemplo, utilize o seu endereço de e-mail.

      Nota

      A lista de conteúdos dinâmicos Add aparece quando clica dentro da caixa 'Caixa' e outras caixas para determinados tipos de entrada. Esta lista mostra quaisquer saídas de passos anteriores que estejam disponíveis para selecionar como entradas para a ação atual. Pode ignorar esta lista por enquanto. O passo seguinte usa a lista de conteúdos dinâmicos.

    2. Na caixa Assunto, introduza o assunto do e-mail. Para este exemplo, insira o seguinte texto com um espaço em branco em fuga: New RSS item:

      Screenshot mostrando a ação "Enviar um e-mail" e cursor dentro da caixa de propriedade "Assunto".

    3. A partir da lista de conteúdos dinâmicos Add, em Quando um item de alimentação é publicado, selecione o título de Feed.

      O título de alimentação é uma saída de gatilho que faz referência ao título do item RSS. O seu email utiliza esta saída para mostrar o título do artigo RSS.

      Screenshot mostrando a ação e cursor "Enviar um e-mail" dentro da caixa de propriedade "Assunto" com a lista de conteúdos dinâmicos abertos e saída de gatilho selecionada, "Feed title".

      Dica

      Na lista de conteúdos dinâmicos, se não aparecerem saídas do gatilho Quando um item de alimentação é publicado, junto ao cabeçalho da ação, selecione Ver mais.

      Screenshot que mostra a lista de conteúdos dinâmicos abertos e "Ver mais" selecionado para o gatilho.

      Quando estiver pronto, o assunto do e-mail terá o aspeto deste exemplo:

      Screenshot mostrando a ação "Enviar um e-mail" e um sujeito de e-mail exemplo com a propriedade incluída "Feed title".

      Nota

      Se um Para cada loop aparecer no designer, então selecionou uma saída que faz referência a uma matriz, como a propriedade categorias-Item. Para este tipo de saída, o designer adiciona automaticamente o For cada loop em torno da ação que faz referência à saída. Desta forma, o seu fluxo de trabalho realiza a mesma ação em cada item de matriz.

      Para remover o laço, na barra de título do loop, selecione o botão elipses (...) e, em seguida, selecione Delete.

    4. Na caixa Corpo, insira o conteúdo do corpo de e-mail.

      Para este exemplo, o corpo inclui as seguintes propriedades, precedidas por texto descritivo para cada propriedade. Para adicionar linhas em branco a uma caixa de edição, prima 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 hora de publicação do item
      Link: Ligação principal do feed O URL do item

      Screenshot mostrando o designer de fluxo de trabalho, a ação "Enviar um e-mail" e propriedades selecionadas dentro da caixa "Body".

  6. Guarde a sua aplicação lógica. Na barra de ferramentas do designer, selecione Save.

Executar o seu fluxo de trabalho

Para verificar se o fluxo de trabalho funciona corretamente, pode esperar que o gatilho verifique o feed RSS com base no horário definido. Ou, pode executar manualmente o fluxo de trabalho selecionando Run na barra de ferramentas do designer de fluxo de trabalho, como mostrado na imagem seguinte.

Screenshot mostrando o designer de fluxo de trabalho e o botão "Run" selecionado na barra de ferramentas do designer.

Se o feed RSS tiver novos itens, o seu fluxo de trabalho envia um e-mail para cada novo item. Caso contrário, o seu fluxo de trabalho aguarda até ao intervalo seguinte para verificar novamente o feed RSS.

A imagem que se segue mostra um e-mail de amostra que é enviado pelo fluxo de trabalho exemplo. O e-mail inclui os detalhes de cada saída de gatilho que selecionou, além do texto descritivo que incluiu para cada item.

Screenshot mostrando Outlook e um e-mail de amostra recebido para um novo item de feed RSS, juntamente com o título do item, data publicada e link.

Resolução de problemas

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

  • Verifique a pasta de lixo 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 artigos desde a última verificação agendada ou manual.

Limpar os recursos

Quando terminar este quickstart, elimine o recurso da app lógica da amostra e quaisquer recursos relacionados, eliminando o grupo de recursos que criou para este exemplo.

  1. Na caixa de pesquisa Azure, insira resource groups e, em seguida, selecione grupos de Recursos.

    Screenshot mostrando a caixa de pesquisa do portal Azure com o termo de pesquisa, "grupos de recursos".

  2. Encontre e selecione o grupo de recursos da sua aplicação lógica. No painel de visão geral, selecione Eliminar o grupo de recursos.

    Screenshot mostrando portal Azure com grupo de recursos selecionado e botão para "Eliminar grupo de recursos".

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

    Screenshot mostrando portal Azure com painel de confirmação e nome de grupo de recursos introduzido para apagar.

Passos seguintes

Neste quickstart, criou o seu primeiro fluxo de trabalho de aplicações lógicas no portal Azure para verificar um feed RSS e enviar um e-mail para cada novo item. Para saber mais sobre fluxos de trabalho programados avançados, consulte o seguinte tutorial: