Workiva Chains-koblingen gir vanlige kommandoer for arbeidsområder, miljøer og kjeder. Dette inkluderer list- og get-kommandoer som brukes til å hente egenskaper, detaljer om kjedekjøringer, påloggingsaktivitetshendelser og mer.
For en fullstendig liste over kompatible kommandoer, se artikkelen Workiva Chains-kommandoer.
Krav
Før du bruker kontakten:
- En sikkerhetsadministrator for organisasjonen må aktivere Workiva Chains-koblingen via konfigurasjonsskjermen.
- For å kjøre kjeden i et testmiljø, trenger du URL-ene for å overstyre API-ets verter og basisstier.
- Du må opprette en dedikert integrasjonsbruker med en OAuth2-tillatelse i programvaren din.
- For å finne kjede-ID-ene dine, se denne artikkelen om å finne ID-er i Workiva.
Ytterligere krav for integrasjonsbrukeren
Selv om alle eiere av arbeidsområder har tilgang til kjeder som bruker koblingen, krever selve koblingen en dedikert integrasjonsbruker for å utføre kommandoene. Ved å bruke en dedikert integrasjonsbruker – i stedet for en samarbeidspartners brukerkonto – kan du spore koblingens aktivitet og begrense tilgangen til kun det den trenger for å utføre kommandoene sine.
Følgende kreves når du konfigurerer integrasjonsbrukeren:
- Du må kjenne integrasjonsbrukerens OAuth2-tildelings-ID og hemmelighet.
- Du må gi integrasjonsbrukeren nødvendige tillatelser for hver kommando koblingen skal utføre. De kan for eksempel være eieren av regnearket eller arbeidsområdet som koblingen samhandler med.
- Integrasjonsbrukeren må logge inn på Chain Builder før de kan utføre noen kommandoer. Dette er nødvendig for å opprette brukerkontoen.
Tilkoblingsoppsett
Slik konfigurerer du Workiva Chains-koblingen:
- Fra Kjedebyggerklikker du på Forbindelser i venstre sidefelt, og deretter på Opprett øverst til høyre.
- Under Connector Connectionvelger du Workiva Chains og standard CloudRunner.
- Under Grunnleggende informasjonskriver du inn et unikt navn og en beskrivelse for å identifisere koblingen.
-
Under Egenskaperskriver du inn tilkoblingsdetaljene:
Egenskap Detaljer Basis-URL Basis-URL-en; standardinnstillingen er https://h.app.wdesk.com/s/wdata/oc/api/ ID Skriv inn ID-en for integrasjonsbrukernes OAuth-tildeling. Hemmelig Skriv inn hemmeligheten for ID -egenskapen. IAM-vertsoverstyring For å overstyre URL-verten og basisbanen for IAM-endepunktene (Identify and Access Management), for eksempel for et testmiljø, skriver du inn URL-en som skal brukes i stedet. - Velg miljøene du vil bruke tilkoblingen i, og klikk på Lagre.
URL-overstyringer
Avhengig av regionen i produksjonsmiljøet ditt, kan det gjelde en overstyrings-URL.Du kan bekrefte dette ved å sammenligne med URL-en som ble brukt til å logge inn på Wdesk.Hvis URL-en inneholder .apac, .caeller .eu, kreves en overstyring.
Merk: Informasjon om den amerikanske regionen er oppført som referanse.
| Felt | Verdi |
|---|---|
| Overstyring av cerebral vert | https://h.app.wdesk.com/s/cerebral |
| Overstyring av regnearkvert | https://api.app.wdesk.com/spreadsheets/v1/ |
| IAM-vertsoverstyring | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Overstyring av administratorvert | https://api.app.wdesk.com/admin/v1 |
| Overstyring av grafdatabasevert | https://api.app.wdesk.com/graphdb/v1/ |
| Overstyring av plattform-API-vert | https://api.app.wdesk.com/platform/v1 |
| Felt | Verdi |
|---|---|
| Overstyring av cerebral vert | https://h.apac.wdesk.com/s/cerebral |
| Overstyring av regnearkvert | https://api.apac.wdesk.com/spreadsheets/v1/ |
| IAM-vertsoverstyring | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Overstyring av administratorvert | https://api.apac.wdesk.com/admin/v1 |
| Overstyring av grafdatabasevert | https://api.apac.wdesk.com/graphdb/v1/ |
| Overstyring av plattform-API-vert | https://api.apac.wdesk.com/platform/v1 |
| Felt | Verdi |
|---|---|
| Overstyring av cerebral vert | https://h.ca.wdesk.com/s/cerebral |
| Overstyring av regnearkvert | https://api.ca.wdesk.com/spreadsheets/v1/ |
| IAM-vertsoverstyring | https://api.ca.wdesk.com/iam/v1/oauth2/token |
| Overstyring av administratorvert | https://api.ca.wdesk.com/admin/v1 |
| Overstyring av grafdatabasevert | https://api.ca.wdesk.com/graphdb/v1/ |
| Overstyring av plattform-API-vert | https://api.ca.wdesk.com/platform/v1 |
| Felt | Verdi |
|---|---|
| Overstyring av cerebral vert | https://h.eu.wdesk.com/s/cerebral |
| Overstyring av regnearkvert | https://api.eu.wdesk.com/spreadsheets/v1/ |
| IAM-vertsoverstyring | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Overstyring av administratorvert | https://api.eu.wdesk.com/admin/v1 |
| Overstyring av grafdatabasevert | https://api.eu.wdesk.com/graphdb/v1/ |
| Overstyring av plattform-API-vert | https://api.eu.wdesk.com/platform/v1 |