Centro assistenza di Workiva

Con il connettore Workiva, puoi utilizzare i comandi in catene per interagire con la piattaforma Workiva, comprese altre funzioni di Wdata, Spreadsheets e GraphDB. Ad esempio, con questo connettore puoi:

• Creare e gestire tabelle, query e viste
• Elencare i dataset o gli errori di importazione di una tabella
• Creare e gestire fogli di calcolo o loro schede
• Gestire record e report

Requisiti

Per interagire con la piattaforma Workiva, il connettore utilizza le API REST di Workiva. Per configurare il connettore, avrai bisogno di:

• Un utente di integrazione Workiva dedicato con una concessione OAuth2.

  Nota: questo utente di integrazione richiede i permessi appropriati per i comandi eseguiti dal connettore, come Owner dei fogli di calcolo o dello spazio di lavoro con cui interagisce.

• L'ID della concessione OAuth2 dell'utente di integrazione e il segreto.
• Per eseguire la catena in un ambiente di test, gli URL per sovrascrivere gli host dell'API e i percorsi di base.

Nota: Mentre i proprietari dell'area di lavoro possono accedere alle catene che utilizzano il connettore, il connettore stesso richiede un utente di integrazione dedicato per eseguire i suoi comandi. L'utilizzo di un utente dedicato all'integrazione, invece dell'account utente di un collaboratore, ti permette di monitorare l'attività del connettore e di limitarne l'accesso solo a ciò che serve per eseguire i suoi comandi.

Imposta il connettore Workiva

1. Da Chain Builder, fai clic su compare_arrows Connessioni nella barra laterale sinistra, quindi compare_arrows Crea in alto a destra.
2. In Crea connessione, seleziona Workiva e il CloudRunner predefinito.
   
3. In Informazioni di base, inserisci un nome e una descrizione unici per identificare il connettore.

4. In Risorse, seleziona le risorse da associare a questa connessione.
   Questa sezione fornisce una posizione sicura per qualsiasi file (script, token di sicurezza, certificati, ecc.) di cui il connettore ha bisogno per funzionare, come per l'autenticazione o i requisiti di ambiente. Quando salvi la connessione, questi file vengono automaticamente crittografati con AES-256. Per ulteriori informazioni, fai riferimento alla pagina di supporto Architettura di sicurezza di Workiva Chain Builder.

   Vantaggi:

   • Archiviazione sicura: poiché questi file vengono crittografati al momento del salvataggio e archiviati a livello di connessione, sono ideali per dati di configurazione sensibili o statici che non dovrebbero essere codificati nella catena stessa.
   • Portabilità: se sposti la catena da uno spazio di lavoro "Test" a uno spazio di lavoro "Production", le risorse rimangono legate alle impostazioni della Connessione, il che significa che non devi riscrivere i percorsi dei file nei nodi della tua catena.
   • Accessibilità: archiviare i file qui li rende disponibili al Runner (l'agente che esegue l'attività) senza richiedere che il file venga inserito manualmente sulla macchina host fisica del runner.

   Svantaggi:

   • Poiché sono crittografati, non possono essere modificati direttamente; devi eliminare il file e caricare la versione modificata.

5. In Proprietà, inserisci i dettagli della connessione:
   

   Proprietà	Informazioni
   ID	Inserisci l'ID per la concessione OAuth degli utenti dell'integrazione.
   Segreto	Inserisci il segreto per la proprietà ID.
   Override dell'host cerebrale	Per sovrascrivere l'host e il percorso di base dell'URL per gli endpoint Wdata, ad esempio per un ambiente di test, inserisci l'URL da utilizzare al suo posto.
   Sovrascrittura dell'host dei fogli di calcolo	Per ignorare l'host e il percorso di base dell'URL per gli endpoint di Spreadsheets, ad esempio per un ambiente di test, inserisci l'URL da utilizzare.
   Sovrascrittura dell'host IAM	Per ignorare l'host dell'URL e il percorso di base per gli endpoint di Identify and Access Management (IAM), ad esempio per un ambiente di test, inserisci l'URL da utilizzare.
   Sovrascrittura dell'host amministratore	Per ignorare l'host e il percorso di base dell'URL degli endpoint di amministrazione, ad esempio per un ambiente di test, inserisci l'URL da utilizzare al suo posto.
   Sovrascrittura dell'host di GraphDB	Per ignorare l'host e il percorso di base dell'URL per gli endpoint di GraphDB, ad esempio per un ambiente di test, inserisci l'URL da utilizzare.
   Sovrascrittura dell'host API della piattaforma	Per ignorare l'host dell'URL e il percorso di base per gli endpoint della piattaforma Workiva, ad esempio per un ambiente di prova, inserisci l'URL da utilizzare.

   Nota: tutte le credenziali sensibili vengono automaticamente crittografate e archiviate usando la crittografia AES-256.

6. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
7. Per testare la connessione, crea ed esegui una catena con il comando List Files del connettore e verifica che restituisca un output valido.

Sovrascritture URL

A seconda della regione in cui si trova l'ambiente di produzione, potrebbe essere applicato un URL di esclusione. Puoi verificarlo confrontando l'URL utilizzato per accedere a Wdesk. Se l'URL contiene .apac, .ca, o .eu, è necessaria una sovrascrittura.

Nota: le informazioni sulla regione USA di sono elencate come riferimento.

Risoluzione dei problemi

Se la connessione alla piattaforma Workiva fallisce:

• Verifica che le credenziali OAuth dell'applicazione del connettore siano presenti, corrette e valide. Le credenziali OAuth hanno date di scadenza definite e il certificato potrebbe essere scaduto. In questo caso, dovrai creare un nuovo certificato e inserire il nuovo segreto del cliente nel Connector. 
• Assicurati che l'utente dell'integrazione abbia i permessi appropriati per il comando da eseguire.
• Se usi una sovrascrittura dell'host, controlla che l'URL inserito per il connettore sia corretto.

• Verifica che l'ID del file Workiva — come la tabella, la query o il foglio di calcolo — con cui si interagisce sia corretto.

  Nota: L'ID di un file appare nel suo URL quando viene aperto in Workiva. Ad esempio, l'ID di un foglio elettronico appare dopo spreadsheet/ nel suo URL; l'ID di una tabella appare dopo tables/.