Conectar-se a sistemas de arquivos locais a partir de fluxos de trabalho nos Aplicativos Lógicos do Azure

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

Este guia mostra como aceder a uma partilha de ficheiros local a partir de um fluxo de trabalho nas Logic Apps do Azure usando o conector do Sistema de Ficheiros. Em seguida, você pode criar fluxos de trabalho automatizados que são executados quando acionados por eventos em seu compartilhamento de arquivos ou em outros sistemas e executar ações para gerenciar seus arquivos. O conector fornece os seguintes recursos:

• Crie, obtenha, anexe, atualize e exclua arquivos.
• Liste arquivos em pastas ou pastas raiz.
• Obtenha conteúdo e metadados de arquivos.

Neste guia de instruções, os cenários de exemplo demonstram as seguintes tarefas:

• Acione um fluxo de trabalho quando um arquivo for criado ou adicionado a um compartilhamento de arquivos e, em seguida, envie um email.
• Acione um fluxo de trabalho ao copiar um arquivo de uma conta do Dropbox para um compartilhamento de arquivos e, em seguida, envie um e-mail.

Problemas conhecidos e de limitações

• Atualmente, o conector do sistema de arquivos suporta apenas sistemas de arquivos do Windows em sistemas operacionais Windows.
• Não há suporte para unidades de rede mapeadas.

Referência técnica do conector

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

Aplicação lógica	Meio Ambiente	Versão do conector
Consumo	Aplicativos Lógicos do Azure Multilocatários	Conector gerenciado, que aparece na galeria de conectores em Compartilhado. Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado do sistema de arquivos - Conectores gerenciados em Aplicativos Lógicos do Azure
Padrão	Aplicativos Lógicos do Azure e Ambiente do Serviço de Aplicativo v3 de locatário único (somente planos do Windows)	Conector gerenciado, que aparece na galeria de conectores em Compartilhado, e conector interno, que aparece na galeria de conectores em Interno e é baseado em provedor de serviços. O conector embutido difere das seguintes maneiras: - O conector integrado suporta apenas aplicativos lógicos padrão que são executados em um Ambiente do Serviço de Aplicativo v3 apenas com planos do Windows. - A versão interna pode se conectar diretamente a um compartilhamento de arquivos e acessar redes virtuais do Azure usando uma cadeia de conexão sem um gateway de dados local. Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado do sistema de arquivos - Referência do conector integrado do sistema de arquivos - Conectores internos nos Aplicativos Lógicos do Azure

Pré-requisitos

• Uma conta e subscrição do Azure. Se não tiver uma subscrição do Azure, inscreva-se para obter uma conta do Azure gratuita.

• Para se conectar ao seu compartilhamento de arquivos, diferentes requisitos se aplicam, com base em seu aplicativo lógico e no ambiente de hospedagem:

  • Fluxos de trabalho do aplicativo de lógica de consumo:

    • Nos Aplicativos Lógicos do Azure multilocatário, você precisa atender aos seguintes requisitos, se ainda não o fez:

      1. Instale um gateway de dados local em um computador local.

         O conector gerenciado do sistema de arquivos requer que a instalação do gateway e o servidor do sistema de arquivos existam no mesmo domínio do Windows.

      2. Conecte-se a fontes de dados locais dos Aplicativos Lógicos do Azure.

      3. Na operação Sistema de Arquivos adicionada, selecione o recurso de gateway de dados criado anteriormente.

  • Fluxos de trabalho de aplicativos lógicos padrão:

    Você pode usar o conector interno do sistema de arquivos ou o conector gerenciado.

    • Para usar o conector gerenciado do Sistema de Arquivos , siga os mesmos requisitos de um fluxo de trabalho de aplicativo lógico de consumo em Aplicativos Lógicos do Azure multilocatário.

    • Para usar o conector interno do Sistema de Arquivos , o fluxo de trabalho do aplicativo lógico padrão deve ser executado no Ambiente do Serviço de Aplicativo v3, mas não requer o recurso de gateway de dados.

• Acesso ao computador que possui o sistema de arquivos que você deseja usar. Por exemplo, se você instalar o gateway de dados no mesmo computador que o sistema de arquivos, precisará das credenciais da conta desse computador.

