Nota: Este conector desarrollado por Workiva te permite conectar las plataformas Workiva y Workday. El Soporte técnico de Workiva estará encantado de guiarte en la configuración del conector dentro de tu espacio de trabajo. Sin embargo, cualquier error de la plataforma Workday o la resolución de problemas dentro de la plataforma Workday deben ser gestionados por tu administrador de Workday o su equipo de soporte.
Con el conector de Workday, puedes utilizar los comandos en una cadena para interactuar con Workday® HR y Finanzas para:
- Descargar informes personalizados de Workday
- Importar datos presupuestarios a Workday
- Iniciar una integración de Workday Enterprise Interface Builder (EIB)
Requisitos
Para establecer la conexión, necesitarás:
- El inquilino de Workday al que conectarse.
- El servidor y el dominio del entorno de Workday al que hay que conectarse.
- Las credenciales de autenticación de un usuario del sistema de integración creado en Workday.
Paso 1: Obtener la información del tenant de Workday
Puedes determinar la información sobre el inquilino, el host y el dominio desde el archivo XML WSDL del servicio web público de Workday .
- Introduce "Servicios Web Públicos" en la barra de búsqueda de Workday y selecciona ese informe.
- Busca el Servicio Web para la integración concreta que estés utilizando.
Algunos ejemplos son: la dotación de personal para Get Workers, la gestión financiera para Import Budget, las integraciones para los comandos relacionados con el EIB, etc. - Haz clic en el botón «Acciones relacionadas» de ese servicio y, a continuación, haz clic en « » (Ver WSDL) en el menú «Servicio web».
- En el archivo XML, localiza el elemento
soapbind:address(suele estar cerca de la parte inferior del archivo). - Utilizando la URL de la ubicación «
» (atributo «»), extrae de la URL la información sobre el inquilino, el host y el dominio.
La URL tiene el siguiente formato:https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number
Ejemplo
Siguiendo el formato anterior, podemos averiguar el inquilino, el host y el dominio a partir de una URL WSDL de ejemplo:https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1
| Propiedad | Valor de muestra |
|---|---|
| Inquilino | miempresa |
| Host | wd2-servicios-impl1 |
| Dominio | workday.com |
Necesitarás estos valores a la hora de configurar tu conector en el siguiente paso.
Paso 2: Configurar la autenticación de Workday
Este conector ofrece dos formas de autenticación: OAuth2 a través de la API y nombre de usuario + contraseña.
Autenticación mediante la API OAuth2
Si utilizas la autenticación mediante la API OAuth2 de , debes tener configurado un cliente de API en Workday. Consulta la página de asistencia de Workday y la página «Registrar clientes de API» para obtener instrucciones sobre cómo crear un cliente de API.
Como parte de la configuración de este cliente de API, asegúrate de que dispones de:
- He seleccionado « » como «Bearer» y « » como «Tipo de token de acceso».
- He marcado las siguientes casillas de selección:
- Tokens de actualización sin fecha de caducidad
- Incluir el ámbito de Workday
URL de redirección
Workiva dispone de URL de anulación de conexión específicas para cada región para las configuraciones de los conectores. Utiliza la siguiente tabla para seleccionar la URL correcta según tu ubicación.
| Entorno | URI de redirección |
|---|---|
| Producción en APAC (región de Asia-Pacífico) | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| CA prod (Canadá) | https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback |
| Productos de la UE (EMEA) | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| Producción estadounidense (EE. UU., América Central, América del Sur) | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
Puntos finales de OAuth2
Si utilizas OAuth2 para verificar tu conexión, necesitarás disponer de los siguientes valores de punto final. Estas opciones aparecerán cuando configures el cliente de la API de Workday en la página « » (Editar cliente de la API) de Workday.
| Punto final | Valor de muestra |
|---|---|
| Punto de conexión REST de Workday | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Punto final del token OAuth2 de Workday | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Punto final de autorización OAuth2 de Workday | https://xxxx.workday.com/xxxx/authorize |
CONSEJO: Si estás utilizando una instancia de cliente de la API ya existente que emplea un token y un secreto de OAuth2, puedes consultar esta información en la parte superior de la página « » de Workday:.
Autenticación básica
Si utilizas la autenticación básica de , consulta la página de soporte técnico de Workday. Crea una cuenta de usuario del sistema de integración (ISU) en Workday para obtener instrucciones sobre cómo crear un usuario del sistema de integración (ISU).
Paso 3: Configurar el conector de Workday
Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización debe habilitarlo primero desde Configuración.
- Desde Chain Builder, haz clic en Connections y, a continuación, en Create en la esquina superior derecha.
- En « » (Conectores de Workday), en «Connection» (Conexión), selecciona « » (Conector de Workday) y el CloudRunner predeterminado.
- En Información básica, ingresa un nombre único y una descripción para ayudar a identificar la conexión.
-
En Propiedades, introduce los detalles de la conexión.
Si utilizas OAuth2, deberás introducir los valores correspondientes a (punto final REST de Workday), (punto final de tokens OAuth2 de Workday) y (punto final de autorización OAuth2 de Workday).
Si utiliz , la autenticación básica (nombre de usuario + contraseña), deja estos campos en blanco.Campo Contenido Inquilino El inquilino de Workday al que conectarse. Host El host del entorno de Workday al que conectarse. En la URL del entorno, los caracteres que preceden a la propiedad « Domain » representan el host. Dominio El dominio del entorno de Workday al que hay que conectarse,
, como por ejemploworkday.com,omyworkday.com,.Punto de conexión REST de Workday La URL del punto final REST facilitada por Workday.
(Solo si se utiliza la autenticación OAuth2.)Punto final del token OAuth2 de Workday La URL del punto final del token OAuth2 facilitada por Workday.
(Solo si se utiliza la autenticación OAuth2.)Punto final de autorización OAuth2 de Workday La URL del punto final OAuth2 facilitada por Workday.
(Solo si se utiliza la autenticación OAuth2.)
Solución de problemas
Si falla la conexión con Workday:
- Verifica que las credenciales de autenticación del usuario del sistema de integración son correctas.
- Comprueba que el usuario del sistema de integración disponga de los permisos adecuados para acceder a los grupos funcionales y dominios relacionados con los comandos de la conexión.
- Comprueba que se hayan introducido correctamente el tenant, el host y el dominio de Workday para el conector.
- Al ejecutar el comando Descargar informe personalizado, asegúrate de que el tipo de informe está establecido como Avanzado. Por el momento, los informes compuestos no están disponibles a través de la API de Workday.