Configurar la integración de exportación de marcajes universal

Este tema describe cómo configurar esta integración.

Esta integración exporta todos los registros de marcaje Las entradas en una hoja de horas que marcan el inicio (marcaje de entrada) o el fin (marcaje de salida) de un intervalo laboral, tal como el comienzo de un turno o transferencia. a un archivo sin formato para que sean importados por sistemas externos como sistemas de nómina, de asistencia (control de asistencia) y de reportes.

Los paquetes de integración universal intercambian los datos a través de archivos sin formato, ya sea para exportar los datos al archivo o para importar los datos desde el archivo. Otros sistemas acceden a los datos de estos archivos sin formato para completar la importación o exportación de la integración. La configuración predeterminada permite una configuración y ejecución rápidas del proceso de integración, mientras que la exposición de las asignaciones de datos y tablas de referencia cruzada de las ampliaciones permite sustituciones y personalizaciones de las asignaciones o valores de datos predeterminados.

Antes de comenzar

Implementar el paquete de integración PunchExport; consulte Implementar integraciones:.

Configurar la integración

  1. Abra el Diseñador de plantillas de integración: seleccione Menú principal  > Administración > Configuración de la aplicación > Configuración de integraciones > Plantillas de integración de diseño.

    Nota:Si se solicita, introduzca su nombre de usuario y contraseña. Haga clic en Pulse Iniciar sesión.

  2. Seleccione la ficha Manejar > Administración Atom.
  3. Seleccione su entorno.

Seleccionar ampliaciones del entorno

  1. En Administración, haga clic en pulse Extensiones de entorno.
  2. En Filtro de proceso, haga clic en pulse la lupa Botón buscar. La activación de este botón puede demorar algunos segundos.
  3. Desplácese hasta el paquete de integración y selecciónelo: Exportación de marcajes universales > PunchExport.

Precaución:Para la configuración de conexión y las propiedades del proceso, si selecciona Usar predeterminado, asegúrese de que Valor esté en blanco. Si Valor no está en blanco, ese valor sustituye el valor predeterminado independientemente de que Usar predeterminado esté seleccionado o desactivado. Ejemplo: Si el valor predeterminado es abc, pero Valor muestra xyz, la integración utiliza xyz independientemente de la configuración de Usar predeterminado.

