Conectar-se a servidores FTP em fluxos de trabalho no Azure Logic Apps

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Esse artigo mostra como acessar seu servidor FTP (File Transfer Protocol) a partir de um fluxo de trabalho em Aplicativos Lógicos do Azure com o conector de FTP. Você pode criar fluxos de trabalho automatizados que são executados quando disparados por eventos em seu servidor FTP ou em outros sistemas e executar ações para gerenciar arquivos em seu servidor FTP.

Por exemplo, seu fluxo de trabalho pode começar com um gatilho de FTP que monitore e responda a eventos no seu servidor FTP. O gatilho disponibiliza as saídas para ações no seu fluxo de trabalho. Seu fluxo de trabalho pode executar ações de FTP que criam, enviam, recebem e gerenciam arquivos por meio da sua conta de servidor FTP usando as seguintes tarefas específicas:

• Monitorar quando arquivos são adicionados ou alterados.
• Criar, copiar, excluir, listar e atualizar arquivos.
• Obter metadados e o conteúdo do arquivo.
• Gerenciar pastas.

Se você não estiver familiarizado com os Aplicativos Lógicos do Azure, confira a seguinte documentação:

• O que são Aplicativos Lógicos do Azure
• Início Rápido: Crie um exemplo de fluxo de trabalho de aplicativo lógico de Consumo

Referência técnica do conector

O conector de FTP tem versões diferentes, com base no tipo de aplicativo lógico e no ambiente do host.

Limitações

• Capacidade e taxa de transferência

  • Conector interno para fluxos de trabalho Padrão:

    Por padrão, as ações de FTP podem ler ou gravar arquivos que tenham 200 MB ou menos. No momento, o conector interno de FTP não oferece suporte a agrupamento.

  • Conector gerenciado para consumo e fluxos de trabalho padrão

    Por padrão, as ações de FTP podem ler ou gravar arquivos que são de 50 MB ou menores. Para lidar com arquivos maiores do que 50 MB, as ações de FTP dão suporte ao agrupamento de mensagens. A ação obter conteúdo do arquivo usa implicitamente o agrupamento.

• Os gatilhos para o conector gerenciado por FTP ou hospedado no Azure podem apresentar resultados ausentes, incompletos ou atrasados quando o carimbo de data/hora última modificação é preservado. Por outro lado, o gatilho de conector interno do FTP em fluxos de trabalho de aplicativo lógico Padrão não tem essa limitação. Para obter mais informações, consulte as limitações do conector FTP.

• O conector gerenciado de FTP pode criar um número limitado de conexões com o servidor FTP. O limite é baseado na capacidade de conexão na região do Azure em que o recurso de aplicativo lógico existe. Se esse limite for um problema em um fluxo de trabalho de aplicativo lógico de Consumo, crie um fluxo de trabalho de aplicativo lógico Standard que use o conector interno do FTP.

• Tanto o conector FTP integrado quanto o gerenciado suportam apenas FTP explícito sobre FTPS, que é uma extensão do TLS. Nenhuma versão do conector dá suporte a FTPS implícito.

Pré-requisitos

• Uma conta e assinatura do Azure. Se você não tiver uma assinatura do Azure, inscreva-se em uma conta gratuita do Azure.

• O fluxo de trabalho de aplicativo lógico que você deseja acessar a sua conta de FTP. Para iniciar seu fluxo de trabalho com um gatilho de FTP, você precisará começar com um fluxo de trabalho em branco. Para usar uma ação de FTP, inicie seu fluxo de trabalho com outro gatilho, por exemplo, Recurrence.

• Para obter mais requisitos que se aplicam ao conector gerenciado ftp e ao conector interno, consulte a referência do conector gerenciado ftp – requisitos.

Problemas conhecidos

Por padrão, gatilhos que aceitam e retornam matrizes geralmente têm a configuração de Dividir em já habilitada. O gatilho elimina automaticamente uma matriz criando internamente uma instância de fluxo de trabalho separada para processar cada item de matriz. Todas as instâncias de fluxo de trabalho são executadas em paralelo para que os itens de matriz sejam processados ao mesmo tempo.

