Integrador - HCM

El Integrador HCM se puede utilizar en servidores exclusivos o compartidos (que tienen otros sistemas).

La infraestructura mínima necesaria es:

• 1 máquina virtual con 2 núcleos de procesador de 2,4 GHz;
• 4 GB de RAM 1600 MHz (si es compartida, debes tener al menos 4 GB libres);
• Red de 1 Gbps;
• 500 GB HD 7000 RPM;
• Java 11: instalación o actualización de OpenJDK 11;
• En las variables del sistema es obligatorio crear la variable JAVA_HOME_HCM ;
• De forma predeterminada, la variable de entorno JAVA_HOME_HCM debe apuntar al JDK de Java 11 .

• Tener acceso igual al de una estación de Gestión de Personas | HCM, que incluye:
  • acceso concedido a los directorios de instalación de Senior;
  • acceso liberado para acceder al servidor de base de datos.

Versiones del Windows compatibles con el Integrador - HCM

El Integrador - HCM puede ser instalado en las siguientes plataformas Windows compatibles con la aplicación:

Plataforma	Arquitectura de la CPU
Windows Server 2019	x64 (64-bit)
Windows Server 2016	x64 (64-bit)
Windows Server 2012 R2	x64 (64-bit)
Windows Server 2012	x64 (64-bit)
Windows 10	x64 (64-bit)
Windows 8.x	x64 (64-bit)
Windows 7	x64 (64-bit)

Navegador aprobado con el Integrador - HCM

El navegador homologado para el funcionamiento del hcm-monitor del Integrador - HCM es el Google Chrome (versión mínima 70.0.3538).

Base de datos del sistema Gestão de Pessoas | HCM (versión 6 - on-premise)

El servidor de base de datos Gestão de Pessoas | HCM debe ser una de las versiones aprobadas por Senior .

Ejecutar en versiones distintas a las aprobadas puede causar inestabilidades o problemas de rendimiento en el Integrador - HCM.

Es necesario asegurarse de que la plataforma X senior esté implementada y configurada. En caso contrario, es necesario cumplir al menos con los mismos requisitos de infraestructura que la plataforma. (los requisitos se detallan en la documentación de los procedimientos de instalación) .

Si hay integración entre los sistemas G5/G6 (on-premise) y XPlatform (cloud) también es necesario garantizar la instalación en un entorno híbrido .

URL que deben publicarse para todos los usuarios y en el servidor Integrador - HCM

• platform.senior.com.br (puerto predeterminado https 443 y https 8243)
• smtp.sendgrid.net:587 (Servidor de correo electrónico del Senior; utilizado por el Integrador HCM para enviar notificaciones de telemetría al Senior sobre situaciones críticas relacionadas con la operación del Integrador en el entorno de los clientes)
• senior-hcm-storage.s3.amazonaws.com (puerto predeterminado https 443)
• br-com-senior-blob-service-shared-area.s3-sa-east-1.amazonaws.com (puerto predeterminado https 443)
• https://hcm-api.senior.com.br/ (puerto predeterminado https 443 ; tipo CNAME: apunta a hcm-prod-services-alb-649147785.sa-east-1.elb.amazonaws.com)

URL para actualización automática

La siguiente URL debe estar habilitada para que la actualización automática del Integrador - HCM funcione correctamente.

Seguridad

Toda la comunicación de Integrador HCM está cifrada y protegida bajo el protocolo HTTPS y TLS 1.2.

La instalación del Integrador - HCM requiere que el cliente cuente con:

• un tenant de acceso a la plataforma senior X
• el archivo (extensión .pem), que contiene las claves de certificado para ejecutar la aplicación

El siguiente procedimiento explica cómo obtener esta información. Esto debe hacerlo el administrador del sistema en el cliente y debe completarse antes de iniciar la instalación de Integrador - HCM.

Cree un tenant senior de acceso a la plataforma X y obtenga el archivo .pem

1. Acceder al Soporte SARA, que es el entorno donde se realizará la solicitud de creación de tenant (haga clic aquí para acceder) .
2. Selecciona la opción TENANTS y sigue las instrucciones que te presenta SARA. Si quieres saber más sobre este paso, consulta la documentación de creación de tenants en el manual de la plataforma .
3. Cuando se complete la solicitud del tenant, el administrador recibirá un correo electrónico con un identificador único, llamado Tenant Id . También recibirá un correo electrónico con un archivo adjunto (extensión .pem).
   
   Revise este correo electrónico y guarde la información y el archivo que se utilizará al instalar el Integrador - HCM.

Es necesario instalar el servicio web para cada módulo adquirido para que se pueda sincronizar la información del módulo. XPlatform para módulos contratados y viceversa.

Este es un requisito obligatorio para el funcionamiento delactualización de registro es degestión de vacaciones.

Además, también es necesario asegurarse de que el servidor donde está instalado el Integrador tenga acceso a las URL de los servicios web instalados.

Obtenga el instalador del Integrador - HCM

El instalador se puede obtener en un archivo .ZIP, que está disponible en la siguiente dirección:

El archivo hcm-integration.zip debe descomprimirse en un servidor que tenga acceso a Gestión de Personas | HCM.

Instalar Integrador HCM como servicio de Windows

Para instalar el Integrador HCM como servicio de Windows, debe realizar la instalación utilizando el siguiente archivo, disponible en el directorio raíz de la aplicación:

• InstallService64.bat (instala el servicio para servidores con instalación Java de 64 bits)

Una vez instalado el servicio se puede iniciar desde el propio panel de servicios de Windows o desde el archivo START.BAT .

Al ejecutar el archivo START.BAT sin parámetros intentará ejecutar el servicio y, si no existe, emite un mensaje indicando su ausencia. Aun así, todavía es posible ejecutar el Integrador HCM como una aplicación, ejecutando el archivo START.BAT con el parámetro -nosvc .

Ejemplo del mensaje de advertencia cuando el servicio Integrador HCM no está instalado en la máquina y se intenta ejecutar la aplicación utilizando el archivo START.BAT:

Exclusión del servicio de Windows

