El conector Cadenas de Workiva proporciona comandos comunes para espacios de trabajo, entornos y cadenas. Esto incluye comandos de listar y obtener utilizados para recuperar propiedades, detalles de ejecuciones en cadena, eventos de actividad de inicio de sesión y mucho más.
Para obtener una lista completa de comandos compatibles, consulta el artículo Comandos de Cadenas Workiva.
Requisitos
Antes de utilizar el conector:
- Un administrador de seguridad de la organización debe habilitar el conector Workiva Cadenas a través de la pantalla Configuraciones.
- Para ejecutar la cadena en un entorno de pruebas, necesitarás las URL para invalidar los hosts y las rutas base de la API.
- Debes crear un usuario de integración dedicado con una concesión de OAuth2 dentro de tu software.
- Para encontrar los identificadores de tus cadenas, consulta este artículo sobre encontrar identificadores en Workiva.
Requisitos adicionales para el usuario de integración
Aunque todos los propietarios de espacios de trabajo pueden acceder a las cadenas que utilizan el conector, el conector en sí requiere un usuario de integración dedicado para ejecutar sus comandos. Mediante un usuario de integración exclusivo (en lugar de la cuenta de usuario de un colaborador) se puede realizar un seguimiento de la actividad del conector y limitar su acceso solo a lo necesario para ejecutar los comandos.
Se requiere lo siguiente al configurar el usuario de integración:
- Debes conocer el ID y el secreto de concesión de OAuth2 del usuario de integración.
- Debes proporcionar al usuario de la integración los permisos adecuados para cada comando que vaya a realizar el conector
- El usuario de la integración debe iniciar sesión en el Generador de cadenas antes de poder ejecutar cualquier comando. Esto es necesario para establecer la Cuenta del usuario.
Configuración de la conexión
Para establecer el conector de Cadenas Workiva:
- En el Generador de cadenas, haz clic en Conexiones y, a continuación, en Crear en la parte superior derecha.
- Debajo de Conector Conexión, selecciona Cadenas Workiva y el CloudRunner predeterminado.
- En Información básica, introduce un nombre único y una descripción para ayudar a identificar el conector.
- En Propiedades, introduce los detalles de la conexión:
Propiedad Detalles URL base La URL base; predeterminada como https://h.app.wdesk.com/s/wdata/oc/api/ id.|Id. Introduce el ID para la concesión OAuth de los usuarios de integración. Secreto Introduce el secreto para la propiedad de ID. Anulación del host de IAM Para anular el host de URL y la ruta base para los puntos finales de la Administración de acceso de identidades (IAM), como por ejemplo, para un entorno de prueba, ingresa la URL que se va a utilizar en su lugar. - Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
Anulaciones de URL
Dependiendo de la región de tu entorno de producción, puede aplicarse una URL de anulación. Puedes comprobarlo comparándola con la URL utilizada para iniciar sesión en Wdesk. Si la URL contiene EU o APAC, es necesaria la anulación.
Nota: La información sobre la región de EE. UU. figura como referencia.
| Campo | Valor |
|---|---|
| Anulación del host central | https://h.app.wdesk.com/s/cerebral |
| Anulación del host de hojas de cálculo | https://api.app.wdesk.com/spreadsheets/v1/ |
| Anulación del host de IAM | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Anulación del host de administración | https://api.app.wdesk.com/admin/v1 |
| Anulación del host de GraphDB | https://api.app.wdesk.com/graphdb/v1/ |
| Anulación del host de API de la plataforma | https://api.app.wdesk.com/platform/v1 |
| Campo | Valor |
|---|---|
| Anulación del host central | https://h.eu.wdesk.com/s/cerebral |
| Anulación del host de hojas de cálculo | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Anulación del host de IAM | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Anulación del host de administración | https://api.eu.wdesk.com/admin/v1 |
| Anulación del host de GraphDB | https://api.eu.wdesk.com/graphdb/v1/ |
| Anulación del host de API de la plataforma | https://api.eu.wdesk.com/platform/v1 |
| Campo | Valor |
|---|---|
| Anulación del host central | https://h.apac.wdesk.com/s/cerebral |
| Anulación del host de hojas de cálculo | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Anulación del host de IAM | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Anulación del host de administración | https://api.apac.wdesk.com/admin/v1 |
| Anulación del host de GraphDB | https://api.apac.wdesk.com/graphdb/v1/ |
| Anulación del host de API de la plataforma | https://api.apac.wdesk.com/platform/v1 |