Anveo EDI Connect / Config / Intercâmbio de dados / File Exchange Service
Esta é uma tradução automática. O post original está disponível em Inglês .

File Exchange Service

O serviço de troca de ficheiros Anveo EDI Connect permite que os dados sejam recebidos e enviados por outros sistemas. Para o efeito, é contactado um serviço externo à Dynamics, que processa os dados. Este serviço é normalmente executado nas instalações ServiceTier (OnPrem) ou num servidor acessível ao público (instalações Cloud). Para o funcionamento com Anveo EDI Connect na sua própria infraestrutura, oferecemos licenças gratuitas para o serviço.

Para utilizar este serviço, é necessária a versão 5.3.0.4 ou superior do Anveo EDI Connect.

O serviço pode ser utilizado em todas as instalações do nosso módulo (OnPrem e Cloud) a partir do Dynamics NAV 2013.

Visão geral

O serviço é fornecido como um único ficheiro de aplicação. A aplicação pode ser lançada como uma aplicação de consola para fins de teste e depuração. Para o funcionamento em produção, recomendamos que a aplicação seja registada como um serviço. O serviço pode ser alojado em qualquer sistema que seja acessível a partir do Dynamics. No entanto, para todas as instalações em que tem acesso ao Dynamics ServiceTier, recomendamos vivamente que o instale juntamente com o ServiceTier. O serviço não suporta várias instâncias a funcionar em paralelo. Assim, se tiver vários ServiceTiers em máquinas diferentes, deve instalar o serviço numa única máquina.
Se o serviço estiver localizado numa máquina diferente da ServiceTier, o acesso tem de ser permitido através da configuração e, neste caso, aconselhamos vivamente a utilização de uma ligação Https encriptada. Isto pode ser definido através da configuração.

Instalação do serviço

Copie os ficheiros AnveoFileExchangeService.exe e appsettings.json para um caminho no seu servidor e certifique-se de que o utilizador que deve executar o serviço tem direitos de acesso a esse diretório.

A aplicação pode ser instalada com o seguinte comando (na consola ou no Powershell) com privilégios de administrador:

sc.exe create "Anveo File Exchange Service" binpath="C:InstallationPathAnveoFileExchangeService.exe --contentRoot C:InstallationPath"
Instalar o serviço

Altere C:InstallationPath para o caminho para o qual copiou a aplicação.

Para efeitos de teste e depuração, o AnveoFileExchangeService.exe também pode ser iniciado diretamente.

Configuração

A maior parte da configuração é efectuada no Microsoft Dynamics NAV 2013R2. Existem algumas definições que têm de ser configuradas para o serviço. Pode encontrar estas definições no ficheiro appsettings.json que é fornecido com o serviço. O ficheiro de configuração tem de estar na mesma pasta que o ficheiro da aplicação.

ApiKey

Alterar este valor para uma cadeia secreta longa e introduzir a mesma cadeia na Dinâmica. Recomendamos a criação de um GUID e a remoção de todos os caracteres especiais, mas cabe-lhe a si escolher uma cadeia de caracteres segura. No caso de ser utilizado Http, o segredo é transferido em texto simples. Utilize Https quando o serviço não estiver instalado no ServiceTier.

AllowLocalFilesystemAccess

Se o serviço pode aceder a todos os ficheiros locais no servidor (utilizando a conta de utilizador que executa o serviço) e executar ficheiros de script.

Certifique-se de que o utilizador que executa o serviço só pode aceder aos directórios que devem ser acessíveis ao FES. Definir esta opção como verdadeira significa que qualquer pessoa que tenha acesso aos canais de comunicação Dynamics ou à chave API pode ler e escrever ficheiros em todas as directorias acessíveis ao serviço FES.

As potenciais implicações de segurança são a razão pela qual esta opção está desactivada por defeito.

SshDefaultLibrary

O valor predefinido é “Ssh.NET”. Se o servidor utilizar métodos de autenticação que não são suportados pelo SSH.NET (como o rsa-sha2-256), pode alterar este valor para “WinSCP”, de modo a utilizá-lo para a ligação. Recomendamos vivamente que teste a ligação com a GUI do WinSCP (utilizamos a versão 6.1 do WinSCP, descarregada aqui: https://winscp.net/eng/download.php) se a ligação puder ser estabelecida com êxito. Relativamente ao ficheiro de chaves, tem de ser utilizado um ficheiro de chaves .ppk. O programa “PuTTYgen” pode ser utilizado para criar esse ficheiro.

AllowedHosts

Limitar o acesso ao serviço a determinados IPs ou nomes DNS. (Saiba mais aqui)

Kestrel

A configuração do ponto de extremidade do serviço, como o endereço, a porta e a utilização de Https ou Http. (Saiba mais aqui)

Próximos passos

Pode agora configurar o canal de comunicação no Anveo EDI Connect.