Para eliminar el servicio de Windows, debe ejecutar el archivo RemoveService.bat, disponible en el directorio raíz del integrador.

Posible falla de Java VM durante la instalación de Integrador HCM

Si observa que Java VM falló durante la instalación de Integrador HCM, descargue el paquete OpenJDK que utiliza la aplicación. Instale el paquete OpenJDK y repita la instalación del Integrador HCM.

El motivo del error se puede encontrar revisando los archivos de registro con el nombre "global", ubicados en la carpeta de registros donde se instaló la aplicación (ejemplo: C:\HCM-Integrador\log)

Para acceder a la Central de Configurações Senior, ejecute la aplicación SeniorConfigCenter.exe, ubicada en el mismo directorio que el Gestão de Pessoas | HCM (on-premise) se ha instalado (ejemplo: c:\Senior\SeniorConfigCenter.exe).

En esta aplicación, realice las siguientes configuraciones:

Datos de conexión

En Central de Configurações Senior, navegue hasta la pantalla de configuración de HCM — ubicada en Sistemas > Gestión de personas > HCM — y complete los campos en la pantalla.

Esta configuración se utilizará para:

• establecer la conexión entre el entorno del sistema local y la plataforma senior X
• habilitar la autenticación a través de ADFS

Puede encontrar detalles adicionales sobre cómo completar los campos de esta pantalla en el Manual de tecnología .

Llaves

En Central de Configurações Senior, navegue hasta la pantalla de configuración de las llaves y agregue (o configure) el siguiente registro:

• Clave: com.senior.vetorh.hcm.g7.auth
• Valor: true

Verifique si se incluyó la siguiente clave; esta inclusión debe haber ocurrido automáticamente cuando se configuraron los datos de conexión en el paso anterior:

• Clave: com.senior.vetoh.hcm.g7.location
• Valor : https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest
  

Puede encontrar detalles adicionales sobre cómo completar los campos de esta pantalla en el Manual de tecnología .

Proxy

Si la empresa utiliza proxy:

Configure el proxy en la Central de Configuraciones Senior (SeniorConfigCenter), por el menú Conexiones de red > Acceso a internet.

Para verificar si la empresa utiliza proxy, se puede consultar las configuraciones del navegador (ejemplo por el Internet Explorer: Opciones de la Internet > Pestaña Conexiones > Botón Configuraciones de la LAN > Servidor proxy).

Si la empresa no utiliza proxy:

Caso no utilice proxy, la propiedad config.ignore.proxy debe estar configurada como true en el archivo integration.properties del Integrador - HCM (config.ignore.proxy=true).

La carpeta raíz donde se instaló HCM Integrator contendrá el archivo Integration.properties (ejemplo: C:\HCM-Integrador\integration.properties).

Usando el bloc de notas o un editor de texto similar, abra este archivo y edite las siguientes propiedades según sea necesario:

