Il connettore Workiva Chains fornisce comandi comuni per spazi di lavoro, ambienti e catene. Questo articolo include i comandi list e get utilizzati per recuperare le proprietà, i dettagli dell'esecuzione della catena, gli eventi dell'attività di login e altro ancora.
Per un elenco completo dei comandi compatibili, consulta l'articolo Workiva Chains commands.
Requisiti
Prima di utilizzare il connettore:
- Un amministratore della sicurezza dell'org deve abilitare il connettore Workiva Chains attraverso la schermata Configurazioni.
- Per eseguire la catena in un ambiente di prova, devi avere gli URL per sovrascrivere gli host e i percorsi di base dell'API.
- Devi creare un utente dedicato all'integrazione con una concessione OAuth2 all'interno del tuo software.
- Per trovare gli ID della tua catena, consulta l'articolo trovare gli ID in Workiva.
Requisiti aggiuntivi per l'utente di integrazione
Mentre tutti i proprietari degli spazi 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.
Per configurare l'utente di integrazione è necessario sapere quanto segue:
- Devi conoscere l'ID di concessione OAuth2 e il segreto dell'utente dell'integrazione.
- Devi fornire all'utente dell'integrazione le autorizzazioni appropriate per ogni comando che il connettore eseguirà; ad esempio, potrebbe essere il Proprietario del foglio di calcolo o dell'area di lavoro con cui il connettore interagisce.
- L'utente dell'integrazione deve accedere a Chain Builder prima di poter eseguire qualsiasi comando. Questa operazione è necessaria per stabilire l'account dell'utente.
Configurazione della connessione
Per impostare il connettore Workiva Chains:
- Da Builder catena, clicca su Connessioni e poi su Crea in alto a destra.
- Sotto Connettore Connessione, seleziona Workiva Chains e il CloudRunner predefinito.
- In Informazioni di base, inserisci un nome e una descrizione unici per identificare il connettore.
- In Proprietà, inserisci i dettagli della connessione:
Proprietà Dettagli URL di base L'URL di base; l'impostazione predefinita è https://h.app.wdesk.com/s/wdata/oc/api/ ID Inserisci l'ID per la concessione OAuth degli utenti dell'integrazione. Segreto Inserisci il segreto per la proprietà ID. Sovrascrittura dell'host IAM Per sovrascrivere l'host e il percorso di base dell'URL per gli endpoint di Identify and Access Management (IAM), ad esempio per un ambiente di test, inserisci l'URL da utilizzare. - Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
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.
| Campo | Valore |
|---|---|
| Override dell'ospite cerebrale | https://h.app.wdesk.com/s/cerebral |
| Sovrascrittura dell'host dei fogli di calcolo | https://api.app.wdesk.com/spreadsheets/v1/ |
| Sovrascrittura dell'host IAM | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Sovrascrittura dell'host amministratore | https://api.app.wdesk.com/admin/v1 |
| Sovrascrittura dell'host del DB grafico | https://api.app.wdesk.com/graphdb/v1/ |
| Sovrascrittura dell'host API della piattaforma | https://api.app.wdesk.com/platform/v1 |
| Campo | Valore |
|---|---|
| Override dell'ospite cerebrale | https://h.eu.wdesk.com/s/cerebral |
| Sovrascrittura dell'host dei fogli di calcolo | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Sovrascrittura dell'host IAM | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Sovrascrittura dell'host amministratore | https://api.eu.wdesk.com/admin/v1 |
| Sovrascrittura dell'host del DB grafico | https://api.eu.wdesk.com/graphdb/v1/ |
| Sovrascrittura dell'host API della piattaforma | https://api.eu.wdesk.com/platform/v1 |
| Campo | Valore |
|---|---|
| Override dell'host cerebrale | https://h.apac.wdesk.com/s/cerebral |
| Sovrascrittura dell'host dei fogli di calcolo | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Sovrascrittura dell'host IAM | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Sovrascrittura dell'host amministratore | https://api.apac.wdesk.com/admin/v1 |
| Sovrascrittura dell'host del DB grafico | https://api.apac.wdesk.com/graphdb/v1/ |
| Sovrascrittura dell'host API della piattaforma | https://api.apac.wdesk.com/platform/v1 |