• Para seguir o cenário de exemplo neste guia, você precisa de uma conta de email de um provedor compatível com os Aplicativos Lógicos do Azure, como o Office 365 Outlook, o Outlook.com ou o Gmail. Para outros provedores, consulte outros conectores de e-mail suportados. Este exemplo usa o conector do Outlook do Office 365 com uma conta corporativa ou de estudante. Se utilizar outra conta de e-mail, os passos gerais são os mesmos, mas a IU poderá ser ligeiramente diferente.

  Importante

  Se você quiser usar o conector do Gmail, apenas as contas comerciais do G-Suite poderão usar esse conector sem restrições em aplicativos lógicos. Se você tiver uma conta de consumidor do Gmail, poderá usar esse conector somente com serviços específicos aprovados pelo Google ou poderá criar um aplicativo cliente do Google para usar para autenticação com o conector do Gmail. Para obter mais informações, consulte Políticas de segurança e privacidade de dados para conectores do Google em Aplicativos Lógicos do Azure.

• Para o cenário de ação de exemplo do Sistema de Ficheiros, necessita de uma conta do Dropbox. Você pode se inscrever gratuitamente.

• O recurso de aplicativo lógico com o fluxo de trabalho onde você deseja acessar seu compartilhamento de arquivos.

  Para iniciar seu fluxo de trabalho com um gatilho de Sistema de Arquivos , você precisa ter um fluxo de trabalho em branco.

  Para usar uma ação do Sistema de Arquivos , seu fluxo de trabalho pode começar com qualquer gatilho que melhor se adapte ao seu cenário.

  Se você não tiver um recurso de aplicativo lógico e fluxo de trabalho, consulte os seguintes artigos:

  • Criar um exemplo de fluxo de trabalho do aplicativo lógico de consumo
  • Criar um exemplo de fluxo de trabalho de aplicativo lógico padrão

Adicionar um gatilho de sistema de arquivos

Consumo

1. No portal Azure, abra o recurso da aplicação lógica de consumo.

2. Nos menus da barra lateral de recursos, em Ferramentas de Desenvolvimento, selecione o designer para abrir seu fluxo de trabalho em branco.

3. Adicione o gatilho de sistema de arquivos desejado para seu cenário seguindo as etapas gerais para adicionar um gatilho.

   Para obter mais informações, consulte Gatilhos do sistema de arquivos. Este exemplo continua com o gatilho chamado When a file is created.

4. Na caixa de informações de conexão, forneça as seguintes informações, conforme necessário:

   Propriedade	Necessário	Valor	Descrição
   Nome da ligação	Sim	< nome da conexão>	O nome a utilizar para a sua ligação
   Pasta raiz	Sim	< nome-da-pasta-raiz>	A pasta raiz do seu sistema de arquivos, que geralmente é a pasta pai principal e é a pasta usada para os caminhos relativos com todos os gatilhos que funcionam em arquivos. Por exemplo, se você instalou o gateway de dados local, use a pasta local no computador com a instalação do gateway de dados. Ou, use a pasta para o compartilhamento de rede onde o computador pode acessar essa pasta, por exemplo, \PublicShare\MyFileSystem.
   Tipo de Autenticação	Não	< tipo auth>	O tipo de autenticação que o servidor do sistema de arquivos usa, que é o Windows
   Nome de utilizador	Sim	< domínio e nome de utilizador>	O domínio e o nome de utilizador do computador onde tem o seu sistema de ficheiros. Para o conector do sistema de arquivos gerenciado, use um dos seguintes valores com a barra invertida (\): - < domínio>\<nome de utilizador> - < local-computador>\<nome de usuário> Por exemplo, se a pasta do sistema de arquivos estiver no mesmo computador que a instalação do gateway de dados local, você poderá usar <
   Palavra-passe	Sim	< palavra-passe>	A palavra-passe do computador onde tem o seu sistema de ficheiros
   Porta de entrada	Não	- <Subscrição do Azure> - <gateway-resource-name>	Esta seção se aplica somente ao conector do sistema de arquivos gerenciado: - Assinatura: a assinatura do Azure associada ao recurso de gateway de dados - Gateway de conexão: o recurso de gateway de dados

   O exemplo a seguir mostra as informações de conexão para o gatilho do conector gerido do Sistema de Ficheiros.

   

