Integración con a3ASESOR | Nom (a3Nom)

Introducción

a3Nom es un sistema de gestión de nóminas que se suele instalar localmente o en una unidad de red desde la que lo arrancan múltiples usuarios/as.

El acceso es mediante un programa Windows estándard.

Integración con Bold o GT

Al tratarse de un programa local, la comunicación entre el servidor Bold / GT y a3Nom requiere la intermediación de un programa que también se debe instalar localmente: el Módulo de Comunicaciones.

Es necesario instalarlo en el servidor de la red interna que tenga acceso al programa de nóminas y a la vez acceso al servidor de GT.

Paso 1. Instalación del módulo de comunicaciones

¡Importante! En caso de clientes de WKE con GT cloud que necesiten conectar con a3ASESOR|nom, se debe comunicar a Soporte GPS el código de licencia del cliente, ya que antes de que descargue el módulo es necesario realizar un paso previo para permitir que pueda conectar con el módulo de comunicaciones. Soporte GPS activará el código de licencia desde el servidor y una vez activado, el cliente ya podrá descargar e instalar el módulo.

Acceder al asistente y seleccionar el tipo de integración a3ASESOR|nom. Seleccionar “Datos de conexión”. Aparecerá la siguiente pantalla:

En una configuración sencilla se escogerá la Opción A y se descargará el programa de comunicaciones directamente en el servidor u ordenador de la red que tenga acceso al programa de nóminas. Si se van a utilizar las funciones de integración con datos de nómina de GT desde diferentes ordenadores, es necesario que se instale este programa de comunicaciones en un servidor de la red con acceso a ambas aplicaciones.

Opción B: Es muy posible que el programa de nóminas a3ASESOR|nom se utilice para gestionar múltiples empresas. Frecuentemente, el control de horarios y presencia del personal de esas empresas se gestionará de forma independiente unas de otras, y la instalación de GT (por ejemplo, en el cloud) puede ser diferente. En estos casos los usuarios administradores de GT en el cloud deberán introducir el código de conexión único que les proporcione el administrador del programa de nóminas para acceder a los datos particulares de esas empresas.

OPCIÓN A. Nueva instalación del módulo de comunicaciones

Con la opción A se descargará el instalador del programa de comunicaciones que se instalará como un servidor de Windows en el ordenador de la red con acceso a a3ASESOR|nom (botón “Descarga módulo”).

Nota importante: Si a3ASESOR|nom está instalado en una unidad de red compartida es necesario introducir unas credenciales de Windows válidas para acceder a este recurso antes de iniciar la descarga del instalador.

Los administradores del programa de nómina que sepan que ésta se utilizará desde diversas instalaciones de GT en el cloud deben escoger también esta opción la primera vez.

Una vez instalado visualizaremos que la comunicación está habilitada:

OPCIÓN B. Vincular con una instalación ya existente.

Hay que introducir la clave de acceso (token) que se proporcione y que debe extraerse de una instalación previa mediante la opción A del fichero ubicado en: C:\Program Files (x86)\Global Planning Solutions\services\daemon_GPSClientModule\serverLink.json

Desde los 3 puntos verticales del botón “Descarga módulo” se pueden realizar las acciones siguientes:

• Comprobar comunicación. Usar en caso de tener problemas de comunicación.
• Volver a descargar módulo. Para volver a realizar la descarga si fuera necesario. En el caso de haber elegido la opción B, se visualizará como “Desvincular caso”.
• Obtener logs. Para revisar logs de errores.

Paso 2. Configuración

1. Introducir la ubicación (en la red o local) de la carpeta de instalación de a3ASESOR|nom.
2. Introducir la selección de los códigos numéricos de las empresas a integrar con GT.

3. Presionar el botón “Guardar & probar”. Debe aparecer el mensaje “Conexión exitosa”. Si aparece un error, se debe revisar el siguiente apartado de solución de problemas.

Una vez el módulo está comunicando y hay conexión exitosa, ya se puede lanzar la sincronización.

Temas muy importantes a tener en cuenta en la configuración:

• El usuario que se configure debe tener permisos de administrador en el ordenador desde donde se instala el módulo de comunicaciones (preferentemente este usuario debería ser de dominio, si no, tendremos que configurarlo en la máquina donde se instale el módulo de comunicaciones y también en la máquina de red donde estén ubicados los archivos de a3nom).
• El usuario debe tener permiso para ejecutar a3nom en ese mismo ordenador
• El usuario debe poder acceder a la ruta completa (UNC si a3nom está instalado en la red) donde esté instalado a3nom (normalmente una ruta de red válida sería algo así: \192.168.123.9\documents\A3\A3NOMV5E)
• El módulo de comunicaciones consume una licencia de a3nom mientras está funcionando. Si el cliente solo dispone de una licencia, los otros usuarios deberán tener cerrado a3nom mientras se usa en GT para lanzar la sincronización.

