Centro de soporte de Workiva

Con el conector de Workiva, puedes utilizar comandos en cadenas para interactuar con la plataforma de Workiva, incluyendo otras funciones de Wdata, Hojas de cálculo y GraphDB. Por ejemplo, con este conector, puedes:

• crear y administrar tablas, consultas y vistas,
• elaborar una lista de los conjuntos de datos de una tabla o los errores de importación,
• crear y administrar hojas de cálculo o sus hojas,
• gestionar registros e informes.

Requisitos

Para interactuar con la plataforma de Workiva, el conector utiliza las API REST de Workiva. Para configurar el conector, necesitarás:

• Un usuario dedicado a la integración de Workiva con una subvención OAuth2.

  Nota: Este usuario de integración requiere permisos apropiados para los comandos que realiza el conector, como Propietario de las hojas de cálculo o del espacio de trabajo con el que interactúa.

• El ID y el secreto de concesión OAuth2 del usuario de integración.
• Para ejecutar la cadena en un entorno de prueba, las URL para anular los hosts de la API y las rutas de base.

Nota: Mientras que los propietarios del espacio de trabajo pueden acceder a las cadenas que utilizan el conector, el conector en sí requiere un usuario de integración exclusivo para ejecutar los 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.

Configurar el conector de Workiva

1. Desde Generador de cadenas, haz clic en Conexiones compare_arrows, y luego en Crear en la parte superior derecha.
2. Debajo de Crear conexión, selecciona Workiva y el CloudRunner predeterminado.
   
3. En Información básica, ingresa un nombre único y una descripción para ayudar a identificar el conector.

4. En Resources, seleccione los recursos que desea asociar a esta conexión.
   Esta sección proporciona una ubicación segura para cualquier archivo (scripts, tokens de seguridad, certificados, etc.) que el conector necesite para funcionar, como por ejemplo para la autenticación o los requisitos del entorno. Al guardar la conexión, estos archivos se cifran automáticamente con AES-256. Para más información, consulte la arquitectura de seguridad de Workiva Chain Builder Support page.

   Ventajas:

   • Almacenamiento seguro: Dado que estos archivos se cifran al guardarlos y se almacenan en el nivel de conexión, son ideales para datos de configuración sensibles o estáticos que no deben codificarse en la propia cadena.
   • Portabilidad: Si traslada su cadena de un espacio de trabajo de "Prueba" a un espacio de trabajo de "Producción", los recursos permanecen vinculados a la configuración de Conexión, lo que significa que no tiene que reescribir las rutas de los archivos en los nodos de su cadena.
   • Accesibilidad: Almacenar los archivos aquí hace que los archivos estén disponibles para el Runner (el agente que ejecuta la tarea) sin requerir que el archivo se coloque manualmente en la máquina host física del corredor.

   Desventajas:

   • Al estar encriptados, no pueden editarse directamente; tienes que borrar el archivo y subir la versión modificada.

5. En Propiedades, ingresa los detalles de la conexión:
   

   Propiedad	Detalles
   ID	Ingresa el ID para la concesión OAuth de los usuarios de integración.
   Secreto	Ingresa el secreto para la propiedad de ID.
   Anulación del host central	Para anular el host de URL y la ruta base para los puntos finales de Wdata, como por ejemplo, para un entorno de prueba, introduce la URL que se va a utilizar en su lugar.
   Anulación del host de hojas de cálculo	Para anular el host de URL y la ruta base para los puntos finales de Hojas de cálculo, como por ejemplo, para un entorno de prueba, introduce la URL que se va a utilizar en su lugar.
   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.
   Anulación del host de administración	Para anular el host de URL y la ruta base para los puntos finales de Administración, como por ejemplo, para un entorno de prueba, introduce la URL que se va a utilizar en su lugar.
   Anulación del host de GraphDB	Para anular el host de URL y la ruta base para los puntos finales de GraphDB, como por ejemplo, para un entorno de prueba, introduce la URL que se va a utilizar en su lugar.
   Anulación del host de API de la plataforma	Para anular el host de URL y la ruta base para los puntos finales de la plataforma de Workiva, como por ejemplo, para un entorno de prueba, introduce la URL que se va a utilizar en su lugar.

   Nota: Todas las credenciales confidenciales se cifran automáticamente y se almacenan mediante cifrado AES-256.

6. Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
7. Para probar la conexión, crea y ejecuta una cadena con el comando List Files del conector y comprueba que devuelve un resultado válido.

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.

Solución de problemas

Si falla la conexión con la plataforma Workiva:

• Compruebe que las credenciales OAuth de la aplicación del conector están presentes, son correctas y válidas. Las credenciales OAuth tienen fechas de caducidad definidas, y el certificado puede haber caducado. Si es así, tendrás que crear un nuevo certificado e introducir el nuevo secreto de cliente en el Conector. 
• Asegúrate de que el usuario de integración tiene los permisos adecuados para el comando que se está ejecutando.
• Si utiliza una anulación de host, compruebe que la URL introducida para el conector es correcta.

• Compruebe que el ID del fichero Workiva -como la tabla, consulta u hoja de cálculo- con el que se está interactuando es correcto.

  Nota: El ID de un archivo aparece en su URL cuando se abre en Workiva. Por ejemplo, el ID de una hoja de cálculo aparece después de spreadsheet/ en su URL; el ID de una tabla aparece después de tables/.