5. Quando terminar, selecione Criar novo.

   As Aplicações Lógicas do Azure criam e testam a sua ligação, certificando-se de que a ligação funciona corretamente. Se a conexão estiver configurada corretamente, as opções de configuração aparecerão para o gatilho selecionado.

6. Continue criando seu fluxo de trabalho.

   1. Forneça as informações necessárias para o seu gatilho.

      Para este exemplo, selecione o caminho da pasta no servidor do sistema de arquivos para verificar se há um arquivo recém-criado. Especifique o número de ficheiros a devolver e a frequência com que pretende verificar.

      

   2. Para testar seu fluxo de trabalho, adicione uma ação do conector do Outlook que envia um email quando um arquivo é criado no sistema de arquivos na pasta especificada. Insira os destinatários do e-mail, o assunto e o corpo. Para testes, você pode usar seu próprio endereço de e-mail.

      

      Gorjeta

      Para adicionar saídas de etapas anteriores no fluxo de trabalho, selecione dentro das caixas de edição do gatilho. Quando a lista de conteúdo dinâmico for exibida, selecione entre as saídas disponíveis.

7. Quando tiver terminado, guarde o fluxo de trabalho.

8. Para testar seu fluxo de trabalho, carregue um arquivo, que aciona o fluxo de trabalho.

Se for bem-sucedido, seu fluxo de trabalho enviará um e-mail sobre o novo arquivo.

Padrão

Gatilho de conector integrado

As etapas a seguir se aplicam somente a fluxos de trabalho de aplicativos lógicos padrão em um Ambiente do Serviço de Aplicativo v3 apenas com planos do Windows.

1. No portal do Azure, abra seu recurso de aplicativo lógico padrão.

2. No menu da barra lateral do recurso, em Fluxos de trabalho, selecione Fluxos de trabalho e, em seguida, selecione o fluxo de trabalho em branco.

3. No menu da barra lateral do fluxo de trabalho, em Ferramentas, selecione o designer para abrir o fluxo de trabalho em branco.

4. Adicione o gatilho interno do Sistema de Arquivos que você deseja para seu cenário seguindo as etapas gerais para adicionar um gatilho.

   Para obter mais informações, consulte Gatilhos do sistema de arquivos. Este exemplo continua com o gatilho chamado When a file is added.

5. Na caixa de informações de conexão, forneça as seguintes informações, conforme necessário:

   Propriedade	Necessário	Valor	Descrição
   Nome da ligação	Sim	< nome da conexão>	O nome a utilizar para a sua ligação
   Pasta raiz	Sim	< nome-da-pasta-raiz>	A pasta raiz do seu sistema de arquivos, que geralmente é a pasta pai principal e é a pasta usada para os caminhos relativos com todos os gatilhos que funcionam em arquivos. Por exemplo, se você instalou o gateway de dados local, use a pasta local no computador com a instalação do gateway de dados. Ou, use a pasta para o compartilhamento de rede onde o computador pode acessar essa pasta, por exemplo, \PublicShare\MyFileSystem.
   Nome de utilizador	Sim	< domínio e nome de utilizador>	O domínio e o nome de utilizador do computador onde tem o seu sistema de ficheiros. Para o conector do sistema de arquivos gerenciado, use um dos seguintes valores com a barra invertida (\): - < domínio>\<nome de utilizador> - < local-computador>\<nome de usuário>
   Palavra-passe	Sim	< palavra-passe>	A palavra-passe do computador onde tem o seu sistema de ficheiros

   O exemplo a seguir mostra as informações de conexão para o gatilho de conector interno do sistema de arquivos:

   

6. Quando terminar, selecione Criar novo.

   As Aplicações Lógicas do Azure criam e testam a sua ligação, certificando-se de que a ligação funciona corretamente. Se a conexão estiver configurada corretamente, as opções de configuração aparecerão para o gatilho selecionado.