Nombre de la propiedad	Descripción de la propiedad	Finalización de la propiedad
hcm.location	Dirección de los servicios de HCM.	Obligatorio
integration.fromFile.dir	Directorio donde quedan los archivos con datos generados por informes. Esta clave debe apuntar a la carpeta donde se guardan los archivos hcm-employee-salary-premiums.txt y hcm-employee-vacation-schedule.txt (consulte la documentación de requisitos previos del Panel de Gestión), así como otros archivos que se citan más adelante. esta página. Ejemplo: integración.fromFile.dir=C:\temp\data_files	Obligatorio
rh.company.id	Empresas que sean consideradas en la integración	Obligatorio
config.rootdir	Carpeta de instalación del sistema de Gestión de Personas | HCM (local).	Obligatorio
config.environment	Nombre del archivo .cfg (sin la extensión). Por ejemplo, si el archivo es senior.cfg, solo debes ingresar: senior	Obligatorio
config.ignore.proxy	Si se establece en verdadero, ignora el proxy definido en el Central de Configurações Senior (SeniorConfigCenter).	Obligatorio
config.proxy.nonProxyHosts	Informar a los hosts que no deben pasar por el servidor proxy, sin espacios y separados por el carácter de barra vertical (|).	Opcional
hcm.tenant.id	Se debe completar con el ID del tenant que aparece en la base de datos de HCM. Esta información se puede obtener del correo electrónico que recibe el administrador del tenant, en el que se envía el archivo de claves .pem . En el correo electrónico, la información se describirá en ID de tenant, por ejemplo: Nombre del tenant: XXX LTDA ID de inquilino: xxx_ltda	Obligatorio
sync.interval	Tiempo para verificación de la sincronía. Si no se establece nada, el valor predeterminado es 30 segundos.	Opcional
integration.administrator	Identificación del usuario que quedará establecido como primer usuario administrador del Panel de Gestión. Se debe rellenar en el formato NumEmp/TipCol/NumCad, donde: NumEmp = código de empresa TipCol = código de tipo de empleado NumCad = código de registro de empleado Ejemplo: integración.administrator=1/1/19028	Opcional
hcm.admin.email	Dirección de correo electrónico del administrador del Integrador - HCM. Una vez informado, el administrador recibirá un correo electrónico diario resumiendo la ocurrencia de errores y fallas del Integrador - HCM. Si el Integrador no presenta errores, el correo electrónico no será enviado.	Opcional
integration.log.level	Nivel de registro. Valores posibles: ALL: Registros completos, considera todas las variaciones del registro de la aplicación. Es la opción recomendada ya que facilita el mantenimiento. FINE: Registro que considera situaciones de error, avisos importantes, avisos informativos y avisos de rastreo (registros abarcados en un flujo, detalles de una entidad, etc). Ejemplo: búsqueda de elemento principal con posición: %s; INFO: Registro que considera situaciones de error, avisos importantes e informativos (aviso de inicio y fin de ejecución de procesos, parámetros de solicitud, etc). Ejemplo: Reejecutar errores de red de integraciones...; WARNING: Registro que considera situaciones de errores y avisos importantes (registro omitido, indisponibilidad momentánea, error solucionable, etc). Ejemplo: Se agotó el tiempo de espera al intentar descargar el archivo de la versión remota con tiempo de espera, lo intentaremos nuevamente pronto.; SEVERE: Registro que sólo considera situaciones de error. Ejemplo: No se pudo crear la tabla de caché de migración de destino.; OFF: Registros deshabilitados. Esta opción no se recomienda ya que puede dificultar el mantenimiento. Recomendamos utilizar el nivel ALL. Si no se establece nada, el valor por defecto será WARNING.	Opcional
integration.hierarchy.interval​	Intervalo de integración de la jerarquía en minutos. Esta propiedad indica con qué frecuencia se enviará la jerarquía a HCM. Valor estándar: 180 minutos Observación No se tendrán en cuenta los valores inferiores o iguales a 60 minutos.	Opcional
sync.enabledOnStart	Activa/desactiva el inicio automático de la sincronización al iniciar el Integrador HCM. Valor predeterminado: false Observación El valor estándar de la propiedad sync.enabledOnStart es false; sin embargo, este valor se puede cambiar a true. Cuando el valor es false, a su vez, el sistema verifica si ya se han ejecutado cargas de al menos el 80% de los flujos. Si ya has ejecutado al menos este porcentaje, el valor cambia automáticamente a true.	Opcional
movimentation.task.enabled	Indica si los flujos relacionados con movimientos de empleados y puestos de trabajo se realizarán diariamente, para ajustar la base y evitar no conformidades. Valor estándar: true	Opcional
updater.disable	Indica si la actualización automática está deshabilitada. Valor estándar: false	Opcional
sync.request.maxRows	Número máximo de asuntos pendientes a manejar en cada ejecución de sincronización. Valor estándar: 300 asuntos pendientes Valor máximo: 500 asuntos pendientes	Opcional
sync.request.batch.size	Tamaño del batch de envío por lotes. Valor estándar: 150 Valor máximo: 300	Opcional
sync.request.batch.timeout	Tiempo de espera de sincronización por lotes (en minutos). Valor estándar: 15	Opcional
updater.openjdk11.download.path	Indica la ubicación (directorio) en la que se descargará OpenJDK11.	Opcional
updater.openjdk11.zip	Define qué versión de Java 11 descargará el Integrador - HCM.	Opcional
updater.integration.healthcheck.port	Puerto para verificar que el servicio Integrador - HCM se esté ejecutando correctamente en Windows. De forma estándar, se utiliza el puerto 9082. Si este puerto ya está siendo utilizado por otro proceso de Windows, se debe utilizar otro puerto en esta propiedad.	Opcional
integration.inbound.port	Puerto integrador HCM. El valor del puerto debe tener exactamente 4 (cuatro) dígitos. Si no se establece nada, el valor predeterminado es 8082 .	Obligatorio
integration.inbound.host	Nombre del computador del Integrador HCM Si no se define nada, el valor predeterminado será localhost .	Opcional
integration.batch.size	Tamaño del lote de envío para la integración. Valor mínimo: 25 Valor estándar: 50 Valor máximo: 80	Opcional
old_files_cleaner.deadline_days	Número de días que los archivos antiguos (registros, por ejemplo) están disponibles antes de que se eliminen. Valor predeterminado: 45 (días) Valor mínimo: 7 (días) Valor máximo: 60 (días)	Opcional
use.index.rtcpendencies.enabled	De forma predeterminada, la base de datos G5 no utiliza el índice RTC_PENDENCIESINDICE_1 en la consulta, que devuelve el número de sincronizaciones pendientes por tabla. Si la consulta presenta problemas de rendimiento en la base de datos SQLServer, se recomienda habilitar su uso indicando true en esta propiedad.	Opcional
useraccount.module.control.disabled	Cuando se establece en true, el Integrador replicará a Senior X la información de los usuarios que están vinculados a empleados y que no tienen indicación de módulos en Gestión de Personas | HCM XT.	Opcional
useraccount.syntax.error	Cuando se establece en true, deshabilita la generación de errores causados por problemas en la sintaxis de los nombres de usuario, considerando que el servicio de autenticación de la plataforma senior X no acepta nombres de usuario con ciertos tipos de caracteres especiales. Al habilitar este parámetro, los usuarios que tengan un error de sintaxis en su nombre aún no se integrarán en HCM, pero en lugar de informar el error, la situación solo se mostrará en el registro del Integrador. Valor estándar: false	Opcional
integration.jvm.params	Parámetro para inicializar la propiedad Xmxsize (Maximum Heap Size) de la Máquina Virtual Java (JVM). Define la cantidad máxima de memoria que Integrator HCM puede asignar durante el procesamiento de problemas pendientes. Valor estándar: -Xmx4096m Valor mínimo recomendado: -Xmx2048m	Opcional
integration.g5.service.module	Indica a través de qué módulo G5 se realizan las integraciones con la XPlatform. Valores posibles: rubi , ronda, cs, rs o ql. Valor estándar: rubi	Opcional
platform.roles.replication.enabled	Permite la integración de grupos de usuarios de SGU (versión on-premise/versión 6 del Gestão de Pessoas | HCM para el XPlatform) Valores posibles: true	Opcional
hcm.email.notification.enabled	Inicializa la configuración para la opción Recibir notificación por correo electrónico Valores posibles: true, false	Opcional
platform.multidomain.enabled	Habilita el soporte para el uso de dominios alternativos (multidominios). Cuando este parámetro se establece en true, indica que el tenant tiene más de un dominio. Valores posibles: true, false Importante Además de habilitar la propiedad platform.multidomain.enabled en Integrador HCM, debe realizar algunas configuraciones adicionales. Consulte la documentación de dominios alternativos de HCM para conocer todas las configuraciones requeridas.	Opcional
sync.request.enabled	Habilita/deshabilita la sincronización en el contexto SeniorX > SeniorXT del Integrador HCM. El valor predeterminado de la propiedad sync.request.enabled es true, sin embargo, este valor se puede cambiar a false. Cuando el valor es false, a su vez, el sistema no inicia ningún proceso de sincronización de contexto SeniorX > SeniorXT	Opcional

La implementación del Integrador HCM es suficiente para sincronizar los datos generales de HCM en entornos híbridos.

En algunos escenarios, es común utilizar Integrador ETL para integrar grupos de usuarios y usuarios (SGU), pero hay situaciones en las que esto no se recomienda.

La siguiente documentación muestra escenarios posibles y cómo ocurren.

HCM + ETL con el ERP:

Cuando se utilizan ETL y ERP de Senior, se recomienda no utilizar ETL para sincronizar grupos de usuarios y usuarios , ya que existe el riesgo de duplicación de usuarios y grupos en la base.

Por lo tanto, en este escenario, debe realizar las siguientes configuraciones para deshabilitar la sincronización de grupos de usuarios y usuarios :

1. Deshabilitar tablas de replicación:
   1. Accede a la plataforma senior X con un usuario administrador del tenant.
   2. Acceda al menú: Tecnología > Administración > Integración > Replicación.
   3. Deshabilite las siguientes tablas de replicación de usuarios ETL:
      • R900CPL
      • R900GRP
      • R900PDT
      • R999USU
2. Configurar inicio de sesión unificado:
   • Accede a la aplicación Central de Configurações Senior (SeniorConfigCenter) y configure el inicio de sesión unificado de base de datos. Para obtener detalles sobre cómo realizar este procedimiento, consulte la documentación completa en el Manual de tecnología .

A través del Integrador HCM, es posible cargar datos de usuario para utilizar la aplicación. Marcação de Ponto | HCM: por lo tanto, no es necesario habilitar el módulo Panel de Gestión. A continuación, consulte las instrucciones:

1. Acceda a Sara del Suporte en https://suporte.sara.senior.com.br/;
2. Haga clic en la opción Tenant y luego en Me gustaría solicitar la creación de un tenant;
3. Ingrese su nombre de usuario y contraseña;

Nota

Para solicitar la creación de un tenant, su usuario debe tener permiso para hacerlo.

4. En la pantalla de Sara, solicita el tenant de la APP - Marcação de Ponto. Para hacerlo, seleccione la opción APP - Marcação de Ponto, presente en el ítem Número de empleados por módulo;
5. Haga clic en Solicitar creación;
6. Una vez cumplida, esta solicitud subirá al Integrador HCM.

En Integrador HCM, la APP - Marcação de Ponto se mostrará en:

• En la pestaña Dashborad, se mostrará la APP - Marcação de Ponto en la tarjeta de Módulos activos;
• En la pestaña Integración, se mostrará la APP - Marcação de Ponto en la tarjeta Flujo, que contiene tres flujos. Ellos son:
  • usuarios de HCM;
  • Grupos de usuarios;
  • Usuarios del grupo.

Tras realizar este proceso se cargarán los datos del usuario y los empleados ya podrán utilizar la aplicación Marcação de Ponto | HCM.

Es posible personalizar los flujos modificando los comandos SQL. Estos comandos se ejecutan en Gestión de Personas | HCM on-premise, cambiando los datos que se integrarán.

Cómo personalizar un flujo

1. Acceda a la carpeta Consultas, que se encuentra en el mismo directorio que la instalación de Integrador - HCM.
2. Dentro de la carpeta Consultas, haga una copia del archivo de consulta (.sql) que desea personalizar y agregue la extensión .usu al final.
   
   Ejemplo:
   • Archivo original: g5-accounting-query.sql
   • Archivo copiado: g5-accounting-query.sql.usu

   Importante

   La codificación del archivo .usu debe ser UTF-8 (Sin BOM) para que el Integrador - HCM pueda interpretarlo. No se admiten otros tipos de codificación.

3. Asegúrese de que el nuevo archivo tenga la extensión correcta.
   
   Ejemplo:
   

La existencia del archivo .usu durante la integración y sincronización le indica al Integrador - HCM que debe considerar esta consulta, en lugar de utilizar el archivo original (.sql).

Si modifica directamente el archivo de consulta original (.sql), se sobrescribirá durante la actualización de Integrator - HCM y sus cambios se revertirán.

No es necesario reiniciar el Integrador - HCM para que se utilice la consulta personalizada, ya que la actualización se produce en tiempo real.

Cómo comprobar la versión del Integrador HCM

En la pantalla de inicio del panel del Integrador HCM, en el campo Versión de Integrator, se muestra la versión en ejecución actual.

Cómo saber si el Integrador - HCM se actualiza automáticamente

Siempre que la propiedad updater.disable en el archivo Integration.properties esté configurada en false, cuando exista una nueva versión, el integrador se actualizará automáticamente cuando se reinicie su servicio respectivo.

Mientras se ejecuta, Integrador HCM también tiene una tarea programada que cada seis horas busca una versión más nueva disponible para descargar. Si se encuentra una nueva versión, se activa un proceso de reinicio automático para que se produzca la actualización.

Cómo comprueba Integrador HCM si hay una nueva versión para actualizar

Se encuentra una nueva versión cuando la versión registrada en el archivo version.properties tiene una fecha inferior a la versión disponible para descargar.

Cómo monitorear el proceso de actualización del Integrador HCM y verificar si ocurre algún error en este proceso

El progreso de la actualización se puede monitorear mediante el archivo updater.log, presente en la carpeta de registro del Integrador HCM. Este archivo registra todo el proceso de actualización y posibles fallos, como por ejemplo en el caso de no poder acceder al servidor donde está alojada la nueva versión.

El dashboard de integración le permite ver información a través de tarjetas y realizar acciones relacionadas con Integrador HCM.

El dashboard (hcm-monitor) se encuentra dentro de la instalación de la aplicación (hcm-integration.zip).

Ver y activar módulos contratados

En el card Módulos activos es posible visualizar los módulos contratados, con su respectivo estado de activación.

Los módulos recién contratados pueden ser activados por la propia tarjeta, acción que hace que el Integrador HCM se reinicie y registre los flujos y sincronías necesarios para el funcionamiento del módulo. También son recriadas todas las triggers de monitoreo en la base de datos de Gestión del Capital Humano | HCM on-premises, dejando los flujos disponibles para realización de la carga inicial.

