08 - Integrador SFTP Cloud

01. OBJETIVO

Descrever as ações necessárias para a utilização do Integrador SFTP Cloud, para realizar troca de arquivos entre o SFTP em TOTVS CLOUD com as estação local de trabalho.

Esse integrador tem como objetivo facilitar a troca de arquivos e criar rotinas de sincronismo.

02. PRÉ-REQUISITOS

• .Net Core 7.0
  
  • Download: https://dotnet.microsoft.com/pt-br/download/dotnet/thank-you/runtime-aspnetcore-7.0.13-windows-hosting-bundle-installer
  • Download: https://dotnet.microsoft.com/pt-br/download/dotnet/thank-you/runtime-aspnetcore-7.0.13-windows-x64-installer
• Preferencialmente utilizar Google Chrome ou Microsoft Edge para realizar as configurações.

03. INSTALAÇÃO

1. Realizar o download do pacote de instalação em: Download TSyncCloudInstaller
2. Realizar a instalação a aplicação seguindo o fluxo abaixo:
   > Após realizar a instalação dos pré-requisitos (conforme item 1) e realizar o Download do instalador do TSyncCloudInstaller, execute o instalador em modo "Administrador"
   
   > Escolha a pasta de instalação na estação e clique em "Avançar".
   
   > Para confirmar a instalação, clique em "Instalar".
   
   > Após a conclusão da instalação, cliente em "Concluir".
   
   > Será carregado a tela da aplicação no navegador padrão utilizado na estação:
   
3. Adicione as aplicações do Integrador SFTP Cloud no inicialização do Windows:
   Em casos de erros ou problemas na instalação do DOSPrint como Serviço, basta adicionar a aplicação na inicialização do Windows, para isso, seguindo os passos abaixo:
   1. Crie um atalho das aplicações:
      > TCloudFileSync.Angular.exe | Que fica na pasta de instalação da aplicação: (..\TOTVS\TCloudFileSync.Setup\Frontend\TCloudFileSync.Angular.exe)
      > TCloudFileSync.Api.exe | Que fica na pasta de instalação da aplicação: (..\TOTVS\TCloudFileSync.Setup\Frontend\TCloudFileSync.Api.exe)
   2. Windows + R, digite: "C:\Users\All Users\Microsoft\Windows\Start Menu\Programs\Startup" e então selecione OK,  Isso abrirá a pasta inicialização
   3. Copie e cole os atalhos dos aplicativos TCloudFileSync.Angular.exe e TCloudFileSync.Api.exe na pasta de Inicialização. dessa forma, a aplicação será carregada em toda inicialização do Windows, para todos os usuários do Windows. 
   4. Após a copia, ficará da seguinte forma os arquivos na pasta de inicialização:
      
      

   Obs: Esse procedimento será refletido no carregamento em todos os usuários. Para utilizar que o carregamento reflita apenas em um usuário especifico, com o usuário logado no Windows, siga os passos abaixo:

   1. Crie um atalho da aplicação TCloudFileSync.Angular.exe e TCloudFileSync.Api.exe.
   2. Windows + R, digite shell:startup, e então selecione OK. Isso abrirá a pasta inicialização .
   3. Copie e cole os atalhos para os aplicativos TCloudFileSync.Angular.exe e TCloudFileSync.Api.exe na pasta de Inicialização.

04. CONFIGURAÇÃO DA APLICAÇÃO

• Credenciais SFTP :
  As Credenciais do SFTP, devem ser obtidas no Portal do T-CLOUD, em "Meu Ambiente" > Ações > Visualizar credenciais de SFTP.
  
  Salve as credenciais obtidas no portal do T-Cloud, pois ela serão utilizadas na configuração do Integrador SFTP Cloud
  

1. A aplicação possui uma interface web onde se é possível realizar toda a configuração desejada do integrador. Na maquina em quem aplicação foi instalada, acesse: http://localhost:4200 
   
   
2. Detalhamento das informações solicitados nos campos acima:
   

> Exemplo de como fica após o preenchimento correto com os dados do ambiente (exemplo):

• MAPEAMENTO DE PASTAS - SINCRONISMO:

1. Clique em "Adicionar Mapeamento"
   
   

2. Detalhamento das informações solicitados nos campos acima:

   Campo	Descrição
   Caminho Nuvem	O diretório no SFTP de onde os arquivos serão baixados ou para onde os arquivos serão enviados.
   Caminho Local	O diretório no computador local para onde os arquivos serão baixados ou de onde os arquivos serão enviados.
   Sentido de sincronismo	Sentido da integração, que pode ser de Nuvem (SFTP) para o computador local, ou do computador local para a Nuvem (SFTP).
   Recorrência em milissegundos	Tempo que o integrador irá aguardar entre uma integração e outra, orientado colocar o valor de Observação: Tempo mínimo de 30000 Milissegundos Dica: Site de conversão de minutos para milissegundos, acesse Portal ConvertLive
   Remove arquivo da origem ao transmitir	Se após a movimentação do arquivo, o arquivo será apagado. Observação, caso o sentido da integração seja da Nuvem para o computador local, o arquivo será apagado na Nuvem, caso o sentido da integração seja do computador local para a nuvem,  o arquivo será apagado no computador local.
   Ativo	Se o mapeamento está ativo ou inativo.

05. HISTÓRICO DE SINCRONISMO 

Para visualizar o histórico das sincronizações, acesse o menu "Histórico de Sincronismo".

06. LOGS DA APLICAÇÃO

Os logs são salvos em "C:\..\TOTVS\TCloudFileSync.Setup\Backend\_logs" no seguinte formato: