Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Manual de Instalación de
Gestión de tiempos
Versión 3
1 de 22
Tabla de contenido
Tabla de contenido.......................................................................................................................... 2
Introducción ........................................................................................................................................ 3
Sobre Albany Technologies ............................................................................................................. 3
Familia de productos de AxisOne .................................................................................................... 3
Administración de Personal y Remuneraciones (HRB y HRC) ..................................................... 3
Gestión de Tiempos (HRT) ........................................................................................................... 4
PeopleGate (Intranet) ................................................................................................................. 4
Integración con SAP BUSINESS ONE ................................................................................................ 5
Utilización del UIAPI .................................................................................................................... 5
Utilización del DIAPI .................................................................................................................... 5
Integración funcional (Sin redundancia de datos) ...................................................................... 5
Algunos de los objetos del SDK que son utilizados por AxisOne .................................................... 6
Integración con la base de datos. ................................................................................................... 6
Integración con la seguridad de acceso .......................................................................................... 7
Otros puntos de integración que deben considerarse.................................................................... 7
Instalación de Gestión de Tiempos AxisOne ....................................................................................... 9
Archivos de instalación.................................................................................................................... 9
Proceso de captura y análisis de marcas........................................................................................... 14
Captura de marcas ........................................................................................................................ 14
Captura de marcas por indicador de marcas ............................................................................ 14
Captura de marcas por auto asignación.................................................................................... 15
Análisis de las marcas .................................................................................................................... 16
Archivo de configuración MAP ...................................................................................................... 17
Configuración de los modelos de captura de marcas ............................................................... 20
Función GTMARCAS ...................................................................................................................... 21
Tabla @A1A_TURNOSPLAN........................................................................................................... 22
2 de 22
Introducción
Sobre Albany Technologies
Albany Technologies, es una empresa Partner de SAP en la categoría de ADP (Application
Devolopment Partner), es decir la categoría de Partner especializado en la construcción de Add-
Ons (Extensiones integradas de software para SAP BUSINESS ONE).
Como Partners ADP de SAP nuestra misión es la construcción de Add-Ons “Integrados” que
permitan administrar completamente los Recursos Humanos y Remuneraciones del personal,
considerando entre otros objetivos, que la funcionalidad de los Add-Ons se ajuste perfectamente
a la legislación de cada país y que cumplan con todas las normas de integración requeridas por
SAP BUSINESS ONE.
Administración de personal
Definiciones y parámetros
Maestro de empleados (Con todos sus antecedentes)
Licencias
Permisos
Inasistencias
Vacaciones
Descripción de cargos
Contratos y documentos
Informes de gestión
Remuneraciones
Conceptos y Fórmulas
Eventos
Imputaciones Contables
Procesos de cálculo
Informes de pago
3 de 22
Informes legales
Pólizas contables
Bancos
Procesos históricos
Pagos a Terceros
Utilitarios
Organigrama
Editor de informes
Tablero de indicadores
Migración e Importación de datos
Es importante considerar que los módulos HRB y HRC están ajustados perfectamente a la
legislación y a las mejores prácticas de cada país.
PeopleGate (Intranet)
Este producto permite a los Managers y a los Empleados acceder a un producto dentro de una
plataforma colaborativa para obtener información en línea, tales como: Certificados,
Comprobantes de pago, Contratos, Visualización de las cuentas corrientes, Registros de
inasistencias y licencias, Hoja de tiempos, Vacaciones, Organigramas, Informes de gestión, Ficha
de los empleados, etc.
http://albany.company/
4 de 22
Integración con SAP BUSINESS ONE
Desde la perspectiva de construcción de soluciones integradas nuestro producto AxisOne
Recursos Humanos ha sido cuidadosamente diseñado para cumplir con todas las normas y
estándares impuestas por SAP, tales como:
El uso del DIAPI nos permite integrarnos totalmente con el mecanismo de manejo de objetos de
SBO y esto garantiza, entre otros: Cambiar rápidamente a las nuevas versiones liberadas al
mercado por SAP, acceder a nuevos métodos y propiedades disponibles en los objetos de la
DIAPI, realizar transferencias de información en forma integrada entre los distintos módulos de
SBO y nuestro producto, por ejemplo, nuestro producto utiliza objetos de la DIAPI para transferir
datos a SBO para emitir cheques para el pago de las remuneraciones del personal, acceder a las
sociedades o usuarios definidos en SBO, enviar el Voucher contable de remuneraciones al módulo
de finanzas, acceder a la lista de bancos, tipos de monedas e índices, cuentas contables, centros
de beneficio, proyectos, etc.
Base de datos (Utiliza las mismas instancias de base de datos que utiliza SBO)
5 de 22
Usuarios
Monedas e índices
Bancos
Sucursales
Parametrizaciones generales (Tipos de datos, sistema de puntuación decimal, rutas de
acceso, colores de fondo, fuentes, etc.)
Centros de beneficio
Proyectos
Nacionalidades
Países
Regiones (También pueden denominarse como: Distritos o Departamentos)
Calendario de feriados y festivos
Cuentas contables
Roles y Funciones
Datos de las sociedades (Nombre, dirección, teléfonos, etc.)
Catálogo de datos (Diccionario de datos de la base de datos de SBO)
Etc.
En resumen, nuestros productos no solo cuentan con los estándares gráficos de visualización, sino
que cumplen con la característica más importante para los productos integrados y eso es la no
redundancia de datos y la integración técnica y funcional.
Sin embargo como característica básica para una buena integración AxisOne no genera
“Redundancia de datos” (Repetición de datos) con respecto a las definiciones ya existentes dentro
de SAP BUSINESS ONE y por ende es necesario que tenga presente que existen otras
definiciones que se parametrizan en otros módulos del ERP y que son utilizadas por nuestro Add-
6 de 22
On, tales definiciones deben existir porque son muy importantes para un adecuado y oportuno
funcionamiento del producto, a saber:
7 de 22
comisiones de ventas, bonos de producción, ventas de mercaderías al personal,
acceso a los socios de negocios, etc.; en resumen, podemos acceder desde el
cálculo de AxisOne a la totalidad de la base de datos del ERP y de este modo
automatizar sus procesos de cálculo como solo un producto totalmente integrado
puede hacerlo
8 de 22
Instalación de Gestión de Tiempos AxisOne
Archivos de instalación
Ilustración 1
AxisOneCriptoPG.exe: Este archivo permite codificar los datos del servidor SQL y datos
de usuario. Así, prevenimos la intrusión de usuarios no autorizados al Servidor de Base
de datos. Como se observa en la ilustración 2, debemos ingresar el nombre de usuario del
Servidor SQL, la Password o contraseña del usuario ingresado, ingresamos el nombre del
servidor SQL (NO ingresar IP del servidor), y por ultimo presionamos el botón “Generar
encriptación”, para que los datos ingresados sean encriptados.
Ilustración 2
9 de 22
GTConfigFile.txt: Este archivo permite que el instalador y el programa de Gestión de
Tiempos pueda accesar al servidor de base de datos. Para ello debemos de copiar los
datos encriptados (ver ilustración 2), en cada línea siguiendo el orden dado en el archivo.
Ilustración 3
10 de 22
Ilustración 4
En esta ventana “Ilustración 5”, podemos cambiar la ruta de instalación o dejar la ruta que
el instalador nos sugiere, acto seguido presionamos el botón “Siguiente”.
Ilustración 5
11 de 22
Ilustración 6
Una vez terminada la instalación presionamos el botón “Finalizar” para salir del proceso
de instalación de Gestión de Tiempos.
Ilustración 7
12 de 22
Una vez terminada la instalación vamos a la ruta donde fue instalado Gestión de tiempos
y verificamos que existan los archivos necesarios para utilizar Gestión de tiempos como
se muestra en la ilustración 8.
Ilustración 8
13 de 22
Proceso de captura y análisis de marcas
Captura de marcas
Existe en Gestión de Tiempos dos modelos de captura de marcas provenientes del reloj
control de horario o checador. Estos modelos permiten que Gestión de tiempos interactúe
con relojes (checadores), de cualquier marca y tipo, siempre y cuando el software del reloj
control (checador) genere un archivo de texto el cual contenga como mínimo lo siguiente:
Esta es la información necesaria para la lectura del archivo y posterior importación de las
marcas a AxisOne. Muchos relojes lo que permiten es identificar más de una marca
cuando se requiere registrar las entradas y salidas del lugar de trabajo de los empleados,
esto quiere decir que se puede llevar el registro no tan solo del horario de entrada y
salida, sino que también se puede llevar el control de la salida y entrada del tiempo de
almuerzo o comida.
Para llegar a este nivel de detalle Gestión de tiempos, como se explica al inicio permite el
uso de dos modelos para realizar la lectura e importación de marcas, explicamos en
detalle cada una de ellas a continuación.
Para realizar la lectura e importación de las marcas desde el archivo de texto, podemos
utilizar el modelo nativo de Gestión de Tiempos, el cual, consiste en la utilización de un
indicador para cada marca de asistencia.
Muchos relojes solo entregan por defecto dos tipos de marcas IN y OUT, lo cual permite
llevar el registro de las entradas y salidas, para ello, se configura el archivo MAP y la
función GTMARCAS (para saber cómo se hace vaya a la sección Función GTMARCAS),
con lo cual, tendrán el registro de entrada y salida diariamente (esto solo si registran dos
marcas), para el caso que quieran registrar cuatro marcas, es decir:
14 de 22
Lo ideal al utilizar este esquema y es que cada marca tenga un indicador propio, este
indicador puede ser alfanumérico o numérico, ¿que logramos con esto?, que cada vez
que se registre una marca en el reloj (checador), ya tiene una posición y al importar esta
maraca ira a la posición que le corresponde según el indicador de la marca.
El modelo de auto asignación de marcas se utiliza cuando el software del reloj control
(checador) no entrega un indicador de marca.
La forma de asignación de marcas está dada por orden de registro, ejemplo, un empleado
marca a las 8 de la mañana, Gestión de Tiempos busca hacia atrás n cantidad de horas,
supongamos que n = 10 horas, entonces el siclo de importación seria así:
- El mismo empleado marca a las 13:00 hrs. para tomar el tiempo de descanso,
entonces se aplica la misma lógica anterior, se utiliza el umbral de búsqueda
desde las 03:00 hasta las 13:00 del miso día, el sistema en ese rango encontrara
la marca de las 08:00, por ende, la marca de las 13:00 se considera salida
- A la vuelta del descanso se marcó a las 14:00 hrs., aplicando la misma lógica, esta
marca se considera como una entrada y la marca del término de la jornada de
trabajo se considera como salida.
Supongamos que la persona por error o por no tener seguridad si marco, vuelve a
marcar, pues, Gestión de tiempos lo consideraría ya sea entrada o salida
(dependiendo la hora), y de ahí para adelante se producirán inconsistencias ya que
perderán el orden lógico, solo por marcar dos veces.
Este modelo de auto asignación es muy útil cuando el reloj (checador) no entrega un
indicador de marca. Pero también tiene sus contras cuando los empleados no registran
adecuadamente sus ingresos y salidas, basta un error en el ciclo para cambiar la lógica
de las marcas.
15 de 22
El umbral de tiempo utilizado para la lectura hacia atrás por defecto está en 10 horas, y es
perfecto cuando tiene jornadas de trabajo de 8 horas o menos, si tiene jornadas de más
de 8 horas de trabajo se recomienda utilizar un umbral de no más de 21 horas, de esta
forma controla adecuadamente la permanencia del empleado en la empresa.
¿Qué pasa cuando por error marcaron dos veces una entrada o salida?
Respuesta: puede funcionar correctamente, pero que pasa si llega un empleado y marca
a las 8 de la mañana y entre los primeros 5 o 10 minutos debe retirarse y marca
nuevamente, esta vez para retirarse. El sistema no va a considerar esta marca porque
está dentro del umbral de tiempo que es considerado para evitar la duplicidad de marcas
dejando una inconsistencia para ese día como una entrada sin salida.
El análisis de las marcas se realizara según la posición de las marcas y del horario
asignado para cada día de trabajo, este análisis se realiza una vez que Gestión de
Tiempos termina de importar las marcas en AxisOne.
- Se lee la primera marca del primer empleado habilitado para el análisis de tiempo
(se valida estado del empleado, fecha de contratación, tipo control horario, fecha
de asignación de turno, turno asignado, tipo de calendario, autorización de horas
extras, cambios de horarios, histórico de horarios, licencias, vacaciones, permisos,
inasistencias y por último el calendario de tiempos)
- Luego con toda esa información, el sistema realiza una comparación entre las
marcas registradas para el día con el horario asignado para ese día y de ahí
entrega si hay atrasos, inasistencias y tiempo extra, si existiesen inconsistencias
16 de 22
en las marcas el análisis no será el correcto y Gestión de Tiempos registrara para
ese día en particular el tipo de inconsistencia y así sucesivamente con cada
empleado habilitado.
Al término del análisis, el usuario de planilla o nóminas, está obligado a revisar el análisis
del tiempo de cada empleado, corrigiendo las inconsistencias encontradas y justificando el
tiempo que no se descontara al empleado.
Una vez que revise la información que puede obtener del software de administración del
reloj de control (checador), podrá definir el tipo de captura de marcas.
Para definir la configuración del archivo de texto que genera el software del reloj, el cual
será utilizado por Gestión de Tiempos, debemos editar la configuración del archivo de
texto llamado MAP.TXT, este se encuentra en la ruta donde fue instado Gestión de
Tiempos, por defecto debe ser esta la ruta: "C:\Program Files (x86)\AxisOne\Gestión de
Tiempos" o "C:\Program Files\AxisOne\Gestión de Tiempos.
Al realizar la edición del archivo MAP.txt, encontraremos varias líneas las cuales se
detallan a continuación:
// dd día
// mm mes
// yyyy año 4 dígitos (También puede ser yy)
// e código de empleado / tarjeta
// r código de reloj
// hh hora
// nn minutos
// c código de marca (E,S,0,1,01,02,03,04,IN,OT) o (00,10)
// b espacios en blanco, vacíos o nulos (Se ignoran)
// t tipo de registro (H,C)
// o referencias o comentarios
// * Se utiliza como wildcard dentro del nombre del archivo
Esta sección nos muestra los caracteres de mapeo, esto nos sirve para saber que
caracteres ingresar para cada línea que se detalla más abajo.
UPDATE AFTER READ VALUE=Y POSITION=48 = Esta línea nos permite insertar un
indicador en la posición que se defina, este indicador se insertara la primera vez que se
lea el archivo y evita la duplicidad en futuras lecturas del mismo archivo. En este ejemplo
insertaremos la letra Y en la posición 48 de cada línea leída.
17 de 22
RENAME AFTER READ = Esta línea permite renombrar el archivo de marcas una vez
leído por Gestión de tiempos, si no queremos renombrar el archivo debemos comentar
esta línea agregando “//” al inicio de la frase, ej.: //RENAME AFTER READ
FTPPASS= Password del usuario del FTP a utilizar para leer las marcas cuando se utiliza
el sistema RIS de AxisOne. La información Ingresada se encripta como política de
seguridad
FTPHOST= Dirección del FTP a utilizar para leer las marcas cuando se utiliza el sistema
RIS de AxisOne. La información Ingresada se encripta como política de seguridad
FTPDIR= Directorio de trabajo del FTP a utilizar para leer las marcas cuando se utiliza el
sistema RIS de AxisOne. La información Ingresada se encripta como política de seguridad
En la práctica, el archivo de marcaje que se descarga del reloj debe ser guardado en una
carpeta compartida en la red, para que los usuarios que utilizaran Gestión de tiempo
puedan tener acceso a él.
FILENAME = Aquí se debe indicar el nombre del archivo que tiene las marcas del reloj
FILENAME =Marcas_*.txt, de esta forma Gestión de Tiempos ira a leer todos los archivos
que comienzan con Marcas_ cuya extensión sea .txt.
18 de 22
Es importante saber que si define el código de empleado “eee”, Gestión de tiempos
espera leer un código de tres caracteres, eso quiere decir que el reloj (checador) debe
entregar los datos del código de empleado de la siguiente forma:
- 001
- 010
- 100
Gestión de Tiempos NO leerá la línea si el código de empleado tiene largo variable como
por ejemplo:
- 1
- 10
Si define el largo de cada columna, los datos deben cumplir el largo especificado, de lo
contrario no se procesara el archivo de texto.
MARK-H = Si el reloj que utiliza tiene un identificador horario puede definirlo en esta línea
MARK-CONS = Si ha definido una marca de consumo, entonces aquí debe especificar las
marca del reloj de uso del consumo
HRSANT= Umbral de tiempo utilizado para la lectura hacia atrás por defecto está seteado
a 10 horas, y es perfecto cuando tiene jornadas de trabajo de 8 horas o menos, si tiene
jornadas de más de 8 horas de trabajo se recomienda utilizar un umbral de no más de 21
horas, de esta forma controla adecuadamente la permanencia del empleado en la
empresa.
19 de 22
MARK-IN=I,1
MARK-OUT=O,0
//MARK-CONS=0
HRSANT=10 (habilitado para la versión 9.6 en adelante)
----------------------------------------------------------------
// = sirve para comentar una línea, la cual no será leída por Gestión de Tiempos
Si se va a utilizar el modelo de captura con dos indicadores de marca suponiendo que los
indicadores son I y O, debemos utilizar los parámetros MARK-IN y MARK-OUT de la
siguiente forma:
MARK-IN=I
MARK-OUT=O
MARK-IN=1,3
MARK-OUT=2,4
//MARK-IN=I
//MARK-OUT=O
20 de 22
La cantidad de archivos de marcas a leer va a depender de cuantos relojes disponga en la
empresa, no hay límite de lectura y captura.
Función GTMARCAS
Esta función nos permite en primer lugar, importar en la tabla MARCAS, los datos leídos
desde los archivos de texto, eso se debe a que al término de la formula tenemos el
parámetros ResultOK. Al cambiar el valor de ResultOK a FALSE, no se importaran las
marcar en la tabla, al dejarlo en True, las marcas serán importadas a la tabla para su
posterior análisis.
La última versión 9.2 de Gestión de Tiempos, permite utilizar esta funcionalidad, además
de esto, también esta versión controla la duplicidad de marcas utilizando un umbral de
tiempo de un minuto entre una marca y otra, omitiendo automáticamente las marcas que
estén dentro de ese umbral de tiempo. Esto aplica para todas las marcas, ya sean
entradas o salidas, o sea misma fecha y hora OMITE desde la segunda en adelante hora,
este control se hace tanto en el archivo de texto y en la tabla de marcas.
Con estas variables en “N”, haremos que se utilice la opción de captura por auto
asignación. Si se hace esto sEntrada := "N"; y sSalida := "N"; se estaría obviando el
indicativo que siempre se pide, que el archivo INDIQUE el sentido de la marca porque
viene una "N" en sEntrada si es ENTRADA o la "N" en SSalida si es una SALIDA ahora
bien si pisamos el sentido de la marca con esto el sistema como no sabe si es entrada o
salida aplica la lógica explicada en la sección Captura de marcas por auto asignación.
21 de 22
Tabla @A1A_TURNOSPLAN
Al actualizar el AddOn de RRHH (HRB), este creara la tabla para que pueda comenzar a
crear los reportes necesarios.
22 de 22