7. Continue criando seu fluxo de trabalho.

   1. Forneça as informações necessárias para o seu gatilho.

      Para este exemplo, selecione o caminho da pasta no servidor do sistema de arquivos para verificar se há um arquivo recém-adicionado. Especifique a frequência com que pretende verificar.

      

   2. Para testar seu fluxo de trabalho, adicione uma ação do Outlook que envie um email quando um arquivo for adicionado ao sistema de arquivos na pasta especificada. Insira os destinatários do e-mail, o assunto e o corpo. Para testes, você pode usar seu próprio endereço de e-mail.

      

      Gorjeta

      Para adicionar saídas de etapas anteriores no fluxo de trabalho, selecione dentro das caixas de edição do gatilho. Depois que as opções da lista de conteúdo dinâmico e do editor de expressões forem exibidas, selecione a lista de conteúdo dinâmico (ícone relâmpago). Quando a lista de conteúdo dinâmico for exibida, selecione entre as saídas disponíveis.

8. Quando tiver terminado, guarde o fluxo de trabalho.

9. Para testar seu fluxo de trabalho, carregue um arquivo, que aciona o fluxo de trabalho.

Se for bem-sucedido, seu fluxo de trabalho enviará um e-mail sobre o novo arquivo.

Gatilho de conector gerenciado

1. No portal do Azure, abra seu recurso de aplicativo lógico padrão.

2. No menu da barra lateral de recursos, em Fluxos de trabalho, selecione Fluxos de trabalho e selecione seu fluxo de trabalho em branco.

3. No menu da barra lateral do fluxo de trabalho, em Ferramentas, selecione o designer para abrir o fluxo de trabalho em branco.

4. Adicione o gatilho do conector gerenciado do sistema de arquivos seguindo as etapas gerais para adicionar um gatilho.

   Para obter mais informações, consulte Gatilhos do sistema de arquivos. Este exemplo continua com o gatilho chamado When a file is created.

5. Na caixa de informações de conexão, forneça as seguintes informações, conforme necessário:

   Propriedade	Necessário	Valor	Descrição
   Nome da ligação	Sim	< nome da conexão>	O nome a utilizar para a sua ligação
   Pasta raiz	Sim	< nome-da-pasta-raiz>	A pasta raiz do seu sistema de arquivos, que geralmente é a pasta pai principal e é a pasta usada para os caminhos relativos com todos os gatilhos que funcionam em arquivos. Por exemplo, se você instalou o gateway de dados local, use a pasta local no computador com a instalação do gateway de dados. Ou, use a pasta para o compartilhamento de rede onde o computador pode acessar essa pasta, por exemplo, \PublicShare\MyFileSystem.
   Tipo de Autenticação	Não	< tipo auth>	O tipo de autenticação que o servidor do sistema de arquivos usa, que é o Windows
   Nome de utilizador	Sim	< domínio e nome de utilizador>	O domínio e o nome de utilizador do computador onde tem o seu sistema de ficheiros. Para o conector do sistema de arquivos gerenciado, use um dos seguintes valores com a barra invertida (\): - < domínio>\<nome de utilizador> - < local-computador>\<nome de usuário> Por exemplo, se a pasta do sistema de arquivos estiver no mesmo computador que a instalação do gateway de dados local, você poderá usar <
   Palavra-passe	Sim	< palavra-passe>	A palavra-passe do computador onde tem o seu sistema de ficheiros
   porta de entrada	Não	- <Subscrição do Azure> - <gateway-resource-name>	Esta seção se aplica somente ao conector do sistema de arquivos gerenciado: - Assinatura: a assinatura do Azure associada ao recurso de gateway de dados - Gateway de conexão: o recurso de gateway de dados

   O exemplo a seguir mostra as informações de conexão para o gatilho do conector gerenciado do sistema de arquivos:

   

6. Quando tiver terminado, selecione Criar.

   As Aplicações Lógicas do Azure criam e testam a sua ligação, certificando-se de que a ligação funciona corretamente. Se a conexão estiver configurada corretamente, as opções de configuração aparecerão para o gatilho selecionado.

