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 dedicato all'integrazione di Workiva con un grant OAuth2.

  Nota: Questo utente dell'integrazione richiede le autorizzazioni appropriate per i comandi che il connettore esegue, come ad esempio Proprietario dei fogli di calcolo o dell'area di lavoro con cui interagisce.

• ID e segreto di concessione OAuth2 dell'utente dell'integrazione.
• Per eseguire la catena in un ambiente di prova, gli URL da sovrascrivere agli host e ai percorsi di base dell'API.

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, clicca su Connections compare_arrows, e poi Create 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 Resources, selezionare le risorse da associare a questa connessione.
   Questa sezione fornisce una posizione sicura per tutti i file (script, token di sicurezza, certificati, ecc.) di cui il connettore ha bisogno per funzionare, ad esempio per l'autenticazione o i requisiti ambientali. Quando si salva la connessione, questi file vengono automaticamente crittografati AES-256. Per ulteriori informazioni, consultare la pagina di supporto per l'architettura di sicurezza di Workiva Chain Builder.

   Vantaggi:

   • Archiviazione sicura: Poiché questi file vengono crittografati al momento del salvataggio e memorizzati a livello di connessione, sono ideali per i dati di configurazione sensibili o statici che non dovrebbero essere codificati nella catena stessa.
   • Portabilità: Se si sposta la catena da un'area di lavoro "Test" a un'area di lavoro "Produzione", le risorse rimangono legate alle impostazioni di Connessione, il che significa che non è necessario riscrivere i percorsi dei file nei nodi della catena.
   • Accessibilità: La memorizzazione dei file in questo punto rende i file disponibili al runner (l'agente che esegue l'attività) senza che il file debba essere collocato manualmente sul computer host fisico del runner.

   Svantaggi:

   • Poiché sono criptati, non possono essere modificati direttamente; è necessario cancellare 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'ospite 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 di Spreadsheets	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.
   Annullamento 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 dell'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 memorizzate con 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.

Sovrascritte 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 EU o APAC è necessario un override.

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

Risoluzione dei problemi

Se la connessione alla piattaforma Workiva fallisce:

• Verificare 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 si utilizza un host override, verificare che l'URL inserito per il connettore sia corretto.

• Verificare che l'ID del file di Workiva, ad esempio 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/.