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 de integración de Workiva dedicado con una concesión OAuth2.

  Nota: Este usuario de integración requiere los permisos adecuados para los comandos que realiza el conector, como ser 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 direcciones URL para anular los hosts y las rutas base de 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 Conexiones en la barra lateral izquierda y luego en compare_arrows 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 Recursos, selecciona los recursos que deseas asociar a esta conexión.
   Esta sección proporciona un lugar seguro para cualquier archivo (scripts, tokens de seguridad, certificados, etc.) que el conector necesite para funcionar, como para autenticación o requisitos de entorno. Cuando guardas la conexión, estos archivos se cifran automáticamente con AES-256. Para obtener más información, consulta la página de soporte Arquitectura de seguridad del Generador de cadenas de Workiva.

   Ventajas:

   • Almacenamiento seguro: Debido a que estos archivos se cifran al guardarlos y se almacenan a nivel de conexión, son ideales para datos de configuración sensibles o estáticos que no deben estar codificados directamente en la cadena.
   • Portabilidad: si mueves tu 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 la conexión, lo que significa que no tienes que reescribir las rutas de los archivos en los nodos de tu cadena.
   • Accesibilidad: almacenar los archivos aquí los pone a disposición del Runner (el agente que ejecuta la tarea) sin necesidad de colocar manualmente el archivo en la máquina física del runner.

   Desventajas:

   • Debido a que están cifrados, no se pueden editar directamente; debes eliminar el archivo y cargar 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 sensibles se cifran y almacenan automáticamente usando 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, se requiere 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:

• Verifica que las credenciales de OAuth de la aplicación del conector estén presentes, sean 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 usas una anulación de host, verifica que la URL ingresada para el conector sea correcta.

• Verifica que el ID del archivo de Workiva (como la tabla, consulta u hoja de cálculo) con el que se interactúa 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/.