Centro assistenza di Workiva

L'integrazione tra OneStream e Workiva di , disponibile all'indirizzo, consente alle organizzazioni di automatizzare l'estrazione, la trasformazione e la trasmissione dei dati da OneStream Cloud alla piattaforma Workiva. Questa integrazione può essere implementata utilizzando una connessione diretta basata sull'API tramite Workiva Chains e l'HTTP Connector, oppure un flusso di lavoro SFTP basato su file utilizzando l'OneStream Smart Integration Connector (SIC).

Entrambi i metodi di integrazione supportano l'inserimento dei dati in Workiva per i processi di reporting collegati a valle.

Integrazione API

Requisiti di connessione all'API

• Ambiente cloud OneStream: L'approccio di integrazione tramite API è supportato solo quando OneStream è ospitato in un ambiente cloud accessibile al pubblico.
• Account di servizio dedicato: Per motivi di sicurezza, controllo e stabilità operativa, creare all’interno di OneStream un account di servizio dedicato non interattivo, specificamente destinato all’integrazione.
• Autorizzazioni minime richieste: Assegnare all'account di servizio solo le autorizzazioni necessarie per accedere alle viste del cubo pertinenti e ai dati associati.
• Token di accesso personale (PAT): Generare un PAT utilizzando le credenziali dell'account di servizio e archiviare il token in modo sicuro subito dopo la creazione, poiché in seguito potrebbe non essere più recuperabile.
• Accesso alla rete e al firewall: Assicurarsi che gli indirizzi IP statici di Workiva siano inseriti nell'elenco delle eccezioni per consentire la comunicazione HTTPS in uscita (porta 443) verso l'endpoint API di OneStream.

Configurare l'integrazione API

L'integrazione API utilizza gli endpoint GetCubeView oppure GetAdoDataSetForCubeViewCommand per recuperare i dati della vista cubo da OneStream.

Workiva Chains è in grado di autenticarsi su OneStream, eseguire la richiesta API, trasformare il payload JSON restituito e caricare il set di dati risultante nelle tabelle Wdata per la creazione di report e l'elaborazione a valle.

Procedura di configurazione di Workiva

1. Conserva il PAT in modo sicuro: Crea una variabile dell'area di lavoro " " (ad esempio, onestream_api_pat) all'interno di Chain Builder e contrassegna la variabile come " Secret" per crittografarne il valore e impedirne la visualizzazione non autorizzata.
2. Abilitare i connettori necessari: Verificare che il connettore HTTP, il connettore di trasformazione JSON e il connettore di trasformazione tabulare siano abilitati e configurati correttamente nell'ambiente Workiva.
3. Creare la tabella Wdata di destinazione: Esportare una vista cubo di esempio da OneStream come file CSV e utilizzarla come modello per lo schema della tabella Wdata " ". Annotare l'ID della tabella per utilizzarlo nella configurazione della catena.
4. Trasformazione e mappatura dei dati: Se necessario, convertire la risposta JSON in formato tabellare, quindi mappare i nomi dei campi di OneStream alle corrispondenti colonne e ai tipi di dati della tabella di Workiva.
5. Configurazione di Chain Automation: Configurare il meccanismo di attivazione di Chain per controllare quando viene eseguita; le opzioni includono l'esecuzione secondo una pianificazione definita , su richiesta (esecuzione manuale), come fase all'interno di un flusso di lavoro di orchestrazione più ampio , oppure attivata da un foglio di controllo .

Parametri API obbligatori

Integrazione SFTP

In un'integrazione basata su SFTP, OneStream esporta i file di dati (in genere in formato CSV) in una posizione SFTP intermedia tramite Smart Integration Connector. Workiva Chains recupera quindi i file utilizzando il connettore SFTP di , elabora i dati e li carica nelle tabelle di Wdata.

Questo approccio viene comunemente utilizzato nelle organizzazioni in cui l'accesso diretto alle API non è disponibile o si preferisce non creare né utilizzare le CubeViews.

Risorse aggiuntive

• Schede di controllo
• Connettore Trasformazione tabellare
• Connettore HTTP