Pautas de proceso de gestión de integración
Información general
Un proceso de gestión de integración es un workflow configurable que orquesta las tareas asociadas a la ejecución de una integración para el intercambio de datos entre Workday y los puntos finales externos. Utiliza el tipo de proceso de gestión
Evento de proceso de integración
, que permite un procesamiento más complejo que un simple inicio de integración . VerConcepto: procesos de gestión de integración .Estas son las secciones de este tema:
- Subprocesos
- Requisitos previos
- Iniciadores de proceso
- Limitaciones
- Workflows de proceso de gestión comunes
- Pasos de workflow
- Integración
- Notificaciones
- Problemas y soluciones
Subprocesos
Puede insertar una integración en otro proceso de gestión añadiendo un paso de Integración a la definición de ese proceso de gestión. Cuando el proceso de gestión principal llega a ese paso, inicia el Evento de proceso de integración especificado como un proceso de gestión secundario.
Requisitos previos
Iniciadores de proceso
Un proceso de gestión de integración se puede iniciar de varias maneras:
- De forma manualUn usuario con los permisos adecuados puede iniciar la integración directamente desde el informeConsulta de sistema de integracióno mediante la tareaInicio/programación de integración.
- ProgramadoPuede programar la integración para que se ejecute a una hora específica o de forma periódica desde la tareaInicio/programación de integración.
- Como proceso de gestiónEl proceso de gestión de integración se puede iniciar desde un paso dentro de otro proceso de gestión de Workday (por ejemplo, ejecutando una integración de E-Verify después del proceso de gestiónde cumplimentación de formulario I-9).
Limitaciones
Aunque el marco del proceso de gestión de integración es flexible, la tecnología de integración subyacente tiene limitaciones específicas.
- Organización para un sistema de integración desde el inicio de un servicio webAl iniciar una integración a través de laLaunch_IntegrationoLaunch_EIBoperaciones de servicio web, no puede especificar una versión específica de la organización en particular del proceso de gestión. Se utilizará la definición de nivel superior (por defecto) para ese sistema de integración . ConsulteOrganizaciones y procesos de gestión de integraciónenConcepto: procesos de gestión de integración .
- Límite de tamaño de archivo para recuperación de documentosLos archivos de entrada tienen un límite de 1 GB para XML y de 300 MB para XLSX. VerReferencia: integraciones y límites de servicio web .
Workflows de proceso de gestión comunes
- Ruta 1: workflow de integración por defecto
- Por defecto, elevento de proceso de integraciónconsta de dos pasos fundamentales:A: Inicio>B: Servicio (Integración de activación)El pasoService (Fire Integration)ejecuta el propio sistema de integración . Para una integración de salida , genera el archivo de resultado. Para una integración de entrada , carga datos en Workday.
- Ruta 2: integración de salida con aprobación
- Este workflow es habitual cuando necesita que un usuario revise los datos antes de enviarlos fuera de Workday.A: Inicio>B: Aprobación>C: Servicio (Integración de activación)>D: Servicio: Envío de documentosUna vez aprobado, el pasoServicio (Incendio de integración)se ejecuta y extrae los datos de Workday, lo que genera el archivo de resultado.El pasoService: Document Deliveryentrega el archivo generado al punto final externo, como un servidor SFTP.
- Ruta 3: workflow de integración de entrada
- Este workflow es un workflow estándar para incorporar datos a Workday desde un origen externo.A: Inicio>B: Servicio: Recuperación de documentos>C: Servicio (Integración de activación)El pasoService: Document Retrievalrecupera un archivo de un origen externo (como un servidor FTP) o envía una tarea a un usuario para que cargar manualmente un archivo.El pasoService: Fire Integrationejecuta la integración, toma el archivo recuperado y carga los datos en Workday.
- Ruta 4: workflow de integración encadenada
- Este patrón es útil cuando el resultado de una integración es la entrada de otra.A: Inicio>B: Integración>C: IntegraciónEl primer pasode integraciónactiva el primer sistema de integración (por ejemplo, una integración de EIB o Studio) para ejecutar y generar un archivo de resultado.El segundo pasoIntegraciónactiva un segundo sistema de integración, que consume el archivo de resultado de la primera integración.
Pasos de workflow
- Inicio
- Orden
- A (primer paso)
- Realizado por
- El usuario o sistema que inicia la integración. Puede ser un usuario de sistema de integración (ISU) para eventos programados o activados por el sistema, o un usuario interactivo para inicios manuales.
- Dominio de seguridad por rol
- El ISU o el administrador de integración que inicia la integración: accesoModify / PutaIntegration Build,Integration Configure,Integration Debug,Integration Event.
- Práctica recomendada
- El pasoInicioes un primer paso obligatorio para todos los procesos de gestión. No se puede eliminar. Sirve como punto de entrada y registro de auditoría para el inicio del proceso.
- Ejemplo
- Un administrador de recursos humanos navega a la tareaInicio/programación de integracióny hace clic en "Aceptar" para ejecutar una exportación de nueva contratación a un proveedor de beneficios externo. Esta acción finaliza el pasoInicioe inicia el workflow del proceso de gestión .
Tipos de paso
Estos son los tipos de pasos comunes que puede añadir a un proceso de gestión de integración.
- Aprobación
- Orden
- Se puede colocar en cualquier lugar después del pasoInicio. Por ejemplo, puede colocarlo después de un pasoActivar integraciónpero antes de un pasode Envío de documentos.
- Realizado por
- Un grupo de seguridad especificado (por ejemplo, HR Partner, Compensation Administrator, Manager).
- Dominios de seguridad
- Usuario de sistema de integración, administrador de integración o administrador de proceso de gestión: accesoModify / Putaevento de integración.
- Especificar
- Debe especificar los grupo de seguridad responsables de la aprobación.
- Regla de condición
- Caso de uso: solicitar a un gerente que revise y apruebe un archivo que contenga datos de bonus de empleado antes de enviarlo al proveedor de nómina.
- Práctica recomendada: utilice reglas de condición para activador aprobaciones solo cuando sea necesario. Por ejemplo, podría crear una regla que omita el paso de aprobación si el importe total de bonus está por debajo de un determinado umbral.
- Ejemplo: se configura una regla de condición en el paso de aprobación para comprobar si el campo "Total de importe de bonus" en el resultado de la integración es superior a 50 000 USD. Si es así, el paso se envía al grupo de seguridadCompensation Administratorpara su aprobación. De lo contrario, el paso se omite.
- Ejemplos, ejemplos y casos de uso de tipo de paso:
- Caso de uso: garantizar la precisión de los datos para integraciones de salida confidenciales, como nóminas o concesiones de acción .
- Práctica recomendada: asigne las aprobaciones a un grupo de seguridad basado en rol en lugar de a un usuario designado específico para evitar retrasos en el proceso debido a la ausencia del empleado .
- Ejemplo: antes de enviar un archivo de cambios de compensación de ejecutivos a un sistema externo, se envía un pasode aprobaciónal grupo de seguridadExecutive Compensation Adminpara validar los datos.
- Servicio
- Orden
- Puede colocarse en cualquier lugar después deInicio. El orden es crítico. Para una integración de entrada ,la recuperación de documentosdebe ir antes dela integración de activación. En el caso de una salida,la integración de Firedebe ir antesde la entrega de documentos.
- Realizado por
- Usuario de sistema de integración (ISU)
- Dominios de seguridad por rol
- ISU: accesoModify / PutaIntegration Build,Integration Configure.
- Especificar
- Debe especificar el servicio que se va a ejecutar:Recuperación de documentos,Envío de documentosoIntegración de activación.
- Regla de condición
- Caso de uso: para una integración que se ejecuta a diario, es posible que solo necesite recuperar un archivo el primer día de la semana.
- Práctica recomendada: utilice reglas de condición en los pasosde Envío de documentospara evitar el envío de archivos vacío . Puede crear una regla que compruebe si el recuento de registros del evento de integración es superior a cero.
- Ejemplo: una regla de condición en un pasode Envío de documentoscomprueba un campo calculado que cuenta el número de registros procesados por el pasoActivar integración. El paso de entrega solo se ejecuta si el recuento es superior a 0, lo que impide que el sistema envíe un archivo en blanco al proveedor.
- Consideraciones sobre el tipo de paso
- Recuperación de documentos: se utiliza en integraciones de entrada para extraer un archivo de un origen externo (como un servidor SFTP).
- Activar integración: este es el paso principal que ejecuta el sistema de integración principal, ya sea generando un archivo de resultado (salida) o cargando datos en Workday (entrada).
- Entrega de documentos: se utiliza en integraciones de salida para enviar un archivo generado a un destino externo (como un servidor SFTP o un punto final de servicio web).
- Tarea externa
- Orden
- Se puede colocar en cualquier parte del proceso en la que se necesite una acción o instrucción manual.
- Realizado por
- Un grupo de seguridad o un usuario especificado.
- Dominios de seguridad
- Usuario de sistema de integración, administrador de integración o administrador de proceso de gestión: accesoModify / Putaevento de integración.
- Regla de condición
- Útil para activar la intervención manual solo cuando sea necesario. Por ejemplo, una regla podría comprobar si el estado del evento de integración es "Finalizado con avisos", lo que activaría unatarea externapara que un administrador revise los avisos.
- Casos de uso de tipo de paso, mejores prácticas y ejemplos
- Caso de uso: notificación a un administrador para que realice una tarea manual fuera de Workday o para que verifique datos en Workday después de un paso de proceso.
- Práctica recomendada: haga que las instrucciones del paso Tareaexternasean claras y prácticas. Incluya vínculos a informes o tareas relevantes si es posible.
- Ejemplo: un EIB de entrada carga nuevos trabajadores contingentes. Un pasode tarea externaestá configurado para activador después del pasoServicio - Activar integración. Se asigna al grupoHRIS Analystcon la siguiente instrucción: "Se han cargado trabajadores contingentes. Ejecute el informe "Auditoría de nuevas contrataciones" para verificar sus datos y completar las localizaciones que faltan.
Integración
Este tipo de paso le permite iniciar otro sistema de integración independiente desde el proceso de gestión actual. Así es como se encadenan las integraciones.
- Orden
- Se puede colocar en cualquier lugar después del pasoInicio.
- Realizado por
- Usuario de sistema de integración (ISU)
- Especificar
- Debe seleccionar el sistema de integración que se va a iniciar como subproceso.
- Reglas de condición con casos de uso, prácticas recomendadas y ejemplo
- Caso de uso: después de ejecutar una integración de salida principal, desea ejecutar una segunda integración para archivar el archivo generado en una ubicación de almacenamiento a largo plazo , pero solo si la primera integración se ha realizado correctamente.Utilice una regla de condición para comprobar el estado de un paso anterior (Activar integración) para asegurarse de que finalice correctamente antes de iniciar una integración posterior que dependa de su resultado.Ejemplo: un pasode integraciónestá configurado para iniciar una "integración de archivo". Una regla de condición en este paso comprueba el estado del pasode activación de integraciónanterior. La integración de archivado solo se ejecuta si el estado del paso anterior es "Finalizado".
- Caso de uso: desea recuperar un archivo sin iniciar una integración o iniciar una integración sin entregar un archivo.Utilice una regla de condición que siempre se evalúe como falsa. Ejemplo: "1=2" en el paso que debe omitirse.
- Casos de uso de tipo de paso
- Caso de uso (enriquecimiento de datos): una integración inicial extrae los datos básicos de los empleado . Un segundo pasode integraciónllama a una integración diferente que toma el resultado inicial, añade datos de otro origen (como un informe personalizado) y genera un archivo final enriquecido.
- Caso de uso ( orquestación de procesos): después de que un EIB de entrada cargue nuevas contrataciones, un pasode integraciónpodría activador una integración de salida para aprovisionar cuentas para esas nuevas contrataciones en un sistema de TI externo.
- Caso de uso (errores de redirección): cuando se produce un error en un paso de integración , envíe la integración con errores a usuarios específicos en lugar de finalizar automáticamente el proceso de gestión.
- Configure los grupos de seguridad para que tengan permisosde Redirecciónen la política de seguridad de proceso de gestión.
- Utilice la acción relacionadaMantenimiento de redireccionamientoen el pasoIntegraciónde la definición de proceso de gestión.
- Seleccione una o varias acciones de redireccionamiento y uno o varios grupos de seguridad para recibir el paso redirigido.
- Ejemplo de tipo de paso
- El proceso de gestión se inicia y el primer paso,Servicio (integración de activación), ejecuta la integraciónde extracción de datos de pago, que genera un archivo de datos de nómina sin procesar. El siguiente paso,Integración, se configura para iniciar la integraciónde transformación PayData. Esta segunda integración está diseñada para acopio el archivo de la primera, reformatearlo con el formato XML obligatorio del proveedor y colocar el nuevo archivo en el área de espera de salida. El último paso,Servicio (entrega de documentos), entrega el archivo XML transformado al proveedor de nómina.
Notificaciones
Las notificaciones personalizadas se activan en función del estado final del evento de proceso de integración global . Puede configurar notificaciones en la propia definición de proceso de gestión (por ejemplo: al finalizar el paso o con un error).
Casos de uso con mejores prácticas y ejemplo:
- Caso de uso (éxito): envíe un correo electrónico al equipo de nómina para confirmar que el archivo de interfaz de nómina semanal se ha generado correctamente y se ha enviado al proveedor.
- Caso de uso (error): si se produce un error en una integración , envíe una notificación de alta prioridad al equipo de administración de integración con los detalles del evento y los mensajes de error para que puedan investigarlo inmediatamente.
- Práctica recomendada: utilice grupos de seguridad específicos basados en roles (por ejemplo,administradores de integración) como destinatarios en lugar de usuarios individuales. Cree mensajes de notificación claros y interactivos que incluyan información clave, como el nombre de la integración, la hora a la que se ejecutó y un vínculo al monitor de procesos para obtener más detalles.
- Ejemplo: se configura una notificación de integración para que activador cuando el estado del proceso de gestión sea "Error". Envía un correo electrónico al grupo de seguridadSoporte de integración. El cuerpo del correo electrónico está personalizado para que diga: "Se ha producido un error en la integraciónCCB - Datos demográficos de salida. Revise el monitor de procesos para obtener más información. ID de evento: [ID de evento]".
Problemas y soluciones
En esta sección se enumeran los problemas comunes junto con sus causas y soluciones correspondientes. Para los problemas que no aparecen aquí, le recomendamos que busque artículos de conocimientos en Community . Para obtener los mejores resultados:
- Busque el nombre exacto del proceso utilizando comillas dobles. Ejemplo: "Proceso de gestión de integración".
- Restrinja los resultados iniciales seleccionando los siguientes filtros de búsqueda:
- Grupo de contenido: artículos
- Tipo de contenido: artículo de conocimientos
- Utilice el filtroOrdenar porpara ver los resultados porRelevanciaoMás reciente.
Expedición | Causa y solución |
|---|---|
El punto final externo no recibir el archivo de integración esperado. | Utilice los informes monitor de procesos y Registro de proceso completo para determinar qué no ha funcionado como se esperaba. Consulte Resolución de problemas de eventos de proceso de integración enConcepto: procesos de gestión de integración . |
El archivo de salida no se ha entregado al punto final externo. | Causa: es posible que se haya producido un error en el proceso de gestión antes del paso de entrega de documentos o que se haya producido un error en el propio paso de entrega.
solución: para ver el estado y los mensajes de error relacionados con el error:
|
La integración de entrada no ha cargado ningún dato. | Causa: es posible que el paso de recuperación de documentos no haya búsqueda (noun), buscar (verb) el archivo, que el archivo esté vacío o que se haya producido un error en el paso de activación de integración durante la carga de datos.
solución: compruebe que el archivo existe en la ubicación externa especificada y que el nombre del archivo coincide con la configuración. Consulte el informe Eventos de integración . Para consultar los mensajes de error de proceso relacionados con el análisis de archivos o la validación de datos, seleccione la columna Creado a partir de activador para el evento de integración. |
Un paso de aprobación se ha enviado incorrectamente o se ha omitido. | Causa: es posible que la regla de condición del paso de aprobación no esté configurada correctamente o que los miembros del grupo de seguridad especificado no sean correctos.
solución: utilice el informe Consulta de definición de proceso de gestión para revisar la lógica de regla de condición del paso. Utilice el informe Consulta de grupo de seguridad para verificar la asociación al grupo de aprobador asignado. |
La integración falla con un error de seguridad . | Causa: al usuario de sistema de integración (ISU) asociado a la integración le faltan permisos para un dominio de seguridad obligatorio .
solución: revise el mensaje de error en los detalles de Eventos de integración para identificar los datos o la acción protegidos. Acceda al informe Políticas de seguridad de dominio para área funcional para búsqueda (noun), buscar (verb) el dominio pertinente y añadirlo a los grupos de seguridad asignados al ISU. |
Todas las integraciones no se inician con el error: "No hay definición por defecto para el tipo de proceso de gestión 'Evento de proceso de integración'..." | Causa: la definición de proceso de gestión por defecto para el evento de proceso de integración se ha desactivado, eliminado o editado incorrectamente y se ha guardado con errores. Todas las integraciones se basan en esta definición.
Solución:
|
Las notificaciones del proceso de gestión de integración están configuradas, pero no se envían por correo electrónico. | Causa: las reglas de ruta de notificación a nivel de entorno de cliente no están configuradas para enviar notificaciones relacionadas con la integración por correo electrónico.
Solución:
|
Se produce un error en una integración encadenada (iniciada desde un paso de integración ), lo que provoca la finalización de todo el proceso de gestión principal. | Causa: este es el comportamiento diseñado y esperado en Workday. El error en cualquier paso de un proceso de gestión, incluido un paso de integración , detendrá el proceso por defecto para evitar más errores.
solución: no se trata de un error que haya que "corregir", sino de un comportamiento que hay que gestionar.
|
Un paso de integración de Studio con errores no se redirige, aunque esté configurado con Mantenimiento de redireccionamiento . | Causa: actualmente, la función de mantenimiento de redireccionamiento solo funciona en integraciones de Studio que finalizan con el estado " Error ". Si una integración de Studio finaliza con el estado " Finalizado con errores ", la funcionalidad de mantenimiento de redireccionamiento no lo considerará un error.
solución: no se trata de un error que haya que "corregir", sino de un comportamiento que hay que gestionar. Asegúrese de que la integración tenga un control de error sólido y sus propias notificaciones específicas. VerConfiguración de redireccionamiento en pasos de proceso de gestión . |