O sea, los flujos, sincronias y triggers de módulos recién contratados no entran en funcionamiento hasta que la activación del módulo sea realizada. El proceso de activación de un módulo de negocio puede llevar algunos minutos, y siempre que ocurrir, sus respectivos flujos serán marcados como pendientes de carga, visto que determinados flujos necesitan de una nueva ejecución para cargar nuevos campos específicos del módulo recién activado.

Seleccionar y ejecutar flujos para la carga inicial

Los fluxos de integração estão agrupados por módulo en el card Flujos de la pestaña Integración. De esta forma, al implantar un módulo, es posible seleccionar solamente los específicos para ejecutar la carga inicial, pues en esta ya constan todos los flujos necesarios para el funcionamiento. A través de este card también es posible identificar cuáles flujos aún necesitan ser ejecutados para finalizar la implantación del módulo.

Al seleccionar un módulo, los flujos de su carga inicial son exhibidos en orden de ejecución. Los flujos presentados en el color verde ya tuvieron su carga inicial ejecutada, y los presentados en el color negro están con la ejecución aún pendiente. Es posible ejecutar solamente los flujos cuya ejecución está pendiente, o también ejecutar nuevamente los que ya tuvieron la carga inicial.

El botón Ejecutar carga a partir del flujo seleccionado solamente es habilitado cuando sólo un flujo sea seleccionado, y ejecuta la carga inicial comenzando por el flujo en selección y siguiendo la secuencia. Ya el botón Ejecutar carga completa puede ser utilizado para la ejecución de la carga inicial completa de todos los flujos de los módulos activos.

Visualizar flujos ya ejecutados o pendientes de carga inicial

Es posible visualizar los flujos que ya tuvieron la carga inicial ejecutada o los que aún están pendientes a través de los cards Flujos con cargas iniciales ya realizadas y Flujos pendientes de carga inicial.

A través de estos cards es posible visualizar cuáles flujos ya tuvieron sus respectivas cargas iniciales ejecutadas por completo (independientemente de la ocurrencia o no de errores) y cuales flujos aún están pendientes de carga. A través de los botones Agregar y/o Agregar Todos es posible incluir los flujos pendientes de carga en la fila de ejecución.

Lista de flujos por módulo o rutina

La tabla abajo presenta el nombre de los flujos de la carga inicial y el archivo .sql que contiene la query. Los archivos pueden ser consultados en el directorio queries del integrador.

Flujos opcionales

Los siguientes flujos son opcionales y no se ejecutan durante la carga inicial ni se pueden seleccionar a través de la lista de flujos. Para ejecutarlos, debe ingresar el nombre del flujo en el cuadro de búsqueda, ubicado justo encima de la lista de flujos:

• Contactos emergenciales de las personas
• Configuración (enviar notificaciones por correo electrónico)

Los siguientes procesos se integran desde HCM en senior X de regreso a la base de HCM XT, pasando por el Integrador HCM:

