Ayuda sobre productos BOLD:
10. Sincronización con GT
El siguiente artículo describe la configuración de la tarea de subida de marcajes en un caso cloud o bien onpremise sólo cuando estamos utilizando un reloj Suprema / Biostar.
Se tendrá que instalar el programa de extracción y subida (upload) de los datos de fichajes.
Instalación
1. Iniciamos la sincronización con GT. Descarga el archivo comprimido desde este link (.zip).
2. Extráelo en la ruta que consideres conveniente.
Dentro de la carpeta Clockings se encuentra el fichero archivo_prueba.txt con marcajes de prueba que nos servirá para configurar el reloj en GT (Atención! esto sólo si usamos Biostar, sino el archivo de prueba con algunos marcajes nos los deberá proporcionar el que haya configurado el reloj).
Importante! Antes de continuar con la instalación de programa script de extracción / subida de marcajes al cloud, accederemos a GT para configurar el reloj:
3. Para configurar el reloj en GT, dentro de la aplicación web, accede a la página de Relojes-Terminales.
Una vez configurado, comprobar si se ha creado la carpeta con el nombre del reloj en la ruta indicada en el Asistente de GT durante el proceso de configuración (solo para el caso onpremise, ya que en los casos cloud la ruta apunta al servidor cloud).
4. Ir a GT y en el Asistente de configuración > Empleados asignar al empleado o empleada el ID que tiene informado en el reloj/Biostar.
Editar empleado -> Datos Básicos: en el campo Tarjeta introducir el ID de su usuario/a en el reloj/Biostar (en este ejemplo, ID = 454).
Presionar Guardar. Presionar Finalizar.
5. Ahora continuaremos con el proceso de instalación del programa de subida de marcajes: Entrar en la carpeta Clockings (extraída al descargar el instalador de marcajes, pasos 1 y 2) y ejecutar el archivo Clockings_Install.bat.
Preguntas en el proceso de instalación
6. El Clockings_Install.bat nos pedirá responder las siguientes preguntas para finalizar la instalación:
Nota: Los valores entre corchetes (‘[‘, ‘]‘) son valores que se añaden por defecto si no introduces nada.
- ¿Usas versión cloud? (y/N) [N]
- (N) – Si usas onpremise, deberás seleccionar esta opción
- (y) – Si usas cloud, deberás seleccionar está opción y te pedirá lo siguiente
- Introduce la URL del cloud de GT: [https://a3gt.wolterskluwer.es/clockings/fileupload]
- Introduce la clave identificadora de marcajes de GT (desde la aplicación: Menú de usuario ➜ Info configuración ➜ Identificador de marcajes):
- Introduce el código de cliente (nombra la instancia Cloud. Ejemplo: ‘W0001’):
-
¿Usas relojes BioStar? (y/N) [y]
- (y) – Para acceder a la configuración de BioStar
-
Introduce el nombre de tu servidor BioStar o la IP (es la IP o el nombre de servidor de la url a través de la que accedes a BioStar en un navegador): [localhost]
-
Introduce el puerto de tu servidor BioStar. También lo puedes obtener desde la url de acceso a BioStar a través de un navegador. Si va por https es el 443, si va por http es el 80, si utiliza otro puerto aparecera en la url de BioStar http://{url}:{puerto}: [443]
- [El programa en este punto verificará automáticamente si se puede o no usar la API de BioStar]
- Si NO USAS la API de BioStar
-
¿Usas versión SQL Server o MariaDB? [MariaDB]
- SQL Server
-
Introduce el nombre de la base de datos:
-
Introduce el nombre del usuario SQL Server:
- Introduce la contraseña que tienes en la base de datos:
-
Introduce el puerto de tu servidor SQL Server: [1433]
-
Introduce la instancia de tu servidor SQL Server:
-
- MariaDB
- Introduce el nombre del usuario de MariaDB: [root]
- Introduce la contraseña que tienes en la base de datos:
-
Introduce el puerto de tu servidor MariaDB: [3312]
-
-
Si USAS la API de BioStar
-
Introduce el nombre del usuario de BioStar: [admin]
-
Introduce la contraseña del usuario de BioStar:
-
-
- (y) – Para acceder a la configuración de BioStar
-
Nombre definido en el listado de relojes del asistente de GT: [reloj1]
-
Indica la ruta con el nombre del fichero, donde se debe guardar el archivo txt con los marcajes que se realizarán en el reloj. Se puede elegir el nombre del archivo que se considere más conveniente: [C:/ImportExport/Custom_Files/clockings/Suprema/marcajes.txt]
Tras esta configuración, se iniciará el proceso de la instalación de una Tarea Programada y te pedirá responder las siguientes preguntas:
- Nombre de usuario. Si estás en dominio escribe dominio\nombre_usuario:
- Ingrese la contraseña:
7. Comprobar que los fichajes de prueba han llegado a GT. En el caso de instalación onpremise el fichero generado estará en la carpeta seleccionada:
C:\ImportExport\Custom_Files\clockings\NOMBRE DEL RELOJ
Debería haber periódicamente un fichero con datos de marcajes. Este fichero se moverá automáticamente a las carpetas “error” o “ok” según se carguen sus datos en GT de forma completa sin errores o no. Además, los ficheros originales con marcajes se guardarán en la carpeta “backup” (se encuentra en la misma ruta que las carpetas error y ok). La carpeta “backup” se creará automáticamente cuando lleguen los primeros marcajes.
Configurar los motivos de marcaje en Biostar
Para poder configurar los motivos de marcaje en Biostar debemos seguir las instrucciones que se describen en el siguiente artículo:
8. Configuración de motivos de marcajes – Soporte GPS (gps-plan.com)
Actualización
Descarga la última versión en este link (.7z) o este link (.zip).
- Extrae en cualquier lugar la última versión descargada y ejecuta el .bat Clockings_Update.bat
Si por algún motivo inesperado el archivo Clockings_Update.bat no funciona correctamente, ejecuta en su lugar el archivo Clockings_Install.bat tras haber realizado los siguientes pasos extra:
- Ve a la carpeta (por defecto) C:\ImportExport.
- Renombra la carpeta Processing.
- Ejecuta Clockings_Install.bat de la última versión descargada.
- Sigue las instrucciones que se muestran en la ventana de comandos. (Punto 6 de esta página)
Exclusión de Terminales
Añadiendo unos parametros extra al fichero de configuración, se puede indicar los terminales cuyos marcajes serán excluidos. Para ello, primero debes saber el identificador (ID) del terminal que quieres excluir.
Obtención del identificador del terminal
Para ello navega a tu página de BioStar2 y conéctate.
En el lateral izquierdo del menú principal, presiona sobre la opción Dispositivo (Device), te aparecerá un listado.
De ese listado te interesa el campo ID Dispositivo (Device ID) del dispositivo que quieres excluir.
Copia ese valor numérico para usarlo más adelante en el fichero de configuración.
Excluir terminal
Para excluir un terminal lo primero que tendrás que hacer es abrir con un editor de texto el fichero uploadConfig.json que (por defecto) estará en la ruta C:\ImportExport\Processing\node .
Te toparás con una información similar a la siguiente:
Lo que debes hacer es, añadir una coma en el último campo y copiar esta línea justo debajo:
"TERMINAL_EXCEPTIONS": ["01234", "56789", "43210", "98765"]
Debes modificar los valores numéricos dados como ejemplo por el identificador de tu terminal. Si deseas excluir varios terminales, sepáralos por una coma.
Es muy importante añadir el identificador del terminal entre comillas (fíjate de no dejar una coma dentro de ellas).
El resultado final basándonos en el ejemplo anterior, debería ser el siguiente:
Solución de problemas
Da un error «Request failed with status code 400»
Normalmente este errro http «Bad request» lo retorna la API de Biostar cuando las credenciales no son correctas. Revisar la contraseña del usuario.
Subir marcajes entre un intervalo de fechas concreto
A partir de la versión* 1.5.12 del script podemos forzar que se suban los marcajes correspondientes a un período concreto de fechas de la siguiente manera:
- Abre un terminal (Inicio ➜ Ejecutar ➜ cmd.exe)
- Ve al directorio del ejecutable node (por defecto)
cd C:\ImportExport\Processing\node - Ejecuta node pasando como parámetro el script de procesado y las fechas** de inicio y fin de la extracción:
.\node.exe ..\ProcessClockings.js 2022-01-01 2022-01-31
*Para consultar la versión del script hay que abrir C:\ImportExport\Processing\ProcessClockings.js) y buscar const version.
**Las fechas se tienen que introducir en formato yyyy-mm-dd