Configure los parámetros de conexión

    1. Seleccione Configuración de conexiones.

    2. En la lista desplegable Conexión, seleccione y configure lo siguiente:

      Configuración de conexiones
      Configuración Obligatorio Acciones
      APIGatewayServer Obligatorio

      (Opcional) Para cambiar el servidor de puerta de enlace de API predeterminado:

      1. Desactive la casilla Usar predeterminado.
      2. Introduzca la URL del servidor.

        Ejemplo: <URL de portador>/api
      SFTPServer Obligatorio

      La configuración del servidor SFTP define la conexión con el archivo que contiene los registros. Las integraciones solo tienen acceso a la cuenta SFTP interna.

      Para cambiar los parámetros de servidor SFTP predeterminados:

      1. Para cada campo, desactive la casilla Usar predeterminado.
      2. Ingrese los siguientes valores:

        Escriba el nombre del host interno.

        Ingrese el número del Puerto para la cuenta de SFTP interna.

        En Usuario, ingrese el nombre de usuario para la cuenta de SFTP interno.

        En Contraseña, seleccione <Cifrado>. Ingrese la contraseña nueva para la cuenta de SFTP interna. Haga clic en Pulse Aplicar.

    • Configure las propiedades del proceso

    Las propiedades de proceso se aplican globalmente a todos los registros que procesa una integración. Cuando instale la integración, puede definir los valores de parámetro o configurar un mensaje para el usuario para definir el valor cuando se ejecuta la integración.

    Nota:La mayoría de las propiedades del proceso tienen valores predeterminados, aunque el Diseñador de plantilla de integración no muestra estos valores.

    1. Seleccione Propiedades del proceso.

    2. Precaución:No edite la AuthenticationProperties; deje esta configuración en sus valores predeterminados. De forma predeterminada, las cookies están habilitadas y establecen los valores de las propiedades de autenticación.

      Solo mientras prueba o diseña las plantillas de integración, debe editar las propiedades para conectarse al servidor de autenticación y obtener el token de acceso para ejecutar las API.

      1. En la lista desplegable Propiedad de proceso, seleccione AuthenticationProperties.
      2. En GatewayDefaultPort, desactive la casilla Usar predeterminado. Introduzca la ruta al puerto para la puerta de enlace de API.
      3. AppKey: desactive la casilla Usar predeterminado. Esta opción inhabilita las cookies para configurar el token de acceso para probar o depurar la integración. Introduzca una AppKey externa. Para generar una clave de la aplicación, consulte Generar claves de aplicaciones y acceder a ellas.
    3. En la lista desplegable Propiedad de proceso, seleccione PunchExport_CRTConfig para editar los encabezados de las tablas de referencia cruzada.

      Comparar tablas (CRT) son las tablas que las integraciones utiliza para traducir los valores de los parámetros. Uno o más valores de datos desde el sistema de origen puede utilizarse para asignar uno o más parámetros en el sistema de destino.

      Precaución:Boomi™ no devuelve valores predeterminados para los encabezados de tabla de referencia cruzada. Deberá introducir los encabezados en Valor.

      Nota:Para obtener información detallada, consulte Configurar tablas de referencia cruzada.

      Para PunchExport_PayPeriodLookup:

      1. Desactive Utilizar predeterminado.
      2. En Valor, ingrese los encabezados, separados por comas (,) pero sin espacios, exactamente como se muestran a continuación debajo del campo Valor. Se puede seleccionar y copiar los encabezados de la pantalla, luego péguelas en el Valor campo.

    4. En la lista desplegable Propiedad de proceso, seleccione PunchExport_ProcessProperties para definir las propiedades de proceso que deben configurarse antes de que se pueda ejecutar la integración.

      Propiedades del proceso
      Propiedad Obligatorio Acciones
      ExcludeEmployee No se requiere

      Para excluir empleados de la integración:

      1. Desactive Utilizar predeterminado.
      2. Ingrese los números de las personas, separados por coma (,) o signo de número (#).
      PayPeriod No se requiere

      Para cambiar el período de pago:

      1. Desactive la casilla Usar predeterminado.
      2. Ingrese uno de los siguientes valores para el período de pago:

        0 = Período de pago anterior

        1 = Período de pago actual

        2 = Siguiente período de pago

        3 = Período de planificación del horario Intervalo de días que se repite en el horario y que es definido para propósitos administrativos, tales como períodos de pago. anterior

        4 = Período de planificación del horario actual

        5 = Período de planificación del horario siguiente

        6 = Semana hasta la fecha

        7 = Semana anterior

        8 = Ayer

        10 = Intervalo de fechas relativo

        11 = Fecha específica

        12 = Fecha específica relativa

        13 = Hoy

      OutputFileName

      		No se requiere

      Nombre del archivo para almacenar los datos de exportación generados

      1. Desactive Utilizar predeterminado.
      2. Introduzca el nombre del archivo. Use una extensión .csv.

      Valor predeterminado = punchexport.csv.

      Ejemplo: ExportPunchData.csv
      DisqualifyActive No se requiere

      Para no procesar registros de personales de empleados activos:

      1. Desactive Utilizar predeterminado.
      2. Seleccione Valor.
      DisqualifyInactive No se requiere

      Para no procesar registros de personales de empleados inactivos:

      1. Desactive Utilizar predeterminado.
      2. Seleccione Valor.
      DisqualifyTerminated No se requiere

      Para no procesar registros de personales de empleados despedidos:

      1. Desactive Utilizar predeterminado.
      2. Seleccione Valor.
      Payrules No se requiere

      Predeterminado = en blanco

      Para considerar las reglas de pago durante la exportación de nómina:

      1. Desactive Utilizar predeterminado.
      2. Ingrese los PayruleNames, separados por coma (,) o un signo de número (#).

      IncludeEmployees

      		No se requiere

      Predeterminado = Incluye a todos los empleados.

      Para procesar los datos solo un grupo de empleados limitado:

      1. Desactive Utilizar predeterminado.
      2. Introduzca los números de las personas, tal como están definidos en el sistema de origen, separados por coma (,) pero no espacios.

        Ejemplo: 13997,15556,20012
      HyperfindAndLocations No se requiere

      Valor predeterminado = 1 (se muestra en blanco) que indica Todos mis empleados Una consulta que devuelve una lista de empleados asociados con un grupo de empleados del supervisor. La función Todos mis empleados busca personas que sean empleados activos o usuarios activos a partir del día de la fecha. e incluye a todos los empleados activos.

      Seleccione otra consulta HyperFind Un motor de búsqueda que filtra y selecciona grupos de empleados a través de consultas que especifican condiciones o ubicaciones (criterios). y ubicaciones:

      1. Desactive la casilla Usar predeterminado.
      2. (Obligatorio) Ingrese los id. de una sola consulta HyperFind o los id. de una o más ubicaciones, cada una separada por comas (,) o numerales (#).

        Precaución:Si no ingresa un id. para el parámetro de plantilla, la integración no puede identificar la consulta HyperFind y se produce un error en la ejecución de la integración.

      Nota:

      No se admiten los hyperfinds específicos.

      Todos mis empleados no incluye a los empleados cesantes o inactivos, incluso si los mismos tienen los totales durante el período. Para incluir estos totales, configure un hyperfind que incluya los empleados cesantes e inactivos de la organización y seleccione ese hyperfind en esta propiedad de proceso.

      La cantidad máxima de empleados en un hyperfind es de 3500. Para procesar más registros de empleados, divida la población en hyperfinds más pequeños que se ejecuten secuencialmente.
      IncludePaycodes No se requiere

      Para exportar solo un grupo limitado de códigos de pago Una categoría de tiempo o dinero que ganan los empleados; por ejemplo, Horas normales, Bonificación o Enfermedad.:

      1. Desactive Utilizar predeterminado.
      2. Ingrese los códigos de pago, separados por coma (,) o por un signo numeral (#).
      ExcludePaycodes No se requiere

      Para excluir códigos de pago de la integración:

      1. Desactive Utilizar predeterminado.
      2. Ingrese los códigos de pago, separados por coma (,) o por un signo numeral (#).
      IsCustomizedOutput No se requiere

      Para generar un archivo de salida personalizado:

      1. Desactive la casilla Usar valor predeterminado.
      2. Seleccione Valor.
      PunchesPairPerRow No se requiere

      Para exportar marcajes de entrada y de salida a filas únicas para cada empleado:

      1. Desactive la casilla Usar valor predeterminado.
      2. Seleccione Valor.
      Personalización 1 No se requiere

      Un campo personalizado puede ser un criterio de búsqueda para extraer los datos de marcaje para empleados o grupos específicos. Especifique los campos personalizados de personas, cada uno separado por un signo de número (#).
      Delimitador No se requiere

      Valor predeterminado = coma (,)

      Para cambiar el carácter que separa los valores de los datos en el archivo sin formato:

      1. Desactive Utilizar predeterminado.

      2. Introduzca el carácter.
      _Threshold No se requiere

      Valor predeterminado = 5000

      Para configurar un número diferente de consultas como el umbral de HyperFind:

      1. Haga clic en Pulse Usar predeterminado.
      2. Indique el número en Valor.

        Precaución:Importante: Los umbrales altos pueden impedir el funcionamiento del sistema.
      _DisableQuotes No se requiere

      Para eliminar las comillas dobles desde el archivo exportado:

      1. Desactive Utilizar predeterminado.
      2. Seleccione Valor.

      Si el valor de cualquier campo incluye algún carácter que se utiliza como delimitador, esta propiedad convierte dicho carácter de la asignación de datos en otro carácter que no se utiliza en el archivo. Ejemplo: Convierta los delimitadores de coma (,) de un archivo de valores separados por comas en un carácter de barra vertical (|).

    5. En la lista desplegable Propiedad de proceso, seleccione PunchExport_SFTPProperties.

      Propiedades de SFTP
      Propiedad Obligatorio Acciones
      OutputDirectory No se requiere

      El directorio del servidor SFTP donde se van a guardar los archivos de salida:

      Valor predeterminado = /Outbound

      Para definir una ruta de directorio diferente:

      1. Desactive la casilla Usar predeterminado.
      2. Introduzca la ruta de directorio.
      AppendRecords No se requiere

      Para adjuntar registros a un archivo de exportación de nómina anterior:

      1. Desactive Utilizar predeterminado.
      2. Seleccione Valor.

    Configurar tablas de referencia cruzada

    Precaución:Antes de que se pueda descargar una tabla de referencia cruzada cuando se ejecuta la integración, debe desactivar Usar predeterminado en la propiedad del proceso > {ProcessName} _CRTConfig e ingresar los nombres de encabezado para esa tabla. Además, debe seleccionar Sustituir en los pasos a continuación. Si los nombres de los encabezados ya están en el campo, cópielos y péguelos nuevamente.

    Comparar tablas (CRT) son las tablas que las integraciones utiliza para traducir los valores de los parámetros. Uno o más valores de datos desde el sistema de origen puede utilizarse para asignar uno o más parámetros en el sistema de destino.

    Una tabla de referencia cruzada (CRT) traduce valores de parámetros en una integración de la siguiente forma:

    • Organiza valores de datos en filas y columnas:
      • Puntos = 20 columnas, 10,000 filas.
    • Puede combinar valores de múltiples columnas para determinar un único valor de salida.
    • Si más de una fila coincide con un valor de referencia, la primera coincidencia es el valor de salida.
    • Si no se encuentra coincidencia, el valor de salida puede ser nulo, o la integración puede producir errores.

    1. Precaución:En el caso de las tablas de referencia cruzada que está personalizando, deberá asegurarse de que Utilizar predeterminado no esté seleccionado en Propiedades de proceso > {ProcessName}_CRTConfig.

    2. Seleccione Referencia cruzada.

    3. En la lista desplegable Referencia cruzada, seleccione PunchExport_PayPeriodLookup.

      Esta tabla asigna períodos de pago entre origen y destino.

      No se puede cambiar el nombre de las tablas.

    4. Seleccione Sustituir a fin de permitir las siguientes:

      • Descargar de las tablas cuando se ejecuta la integración
      • Ediciones manuales de las celdas de tabla en Extensiones

    Configurar asignaciones de datos

    (Optativo)

    Una asignación traduce la estructura de datos del formato de origen al formato de destino. Ejemplos: Asigne "PersonID" en el origen a "Id. de persona" en el destino o "LastName" a "Apellido".

    Cada paquete de integración tiene una asignación de datos predeterminada. La edición de la asignación predeterminada se limita a agregar campos, cambiar las asignaciones, o insertar funciones. Cualquier cambio invalida los valores anteriores. Si los campos predefinidos no se adaptan sus requisitos, use la asignación predeterminada como guía al crear su asignación de datos personalizada.

    Para personalizar la transformación de datos, seleccione la extensión de asignación de datos.

    1. Seleccione Asignaciones de datos.
    2. En la lista desplegable Asignaciones de datos, seleccione una de las opciones siguientes:
      • PunchExport_SinglePunchesForFilter—PunchExport_CustomizedOutputFields para definir una asignación personalizada con sus propios campos y orden para asignar los datos del origen al destino. También puede definir funciones para transformar datos asignados.
      • PunchExport_CustomizedOutputFieldsSource—PunchExport_CustomizedOutputFields para definir una asignación personalizada con sus propios campos y orden para asignar los datos del origen al destino. También puede definir funciones para transformar datos asignados.

    3. Seleccione Expandir para ampliar o Contraer para contraer los niveles.

      Para ampliar todos los niveles, haga clic con el botón secundario en el icono de cuadros verdes Asignar opciones de nivel. Seleccione Ampliar todos

      Las líneas muestran los vínculos entre los campos en el origen (del lado izquierdo), cualquier función intermedia y el destino (del lado derecho).

    4. (Optativo)

      Precaución:Las asignaciones predeterminadas se desarrollan y evalúan de acuerdo con las recomendaciones. Si realiza cambios, puede obtener resultados inesperados. Modifique y pruebe cuidadosamente.

      • Cambiar asignaciones: al personalizar una asignación de datos predeterminado, puede agregar campos únicamente al final del mapa.

        Puede seleccionar y arrastrar para cambiar los vínculos entre los elementos de origen (columna izquierda), de función (columna intermedia) y de destino (columna derecha). Un solo campo de origen se puede vincular a varios campos de destino, pero un campo de destino se puede vincular a un solo campo de origen.

      • Transformar los datos: una asignación puede incluir funciones intermedias que transforman los datos. Ejemplos: Realizar cálculos matemáticos sobre los valores u obtener valores de una tabla de referencia cruzada.

        Sugerencia: Para sustituir un campo (por ejemplo, porque no se puede eliminar de una asignación predeterminada), inserte una función que tenga una salida nula.

        1. En Función, haga clic en pulse el botón con el signo más Agregar función de asignación para agregar una función intermedia.

          Sugerencia: Para sustituir un campo (por ejemplo, porque no se puede eliminar de una asignación predeterminada), inserte una función que tenga una salida nula.

        2. En Categoría, seleccione una categoría de funciones:

          Cadena: recorte, agregue, concatene, reemplace, elimine, divida o cambie mayúsculas y minúsculas.

          Precaución:No utilice caracteres especiales como corchetes angulares (< o >) en los datos de las tablas de referencia cruzada, asignaciones de datos y archivos de entrada. La integración puede fallar debido al uso de estos caracteres.

          Numérico: realice cálculos matemáticos con los datos.

          Fecha: cambie el formato u obtenga la fecha actual.

          Búsqueda: obtenga datos de una tabla de referencia cruzada (CRT), memoria caché de documentos, consulta SQL o defina un cambio de par clave-valor.

          Conector: llame un valor de un conector para una aplicación o fuente de datos.

          Secuencias de comandos personalizadas: transforme los datos con el código de Groovy o JavaScript.

          Propiedades: obtenga o configure las propiedades del proceso o el documento.

        3. Seleccione la función de la lista en la categoría seleccionada.
        4. Haga clic en Pulse Aceptar.
        5. Si se le indica en Configurar opciones predeterminadas, ingrese los valores pertinentes. Seleccione una Memoria caché. Haga clic en Pulse Aceptar.
        6. Seleccione y arrastre desde un campo de origen hasta una entrada de la función.
        7. Seleccione y arrastre desde la salida de la función hasta un campo de destino.
        8. Repita para agregar otra función.
    5. Cuando termine, haga clic en pulse Aceptar.

    Seleccionar ampliaciones del entorno

    1. En Administración, haga clic en pulse Extensiones de entorno.
    2. En Filtro de proceso, haga clic en pulse la lupa Botón buscar. La activación de este botón puede demorar algunos segundos.
    3. Desplácese hasta el paquete de integración y selecciónelo: Exportación de marcajes universales > PunchExportFILO.

    Precaución:Para la configuración de conexión y las propiedades del proceso, si selecciona Usar predeterminado, asegúrese de que Valor esté en blanco. Si Valor no está en blanco, ese valor sustituye el valor predeterminado independientemente de que Usar predeterminado esté seleccionado o desactivado. Ejemplo: Si el valor predeterminado es abc, pero Valor muestra xyz, la integración utiliza xyz independientemente de la configuración de Usar predeterminado.

    Configure los parámetros de conexión

    1. Seleccione Configuración de conexiones.

    2. En la lista desplegable Conexión, seleccione y configure lo siguiente:

      Configuración de conexiones
      Configuración Obligatorio Acciones
      APIGatewayServer Obligatorio

      (Opcional) Para cambiar el servidor de puerta de enlace de API predeterminado:

      1. Desactive la casilla Usar predeterminado.
      2. Introduzca la URL del servidor.

        Ejemplo: <URL de portador>/api
      SFTPServer Obligatorio

      La configuración del servidor SFTP define la conexión con el archivo que contiene los registros. Las integraciones solo tienen acceso a la cuenta SFTP interna.

      Para cambiar los parámetros de servidor SFTP predeterminados:

      1. Para cada campo, desactive la casilla Usar predeterminado.
      2. Ingrese los siguientes valores:

        Escriba el nombre del host interno.

        Ingrese el número del Puerto para la cuenta de SFTP interna.

        En Usuario, ingrese el nombre de usuario para la cuenta de SFTP interno.

        En Contraseña, seleccione <Cifrado>. Ingrese la contraseña nueva para la cuenta de SFTP interna. Haga clic en Pulse Aplicar.

    • Configure las propiedades del proceso

    Las propiedades de proceso se aplican globalmente a todos los registros que procesa una integración. Cuando instale la integración, puede definir los valores de parámetro o configurar un mensaje para el usuario para definir el valor cuando se ejecuta la integración.

    Nota:La mayoría de las propiedades del proceso tienen valores predeterminados, aunque el Diseñador de plantilla de integración no muestra estos valores.

    1. Seleccione Propiedades del proceso.

    2. Precaución:No edite la AuthenticationProperties; deje esta configuración en sus valores predeterminados. De forma predeterminada, las cookies están habilitadas y establecen los valores de las propiedades de autenticación.

      Solo mientras prueba o diseña las plantillas de integración, debe editar las propiedades para conectarse al servidor de autenticación y obtener el token de acceso para ejecutar las API.

      1. En la lista desplegable Propiedad de proceso, seleccione AuthenticationProperties.
      2. En GatewayDefaultPort, desactive la casilla Usar predeterminado. Introduzca la ruta al puerto para la puerta de enlace de API.
      3. AppKey: desactive la casilla Usar predeterminado. Esta opción inhabilita las cookies para configurar el token de acceso para probar o depurar la integración. Introduzca una AppKey externa. Para generar una clave de la aplicación, consulte Generar claves de aplicaciones y acceder a ellas.
    3. En la lista desplegable Propiedad de proceso, seleccione AutoCallbackProperty.

      Para cambiar la etiqueta batchName en el resumen de ejecuciones y el asistente de transacciones Corrige los errores de transacción en integraciones sin la necesidad de volver a enviar proyectos completos.:

      • Desactive la casilla Usar valor predeterminado. 

      • En Valor, especifique la etiqueta.

        Ejemplo: PunchImport.

    4. En la lista desplegable Propiedad de proceso, seleccione PunchExportFILO_CRTConfig para editar los encabezados de las tablas de referencia cruzada.

      Comparar tablas (CRT) son las tablas que las integraciones utiliza para traducir los valores de los parámetros. Uno o más valores de datos desde el sistema de origen puede utilizarse para asignar uno o más parámetros en el sistema de destino.

      Precaución:Boomi™ no devuelve valores predeterminados para los encabezados de tabla de referencia cruzada. Deberá introducir los encabezados en Valor.

      Nota:Para obtener información detallada, consulte Configurar tablas de referencia cruzada.

      Para PunchExportFILO_PayPeriodLookup:

      1. Desactive Utilizar predeterminado.
      2. En Valor, ingrese los encabezados, separados por comas (,) pero sin espacios, exactamente como se muestran a continuación debajo del campo Valor. Se puede seleccionar y copiar los encabezados de la pantalla, luego péguelas en el Valor campo.

    5. En la lista desplegable Propiedad de proceso, seleccione PunchExportFILO_ProcessProperties para definir las propiedades de proceso que deben configurarse antes de que se pueda ejecutar la integración.

      Propiedades del proceso
      Propiedad Obligatorio Acciones
      ExcludeEmployee No se requiere

      Para excluir empleados de la integración:

      1. Desactive Utilizar predeterminado.
      2. Ingrese los números de las personas, separados por coma (,) o signo de número (#).
      PayPeriod No se requiere

      Para cambiar el período de pago:

      1. Desactive la casilla Usar predeterminado.
      2. Ingrese uno de los siguientes valores para el período de pago:

        0 = Período de pago anterior

        1 = Período de pago actual

        2 = Siguiente período de pago

        3 = Período de planificación del horario anterior

        4 = Período de planificación del horario actual

        5 = Período de planificación del horario siguiente

        6 = Semana hasta la fecha

        7 = Semana anterior

        8 = Ayer

        10 = Intervalo de fechas relativo

        11 = Fecha específica

        12 = Fecha específica relativa

        13 = Hoy

      OutputFileName

      		 No se requiere

      Nombre del archivo para almacenar los datos de exportación generados

      1. Desactive Utilizar predeterminado.
      2. Introduzca el nombre del archivo. Use una extensión .csv.

      Valor predeterminado = punchexport.csv.

      Ejemplo: ExportPunchData.csv
      Payrules No se requiere

      Predeterminado = en blanco

      Para considerar las reglas de pago durante la exportación de nómina:

      1. Desactive Utilizar predeterminado.
      2. Ingrese los PayruleNames, separados por coma (,) o un signo de número (#).

      IncludeEmployees

      		 No se requiere

      Predeterminado = Incluye a todos los empleados.

      Para procesar los datos solo un grupo de empleados limitado:

      1. Desactive Utilizar predeterminado.
      2. Introduzca los números de las personas, tal como están definidos en el sistema de origen, separados por coma (,) pero no espacios.

        Ejemplo: 13997,15556,20012
      HyperfindAndLocations No se requiere

      Valor predeterminado = 1 (se muestra en blanco) que indica Todos mis empleados e incluye a todos los empleados activos.

      Seleccione otra consulta HyperFind y ubicaciones:

      1. Desactive la casilla Usar predeterminado.
      2. (Obligatorio) Ingrese los id. de una sola consulta HyperFind o los id. de una o más ubicaciones, cada una separada por comas (,) o numerales (#).

        Precaución:Si no ingresa un id. para el parámetro de plantilla, la integración no puede identificar la consulta HyperFind y se produce un error en la ejecución de la integración.

      Nota:

      No se admiten los hyperfinds específicos.

      Todos mis empleados no incluye a los empleados cesantes o inactivos, incluso si los mismos tienen los totales durante el período. Para incluir estos totales, configure un hyperfind que incluya los empleados cesantes e inactivos de la organización y seleccione ese hyperfind en esta propiedad de proceso.

      La cantidad máxima de empleados en un hyperfind es de 3500. Para procesar más registros de empleados, divida la población en hyperfinds más pequeños que se ejecuten secuencialmente.
      IsCustomizedOutput No se requiere

      Para generar un archivo de salida personalizado:

      1. Desactive la casilla Usar valor predeterminado.
      2. Seleccione Valor.
      Personalización 1 No se requiere

      Un campo personalizado puede ser un criterio de búsqueda para extraer los datos de marcaje para empleados o grupos específicos. Especifique los campos personalizados de personas, cada uno separado por un signo de número (#).
      Delimitador No se requiere

      Valor predeterminado = coma (,)

      Para cambiar el carácter que separa los valores de los datos en el archivo sin formato:

      1. Desactive Utilizar predeterminado.

      2. Introduzca el carácter.
      _Threshold No se requiere

      Valor predeterminado = 5000

      Para configurar un número diferente de consultas como el umbral de HyperFind:

      1. Haga clic en Pulse Usar predeterminado.
      2. Indique el número en Valor.

        Precaución:Importante: Los umbrales altos pueden impedir el funcionamiento del sistema.
      _DisableQuotes No se requiere

      Para eliminar las comillas dobles desde el archivo exportado:

      1. Desactive Utilizar predeterminado.
      2. Seleccione Valor.

      Si el valor de cualquier campo incluye algún carácter que se utiliza como delimitador, esta propiedad convierte dicho carácter de la asignación de datos en otro carácter que no se utiliza en el archivo. Ejemplo: Convierta los delimitadores de coma (,) de un archivo de valores separados por comas en un carácter de barra vertical (|).

    6. En la lista desplegable Propiedad de proceso, seleccione PunchExportFILO_SFTPProperties.

      Propiedades de SFTP
      Propiedad Obligatorio Acciones
      OutputDirectory No se requiere

      El directorio del servidor SFTP donde se van a guardar los archivos de salida:

      Valor predeterminado = /Outbound

      Para definir una ruta de directorio diferente:

      1. Desactive la casilla Usar predeterminado.
      2. Introduzca la ruta de directorio.
      AppendRecords No se requiere

      Para adjuntar registros a un archivo de exportación de nómina anterior:

      1. Desactive Utilizar predeterminado.
      2. Seleccione Valor.

    Configurar tablas de referencia cruzada

    Precaución:Antes de que se pueda descargar una tabla de referencia cruzada cuando se ejecuta la integración, debe desactivar Usar predeterminado en la propiedad del proceso > {ProcessName} _CRTConfig e ingresar los nombres de encabezado para esa tabla. Además, debe seleccionar Sustituir en los pasos a continuación. Si los nombres de los encabezados ya están en el campo, cópielos y péguelos nuevamente.

    Comparar tablas (CRT) son las tablas que las integraciones utiliza para traducir los valores de los parámetros. Uno o más valores de datos desde el sistema de origen puede utilizarse para asignar uno o más parámetros en el sistema de destino.

    Una tabla de referencia cruzada (CRT) traduce valores de parámetros en una integración de la siguiente forma:

    • Organiza valores de datos en filas y columnas:
      • Puntos = 20 columnas, 10,000 filas.
    • Puede combinar valores de múltiples columnas para determinar un único valor de salida.
    • Si más de una fila coincide con un valor de referencia, la primera coincidencia es el valor de salida.
    • Si no se encuentra coincidencia, el valor de salida puede ser nulo, o la integración puede producir errores.

    1. Precaución:En el caso de las tablas de referencia cruzada que está personalizando, deberá asegurarse de que Utilizar predeterminado no esté seleccionado en Propiedades de proceso > {ProcessName}_CRTConfig.

    2. Seleccione Referencia cruzada.

    3. En la lista desplegable Referencia cruzada, seleccione PunchExportFILO_PayPeriodLookup.

      Esta tabla asigna períodos de pago entre origen y destino.

      No se puede cambiar el nombre de las tablas.

    4. Para permitir que las tablas se descarguen cuando se ejecuta la integración, seleccione Sustituir.

    5. Seleccione Sustituir a fin de permitir las siguientes:

      • Descargar de las tablas cuando se ejecuta la integración
      • Ediciones manuales de las celdas de tabla en Extensiones

    Configurar asignaciones de datos

    (Optativo)

    Una asignación traduce la estructura de datos del formato de origen al formato de destino. Ejemplos: Asigne "PersonID" en el origen a "Id. de persona" en el destino o "LastName" a "Apellido".

    Cada paquete de integración tiene una asignación de datos predeterminada. La edición de la asignación predeterminada se limita a agregar campos, cambiar las asignaciones, o insertar funciones. Cualquier cambio invalida los valores anteriores. Si los campos predefinidos no se adaptan sus requisitos, use la asignación predeterminada como guía al crear su asignación de datos personalizada.

    Para personalizar la transformación de datos, seleccione la extensión de asignación de datos.

    1. Seleccione Asignaciones de datos.
    2. En la lista desplegable Asignaciones de datos, seleccione PunchExport_CustomizedOutputFieldsSource—PunchExport_CustomizedOutputFields para definir una asignación personalizada con sus propios campos y orden para asignar los datos del origen al destino. También puede definir funciones para transformar datos asignados.

    3. Seleccione Expandir para ampliar o Contraer para contraer los niveles.

      Para ampliar todos los niveles, haga clic con el botón secundario en el icono de cuadros verdes Asignar opciones de nivel. Seleccione Ampliar todos

      Las líneas muestran los vínculos entre los campos en el origen (del lado izquierdo), cualquier función intermedia y el destino (del lado derecho).

    4. (Optativo)

      Precaución:Las asignaciones predeterminadas se desarrollan y evalúan de acuerdo con las recomendaciones. Si realiza cambios, puede obtener resultados inesperados. Modifique y pruebe cuidadosamente.

      • Cambiar asignaciones: al personalizar una asignación de datos predeterminado, puede agregar campos únicamente al final del mapa.

        Puede seleccionar y arrastrar para cambiar los vínculos entre los elementos de origen (columna izquierda), de función (columna intermedia) y de destino (columna derecha). Un solo campo de origen se puede vincular a varios campos de destino, pero un campo de destino se puede vincular a un solo campo de origen.

      • Transformar los datos: una asignación puede incluir funciones intermedias que transforman los datos. Ejemplos: Realizar cálculos matemáticos sobre los valores u obtener valores de una tabla de referencia cruzada.

        Sugerencia: Para sustituir un campo (por ejemplo, porque no se puede eliminar de una asignación predeterminada), inserte una función que tenga una salida nula.

        1. En Función, haga clic en pulse el botón con el signo más Agregar función de asignación para agregar una función intermedia.

          Sugerencia: Para sustituir un campo (por ejemplo, porque no se puede eliminar de una asignación predeterminada), inserte una función que tenga una salida nula.

        2. En Categoría, seleccione una categoría de funciones:

          Cadena: recorte, agregue, concatene, reemplace, elimine, divida o cambie mayúsculas y minúsculas.

          Precaución:No utilice caracteres especiales como corchetes angulares (< o >) en los datos de las tablas de referencia cruzada, asignaciones de datos y archivos de entrada. La integración puede fallar debido al uso de estos caracteres.

          Numérico: realice cálculos matemáticos con los datos.

          Fecha: cambie el formato u obtenga la fecha actual.

          Búsqueda: obtenga datos de una tabla de referencia cruzada (CRT), memoria caché de documentos, consulta SQL o defina un cambio de par clave-valor.

          Conector: llame un valor de un conector para una aplicación o fuente de datos.

          Secuencias de comandos personalizadas: transforme los datos con el código de Groovy o JavaScript.

          Propiedades: obtenga o configure las propiedades del proceso o el documento.

        3. Seleccione la función de la lista en la categoría seleccionada.
        4. Haga clic en Pulse Aceptar.
        5. Si se le indica en Configurar opciones predeterminadas, ingrese los valores pertinentes. Seleccione una Memoria caché. Haga clic en Pulse Aceptar.
        6. Seleccione y arrastre desde un campo de origen hasta una entrada de la función.
        7. Seleccione y arrastre desde la salida de la función hasta un campo de destino.
        8. Repita para agregar otra función.
    5. Cuando termine, haga clic en pulse Aceptar.

    Integraciones básicas: PunchExport-v1 y PunchExportFILO-v1

    Archivo de origen predeterminado = punchexport.csv.

    Esta sección proporciona información detallada para ayudarlo a evaluar si esta integración cumple con las necesidades de su negocio.

    Este paquete de integración contiene las siguientes integraciones.

    Exportar marcajes

    Exportar todos los marcajes.

    Propiedades:

    • Exporte un solo marcaje para cada fila o un par de marcajes (de entrada y de salida) para cada fila.
    • Exporte ya sea columnas simples (4 columnas) una cantidad de columnas personalizada (ampliada).

    Exportar marcajes FILO

    FILO = Primero en entrar, último en salir

    Exporte solo el primer y último marcaje de cada turno y solo como un par de marcajes (de entrada y de salida) para cada fila.

    Propiedades:

    • Exporte ya sea columnas simples (4 columnas) una cantidad de columnas personalizada (ampliada).

    Tipos de marcajes

    Todas las exportaciones son masivas, porque los datos abarcan muchos empleados, cada uno con múltiples marcajes.

    • Solo marcajes

      Todos los marcajes y campos de transferencia (estructura empresarial, regla de trabajo) con período de pago previo, semana hasta la fecha, período de pago actual e intervalo de fechas.

      Frecuencia de toma de muestras alta

      Realice uno de los procedimientos siguientes:

      • Los pares de marcajes (de entrada y de salida, de horas normales o transferencia) están en la misma fila. Los marcajes omitidos están en blanco.
      • Los marcajes están en filas separadas.
      Ejemplo de marcajes solamente
      Empleado Marcaje de entrada Marcaje de salida Nodo organizativo o cuenta laboral Interpretación
      1245 2016-07-01 0900 2016-07-01 0900 101

      entrada = comienzo del turno

      salida = fin del turno
      1245 2016-07-02 0900 2016-07-02 1300 101

      entrada = comienzo del turno

      salida = derivado de transferencia a las 1300
      1245 2016-07-02 1300 2016-07-02 1700 102

      entrada = transferencia

      salida = fin del turno
      1245 en blanco 2016-07-03 1700 101

      entrada = faltante

      salida = fin del turno
      1245 2016-07-05 0945 en blanco 103

      entrada = comienzo del turno

      salida = faltante
      1245 2016-07-06 0915 2016-07-06 1130 101

      entrada = comienzo del turno

      salida =descanso
      1245 2016-07-06 1201 2016-07-06 1650 101

      entrada = descanso

      salida = fin del turno

    • Ediciones de marcajes y códigos de pago

      Duraciones de marcaje, códigos de pago trabajados que se calculan a partir de las duraciones, y códigos de pago no trabajados

      Frecuencia media de toma de muestras

      Ejemplo de marcajes y ediciones de códigos de pago no trabajados
      Nodo de cuenta trabajada Empleado Fecha del turno Día de turno de la semana Fecha de inicio Hora de inicio Fecha de fin Hora de fin Código de pago Duración (redondeado, HH:mm)
      00742 111222 140612 Jueves 140612 0800 140612 1200 NORMAL 4:00
      00742 111222 140612 Jueves 140612 1200 140612 1616 VACACIONES 4:15
      00459 222333 140612 Jueves 140612 0626 140612 1426 NORMAL 8:00
      00459 222333 140612 Jueves 140612 1426 140612 1726 TIEMPO EXTRA 3:00
      00459 222333 140612 Jueves 140612 2330 140613 0730 NORMAL 8:00

      Los códigos de pago de horas normales y de tiempo extra y las duraciones se calculan de forma automática desde los marcajes.

      Las vacaciones es un código de pago no calculado y es el resultado de una edición de código de pago manual.

      Fecha de turno = Fecha de inicio. La fecha de fin es el día siguiente, cuando el turno supera la medianoche.

      Las horas pueden no ser horas de marcaje:

      • Vacaciones: la edición de código de pago define la hora de inicio y la duración; de manera que la hora de fin se deriva.
      • Horas normales y tiempo extra: el empleado realiza un marcaje de turno continuo de 0626 a 1726; sin embargo, las reglas de pago calculan tiempo extra después de las 8 horas, de manera que la hora de fin de las horas normales y la hora de inicio del tiempo extra se derivan.
      Ejemplo de duraciones de marcajes solamente
      Nodo de cuenta trabajada Empleado Fecha de inicio Hora de inicio Fecha de fin Hora de fin Duración (redondeado, HH.dd)
      00742 111222 140612 0800 140612 1230 4.50
      00459 222333 140612 0626 140612 1726 11.00
      00459 222333 140612 1205 140612 0510 5.00

    • Atributos de marcaje para requisitos de no reporte

      Disponibles en integraciones base y FILO

      Frecuencia media de toma de muestras

      • Comentarios y notas
      • Transferencias de regla de trabajo
      • Fecha trabajada, día trabajado de la semana
      • Número de tarjeta
      • Otro origen de marcaje: computadora o usuario
      • Campos demográficos de la persona que realiza el marcaje: regla de pago, nombre de la persona
      • Versiones reales y redondeadas del marcaje

    • Marcajes FILO

      Un sistema de destino puede necesitar que los marcajes de origen sean limitados.

      Frecuencia media de toma de muestras

      Ejemplos:

      • Exporte solo el primer y el último marcaje del día.
      • Excluya los marcajes de refrigerio, descanso y transferencia.
      • Determine inclusiones y exclusiones por la relación del marcaje con otros marcajes o con la división de días.

      Ejemplo de marcajes limitados

      Genere un registro de salida para cada fecha para la que el empleado realiza un marcaje e incluya solo el primer y último marcaje de esa fecha.

      Ejemplo de marcajes FILO
      Nodo de cuenta trabajada Fecha Empleado Hora de inicio Hora de fin Interpretación (sin salida)
      789 20160202 00122 071500 154500 El empleado realizó 4 marcajes; los marcajes de entrada y salida de descanso quedan excluidos
      789 20160203 00122 092500 — El empleado realizó el marcaje de entrada, pero no de salida
      777 20160204 00122 — 175500 El empleado realizó el marcaje de salida, pero no de entrada
      789 20160205 01988 233000 — El empleado realizó el marcaje de entrada, y el turno terminó después de la medianoche
      789 20160206 01988 — 070000 El empleado realizó el marcaje de salida y terminó el turno que comenzó en los días anteriores

      Los marcajes que están dentro del turno, tal como descanso o transferencia, se ignoran.

      El nodo de la cuenta trabajada es el nodo que está asociado con el marcaje de entrada.

      Si un turno supera la medianoche, se realizan dos registros de salida:

      • La fecha de inicio y el marcaje de entrada se envían en el primer registro, y el marcaje de salida queda en blanco.
      • La fecha de fin y el marcaje de salida se envían en el segundo registro, y el marcaje de entrada queda en blanco.

      Si a un empleado le faltan marcajes de entrada o de salida, se crea un registro con espacios en blanco para los marcajes faltantes.