7. Continue criando seu fluxo de trabalho.

   1. Forneça as informações necessárias para o seu gatilho.

      Para este exemplo, selecione o caminho da pasta no servidor do sistema de arquivos para verificar se há um arquivo recém-criado. Especifique o número de ficheiros a devolver e a frequência com que pretende verificar.

      

   2. Para testar seu fluxo de trabalho, adicione uma ação do Outlook que envie um email quando um arquivo for criado no sistema de arquivos na pasta especificada. Insira os destinatários do e-mail, o assunto e o corpo. Para testes, você pode usar seu próprio endereço de e-mail.

      

      Gorjeta

      Para adicionar saídas de etapas anteriores no fluxo de trabalho, selecione dentro das caixas de edição do gatilho. Depois que as opções da lista de conteúdo dinâmico e do editor de expressões forem exibidas, selecione a lista de conteúdo dinâmico (ícone relâmpago). Quando a lista de conteúdo dinâmico for exibida, selecione entre as saídas disponíveis.

8. Quando tiver terminado, guarde o fluxo de trabalho.

9. Para testar seu fluxo de trabalho, carregue um arquivo, que aciona o fluxo de trabalho.

Se for bem-sucedido, seu fluxo de trabalho enviará um e-mail sobre o novo arquivo.

Adicionar uma ação do sistema de arquivos

O fluxo de trabalho do aplicativo lógico de exemplo começa com o gatilho do Dropbox, mas você pode usar qualquer gatilho que desejar.

Consumo

1. No portal Azure, abra o recurso da aplicação lógica de consumo.

2. No menu da barra lateral de recursos, em Ferramentas de Desenvolvimento, selecione o designer para abrir seu fluxo de trabalho.

3. Adicione a ação Sistema de Arquivos desejada para seu cenário seguindo as etapas gerais para adicionar uma ação.

   Para obter mais informações, consulte Gatilhos do sistema de arquivos. Este exemplo continua com a ação chamada Create file.

4. Se solicitado, forneça suas informações de conexão. Para obter mais informações, consulte a tabela na seção anterior.

5. Continue criando seu fluxo de trabalho.

   1. Forneça as informações necessárias para a sua ação.

      Para este exemplo, selecione o caminho da pasta no servidor do sistema de arquivos a ser usado, que é a pasta raiz aqui. Digite o nome e o conteúdo do arquivo, com base no arquivo enviado para o Dropbox.

      

      Gorjeta

      Para adicionar saídas de etapas anteriores no fluxo de trabalho, selecione dentro das caixas de edição da ação. Quando a lista de conteúdo dinâmico for exibida, selecione entre as saídas disponíveis.

   2. Para testar seu fluxo de trabalho, adicione uma ação do Outlook que envie um email quando a ação Sistema de arquivos criar um arquivo. Insira os destinatários do e-mail, o assunto e o corpo. Para testes, você pode usar seu próprio endereço de e-mail.

      

6. Quando tiver terminado, guarde o fluxo de trabalho.

7. Para testar seu fluxo de trabalho, carregue um arquivo, que aciona o fluxo de trabalho.

Se for bem-sucedido, seu fluxo de trabalho criará um arquivo no servidor do sistema de arquivos, com base no arquivo carregado no DropBox, e enviará um e-mail sobre o arquivo criado.

Padrão

Ação do conector integrado

Estas etapas aplicam-se apenas a aplicativos lógicos padrão em um Ambiente do Serviço de Aplicativo v3 apenas com planos do Windows.

1. No portal do Azure, abra seu recurso de aplicativo lógico padrão.

2. No menu da barra lateral de recursos, em Fluxos de trabalho, selecione Fluxos de trabalho e, em seguida, selecione o fluxo de trabalho.

3. No menu da barra lateral do fluxo de trabalho, em Ferramentas, selecione o designer para abrir o fluxo de trabalho.

4. Adicione a ação integrada Sistema de Ficheiros que o utilizador deseja para o seu cenário, seguindo as etapas gerais para adicionar uma ação.

   Para obter mais informações, consulte Ações do sistema de arquivos. Este exemplo continua com a ação chamada Create file.

5. Se solicitado, forneça suas informações de conexão. Para obter mais informações, consulte a tabela na seção Gatilho de conector interno .

