Repositórios de arquivos: quais a Dattos conecta e como cadastrar
Um repositório de arquivos é o lugar onde os sistemas da sua empresa depositam e guardam arquivos: extratos, relatórios de sistemas legados, arquivos de retorno. Conectando o repositório à Dattos, os processos passam a buscar os arquivos de entrada sozinhos e a entregar os arquivos exportados direto no destino, sem envio nem download manual.
A integração tem duas partes:
Cadastrar a conexão com o repositório, uma vez, em Credenciais. É o que este artigo explica.
Ligar cada processo às pastas do repositório, pelo Diretório de Origem e pelo Diretório de Saída. Veja Integração com repositórios de arquivos: diretórios de origem e de saída.
Repositórios com integração nativa
Tipo de credencial | Quando usar | Tutorial |
|---|---|---|
SFTP - Senha e SFTP - Chave SSH | Servidor SFTP da empresa ou de um parceiro (banco, adquirente, ERP que gera arquivo) | |
FTP | Servidor FTP que ainda não oferece SFTP | |
Amazon S3 | Bucket na AWS | |
Azure Blob Storage | Container numa conta de armazenamento do Azure | |
Google Cloud Storage | Bucket no Google Cloud |
SharePoint: não tem integração nativa. Se a sua empresa precisa buscar ou entregar arquivos no SharePoint, fale com o time de consultoria da Dattos para avaliar uma integração sob medida. Veja também Integrações customizadas via API Rest e conectores SQL.
O que preparar no seu lado
Antes de cadastrar, combine com o time de TI responsável pelo repositório:
Um acesso exclusivo para a Dattos, com usuário, chave ou conta de serviço próprios. Assim, a sua empresa consegue revogar o acesso sem afetar outros sistemas.
Permissão para ler, gravar, mover e apagar arquivos nas pastas que a Dattos vai usar. A plataforma lê os arquivos de entrada, move cada um para subpastas de controle (
.processing,.processede.error) e grava os arquivos exportados. Com permissão só de leitura, a execução falha.As pastas já criadas. A plataforma lista as pastas que existem no repositório; ela não cria a pasta de origem para você.
Servidor SFTP ou FTP acessível pela internet. A plataforma não se conecta a endereços de rede interna (por exemplo,
10.x.x.x,172.16.x.xa172.31.x.x,192.168.x.x) nem a servidores que só existem dentro da VPN da empresa. Se o servidor só aceita conexões de endereços liberados, peça ao suporte da Dattos os endereços que devem ser liberados no firewall.
Cadastrar a conexão
Clique no ícone de engrenagem, no canto superior direito, e abra Geral › Credenciais.
Clique em + Nova credencial.
Na aba Armazenamento, escolha o tipo do repositório.
Preencha o Nome da credencial. É o nome que vai aparecer em Integração de Armazenamento nas configurações do processo; use algo que identifique o repositório, como "SFTP Banco X - extratos".
Preencha os campos do tipo escolhido. O tutorial de cada tipo explica onde conseguir cada informação.
Em Perfis de privacidade, escolha quem pode usar a credencial. Só quem tem um desses perfis vê o repositório na hora de configurar um processo.
Clique em Salvar.
Os campos sensíveis (senha, chave, JSON da conta de serviço) não voltam a ser exibidos depois de salvos. Ao editar, deixe o campo em branco para manter o valor atual.
Conferir se a conexão funciona
SFTP: depois de salvar, abra a credencial de novo e clique em Testar conexão. O teste confirma que o servidor responde no endereço e na porta informados, mas não confere usuário e senha nem a chave.
Amazon S3, Azure Blob Storage, Google Cloud Storage e FTP: não têm o botão Testar conexão.
Para todos os tipos, a forma de confirmar o acesso completo é abrir o Diretório de Origem de um processo Turbo AI, clicar em Editar, Adicionar destino e escolher o repositório em Integração de Armazenamento. Se a lista de Pastas de Importação carregar, a conexão e as permissões de leitura estão certas. Se aparecer uma mensagem de erro, revise os dados seguindo o tutorial do seu tipo.
Manter a conexão
Trocar senha ou chave: edite a credencial e preencha só o campo que mudou. Todos os processos que usam a credencial passam a usar o valor novo.
Desativar: a credencial deixa de aparecer para novos vínculos, e os processos que a usam mostram Integração indisponível no editor do diretório. Para editar uma credencial inativa, reative-a primeiro.
Excluir: só é possível quando nenhum processo usa a credencial. A coluna Processos da lista de credenciais mostra quantos processos estão ligados; ao tentar excluir, a plataforma lista quais são.