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 host y el dominio del entorno de Workday al que conectarse.
- Las credenciales de autenticación de un usuario del sistema de integración creado en Workday.
Paso 1: Obtener la información de Workday Tenant
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: Dotación de personal para Get Workers, Gestión financiera para el presupuesto de importación, Integraciones para los mandos relacionados con el BEI,.... - Haga clic en el botón "Acciones relacionadas" de ese servicio y, a continuación, 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 del atributo
location, extraiga la información del inquilino, el host y el dominio de la URL.
La URL utiliza el siguiente formato:https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number
Ejemplo
Utilizando el formato anterior, podemos encontrar 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 la muestra |
|---|---|
| Inquilino | miempresa |
| Host | wd2-servicios-impl1 |
| Dominio | workday.com |
Necesitará estos valores cuando configure su conector en el siguiente paso.
Paso 2: Configurar la autenticación de Workday
Este conector ofrece dos formas de autenticación: OAuth2 vía API, y Usuario+Contraseña.
Autenticación API OAuth2
Si utiliza la autenticación de API OAuth2, debe tener un cliente de API configurado en Workday. Consulte la página de soporte de Workday Register API Clients para obtener instrucciones sobre la creación de un cliente API.
Como parte de esta configuración del cliente API, asegúrese de que tiene:
- Seleccionado Bearer como el Access Token Type.
- Habilitadas (marcadas) las siguientes casillas de verificación:
- Fichas de actualización no caducadas
- Incluir el ámbito propio de Workday
URL de redireccionamiento
Workiva tiene URLs de anulación de conexión específicas de cada región para las configuraciones de los conectores. Utilice la siguiente tabla para seleccionar la URL correcta para su ubicación.
Si se encuentra en América del Norte, Central o del Sur, utilice la URL por defecto. Si se encuentra en la región Asia-Pacífico, utilice la URL APAC. Si se encuentra en EMEA, utilice la URL de la UE.
| Entorno | Redirigir URL |
|---|---|
| APAC prod | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| Prod UE | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| EE.UU. prod | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
Puntos finales OAuth2
Si está utilizando OAuth2 para verificar su conexión necesitará tener los siguientes valores de endpoint. Estos aparecerán cuando configure el cliente API de Workday en la página Edit API Client en Workday.
| Punto final | Valor de la muestra |
|---|---|
| Punto final REST de Workday | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Workday OAuth2 token endpoint | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Punto final de autorización Workday OAuth2 | https://xxxx.workday.com/xxxx/authorize |
SUGERENCIA: Si está utilizando una instancia de cliente de API existente que utiliza un token y un secreto OAuth2, puede ver esta información en la parte superior de la página Workday View API.
Autenticación básica
Si utiliza Basic Authentication, consulte la página de soporte de Workday Crear 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 su organización, un administrador de seguridad de la organización debe habilitarlo primero desde Configuración.
- Desde Chain Builder, haga clic en Connections, y luego Create en la parte superior derecha.
- En Connector Connection, seleccione Workday Connector 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 utiliza OAuth2, deberá introducir los valores de Workday REST Endpoint, Workday OAuth2 Token Endpoint, y Workday OAuth2 Authorization Endpoint.
Si utiliza Basic Authentication (nombre de usuario+contraseña), déjelos 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 conectarse,
comoworkday.comomyworkday.com.Punto final REST de Workday La URL del punto final REST proporcionado por Workday.
(Sólo si se utiliza la autenticación OAuth2)Workday OAuth2 token endpoint La URL del punto final del token OAuth2 proporcionado por Workday.
(Sólo si se utiliza la autenticación OAuth2)Punto final de autorización Workday OAuth2 La URL del punto final de OAuth2 proporcionada por Workday.
(Sólo 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.
- Verifique que el usuario del sistema de integración tiene los permisos adecuados para acceder a los grupos funcionales y dominios relacionados con los comandos de la conexión.
- Compruebe que se han introducido el inquilino, el host y el dominio de Workday correctos para el conector.
- Al ejecutar el comando Descargar informe personalizado, asegúrate de que el tipo de informe está establecido como Avanzado. Los informes compuestos no están disponibles a través de la API de Workday en este momento.