File Exchange Service
El servicio de intercambio de archivos Anvaigo EDI Connect permite recibir y enviar datos a otros sistemas. Para ello, se dirige a un servicio externo a Dynamics, que procesa los datos. Este servicio suele ejecutarse en las instalaciones ServiceTier (OnPrem) o en un servidor de acceso público (instalaciones Cloud). Para operar con Anvaigo EDI Connect en su propia infraestructura, ofrecemos licencias gratuitas para el servicio.
Para utilizar este servicio necesitas la versión 5.3.0.4 o superior de Anvaigo EDI Connect.
El servicio se puede utilizar desde todas las instalaciones de nuestro módulo (OnPrem y Cloud) a partir de Dynamics NAV 2013.
Visión general
Anvaigo File Exchange Service se suministra como un archivo ZIP que contiene todos los componentes necesarios para ejecutar la aplicación, incluido el tiempo de ejecución .NET necesario. Debido a sus dependencias, la aplicación sólo es compatible con sistemas Windows de 64 bits.
El servicio puede iniciarse como una aplicación de consola, lo que resulta útil para pruebas y depuración. Para uso en producción, se recomienda registrar la aplicación como un servicio de Windows.
El servicio puede alojarse en cualquier sistema accesible desde Dynamics. Sin embargo, para instalaciones en las que está disponible Dynamics ServiceTier, se recomienda encarecidamente instalar el servicio en la misma máquina que ServiceTier.
Tenga en cuenta que el servicio no permite ejecutar varias instancias en paralelo. Si tiene varios ServiceTiers en diferentes máquinas, el servicio sólo debe instalarse y funcionar en una única máquina.
Si el servicio está alojado en una máquina diferente a la de ServiceTier, deberá configurar el acceso en consecuencia. En tales casos, se recomienda encarecidamente utilizar una conexión Https cifrada, que puede configurarse a través de los ajustes del servicio.
Instalación del Servicio
Extraiga el archivo ZIP
Antes de descomprimir el archivo ZIP, asegúrese de que Windows lo reconoce como una fuente de confianza. Este paso es crucial, ya que el archivo contiene varios archivos DLL en los que debe confiar el sistema operativo tras la extracción.
Copie los archivos en el directorio del servidor
Extraiga y copie todo el contenido del archivo ZIP, incluyendo AnvaigoFileExchangeService.exe, appsettings.jsony todos los demás archivos incluidos, en un directorio de destino de su servidor.
Asignar permisos de directorio
Conceda los derechos de acceso adecuados a la cuenta de usuario que ejecutará el servicio. Este usuario debe tener acceso total al directorio de destino para que el servicio funcione correctamente.
La aplicación se puede instalar como un servicio de Windows con el siguiente comando (en la consola o Powershell) con privilegios de administrador:
sc.exe create "Anvaigo File Exchange Service" binpath="C:InstallationPathAnvaigoFileExchangeService.exe --contentRoot=C:InstallationPath"Por favor, cambie C:InstallationPath a la ruta en la que ha copiado la aplicación.
Para fines de prueba y depuración, el AnvaigoFileExchangeService.exe puede iniciarse directamente. En este modo autónomo, la aplicación se ejecuta mientras la ventana de la consola permanezca abierta y enviará los eventos de registro directamente a la consola, lo que resulta útil para solucionar problemas. Tenga en cuenta que la aplicación no puede ejecutarse en modo autónomo mientras el servicio esté activo. Debe detener el servicio de Windows antes de iniciar la aplicación manualmente.
Configuración
La mayor parte de la configuración se realiza en Microsoft Dynamics 365 Business Central. Hay algunos ajustes que deben configurarse para el servicio. Puede encontrar estos ajustes en el archivo appsettings.json que se suministra con el servicio. El archivo de configuración tiene que estar en la misma carpeta que el archivo de la aplicación.
Cambie este valor a una cadena secreta larga e introduzca la misma cadena en Dynamics. Recomendamos crear un GUID y eliminar todos los caracteres especiales, pero depende de ti elegir una cadena segura. En caso de que se utilice Http, el secreto se transfiere en texto plano. Utilice Https cuando el servicio no esté instalado en el ServiceTier.
Si el servicio puede acceder a todos los archivos locales del servidor (utilizando la cuenta de usuario que ejecuta el servicio) y ejecutar archivos de script.
Asegúrate de que el usuario que ejecuta el servicio sólo puede acceder a los directorios a los que debe tener acceso el FES. Establecer esta opción en true significa que cualquiera que tenga acceso a los canales de comunicación de Dynamics o a la clave API puede leer y escribir archivos en todos los directorios accesibles al servicio FES.
Las posibles implicaciones de seguridad son la razón por la que esta opción está desactivada por defecto.
La librería SFTP por defecto utilizada por el Servicio de Intercambio de Archivos de Anvaigo es «Ssh.NET». Si el servidor requiere métodos de autenticación no soportados por Ssh.NET, como rsa-sha2-256, puede pasar a utilizar «WinSCP» cambiando el ajuste de configuración en consecuencia.
En estos casos, recomendamos encarecidamente probar la conexión mediante la interfaz gráfica WinSCP, que puede descargarse de https://winscp.net/eng/download.php. Esto ayuda a verificar que la conexión puede establecerse con éxito antes de configurarla en el servicio.
Cuando se utiliza la autenticación basada en claves, se requiere un .ppk es necesario. Puede crear este archivo utilizando la herramienta «PuTTYgen».
Limitar el acceso al servicio a determinadas IP o nombres DNS. (Más información aquí)
La configuración del endpoint del servicio, como la dirección, el puerto y si usar Https o Http. (Más información aquí)
Próximos pasos
Ya puedes configurar el canal de comunicación en Anvaigo EDI Connect.