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 con Workiva con e un'autorizzazione OAuth2.

  Nota: Questo utente di integrazione deve disporre delle autorizzazioni necessarie per i comandi eseguiti dal connettore, come ad esempio il ruolo di proprietario dei fogli di calcolo o dell'area di lavoro con cui interagisce.

• L'ID di autorizzazione OAuth2 e il segreto dell'utente di integrazione.
• Per eseguire la catena in un ambiente di test, gli URL da utilizzare per sovrascrivere gli host e i 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 compare_arrows Connections nella barra laterale sinistra, quindi su compare_arrows 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. Nella sezione "Risorse" ( ), selezionare le risorse da associare a questa connessione.
   Questa sezione offre uno spazio sicuro in cui archiviare tutti i file (script, token di sicurezza, certificati, ecc.) necessari al funzionamento del connettore, ad esempio per l'autenticazione o per soddisfare i requisiti ambientali. Quando si salva la connessione, questi file vengono automaticamente crittografati con AES-256. Per ulteriori informazioni, consultare la pagina di supporto dedicata all’architettura di sicurezza di Workiva Chain Builder all’indirizzo .

   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 hardcoded nella blockchain stessa.
   • Portabilità: Se si sposta la catena da un'area di lavoro "Test" a un'area di lavoro "Produzione", le risorse rimangono associate alle impostazioni di connessione, il che significa che non è necessario riscrivere i percorsi dei file nei nodi della catena.
   • Accessibilità: Salvando i file qui, questi risultano disponibili per il Runner di (l'agente che esegue l'attività) senza che sia necessario copiarli manualmente sulla macchina fisica del runner.

   Svantaggi:

   • Poiché sono crittografati, non è possibile modificarli direttamente; è necessario 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'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.
   Sostituzione 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 archiviate utilizzando 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, è 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'impostazione personalizzata per l'host, verificare che l'URL inserito per il connettore sia corretto.

• Verificare che l'ID del file Workiva —ad esempio la tabella, la query o il foglio di calcolo— con cui si sta interagendo 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/.