Nombre del proceso	Nombre que se muestra en los registros del Integrador HCM	Tablas HCM XT que recibirán los datos integrados
Dependientes - Datos personales	DependentRequestFlow	R036DEP
Dependientes - Impuesto de renta	DependentIncomeTaxRequestFlow	R036IRF, R036DEP
Dependientes - Foto	DependentPhotoRequestFlow	R036FOT
Dependientes - Comprobantes de salario familia	FamilySalaryDocumentRequestFlow	R036EDU
Historial de cuentas bancarias de pensiones judiciales	HistoricalJudicialPensionBankAccountRequestFlow	R036CPJ
Ajustes de la pensión judicial	JudicialAdjustmentRequestFlow	R036PJA
Pensión judicial - Base mensual	JudicialBaseMonthlyRequestFlow	R036PJN
Pensión judicial - Base de participación en las utilidades	JudicialBasePlrRequestFlow	R036PJL
Pensión judicial - Sueldo base aguinaldo	JudicialBaseSalary13RequestFlow	R036PJD
Pensión judicial - Base vacacional	JudicialBaseVacationRequestFlow	R036PJF
Beneficiarios (Alimentandos) de la pensión judicial	JudicialPayeeItemRequestFlow	R036PPD
Pagos de la pensión judicial	JudicialPaymentRequestFlow	R036PJP
Pensiones judiciales	JudicialPensionRequestFlow	R036PJU
Entradas de prorrateo: ubicación y posición	ApportionmentEntryDepartmentJobPositionRequestFlow	R020RLC
Liberaciones de prorrateo - Empleado	ApportionmentEntryEmployeeRequestFlow	R020RMO
Entradas de excepción de prorrateo: ubicación y posición	ApportionmentEntryExceptionDepartmentJobPositionRequestFlow	R020ELC
Entradas de excepción de prorrateo - Empleado	ApportionmentEntryExceptionEmployeeRequestFlow	R020EXC
Bases de cálculo para enlaces múltiples	EmployeeCalculationBasisRequestFlow	R044BAS
Lanzamiento aguinaldo	Entry13SalaryRequestFlow	R044D13
Lanzamientos fijos	FixedEntryItemRequestFlow	R044FIX
Lanzamientos variables	VariableEntryItemRequestFlow	R044MOV
Tipos de anotaciones de los formularios registro	AnnotationTypeRequestFlow	R022NO
Prorrateos	ApportionmentRequestFlow	R020RATA
Asistentes	AttendantRequestFlow	R108TAT
Horarios de la búsqueda automática	AutomaticWorkScheduleSearchRequestFlow	R006HBA
Agencias bancarias	BankBranchRequestFlow	R012EDAD
Bancos	BankRequestFlow	R012BAN
Variedades	CasteRequestFlow	R114CAS
CID por CNAE	CidByCnaeRequestFlow	R192CNA
Ciudades	CityRequestFlow	R074CID
Rangos de marcación de horario	ClockingEventBandsRequestFlow	R004FHR
Programar citas	ClockingEventOfWorkScheduleRequestFlow	R004MHR
Índices de conversión	ConversionRatesRequestFlow	R026ICM
Países	CountryRequestFlow	R074PAI
Monedas	CurrencyRequestFlow	R026MOE
Deficiencias	DisabilityRequestFlow	R022DEF
Enfermedades (CID)	DiseaseRequestFlow	R192DOE
Tipos de documentos	DocumentTypeRequestFlow	R022DOC
Grados de instrucción de los empleados	EducationDegreeRequestFlow	R022GRA
Tipos de dirección electrónica	ElectronicAddressRequestFlow	R022EEL
Vínculos de trabajo	EmploymentRelationshipRequestFlow	R022VIN
Naturalezas de Gasto	ExpenseNatureRequestFlow	R048NAT
Índices	FinancialIndexRequestFlow	R026IDM
Fechas Festivas	HolidayDatesRequestFlow	R002FEC
Festivos	HolidayRequestFlow	R002FEM
Índices - Valores	IndexValueRequestFlow	R026IDV
Seguros	InsuranceRequestFlow	R166SEG
Actividades de servicio	IssActivityRequestFlow	R022ISS
Limites de exención de ISS	IssLimitRequestFlow	R022LIM
Áreas de conocimiento	KnowledgeAreaRequestFlow	R171ACN
Precios de línea de transporte	LinePricesRequestFlow	R028PRT, R028PRM
Medios de transporte	MeansOfTransportRequestFlow	R028MVT
Motivos de las movimientos	MovimentationReasonRequestFlow	R076MOT
Nacionalidades	NationalityRequestFlow	R023NAC
Barrios	NeighborhoodRequestFlow	R074BAI
Pareceres	OpinionRequestFlow	R106PAR
Estructura de Organigrama	OrganizationalChartStructureRequestFlow	R016ORE
Puntos de embarque	PointEmbarkationRequestFlow	R028BVT
Siglas de los consejos profesionales	ProfessionalBoardAcronymRequestFlow	R022SIG
Consejos profesionales	ProfessionalCouncilRequestFlow	R022PRF
Áreas	PublicPlaceRequestFlow	R074CALLE
Calificaciones	QualificationRequestFlow	R022QUA
Religiones	ReligionRequestFlow	R114RLR
Motivos de la despido	ResignationReasonRequestFlow	R114RMD
Estados	StateRequestFlow	R074EST
Estructuras	StructureRequestFlow	R000EST
Subgrupos de Enfermedades (CID)	SubgroupDiseaseRequestFlow	R192SUB
Montos de las escalas de bonos de transporte	TransportationVoucherScaleItemRequestFlow	R028EVL
Básculas de bonos de transporte	TransportationVoucherScaleRequestFlow	R028EVT
Líneas de transporte	TransportLineRequestFlow	R028LVT
Grupo de Selección de los Eventos	WagetypeGroupRequestFlow	R008SEL
Horarios	WorkSchedulesRequestFlow	R004HORA
Clases de la Escala	WorkshiftClassRequestFlow	R006CLE
Equipo de la escala	WorkshiftGroupRequestFlow	R006TMA
Escalas (turnos)	WorkshiftRequestFlow	R006ESC
Horario de Escala	WorkshiftScheduleRequestFlow	R006HORA
Ramos de Actuación	ActivityfieldRequestFlow	R032ATU
CBO 2002	Cbo2002RequestFlow	R024CB2
Clasificación brasileña de ocupaciones (CBO)	CboRequestFlow	R024CBO
Contratos	ContractRequestFlow	R032EMC
Centro de costos	CostCenterRequestFlow	R018CCU
Otras empresas - Datos en el exterior	DataAbroadOtherCompanyRequestFlow	R032EXT
Jerarquías de Cargos	HierarchyofficeRequestFlow	R024HIE
Adjuntos de cargos	JobPositionAttachmentRequestFlow	R024ANX
Cargo - Órgano Público	JobPositionPublicBodyRequestFlow	R024CPU
Cargos	JobPositionRequestFlow	R024CAR
Requisitos del Cargo	JobPositionRequirementsRequestFlow	R024RQU
Historial de informaciones salariales del cargo	JobPositionSalaryInfoRequestFlow	R024HIS
Complementos salariales para cargos	JobPositionSalaryPremiumRequestFlow	R038LAG
Niveles de Cargos	JobPositionStructureLevelRequestFlow	R024NIV
Estructuras de Cargos	JobPositionStructureRequestFlow	R024EST
Excepción de jefatura	LeadershipExceptionRequestFlow	R080EXC
Jefaturas	LeadershipRequestFlow	R080SUB
Áreas de Actuación	OccupationareaRequestFlow	R024AAT
Otras empresas	OtherCompanyRequestFlow	R032OEM
Otras empresas - Tipos de uso	UseTypesOtherCompanyRequestFlow	R032USO
Regiones administrativas	AdministrativeRegionRequestFlow	R074RAD
Programaciones de desvinculación	DismissalMovimentationRequestFlow	R042PRC
Anexos de las anotaciones de los formularios registro de los empleados	EmployeeAnnotationAttachmentRequestFlow	R038DHA
Anotaciones de los formularios registro de los empleados	EmployeeAnnotationRequestFlow	R038NO
Anuidades del empleado	EmployeeAnnuityRequestFlow	R034ANU
Seguros del empleado	EmployeeInsuranceRequestFlow	R034SEG
Modalidad PAT	EmployeePatModalityRequestFlow	R034PAT
Porcentuales libres del empleado	EmployeePercentageRequestFlow	R034PLI
Fotos de los empleados	EmployeePhotoRequestFlow	R034FOT
Empleado	EmployeeRequestFlow	R033PES, R034FUN, R038HVI, R110FIC, R110HDF, R038HSI, R034SIN, R038HSA, R038HPO, R038HFI, R038HCC, R038HCA, R038EVT, R038HLO, R038HES, R038HCS, R038CAT, NA R0, 34CON, R034ADM, R034ETG, R034PAT, R034CPL, R034CTR, R034SEG, R034SEL, R034ANU, R034EST, R034IEA, R034PLI, R034USO
Tipos de uso de terceros	EmployeeThirdPartyUsingTypeRelationshipRequestFlow	R034USO
Grupo de Selección de los Eventos del empleado	EmployeeWagetypeGroupRequestFlow	R034SEL
Historiales de cuentas bancarias de empleados	HistoricalBankAccountRequestFlow	R034CON
Historiales de sucursal	HistoricalCompanyBranchRequestFlow	R038HFI
Historiales de centro de costo	HistoricalCostCenterRequestFlow	R038HCC
Historiales de lugar del empleado	HistoricalDepartmentRequestFlow	R038HLO
Historiales de vínculo del empleado	HistoricalEmploymentRelationshipRequestFlow	R038HVI
Historiales de categorías del eSocial	HistoricalEsocialCategoryRequestFlow	R038CAT
Historiales de naturaleza de gasto	HistoricalExpenseNatureRequestFlow	R038HNA
Historiales de prorrogación de alejamiento	HistoricalExtensionLeaveRequestFlow	R038PRO
Historiales de IRRF	HistoricalIrrfRequestFlow	R038HRE
Historiales de cargo	HistoricalJobPositionRequestFlow	R038HCA
Archivos adjuntos del historial de empleados	HistoricalLeaveAttachmentRequestFlow	R038IMA
Historiales de alejamiento	HistoricalLeaveRequestFlow	R038AFA
Historiales de adicionales del salario	HistoricalSalaryPremiumRequestFlow	R038HAD
Historiales de salario del empleado	HistoricalSalaryRequestFlow	R038HSA
Historiales de categorías de SEFIP* del empleado	HistoricalSefipCategoryRequestFlow	R038HCS
Ítems de los historiales de sindicato del empleado	HistoricalSyndicateItemMainSyndicateRequestFlow	R038HSI
Ítems de los historiales de sindicato del empleado	HistoricalSyndicateItemOtherSyndicateRequestFlow	R034SIN
Historiales de sindicato del empleado	HistoricalSyndicateRequestFlow	R038HSI, R034SIN
Historial de contribución sindical	HistoricalSyndicateUnionContributionRequestFlow	R038HCO
Historiales de teletrabajos de los empleados	HistoricalTeleworkRequestFlow	R038HTT
Historial de contrato temporal	HistoricalTemporaryContractRequestFlow	R034CTR
Historiales de pasante	HistoricalTraineeRequestFlow	R034ETG
Historiales de escala	HistoricalWorkshiftRequestFlow	R038HES
Historiales de puesto de trabajo	HistoricalWorkstationRequestFlow	R038HPO
Históricos de estabilidades	HistoricStabilityRequestFlow	R038HEB
Registros de aviso previo de desvinculación	NoticeWorkedRequestFlow	R042AVI
Historiales de licencias retroactivas	RetroactiveHistoricalLeaveRequestFlow	R039AFA
Sindicato Rescisión	SyndicateDismissalRequestFlow	R014HOM
Colaboradores - Exámenes toxicológicos	ToxicologicalExaminationRequestFlow	R038HEX
Escala salarial	WageScaleRequestUpdateFlow	R076DES
Revisión de la tabla salarial.	WageScaleRevisionRequestUpdateFlow	R076EST

