Centro de soporte de Workiva

La integración de OneStream con Workiva de permite a las organizaciones automatizar la extracción, la transformación y la transferencia de datos desde OneStream Cloud a la plataforma Workiva. Esta integración puede implementarse bien mediante una conexión directa basada en la API de a través de Workiva Chains y el conector HTTP, bien mediante un flujo de trabajo SFTP basado en archivos utilizando el conector OneStream Smart Integration Connector (SIC).

Ambos métodos de integración permiten la importación de datos a Workiva para los procesos de generación de informes conectados posteriores.

Integración de API

Requisitos de conexión a la API

• Entorno en la nube de OneStream: El método de integración mediante API solo es compatible cuando OneStream se aloja en un entorno en la nube de acceso público.
• Cuenta de servicio dedicada: Por motivos de seguridad, auditoría y estabilidad operativa, crea una cuenta de servicio dedicada y no interactiva dentro de OneStream específicamente para la integración.
• Permisos mínimos necesarios: Asigna a la cuenta de servicio únicamente los permisos necesarios para acceder a las vistas del cubo pertinentes y a los datos asociados.
• Token de acceso personal (PAT): Genera un PAT utilizando las credenciales de la cuenta de servicio y almacena el token de forma segura inmediatamente después de su creación, ya que es posible que no se pueda recuperar posteriormente.
• Acceso a la red y al cortafuegos: Asegúrate de que las direcciones IP estáticas de Workiva figuren en la lista de direcciones permitidas para autorizar la comunicación HTTPS saliente (puerto 443) hacia el punto final de la API de OneStream.

Configurar la integración de la API

La integración de la API utiliza los puntos finales GetCubeView o GetAdoDataSetForCubeViewCommand para recuperar datos de Cube View desde OneStream.

Workiva Chains puede autenticarse en OneStream, ejecutar la solicitud de API, transformar los datos JSON devueltos y cargar el conjunto de datos resultante en tablas de Wdata para la elaboración de informes y el procesamiento posterior.

Pasos para la configuración de Workiva

1. Guarda el PAT de forma segura: Crea una variable de espacio de trabajo de « » (por ejemplo, onestream_api_pat) en Chain Builder y marca la variable como « » para cifrar el valor y evitar el acceso no autorizado.
2. Habilitar los conectores necesarios: Comprueba que el conector HTTP, el conector de transformación JSON y el conector de transformación tabular estén habilitados y correctamente configurados en el entorno de Workiva.
3. Crea la tabla Wdata de destino: Exporta una vista de cubo de ejemplo desde OneStream como archivo CSV y utilízala como plantilla para el esquema de la tabla Wdata de . Anota el ID de la tabla para utilizarlo en la configuración de la cadena.
4. Transformar y asignar datos: Convierte la respuesta JSON a un formato tabular si es necesario y, a continuación, asigna los nombres de los campos de OneStream a las columnas y tipos de datos correspondientes de la tabla de Workiva.
5. Configurar la automatización de la cadena: Configure el mecanismo de activación de la cadena para controlar cuándo se ejecuta; las opciones incluyen la ejecución según una programación definida , bajo demanda (ejecución manual), como un paso dentro de un flujo de trabajo de orquestación más amplio , o activada por una hoja de control .

Parámetros obligatorios de la API

Integración con SFTP

En una integración basada en SFTP, OneStream exporta archivos de datos (normalmente en formato CSV) a una ubicación SFTP intermedia mediante Smart Integration Connector. A continuación, Workiva Chains recupera los archivos mediante el conector SFTP de , procesa los datos y los carga en las tablas de Wdata.

Este enfoque se utiliza habitualmente en organizaciones en las que no se dispone de acceso directo a la API o en las que se prefiere no crear ni utilizar CubeViews.

Recursos adicionales

• Hojas de control
• Conector de transformación tabular
• Conector HTTP