No entanto, quando a configuração Dividir em está habilitada, os gatilhos de conector gerenciado retornam as saídas para todos os itens de matriz como listas. Todas as ações subsequentes que referenciam essas saídas devem primeiro tratar essas saídas como listas. Para manipular cada item de matriz individualmente, você pode adicionar ações extras. Por exemplo, para iterar por meio desses itens de matriz, você pode usar um loop Para cada. Para gatilhos que retornam apenas metadados ou propriedades, use uma ação que primeiro obtenha os metadados do item de matriz e, em seguida, use uma ação para obter o conteúdo dos itens.

Você deve aplicar essa abordagem apenas para gatilhos de conector gerenciado, e não para gatilhos de conector internos que retornam saídas para um item de matriz de cada vez com a configuração Dividir em habilitada.

Por exemplo, suponha que você tenha um gatilho de conector gerenciado chamado Quando um arquivo for adicionado ou modificado (somente propriedades) que retorne os metadados ou as propriedades dos arquivos novos ou atualizados como matrizes. Para obter os metadados separadamente para cada arquivo, você pode usar um loop Para cada que itera por meio da matriz. Neste loop, use as seguintes ações do conector gerenciado na ordem especificada:

1. Obter metadados do arquivo para obter metadados de cada arquivo.

2. Ação Obter conteúdo do arquivo para obter o conteúdo de cada arquivo.

Adicionar um gatilho de FTP

Um fluxo de trabalho de aplicativo lógico Consumo pode usar apenas o conector gerenciado de FTP. No entanto, um fluxo de trabalho de aplicativo lógico Padrão pode usar o conector gerenciado de FTP e o conector interno de FTP.connection profile.

O conector gerenciado de FTP e o conector interno têm apenas um gatilho disponível:

• Gatilho de conector gerenciado: O gatilho de FTP chamado Quando um arquivo for adicionado ou modificado (somente propriedades) executa um fluxo de trabalho de aplicativo lógico Consumo ou Padrão quando um ou mais arquivos são adicionados ou alterados em uma pasta no servidor FTP. Esse gatilho obtém apenas as propriedades ou os metadados do arquivo, não o seu conteúdo. Para obter o conteúdo do arquivo, seu fluxo de trabalho pode seguir esse gatilho com outras ações FTP.

  Para obter mais informações, consulte Quando um arquivo é adicionado ou modificado (somente propriedades).

• Gatilho de conector interno: O gatilho de FTP chamado Quando um arquivo for adicionado ou modificado (somente propriedades) executa um fluxo de trabalho de aplicativo lógico Padrão quando um ou mais arquivos são adicionados ou alterados em uma pasta no servidor FTP. Esse gatilho obtém apenas as propriedades ou os metadados do arquivo, não o seu conteúdo. Para obter o conteúdo, seu fluxo de trabalho pode seguir esse gatilho com outras ações FTP. Para obter mais informações, consulte Quando um arquivo é adicionado ou atualizado.

Os procedimentos a seguir usam o portal do Azure. Com a extensão correspondente de Aplicativos Lógicos do Azure para aplicativos lógicos de Consumo ou Padrão, você pode usar as seguintes ferramentas para criar e editar fluxos de trabalho de aplicativos lógicos:

• Fluxos de trabalho de aplicativos de lógica de Consumo: Visual Studio Code
• Fluxos de trabalho de aplicativos lógicos padrão: Visual Studio Code

Esta seção mostra as etapas para os seguintes gatilhos de conector de FTP:

• Gatilho interno chamado Quando um arquivo for adicionado ou modificado

  Se você usar esse gatilho interno ftp, poderá obter o conteúdo do arquivo usando a ação interna ftp chamada Obter conteúdo do arquivo sem usar a ação Obter metadados de arquivo primeiro, ao contrário de quando você usa o gatilho gerenciado FTP. Para obter mais informações sobre as operações de conector internas do FTP, consulte as operações de conector internas do FTP.

  Este gatilho interno do FTP não está disponível para fluxos de trabalho de aplicativo lógico de Consumo.

• Gatilho Gerenciado chamado Quando um arquivo for adicionado ou modificado (somente propriedades)

  Se você usar esse gatilho gerenciado de FTP, deverá usar a ação Obter metadados de arquivo para obter um único item de matriz antes de usar qualquer outra ação no arquivo que foi adicionado ou modificado. Essa solução alternativa resulta do problema conhecido em torno da configuração Split On descrita anteriormente neste artigo.

Adicionar gatilho de conector embutido

Para adicionar um gatilho de conector embutido a um fluxo de trabalho Standard:

1. Abra o recurso de aplicativo lógico no portal do Azure.