¿Qué es una sincronización pendiente?

La sincronización pendiente es un registro en la Gestión de Personas | HCM (versión 6) que tiene un cambio y necesita replicarlo en la base de datos HCM senior X.

Se considera que todas las operaciones realizadas en una de las tablas monitoreadas por HCM Integrator generan un problema pendiente. Las operaciones son: INSERT (inclusión de un nuevo registro), UPDATE (modificación de un registro) y DELETE (eliminación de un registro).

Cómo se generan los asuntos pendientes

Estos asuntos pendientes se generan mediante activadores en cada una de las tablas monitoreadas por Integrador HCM. La generación y mantenimiento de estos triggers se realiza en el momento de consistencia base que realiza Integrador HCM al inicializarse.

Ejemplos de nombres de triggers generados:

• RTC_R034FUN_I
• RTC_R034FUN_U
• RTC_R034FUN_D

Cuestiones pendientes

En la pestaña Sincronización del dashboard, puede encontrar el agrupador G5 → HCM abierto (programado).

Este agrupador muestra la cantidad de problemas abiertos que están programados para su ejecución nocturna.

La integración de las mesas en espera de ejecución nocturna se produce diariamente, entre las 18.30 horas de un día y las 8.00 horas del día siguiente.

La columna Horário Execução indica si los problemas pendientes de las tablas respectivas ya están en la cola para su procesamiento o si se programó el procesamiento de los problemas pendientes por la noche.

Dónde se almacenan los trabajos pendientes de sincronización

Los asuntos pendientes generados se almacenan en la tabla RTC_PENDENCIES, en la Gestión de Personas | HCM (versión 6).

Cómo identificar si una sincronización pendiente ya fue procesada

Los asuntos pendientes que ya han sido procesados por Integrador HCM continúan teniendo un registro en la tabla RTC_PENDENCIES, pero reciben un registro en la tabla HCM_PENDENCIES (también de la base de datos Gestión de Personas | HCM - versión 6). Por lo tanto, el Integrador HCM considera que el asunto pendiente ya ha sido debidamente tramitado.

Por lo tanto, una forma de identificar qué problemas de sincronización no se han procesado es ejecutando la siguiente consulta en Gestión de personas | HCM:

Ejecución de problemas de sincronización pendientes

El intervalo de tiempo para ejecutar sincronizaciones relacionadas con solicitudes en el contexto HCM > G5 será de 1 (un) minuto para los clientes que tengan habilitado el módulo de Nómina en el Integrador HCM; y 3 (tres) minutos para clientes que no tengan el módulo habilitado.

Integrador HCM tiene una rutina que permite al administrador configurar qué problemas de sincronización no deben procesarse.

Cómo funciona la rutina ignorar pendientes

Esta rutina se basa en la configuración del archivo de propiedades sync-ignorefields.properties (que se encuentra en la carpeta raíz de la instalación de Integrador HCM).

Si la sincronización pendiente de una tabla es como campos modificados , solo aquellos definidos en la propiedad (uno o más) tendrán el problema pendiente ignorado, insertándose así un registro en la tabla HCM_PENDENCIES en la Gestión de Personas | HCM (versión 6). Esto indica al Integrador HCM que el problema en cuestión debe considerarse "tramitado con éxito".