Nota: al instalar el módulo cliente se instalan dos servicios en el ordenador que tendrá el acceso al a3nom (ver services.msc): GPSClientModuleUpdater (que normalmente se instalará automáticamente con las credenciales “sistema local”) y GPSClientModule (que tiene que quedar instalado con las credenciales introducidas desde la aplicación web y es el que realmente se comunicará con a3nom).

Solución de problemas de configuración del módulo de comunicaciones y a3Nom

Aparece el error: “Error probando conexión…” “No se ha podido leer el fichero TPARAGEN.DAT…”

Aplicaremos el Procedimiento de ejecución manual del test de extracción de datos:

Cuando los problemas de conectividad persisten puede resultar útil ejecutar un test de conectividad directamente desde la línea de comandos para verificar la instalación.

Hacer lo siguiente:

1. Abrir un cmd
2. Ejecutar los siguientes comandos:

cd "C:\Program Files (x86)\Global Planning Solutions\services\daemon_GPSClientModule"
.\a3GTClient\node.exe .\a3GTClient\a3NOM\a3NOM_ExtraccionTotal.js "1 560" c:\temp 20210131 No \\192.168.122.9\documents\A3\A3NOMV5E\ test c:\temp\a3_output.log

«c:\temp» –> especifica la carpeta donde dejar los ficheros temporales

«1» –> indica el número de empresa a utilizar

20210131 –> indica la fecha de vigencia de los datos a extraer

«c:\A3\A3NOMV5E\» –> ruta de red de la instalación de a3nom (importante que a3Nom arranque correctamente desde esta carpeta o unidad de red, y es necesario poner la contrabarra del final).

El resultado de este comando no debería retornar ningún error y el contenido del fichero .log contener tan sólo «true».

Si en vez de hacer el test queremos forzar una extración completa de datos, en vez de “test” poner “TODO”

Para ver otros comandos posibles, consultar los scripts de la carpeta:

C:\Program Files (x86)\Global Planning Solutions\services\daemon_GPSClientModule\a3GTClient\a3NOM

Prueba de ejecutar una extracción manual directamente sobre el ordenador donde se ejecuta a3Nom

Se trata de ejecutar el comando anterior con la empresa que se seleccione. Por ejemplo, el siguiente comando extrae los datos de la empresa 25 y deja los resultados en el archivo c:\temp\a3_output.log. Sería lo recibido finalmente por GT para su procesamiento (modificar las IPs y carpetas de instalación a3nom de red según convenga!):

cd "C:\Program Files (x86)\Global Planning Solutions\services\daemon_GPSClientModule"
.\a3GTClient\node.exe .\a3GTClient\a3NOM\a3NOM_ExtraccionTotal.js "25" c:\temp 20210131 No \\192.168.122.9\documents\A3\A3NOMV5E\ TODO c:\temp\a3_output.log

En el caso de a3 nom esté instalado localmente en la unidad por defecto sería esto:

.\a3GTClient\node.exe .\a3GTClient\a3NOM\a3NOM_ExtraccionTotal.js "2" "%TEMP%" 20230525 No C:\A3\A3NOMV5E\ TODO "%TEMP%"\a3_output.log

Nota 1: la salida nos ira mostrando el progreso de la extracción que puede ser algo lenta en función del nº de trabajadores.

No arranca el servicio GPSClientModule

Comprobar que las credenciales con las que se ha instalado el servicio sean correctas. Si aparece en el fichero C:\Program Files (x86)\Global Planning Solutions\services\trace.log el texto “Las credenciales del núcleo no son válidas” posiblemente ese usuario no sea correcto. Verificar bien ejecutando un comando desde un cmd.exe de administrador: runas /user:usuario_a_probar notepad.exe (deberá arrancar el notepad sin errores).

Aparece el error NO_VALID_BD_SERVICE

El error NO_VALID_BD_SERVICE lo da cuando se intenta descargar de nuevo el módulo de comunicaciones desde una instalación donde ya se había hecho. Para solucionarlo, antes de repetir cualquier instalación debemos seleccionar la opción “Volver a descargar módulo”.