2. No menu da barra lateral do recurso, em Fluxos de Trabalho, selecione Fluxos de Trabalho e selecione seu fluxo de trabalho vazio, que é aberto no designer.

3. No designer, selecione Adicionar um gatilho.

4. Siga as etapas gerais para adicionar o gatilho FTP quando um arquivo é adicionado ou atualizado (versão prévia).

5. Forneça as informações para sua conexão. Quando terminar, selecione Criar novo.

   

   Observação

   Por padrão, esse conector transfere arquivos no formato de texto. Para transferir arquivos no formato binário, como nos casos em que é usada codificação, selecione a opção de transporte binário.

6. Depois que o painel de informações do gatilho for exibido, na caixa Caminho da Pasta , especifique o caminho para a pasta que você deseja monitorar.

   

7. Quando terminar, salve o fluxo de trabalho.

Quando você salva seu fluxo de trabalho, o Azure publica suas atualizações em seu aplicativo lógico dinâmico e implantado no Azure. Com um gatilho apenas, o fluxo de trabalho só verifica o servidor FTP com base no seu agendamento especificado. Você precisa adicionar uma ação que responda ao gatilho e faça algo com as saídas do gatilho, conforme descrito nas seções posteriores.

Adicionar gatilho do conector gerenciado

Para adicionar um gatilho de conector gerenciado a um workflow do tipo Consumption ou Standard:

1. No portal do Azure, localize e abra o recurso do aplicativo lógico.

2. Com base no tipo de aplicativo lógico que você tem, Consumo ou Standard:

   • Consumo: no menu lateral do recurso, em Ferramentas de Desenvolvimento, selecione o designer para abrir o fluxo de trabalho.

   • Padrão: no menu da barra lateral do recurso, em Fluxos de Trabalho, selecione Fluxos de Trabalho. Selecione o fluxo de trabalho em branco, que é aberto no designer.

3. No designer de fluxo de trabalho, selecione Adicionar um gatilho.

4. Siga as etapas gerais para adicionar o gatilho FTP quando um arquivo for adicionado ou modificado (somente propriedades).

5. Forneça as informações para sua conexão. Quando terminar, selecione Criar novo.

   

   Observação

   Por padrão, esse conector transfere arquivos no formato de texto. Para transferir arquivos no formato binário, como nos casos em que é usada codificação, selecione a opção de transporte binário.

6. Quando o painel de informações de gatilho for aberto, localize a pasta que você deseja monitorar para arquivos novos ou editados.

   1. Na caixa Pasta, selecione o ícone de pasta para exibir o diretório de pastas.

   2. Selecione a seta para a direita (>). Acesse e selecione a pasta desejada.

   

   Sua pasta selecionada aparece na caixa Pasta.

   

7. Quando terminar, salve o fluxo de trabalho.

Quando você salva seu fluxo de trabalho, o Azure publica suas atualizações em seu aplicativo lógico dinâmico e implantado. Com um gatilho apenas, o fluxo de trabalho só verifica o servidor FTP com base no seu agendamento especificado. Você deve adicionar uma ação que responda ao gatilho e faça algo com as saídas do gatilho, conforme descrito nas seções posteriores.

Adicionar ação de FTP

Um fluxo de trabalho de aplicativo lógico Consumo pode usar apenas o conector gerenciado de FTP. Um fluxo de trabalho de aplicativo lógico Standard pode usar o conector gerenciado do FTP e o conector interno do FTP. Cada versão tem várias ações. Por exemplo, as versões de conector gerenciado e interno têm suas próprias ações para obter metadados do arquivo e obter o conteúdo do arquivo.

• Ações do conector interno: essas ações são executadas somente em um fluxo de trabalho de aplicativo lógico Padrão.
• Ações do conector gerenciado: essas ações são executadas em um fluxo de trabalho de aplicativo lógico do tipo Consumo ou Padrão.

Os procedimentos a seguir usam o portal do Azure. Com a extensão correspondente do Azure Logic Apps para Consumption ou Standard, você pode usar as seguintes ferramentas para criar e editar fluxos de trabalho do Logic Apps:

• Fluxos de trabalho de Consumo: Visual Studio Code
• Fluxos de trabalho padrão: Visual Studio Code

Para que você possa usar uma ação de FTP, seu fluxo de trabalho já deve começar com um gatilho, que pode ser qualquer tipo à sua escolha. Por exemplo, você pode usar o gatilho interno genérico Recorrência para iniciar seu fluxo de trabalho com agendamento específico.