Cómo configurar el archivo sync-ignorefields.properties

En este archivo es necesario poner como clave el nombre de la tabla de Gestión de Personas | HCM (versión 6) y, como valor clave, los campos que deben ignorarse.

Por lo tanto, si Integrador HCM recibe una sincronización pendiente de cambiar solo uno de estos campos, el problema pendiente será ignorado.

También es posible configurarlo con el término ALL, por lo que se ignorarán todas las sincronizaciones pendientes de esa tabla, independientemente de qué campos se cambiaron.

Ejemplo de configuración del archivo:

La sincronización por lotes permite que las rutinas procesen sus tareas pendientes de forma independiente, agrupándolas por contexto y enviándolas al servidor de aplicaciones, proceso que ocurre de esta manera debido a las sincronizaciones que se ejecutan en grandes cantidades por día.

No necesita realizar ninguna configuración adicional para utilizar la rutina de sincronización por lotes, ya que está habilitada de forma predeterminada para todos los clientes.

Debido al decreto del Gobierno que suspendió el horario de verano por tiempo indeterminado, pode ser necesario ajustar el Integrador HCM para que los horarios del log de la aplicación queden correctos.

Procedimiento para adecuar los horarios del Integrador - HCM:

1. Haga la descarga del archivo tzdb.zip, disponible en: http://s3-sa-east-1.amazonaws.com/senior-hcm-integration/tzdb.zip
2. Descomprima el archivo que descargó y coloque el archivo tzdb.dat descomprimido en la carpeta lib del siguiente JDK:
   • Integrator JDK 11 - HCM (carpeta jdk-11.0.2 en el directorio de Integrador)
   • JDK 8 utilizado para instalar el Integrador - HCM (normalmente se puede encontrar en la variable de entorno %JAVA_HOME_HCM%)

   Importante

   Si la base de datos de la solución local es Oracle, coloque también el archivo tzdb.dat en la carpeta lib de Oracle Java.   Si esto no fuera hecho, el Java utilizado por el Oracle no tendrá las mismas configuraciones de fecha y hora, causando errores en las consultas que envuelven campos del tipo date y datetime.

3. Reinicie el servicio del Integrador - HCM para que la alteración sea aplicada.

HCM Integrator le permite integrar grupos de usuarios de SGU (versión local/versión 6 del Gestão de Pessoas | HCM para el XPlatform).

Cómo habilitar esta funcionalidad

1. Acceda a la carpeta raíz donde se instaló Integrator HCM (ejemplo: C:\HCM-Integrador\integration.properties);
2. acceder al archivo integration.properties;
3. Dentro del archivo Integration.properties, active (establezca en true) la clave platform.roles.replication.enabled;
4. Reinicie el Integrador HCM.

Al reiniciar el Integrador HCM, la integración de grupos de usuarios desde la SGU al XPlatform ya estará disponible.

Después de reiniciar Integrador HCM, los flujos de grupos de usuarios y usuarios de grupos se marcarán como pendientes en la pestaña Integración . Por lo tanto, es necesario ejecutar ambos grupos para inicializar la rutina. Con esto, enfatizamos una vez más la importancia de verificar/realizar los elementos resaltados en el cuadro Atención de arriba.

Cómo utilizar esta función

Con la funcionalidad habilitada, simplemente cree, cambie y/o elimine un grupo (así como los usuarios de un grupo) en la SGU. Al realizar cualquier tipo de cambio en el SGU, la información se sincronizará con el XPlatform.

La siguiente tabla aclara qué se cambia en el SGU y cuál/dónde está el impacto en XPlatform:

En SGU	En XPlatform
Grupo de usuarios (campos: Nombre , Descripción y Origen del grupo) Tabla de versión local/versión 6 donde se guardan los datos: Usuarios - Datos de personas (R900PDT)	Papel (campos: Nombre del papel , Descripción y Tipo)
Miembros Tabla de versión local/versión 6 donde se guardan los datos: Usuarios - Miembros del grupo (R900GRP)	Usuarios

Preguntas frecuentes

El sistema permite estandarizar el envío de notificaciones por correo electrónico a los usuarios de la empresa, esto se realiza a través del flujo de Configuración (enviar notificaciones por correo electrónico) . Para hacer esto, debe seguir los pasos a continuación para habilitar esta funcionalidad.

1. En la pestaña Integración, ingrese el flujo Configuración (enviar notificaciones por correo electrónico) en el cuadro de búsqueda encima de la lista de flujos;
2. Luego haga clic en Ejecutar flujo seleccionado;

3. Acceda a la carpeta raíz donde se instaló el Integrador HCM (ejemplo: C:\HCM-Integrador\integration.properties);
4. acceder al archivo integration.properties;
5. Dentro del archivo integration.properties, ingrese la clave hcm.email.notification.enabled = true;
6. Reinicie el Integrador HCM para que se pueda leer esta nueva clave;
7. Ejecute el flujo de Configuración (enviar notificaciones por correo electrónico);

La pantalla de Asociación de colaboradores y usuarios, a la que se accede desde XPlatform en Gestión de Personas | HCM > Integrador HCM > Asociación de Usuarios Colaboradores, permite la consulta y asociación de usuarios creados con el colaborador correspondiente en HCM.

• Para los clientes que se integran con SeniorX a través de XT, la pantalla solo se usa para consultar a los empleados asociados.
• Para quienes se integran vía Novasoft (es decir, sin XT), la pantalla sirve, además de consultas, para inclusión y eliminación de asociaciones. En este caso, esta funcionalidad es esencial para definir quién tendrá acceso a la XPlatform, asegurando que cada usuario tenga los permisos adecuados asociados a su perfil.

En esta pantalla los administradores o personas autorizadas por ellos podrán realizar las siguientes acciones:

• Asociar/Incluir: permite la inclusión de nuevas asociaciones entre colaboradores y usuarios;
• Desasociar/Eliminar: permite eliminar asociaciones previamente establecidas;
• Consultar: le permite ver las asociaciones existentes.