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

  Nota: este usuario de integración requiere permisos adecuados para los comandos que ejecuta 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 Generador de cadenas, haz clic en compare_arrows Conexiones en la barra lateral izquierda y, a continuación, 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 quieras 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 para requisitos de autenticación o entorno. Cuando guardas la conexión, estos archivos se cifran automáticamente con AES-256. Para más información, consulta la página de Soporte de Workiva Arquitectura de seguridad del Generador de cadenas de Workiva.

   Ventajas:

   • Almacenamiento seguro: debido a que estos archivos se cifran al guardarse y se almacenan a nivel de conexión, son ideales para datos de configuración confidenciales o estáticos que no deberían estar codificados directamente en la cadena.
   • Portabilidad: si trasladas tu cadena de un espacio de trabajo de «Prueba» a uno 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 archivo en los nodos de tu cadena.
   • Accesibilidad: almacenar los archivos aquí los hace disponibles para el Runner (el agente que ejecuta la tarea) sin necesidad de colocar manualmente el archivo en la máquina host física del runner.

   Desventajas:

   • Debido a que están cifrados, no se pueden editar directamente; tienes que eliminar el archivo y subir la versión modificada.

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

   Propiedad	Detalles
   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 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 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 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, comprueba que la URL introducida para el conector sea correcta.

• Verifica que el ID del archivo de Workiva (como la tabla, la consulta o la 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/.