As etapas para adicionar e usar uma ação FTP diferem com base em se o fluxo de trabalho usa o conector interno ou o conector gerenciado.

• Fluxos de trabalho de gatilho integrado: descreve as etapas para adicionar uma ação integrada a um fluxo de trabalho que começa com um gatilho integrado.

  Se você usou o gatilho interno do FTP e deseja o conteúdo de um arquivo recém-adicionado ou atualizado, poderá usar um loop Para cada para iterar pela matriz retornada pelo gatilho. Em seguida, você pode usar apenas a ação Obter conteúdo do arquivo, sem outras intermediárias. Para obter mais informações sobre as operações de conector internas do FTP, consulte as operações de conector internas do FTP.

• Fluxos de trabalho de gatilho gerenciado: descreve as etapas para adicionar uma ação gerenciada a um fluxo de trabalho que começa com um gatilho gerenciado.

  Se você usou o gatilho do conector gerenciado do FTP e deseja o conteúdo de um arquivo recém-adicionado ou modificado, poderá usar um loop Para cada para iterar pela matriz retornada pelo gatilho. Em seguida, você precisa usar ações intermediárias, como a ação de FTP chamada Obter metadados do arquivo antes de usar a ação Obter conteúdo do arquivo.

Fluxos de trabalho com gatilho interno

Para adicionar ações a um fluxo de trabalho Standard que começa com um gatilho de conector interno:

1. No portal do Azure, localize e abra o recurso do aplicativo lógico.

2. No menu da barra lateral do recurso, em Fluxos de Trabalho, selecione Fluxos de Trabalho. Selecione o fluxo de trabalho com o gatilho interno FTP.

3. No designer, siga estas etapas gerais para adicionar a ação FTP chamada Obter conteúdo de arquivo ao seu fluxo de trabalho.

4. Se preciso, forneça as informações sobre a sua conexão. Quando terminar, selecione Criar novo.

   

   Observação

   Por padrão, esse conector transfere arquivos no formato de texto. Para transferir arquivos no formato binário, como nos casos em que é usada codificação, selecione a opção de transporte binário.

5. No painel de informações da ação que é aberto, selecione dentro do Caminho do Arquivo para mostrar as opções de entrada. Selecione o ícone relâmpago para abrir a lista de conteúdo dinâmico.

   Agora você pode selecionar saídas do gatilho anterior.

6. Na lista de conteúdo dinâmico, em Quando um arquivo for adicionado ou atualizado, selecione Caminho do arquivo.

   

   A propriedade File path agora faz referência à saída do gatilho de Caminho do arquivo.

   

7. Adicione outras ações necessárias ao seu fluxo de trabalho.

8. Quando terminar, salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Fluxos de trabalho com gatilho gerenciado

Para adicionar ações a um fluxo de trabalho de Consumo ou Standard que começa com um gatilho de conector gerenciado:

1. No portal do Azure, localize e abra o recurso do aplicativo lógico.

2. Com base no tipo de aplicativo lógico que você tem, Consumo ou Standard:

   • Consumo: no menu lateral do recurso, em Ferramentas de Desenvolvimento, selecione o designer para abrir o fluxo de trabalho.

   • Padrão: no menu da barra lateral do recurso, em Fluxos de Trabalho, selecione Fluxos de Trabalho. Selecione o fluxo de trabalho que começa com o acionador do conector gerenciado FTP. No menu da barra lateral do fluxo de trabalho, selecione o designer para abrir o fluxo de trabalho.

3. No designer, siga estas etapas gerais para adicionar a ação FTP chamada Obter metadados de arquivo ao fluxo de trabalho.

4. Se preciso, forneça as informações sobre a sua conexão. Quando terminar, selecione Criar novo.

   

   Observação

   Por padrão, esse conector transfere arquivos no formato de texto. Para transferir arquivos no formato binário, como nos casos em que é usada codificação, selecione a opção de transporte binário.

5. No painel de informações da ação que é aberto, selecione dentro de Arquivo para mostrar as opções de entrada. Selecione o ícone relâmpago para abrir a lista de conteúdo dinâmico.

   Agora você pode selecionar saídas do gatilho anterior.

6. Na lista de conteúdo dinâmico, em Quando um arquivo for adicionado ou modificado (somente propriedades), selecione Lista de Ids de Arquivos.

   

   A propriedade File agora faz referência à saída do gatilho Lista de Ids de Arquivos.

   

