Compartilhar via


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

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Standard)

Este guia mostra como acessar um compartilhamento de arquivos local 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 disparados por eventos em seu compartilhamento de arquivos ou em outros sistemas e executar ações para gerenciar seus arquivos. O conector fornece as seguintes capacidades:

  • Criar, obter, acrescentar, atualizar e excluir arquivos.
  • Listar arquivos em pastas ou pastas raiz.
  • Obter conteúdo e metadados do arquivo.

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

  • Disparar um fluxo de trabalho quando um arquivo é criado ou adicionado a um compartilhamento de arquivos e enviar um email.
  • Disparar um fluxo de trabalho ao copiar um arquivo de uma conta do Dropbox para um compartilhamento de arquivos e enviar um email.

Limitações e problemas conhecidos

  • Atualmente, o conector do Sistema de Arquivos só dá suporte a 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 do host.

Aplicativo lógico Ambiente Versão do conector
Consumo Aplicativos Lógicos Multilocatários do Azure Conector gerenciado, que é exibido na galeria de conectores sob Compartilhado. Para saber mais, 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 de locatário único e Ambiente do Serviço de Aplicativo v3 (somente planos Windows) Conector gerenciado, que aparece na galeria e conectores em Compartilhado e conector interno, que aparece na galeria de conectores em Interno e é baseado no provedor de serviços. O conector interno é diferente das seguintes maneiras:

- O conector interno dá suporte apenas a aplicativos lógicos Standard que são executados em um Ambiente do Serviço de Aplicativo v3 somente 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 saber mais, consulte a seguinte documentação:

- Referência do conector gerenciado do Sistema de Arquivos
- Referência do conector interno do Sistema de Arquivos
- Conectores internos em Aplicativos Lógicos do Azure

Pré-requisitos

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

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

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

    • Fluxos de trabalho de aplicativo lógico 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 nos Aplicativos Lógicos do Azure multilocatários.

      • Para usar o conector interno do Sistema de Arquivos, o fluxo de trabalho do aplicativo lógico Standard 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 tem o sistema de arquivos que você deseja usar. Por exemplo, se você instalar o gateway de dados no mesmo computador que seu sistema de arquivos, precisará das credenciais da conta nesse computador.

  • Para seguir o cenário de exemplo neste guia, você precisa de uma conta de email de um provedor com suporte dos Aplicativos Lógicos do Azure, como o Office 365 Outlook, Outlook.com ou Gmail. Para outros provedores, examine os outros conectores de email com suporte. Este exemplo usa o conector do Outlook do Office 365 com uma conta corporativa ou de estudante. Se você usar outra conta de email, as etapas gerais são as mesmos, mas a interface do usuário pode ser ligeiramente diferente.

    Importante

    Se você quiser usar o conector do Gmail, somente as contas comerciais do G Suite poderão usar esse conector sem restrição nos aplicativos lógicos. Se você tiver uma conta de consumidor do Gmail, poderá usar esse conector apenas com serviços específicos aprovados pelo Google ou criar um aplicativo cliente do Google para usar para 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.

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

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

    Para iniciar seu fluxo de trabalho com um gatilho do 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 ajuste ao seu cenário.

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

Adicionar um gatilho do Sistema de Arquivos

  1. No portal do Azure, abra o recurso de aplicativo lógico de Consumo.

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

  3. Adicione o gatilho do 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 Quando um arquivo é criado.

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

    Propriedade Obrigatório Valor Descrição
    Nome da conexão Sim < nome-da-conexão> O nome a usar para a conexão
    Pasta raiz Sim < root-folder-name> A pasta raiz do sistema de arquivos, que geralmente é a pasta pai principal e é a pasta usada para os caminhos relativos com todos os gatilhos que funcionam nos 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 do compartilhamento de rede em que o computador pode acessar essa pasta, por exemplo, \PublicShare\MyFileSystem.
    Tipo de Autenticação Não < tipo de autenticação> O tipo de autenticação usado pelo servidor do sistema de arquivos, que é Windows
    Nome de usuário Sim < domínio-e-nome-de-usuário> O domínio e o nome de usuário do computador em que você tem o sistema de arquivos.

    Para o conector do Sistema de Arquivos gerenciado, use um dos seguintes valores com a barra invertida (\):

    - < domínio>\<nome de usuário>
    - < computador-local>\<nome de usuário>

    Por exemplo, se sua pasta do sistema de arquivos estiver no mesmo computador que a instalação do gateway de dados local, você poderá usar <computador-local>\<nome de usuário>.
    Senha Sim < Senha> A senha do computador no qual você tem seu sistema de arquivos
    Gateway Não - <Azure-subscription>

    - <nome-do-recurso-de-gateway>
    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 do 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 as informações de conexão para o gatilho do conector gerenciado do Sistema de Arquivos.

  5. Quando terminar, selecione Criar novo.

    Os Aplicativos Lógicos do Azure criam e testam a conexão, garantindo seu funcionamento correto. Se a conexão estiver configurada corretamente, as opções de instalação aparecerão para o gatilho selecionado.

  6. Continue criando o fluxo de trabalho.

    1. Forneça as informações necessárias para o 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 arquivos a serem retornados e com que frequência deseja verificar.

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

    2. Para testar o 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, o assunto e o corpo do email. Para testar, você pode usar seu próprio endereço de email.

      Captura de tela mostrando o designer de fluxo de trabalho consumo, o gatilho do conector gerenciado chamado Quando um arquivo é criado e a ação chamada Enviar um email.

      Dica

      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 terminar, salve o fluxo de trabalho.

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

Se tiver êxito, o fluxo de trabalho enviará um email 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 Dropbox, mas você pode usar qualquer gatilho desejado.

  1. No portal do Azure, abra o recurso de aplicativo lógico de Consumo.

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

  3. Adicione a ação sistema de arquivos que você deseja para o 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 Criar arquivo.

  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 o fluxo de trabalho.

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

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

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

      Dica

      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 o fluxo de trabalho, adicione uma ação do Outlook que envia um email quando a ação do Sistema de Arquivos cria um arquivo. Insira os destinatários, o assunto e o corpo do email. Para testar, você pode usar seu próprio endereço de email.

      Captura de tela mostrando o designer de fluxo de trabalho consumo, o conector gerenciado Criar ação de arquivo e enviar uma ação de email.

  6. Quando terminar, salve o fluxo de trabalho.

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

Se tiver êxito, o fluxo de trabalho criará um arquivo no servidor do sistema de arquivos com base no arquivo carregado no DropBox e enviará um email sobre o arquivo criado.