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 y una autorización OAuth2.

  Nota: Este usuario de integración debe disponer de los permisos adecuados para los comandos que ejecuta el conector, como por ejemplo, ser propietario de las hojas de cálculo o del espacio de trabajo con el que interactúa.

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

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 Chain Builder, haz clic en compare_arrows Connections en la barra lateral izquierda y, a continuación, en compare_arrows Create en la esquina 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 « » (Recursos), selecciona los recursos que deseas asociar a esta conexión.
   Esta sección ofrece una ubicación segura para cualquier archivo (scripts, tokens de seguridad, certificados, etc.) que el conector necesite para funcionar, por ejemplo, para la autenticación o para cumplir los requisitos del entorno. Al guardar la conexión, estos archivos se cifran automáticamente con el algoritmo AES-256. Para obtener más información, consulta la página de soporte de Workiva Chain Builder sobre la arquitectura de seguridad de .

   Ventajas:

   • Almacenamiento seguro: Dado que estos archivos se cifran al guardarlos y se almacenan a nivel de conexión, son ideales para datos de configuración confidenciales o estáticos que no deben incluirse de forma fija en la propia cadena.
   • Portabilidad: Si trasladas tu cadena de un espacio de trabajo «Test» a uno «Production», los recursos siguen vinculados a la configuración de conexión, lo que significa que no tienes que volver a escribir las rutas de los archivos en los nodos de tu cadena.
   • Accesibilidad: Al almacenar los archivos aquí, el Runner (el agente que ejecuta la tarea) puede acceder a ellos sin necesidad de colocarlos manualmente en el servidor físico del runner.

   Desventajas:

   • Como están encriptados, no se pueden editar directamente; hay 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 y almacenan automáticamente mediante el 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 .apac, .ca o .eu, es necesario realizar una 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:

• Comprueba que las credenciales OAuth de la aplicación del conector estén presentes, sean correctas y estén vigentes. 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 utilizas una sustitución de host, comprueba que la URL introducida para el conector sea correcta.

• Comprueba que el identificador del archivo de Workiva —como la tabla, la consulta o la hoja de cálculo— con el que se está interactuando sea 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/.