Referencias técnicas

Esta sección incluye información útil que puede necesitar al interactuar con las actividades Workday REST .

Utilizar la actividad Ejecutar consulta WQL

Importante:

Para utilizar la actividad Ejecutar consulta WQL , debes configurar el ámbito Sistema - Lenguaje de consulta de Workday . Para obtener más información, consulta Autenticación de Workday.

El lenguaje de consulta de Workday o WQL es un lenguaje de consulta similar a SQL que proporciona capacidades mejoradas para consultar datos de Workday. Como se parece a SQL, puedes crear consultas manualmente dentro de Workday o convertir un informe existente a WQL utilizando la actividad Ejecutar consulta WQL .

Puedes convertir informes avanzados y matriciales a lenguaje de consulta de Workday (WQL) y, a continuación, utilizar la consulta resultante en la actividad Ejecutar consulta WQL para extraer datos de Workday.

Utiliza el siguiente ejemplo como referencia:

1. En Workday, busca la tarea Convertir informe a WQL .

   

2. Selecciona el informe que deseas convertir y selecciona la Cadena de consulta WQL convertida.

   

   

3. A continuación, introduce la consulta copiada en la actividad Ejecutar consulta WQL y selecciona el botón Generar esquema de salida .

   

4. Esta acción genera una lista de campos de salida.

   

También puedes explorar las tablas de Workday utilizando el objeto Fuentes de datos y crear tus propias consultas. Puedes acceder a las columnas de la tabla a través del objeto Campos de origen de datos , y los campos filtrables están disponibles en el objeto Filtros de origen de datos . Para obtener más información, consulta la documentación de Workday REST sobre fuentes de datos.

Cosas importantes a considerar

1. Primero debes generar el esquema de salida de los resultados de tu consulta y luego reemplazar cualquier valor de columna con variables después, en tiempo de diseño.
2. Puedes utilizar los parámetros LIMIT y OFFSET para paginar grandes conjuntos de datos.
3. Puede aparecer el siguiente mensaje de error si:

   1. El ámbito del sistema está ausente del cliente API. Comprueba los ámbitos (área funcional) de tu cliente API.

   2. Su consulta es incorrecta o contiene variables. Asegúrate de ejecutar correctamente la tarea Ver resultado de la consulta WQL en Workday y utiliza la consulta correcta en la actividad Ejecutar consulta WQL .

      

Referencia de fuentes de datos WQL

Las siguientes tablas enumeran los alias de origen de datos WQL seleccionados disponibles en la actividad Enumerar registros , organizados por objeto empresarial principal. Todas las fuentes de datos enumeradas son objetos estándar entregados por Workday que existen en todos los tenants y se pueden consultar sin parámetros adicionales.

Para descubrir todas las fuentes de datos disponibles en tu tenant específico, llama a:

GET /api/wql/v1/dataSources

Trabajador

Alias del origen de datos	Descripción	Caso de uso común
allWorkers	Todos los trabajadores (empleados y eventuales)	Sincronización completa de la fuerza de trabajo, aprovisionamiento de identidad
allActiveEmployees	Empleados actualmente activos	Informes de recuento activos, fuentes de nómina
allContingentWorkers	Trabajadores eventuales y por contrato	Gestión de proveedores, aprovisionamiento de acceso
allTerminatedWorkers	Trabajadores despedidos	Offboarding, auditorías de cumplimiento
allPreHires	Registros previos a la contratación	Incorporación de flujos de trabajo
allLeaveOfAbsenceWorkers	Trabajadores actualmente en licencia	Seguimiento de licencias, continuidad de beneficios
allRetiredWorkers	Trabajadores jubilados	Fuentes de beneficios para jubilados y pensiones
workerHistory	Registros históricos de cambios de trabajadores	Pistas de auditoría, seguimiento de cambios
workerCompensation	Datos de compensación por trabajador	Integraciones de nómina, recompensas totales
workerBenefitElections	Detalles de inscripción de beneficios	Fuentes del operador, informes de beneficios
workerTimeOff	Saldos y entradas de tiempo libre	Dejar informes de saldo
workerPersonalData	Información personal (dirección, fecha de nacimiento, etc.)	Sincronización de datos de recursos humanos, cumplimiento
workerDocuments	Documentos de trabajador adjuntos	Integraciones de gestión de documentos
workerAccountProvisioning	Datos de aprovisionamiento de cuenta e identidad	Sincronización de IAM (por ejemplo, Okta, Azure AD)