6. Continue criando seu fluxo de trabalho.

   1. Forneça as informações necessárias para a sua ação. Para este exemplo, siga estes passos:

      1. Insira o caminho e o nome do arquivo que você deseja criar, incluindo a extensão de nome de arquivo. Verifique se o caminho é relativo à pasta raiz.

      2. Para especificar o conteúdo do arquivo criado no Dropbox, na lista Adicionar um parâmetro , selecione Conteúdo do arquivo.

      3. Depois que o parâmetro File content for exibido no painel de informações da ação, selecione dentro da caixa de edição do parâmetro.

      4. Depois que as opções da lista de conteúdo dinâmico e do editor de expressões forem exibidas, selecione a lista de conteúdo dinâmico (ícone relâmpago). Na lista exibida, na seção Quando um arquivo é criado , selecione Conteúdo do arquivo.

      Quando terminar, a saída do gatilho Conteúdo do Arquivo aparecerá no parâmetro Conteúdo do arquivo:

      

   2. Para testar seu fluxo de trabalho, adicione uma ação do Outlook que envie um email quando a ação Sistema de arquivos criar um arquivo. Insira os destinatários do e-mail, o assunto e o corpo. Para testes, você pode usar seu próprio endereço de e-mail.

      

7. Quando tiver terminado, guarde o fluxo de trabalho.

8. Para testar seu fluxo de trabalho, carregue um arquivo, que aciona o fluxo de trabalho.

Se for bem-sucedido, seu fluxo de trabalho criará um arquivo no servidor do sistema de arquivos, com base no arquivo carregado no DropBox, e enviará um e-mail sobre o arquivo criado.

Ação do conector gerenciado

1. No portal do Azure, abra seu recurso de aplicativo lógico padrão.

2. No menu da barra lateral de recursos, em Ferramentas de Desenvolvimento, selecione o designer para abrir seu fluxo de trabalho.

3. Adicione a ação do conector gerenciado do sistema de arquivos que você deseja para seu cenário seguindo as etapas gerais para adicionar uma ação.

   Para obter mais informações, consulte Ações do sistema de arquivos. Este exemplo continua com a ação chamada Create file.

4. Se solicitado, forneça suas informações de conexão. Para obter mais informações, consulte a tabela na seção Gatilho do conector gerenciado .

5. Continue criando seu fluxo de trabalho.

   1. Forneça as informações necessárias para a sua ação. Para este exemplo, siga estes passos:

      1. Insira o caminho e o nome do arquivo que você deseja criar, incluindo a extensão de nome de arquivo. Verifique se o caminho é relativo à pasta raiz.

      2. Para especificar o conteúdo do arquivo criado no Dropbox, na lista Adicionar um parâmetro , selecione Conteúdo do arquivo.

      3. Depois que o parâmetro File content for exibido no painel de informações da ação, selecione dentro da caixa de edição do parâmetro.

      4. Depois que as opções da lista de conteúdo dinâmico e do editor de expressões forem exibidas, selecione a lista de conteúdo dinâmico (ícone relâmpago). Na lista exibida, na seção Quando um arquivo é criado , selecione Conteúdo do arquivo.

      Quando terminar, a saída do gatilho Conteúdo do Arquivo aparecerá no parâmetro Conteúdo do arquivo:

      

   2. Para testar seu fluxo de trabalho, adicione uma ação do Outlook que envie um email quando a ação Sistema de arquivos criar um arquivo. Insira os destinatários do e-mail, o assunto e o corpo. Para testes, você pode usar seu próprio endereço de e-mail.

      

6. Quando tiver terminado, guarde o fluxo de trabalho.

7. Para testar seu fluxo de trabalho, carregue um arquivo, que aciona o fluxo de trabalho.

Se for bem-sucedido, seu fluxo de trabalho criará um arquivo no servidor do sistema de arquivos, com base no arquivo carregado no DropBox, e enviará um e-mail sobre o arquivo criado.

Conteúdo relacionado

• Conectores gerenciados para Aplicativos Lógicos do Azure
• Conectores internos para Aplicativos Lógicos do Azure