Partilhar via


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 de instruções mostra como acessar um compartilhamento de arquivos local a partir de um fluxo de trabalho nos Aplicativos Lógicos do Azure usando o conector do Sistema de Arquivos. 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 Environment Versão do conector
Consumo Aplicativos Lógicos do Azure Multilocatários Conector gerenciado, que aparece na galeria de conectores em Runtime>Shared. 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
Standard 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 Runtime>Shared, e conector interno, que aparece na galeria de conectores em Runtime>In-App 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 de aplicativos lógicos de consumo

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

        1. Instale o 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. Crie um recurso de gateway de dados local no Azure.

        3. Depois de adicionar um gatilho ou ação do conector gerenciado pelo sistema de arquivos ao seu fluxo de trabalho, selecione o recurso de gateway de dados que você criou anteriormente para que possa se conectar ao seu sistema de arquivos.

    • 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 de instruções, 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 tiver uma conta de consumidor do Gmail, pode utilizar este conector apenas com serviços específicos aprovados pela Google ou pode criar uma aplicação cliente Google para utilizar na 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 Sistema de arquivos de exemplo, você precisa de uma conta do Dropbox, na qual você pode se inscrever gratuitamente.

  • O fluxo de trabalho do aplicativo lógico onde você deseja acessar seu compartilhamento de arquivos. Para iniciar seu fluxo de trabalho com um gatilho de Sistema de Arquivos, você precisa começar com um fluxo de trabalho em branco. Para adicionar uma ação do Sistema de Arquivos, inicie seu fluxo de trabalho com qualquer gatilho.

Adicionar um gatilho de sistema de arquivos

  1. No portal do Azure, abra seu fluxo de trabalho de aplicativo lógico em branco no designer.

  2. No designer, siga estas etapas gerais para adicionar o gatilho de sistema de arquivos desejado ao seu fluxo de trabalho.

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

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

    Property Necessário Valor Description
    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 <local-computer>\<username.>
    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:

    Captura de tela mostrando o designer de fluxo de trabalho de consumo e informações de conexão para o gatilho do conector gerenciado pelo sistema de arquivos.

  4. 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.

  5. 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.

      Captura de tela mostrando o designer de fluxo de trabalho de consumo e o gatilho chamado Quando um arquivo é criado.

    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.

      Captura de tela mostrando o designer de fluxo de trabalho de consumo, o gatilho de conector gerenciado chamado Quando um arquivo é criado e a ação chamada Enviar um 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.

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

  1. No portal do Azure, abra o fluxo de trabalho do aplicativo lógico no designer.

  2. No designer, siga estas etapas gerais para adicionar a ação Sistema de Arquivos desejada ao seu fluxo de trabalho.

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

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

    Property Necessário Valor Description
    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 <local-computer>\<username.>
    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 a ação do conector gerenciado do sistema de arquivos:

    Captura de tela mostrando informações de conexão para a ação do conector gerenciado pelo sistema de arquivos.

  4. 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 a ação selecionada.

  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.

      Captura de tela mostrando o designer de fluxo de trabalho de consumo e a ação do conector gerenciado do sistema de arquivos chamada Criar arquivo.

      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.

      Captura de tela mostrando o designer de fluxo de trabalho de consumo, a ação

  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.

Próximos passos