7. No designer, siga estas etapas gerais para adicionar a ação FTP chamada Obter conteúdo de arquivo ao seu fluxo de trabalho.

8. No painel de informações da ação exibido, selecione a opção Arquivo para mostrar as opções de entrada. Selecione o ícone relâmpago para abrir a lista de conteúdo dinâmico.

   Agora você pode selecionar saídas do gatilho ou de ações anteriores.

9. Na lista de conteúdo dinâmico, em Obter metadados do arquivo, selecione Id.

   

   A propriedade File agora faz referência à saída da ação Id.

   

10. Adicione outras ações necessárias ao seu fluxo de trabalho.

11. Quando terminar, salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Testar seu fluxo de trabalho

Para verificar se o fluxo de trabalho retorna o conteúdo esperado, adicione outra ação que lhe envie o conteúdo do arquivo carregado ou atualizado. Este exemplo usa a ação do Office 365 Outlook chamada Enviar um email.

Fluxo de trabalho com gatilho interno e ações

Para adicionar uma ação do Outlook do Office 365 ao fluxo de trabalho Standard:

1. No designer, na ação Obter conteúdo do arquivo , siga estas etapas gerais para adicionar a ação chamada Enviar um email ao seu fluxo de trabalho.

   Se você tiver uma conta Outlook.com, adicione a ação Enviar um email do Outlook.com.

2. Se solicitado, entre na sua conta de email.

3. No painel de informações de ação, forneça os valores necessários e inclua quaisquer outros parâmetros ou propriedades que você deseja testar.

   Por exemplo, você pode incluir a saída Conteúdo do arquivo da ação Obter conteúdo do arquivo. Para localizar essa saída, siga estas etapas:

   1. Na ação Obter conteúdo do arquivo , selecione dentro do Corpo para mostrar as opções de entrada. Selecione o ícone relâmpago para abrir a lista de conteúdo dinâmico. Nesta lista, em Obter conteúdo do arquivo, selecione Conteúdo do arquivo.

      

   2. Na lista de conteúdo dinâmico, em Obter conteúdo do arquivo, selecione Conteúdo do arquivo.

      A propriedade Body agora contém a saída da ação Conteúdo do Arquivo.

      

4. Salve seu fluxo de trabalho.

Para executar e disparar o fluxo de trabalho, siga estas etapas:

1. Na barra de ferramentas do designer, selecione Executar>Execução.

2. Adicione um arquivo à pasta FTP que seu fluxo de trabalho monitora.

Fluxo de trabalho com gatilho e ações gerenciados

Para adicionar uma ação do Outlook do Office 365 ao seu fluxo de trabalho de Consumo ou Padrão:

1. No designer, na ação Obter conteúdo do arquivo , siga estas etapas gerais para adicionar a ação chamada Enviar um email ao seu fluxo de trabalho.

   Se você tiver uma conta Outlook.com, adicione a ação Enviar um email do Outlook.com.

2. Se solicitado, entre na sua conta de email.

3. Na caixa de informações de ação, forneça os valores necessários e inclua todos os outros parâmetros ou propriedades que você queira testar.

   Por exemplo, você pode incluir a saída Conteúdo do arquivo da ação Obter conteúdo do arquivo. Para localizar essa saída, siga estas etapas:

   1. Na ação Obter conteúdo do arquivo , selecione dentro da caixa Corpo para mostrar as opções de entrada. Selecione o ícone relâmpago para abrir a lista de conteúdo dinâmico. Nesta lista, em Obter conteúdo do arquivo, selecione Conteúdo do arquivo.

      

   2. Na lista de conteúdo dinâmico, em Obter conteúdo do arquivo, selecione Conteúdo do arquivo.

      A propriedade Body agora contém a saída da ação Conteúdo do Arquivo.

      

4. Salve o fluxo de trabalho do aplicativo lógico.

Para executar e disparar o fluxo de trabalho, siga estas etapas:

1. Na barra de ferramentas do designer, selecione Executar>Execução.

2. Adicione um arquivo à pasta FTP que seu fluxo de trabalho monitora.

Conteúdo relacionado

• Conectores gerenciados dos Aplicativos Lógicos do Azure
• Conectores internos de Aplicativos Lógicos do Azure
• O que são os conectores nos Aplicativos Lógicos do Azure