Organización

Alias del origen de datos	Descripción	Caso de uso común
allOrganizations	Todos los tipos de organización	Sincronización de la estructura organizativa
allSupervisoryOrganizations	Jerarquía de la organización de supervisión	Jerarquía de gestores, organigramas
allCostCenters	Lista de centros de coste	Informes financieros, asignación de costes
allCompanies	Lista de entidades legales y empresas	Informes de varias entidades
allRegions	Estructuras regionales	Informes basados en la geografía
allCustomOrganizations	Tipos de organización personalizados	Estructuras organizativas específicas del cliente
organizationHierarchies	Árbol organizativo completo	La jerarquía se alimenta a los sistemas posteriores
allBusinessUnits	Estructura de la unidad de negocio	Informes a nivel de segmento

Posición

Alias del origen de datos	Descripción	Caso de uso común
allPositions	Todas las posiciones	Sincronización del catálogo de puestos
allOpenPositions	Posiciones sin cubrir y abiertas	Proceso de contratación, planificación de la fuerza laboral
allFilledPositions	Puestos ocupados actualmente	Informes de recuento
positionBudget	Datos de presupuesto de posición	Integración de la planificación financiera
positionRestrictions	Restricciones en las posiciones	Cumplimiento y gobernanza
allHeadcountGroups	Grupos de seguimiento de recuento	Análisis de la fuerza de trabajo

Contratación (solicitud de empleo)

Alias del origen de datos	Descripción	Caso de uso común
allJobApplications	Aplicaciones de contratación	Integración de ATS, análisis de contratación
allJobRequisitions	Abrir solicitudes	Seguimiento de solicitudes
allCandidates	Grupo de candidatos	Informes de procesos de candidatos
allOffers	Ofertas de trabajo	Fuentes de gestión de ofertas
allInterviews	Registros de entrevistas	Análisis de programación de entrevistas
allReferrals	Referencias de empleados	Seguimiento del programa de referencia

Compensación

Alias del origen de datos	Descripción	Caso de uso común
allCompensationPlans	Estructuras del plan de compensación	Administración del plan
allCompensationGrades	Definiciones de grado y banda	Integraciones de asignación de calificaciones
allCompensationPackages	Compensación empaquetada	Informe de recompensas totales
allBonusPlans	Estructuras de bonificación	Fuentes de pago de bonificación
allStockPlans	Planes de acciones y acciones	Administración de capital
allMeritPlans	Planes de aumento por méritos	Fuentes anuales del ciclo de méritos

Beneficios

Alias del origen de datos	Descripción	Caso de uso común
allBenefitPlans	Catálogo de planes de beneficios	Validación de la configuración del plan
allBenefitGroups	Grupos de elegibilidad para beneficios	Revisión de las reglas de elegibilidad
allHealthCareCoverage	Datos de cobertura sanitaria	Fuentes de inscripción de operadores
allInsuranceCoverage	Seguro de vida e invalidez	Fuentes de las compañías de seguros
allRetirementPlans	401k y planes de pensiones	Retirada de fuentes de proveedores
allBenefitElections	Elecciones activas	Informes de inscripción abierta

Seguimiento de tiempo y ausencia

Alias del origen de datos	Descripción	Caso de uso común
allTimeEntries	Entradas de reloj de tiempo	Fuentes de tiempo de nómina
allAbsenceRequests	Solicitudes de permiso	Gestión de licencias
allTimeOffPlans	Definiciones del plan de tiempo libre	Sincronización de la configuración del plan
allLeaveTypes	Dejar catálogo de tipos	Dejar informes de políticas
allTimeCalendars	Configuraciones de calendario	Gestión de programación

Talento y rendimiento

Alias del origen de datos	Descripción	Caso de uso común
allPerformanceReviews	Datos del ciclo de revisión	Análisis de rendimiento
allGoals	Objetivos de los empleados	Integración de seguimiento de objetivos
allCompetencies	Marcos de competencias	Análisis de brechas de habilidades
allSuccessionPlans	Grupos de sucesión	Planificación de la sucesión
allTalentPools	Proceso de talentos	Gestión del talento
allLearningCourses	Catálogo de cursos LMS	Sincronización de la plataforma de aprendizaje

Solicitud HTTP

Puedes utilizar la actividad de solicitud HTTP para llamar a cualquier API Workday REST, siempre que asignes los permisos necesarios al cliente de API utilizado. Para obtener más información, consulta la Guía de autenticación de Workday REST.