Anteriormente conocido como Adaptive Insights, el conector de Workday Adaptive Planning utiliza comandos en una cadena para importar o exportar datos o metadatos.
Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.
Requisitos
Para habilitar la conexión, el conector utiliza la API REST de Workday Adaptive Planning. Para configurar el conector, necesitarás:
- Un usuario de integración configurado en Planificación Adaptativa al que se le ha asignado un rol con los permisos adecuados para ejecutar los comandos del conector.
- Nombre de usuario y Contraseña del usuario de integración.
- Si el usuario de la integración puede acceder a varias instancias de Planificación Adaptativa, el Código de Instancia al que se conectarán.
Nota: Para determinar los códigos de instancia disponibles del usuario de integración, puedes utilizar el punto final de la API de planificación adaptativa
exportInstances.
Establece el conector de planificación adaptativa 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 primero lo habilita desde Configuración.
- En el Generador de cadenas, haz clic en Conexiones compare_arrows y, a continuación, en Crear en la parte superior derecha.
- En Conector Conexión, selecciona Workday Adaptive Planning y el CloudRunner predeterminado.
Workiva ofrece dos métodos de autenticación (Básico y Concesión de portadores JWT (Credenciales de Workday)). Puedes seleccionar el que quieras utilizar en Credenciales en la configuración de la conexión.
Autenticar con Autenticación básica
- En Propiedades, introduce opcionalmente el código de instancia para la instancia de Planificación adaptativa.
- Selecciona 'Credencial Básica' como tipo de autenticación.
- Introduce los siguientes valores:
Nombre de usuario: El nombre de usuario del usuario de integración para utilizarlo con el conector.
Contraseña: La contraseña para el usuario proporcionada en el campo Nombre de usuario.
Autenticación con una concesión de portador JWT (credenciales de Workday)
Este método de autenticación utiliza las credenciales de Workday para autenticarse con Adaptive Planning, y requiere que:
- El SSO esté activado.
- Los ajustes de inquilino de Workday para el Inicio de sesión de usuario de Planificación adaptable y las API públicas habilitadas están activados.
- Está asignada una ISU de API pública entre Workday y Planificación adaptable.
Para obtener detalles específicos sobre esta configuración, consulta la siguiente Documentación de Workday:
- Establecer SAML SSO en Adaptive Planning para usuarios sincronizados
- Resolución de problemas: Sincronización de usuarios con Planificación Adaptativa
A partir de esta configuración, debe subirse una clave privada x509 a la parte Connection Resources de esta conexión, y debe subirse a Workday un certificado público creado por esta clave y asociado a un cliente API de tipo "JWT Bearer Grant". Este cliente, a su vez, debe estar asociado a la ISU que estés utilizando para las solicitudes a Planificación adaptable, con credenciales asignadas entre los dos sistemas.
Para obtener detalles específicos sobre esta configuración, consulta la siguiente documentación de Workday: Registrar Clientes API.
Detalles de la clave
El formato de clave privada admitido es PKCS#8, y puede estar protegido con contraseña o no. Se puede crear una nueva clave utilizando openssl con el siguiente comando:
openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650
Determinar el host, el dominio y el inquilino de Workday
Utilizando el punto final de la API REST de Workday que aparece bajo el Cliente API, identifica el host, el dominio y el inquilino, que sigue el formato de https://{host}.{domain}/ccx/api/v1/.{tenant}
Ejemplo
https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany
| Propiedad | Valor |
| Inquilino | miempresa |
| Host | wd2-servicios-impl1 |
| Dominio | workday.com |
Establecer como Tipo de credenciales de portador en el conector de Planificación adaptable
- Sube tu clave privada a la parte de Recursos de la conexión.
- Selecciona el tipo de autenticación "Portador".
- Introduce la siguiente información:
Propiedad Detalles Tecla Privada x509 Introduce el nombre de la clave privada cargada exactamente como se muestra en los recursos de conexión. Contraseña Introduce la contraseña de la clave privada. Deja este campo en blanco si tu clave no está protegida con contraseña. ID de cliente Introduce el Id. de cliente del cliente de la API de concesión de portadores JWT. Usuario del servicio de integración Introduce el nombre del Usuario del Servicio de Integración (ISU) asociado al Cliente API Host Introduce el host del entorno de Workday al que conectarte. En la URL del entorno, los caracteres anteriores a la propiedad Dominio representan el host. Inquilino Introduce el entorno de cliente de Workday al que conectarse. Dominio Introduce el dominio del entorno de Workday al que conectarte, como workday.com o myworkday.com.
Una vez establecida la autenticación:
- Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
- Para probar la conexión, crea y ejecuta una cadena con el comando Exportar versiones del conector , y comprueba que devuelve un resultado válido.
Solución de problemas
Si falla la conexión con Workday Adaptive Planning:
- Verifica las credenciales de autenticación del usuario de integración.
- Asegúrate de que el rol del usuario de integración tiene los permisos adecuados para los comandos que realiza el conector.
- Si el usuario de la integración puede acceder a varias instancias de Adaptive Planning, comprueba el código de instancia introducido para el conector.
Para obtener información adicional sobre cómo realizar solicitudes de API de planificación adaptable utilizando credenciales de Workday, consulta esta página de Workday: Realizar Solicitudes a la API de Planificación Adaptativa con Credenciales de Workday.