Workiva Chains Connector inneholder felles kommandoer for arbeidsområder, miljøer og kjeder. Dette inkluderer list- og get-kommandoer som brukes til å hente ut egenskaper, detaljer om kjedekjøringer, innloggingshendelser og mer.
For en fullstendig liste over kompatible kommandoer, se artikkelen Workiva Chains-kommandoer.
Krav
Før du bruker kontakten:
- En sikkerhetsadministrator i organisasjonen må aktivere Workiva Chains-kontakten via skjermbildet Konfigurasjoner.
- For å kjøre kjeden i et testmiljø trenger du URL-adressene for å overstyre API-ens hosts og base paths.
- Du må opprette en dedikert integrasjonsbruker med en OAuth2-bevilgning i programvaren din.
- For å finne kjede-ID-ene dine, se denne artikkelen på for å finne ID-er i Workiva.
Ytterligere krav til 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 connectorens aktivitet og begrense tilgangen til kun det den trenger for å utføre kommandoene sine.
Følgende er nødvendig når du konfigurerer integrasjonsbrukeren:
- Du må kjenne integrasjonsbrukerens OAuth2-godkjennings-ID og -hemmelighet.
- Du må gi integrasjonsbrukeren de riktige tillatelsene for hver kommando som koblingen skal utføre, for eksempel kan de være eier av regnearket eller arbeidsområdet som koblingen samhandler med.
- Integrasjonsbrukeren må logge seg på Chain Builder før han eller hun kan utføre kommandoer. Dette er nødvendig for å opprette brukerens konto.
Oppsett av tilkobling
Slik konfigurerer du Workiva Chains-kontakten:
- Fra Chain Builder klikker du på Connections, og deretter Create øverst til høyre.
- Under Connector Connection velger du Workiva Chains og standard CloudRunner.
- Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere kontakten.
- Under Properties angir du detaljer om tilkoblingen:
Egenskap Detaljer Base URL Base-URL; standardinnstilling er https://h.app.wdesk.com/s/wdata/oc/api/ ID Skriv inn ID-en for integrasjonsbrukernes OAuth-tildeling. Hemmelig Skriv inn hemmeligheten for egenskapen ID. Overstyring av IAM-vert Hvis du vil overstyre URL-vert og basebane for Identify and Access Management (IAM)-endepunktene, for eksempel for et testmiljø, skriver du inn URL-adressen som skal brukes i stedet. - Velg miljøene som skal bruke tilkoblingen, og klikk på Lagre.
URL-overstyringer
Avhengig av hvilken region produksjonsmiljøet ditt befinner seg i, kan en overstyrt URL gjelde. Du kan bekrefte dette ved å sammenligne med URL-en som brukes til å logge på Wdesk. Hvis URL-adressen inneholder EU eller APAC, er det nødvendig med en overstyring.
Merk: Informasjon om USAs regioner er oppført som referanse.
| Felt | Verdi |
|---|---|
| Cerebral vertsoverstyring | https://h.app.wdesk.com/s/cerebral |
| Overstyring av regnearkvert | https://api.app.wdesk.com/spreadsheets/v1/ |
| Overstyring av IAM-vert | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Overstyring av administratorvert | https://api.app.wdesk.com/admin/v1 |
| Overstyring av Graph DB-vert | https://api.app.wdesk.com/graphdb/v1/ |
| Overstyring av plattform-API-vert | https://api.app.wdesk.com/platform/v1 |
| Felt | Verdi |
|---|---|
| Cerebral vertsoverstyring | https://h.eu.wdesk.com/s/cerebral |
| Overstyring av regnearkvert | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Overstyring av IAM-vert | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Overstyring av administratorvert | https://api.eu.wdesk.com/admin/v1 |
| Overstyring av Graph DB-vert | https://api.eu.wdesk.com/graphdb/v1/ |
| Overstyring av plattform-API-vert | https://api.eu.wdesk.com/platform/v1 |
| Felt | Verdi |
|---|---|
| Cerebral vertsoverstyring | https://h.apac.wdesk.com/s/cerebral |
| Overstyring av regnearkvert | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Overstyring av IAM-vert | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Overstyring av administrasjonsvert | https://api.apac.wdesk.com/admin/v1 |
| Overstyring av Graph DB-vert | https://api.apac.wdesk.com/graphdb/v1/ |
| Overstyring av plattform-API-vert | https://api.apac.wdesk.com/platform/v1 |