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 + Padrão)
Este guia de instruções 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 no seu compartilhamento de arquivo ou em outros sistemas e executam ações para gerenciar seus arquivos. O conector fornece os seguintes recursos:
- 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 aparece na galeria de conectores em Runtime>Shared. 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) | O conector gerenciado, que aparece na galeria de conectores em Runtime>Compartilhado, e o conector interno, que aparece na galeria de conectores em Runtime>No aplicativo e é baseado em provedor de serviços. O conector interno é diferente das seguintes maneiras: – A versão interna dá suporte apenas a aplicativos lógicos Standard executados em um Ambiente do Serviço de Aplicativo v3 e 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 lógico de consumo
Nos Aplicativos Lógicos do Azure multilocatário, você precisa atender aos seguintes requisitos, caso ainda não tenham sido atendidos:
Instalar 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.
Depois de adicionar um gatilho ou uma ação do conector gerenciado do Sistema de Arquivos ao fluxo de trabalho, selecione o recurso de gateway de dados criado anteriormente para que você possa se conectar ao sistema de arquivos.
Fluxos de trabalho do aplicativo lógico padrão
Você pode usar o conector do Sistema de Arquivos interno ou o conector gerenciado.
Se você quiser usar o conector gerenciado do Sistema de Arquivos, precisará seguir os mesmos requisitos que um fluxo de trabalho do aplicativo lógico 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 Standard precisará ser executado no Ambiente do Serviço de Aplicativo v3, mas não requererá 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 os cenários de exemplo neste guia de instruções, você precisará 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, examine os outros conectores de email com suporte. Este exemplo usa o conector do Office 365 Outlook 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 somente com serviços específicos do Google aprovados ou poderá 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, na qual pode inscrever-se gratuitamente.
O fluxo de trabalho de aplicativo lógico que você deseja acessar o compartilhamento de arquivos. Se você quiser iniciar o fluxo de trabalho com um gatilho do Sistema de Arquivos, precisará começar com um fluxo de trabalho em branco. Para adicionar uma ação do Sistema de Arquivos, inicie seu fluxo de trabalho com um gatilho.
Adicionar um gatilho do Sistema de Arquivos
No portal do Azure, abra o fluxo de trabalho do aplicativo de lógica vazio no designer.
No designer, siga estas etapas gerais para adicionar o gatilho Sistema de arquivos que você deseja para seu fluxo de trabalho.
Para obter mais informações, consulte Gatilhos do sistema de arquivos. Este exemplo continua com o gatilho chamado Quando um arquivo é criado.
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 Yes <connection-name> 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 <auth-type> 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 No - <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 dadosO seguinte exemplo mostra as informações de conexão para o gatilho do conector gerenciado do Sistema de Arquivos:
Quando terminar, selecione Criar.
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.
Continue criando o fluxo de trabalho.
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.
Para testar o fluxo de trabalho, adicione uma ação 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.
Dica
Para adicionar as saídas das etapas anteriores do 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.
Quando terminar, salve o fluxo de trabalho.
Para testar seu fluxo de trabalho, carregue um arquivo que dispare 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.
No portal do Azure, abra o fluxo de trabalho do aplicativo de lógica no designer.
No designer, siga estas etapas gerais para adicionar a ação Sistema de Arquivos que você deseja para seu fluxo de trabalho.
Para obter mais informações, consulte Gatilhos do sistema de arquivos. Este exemplo continua com a ação chamada Criar arquivo.
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 Yes <connection-name> 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 <auth-type> 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 No - <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 dadosO seguinte exemplo mostra as informações de conexão para a ação do conector gerenciado do Sistema de Arquivos:
Quando terminar, selecione Criar.
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 a ação selecionada.
Continue criando o fluxo de trabalho.
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.
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.
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.
Quando terminar, salve o fluxo de trabalho.
Para testar seu fluxo de trabalho, carregue um arquivo que dispare 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.
