Workiva Chains-anslutningen innehåller gemensamma kommandon för arbetsytor, miljöer och kedjor. Detta inkluderar list- och get-kommandon som används för att hämta egenskaper, detaljer om kedjekörningar, inloggningsaktivitetshändelser med mera.
För en fullständig lista över kompatibla kommandon, se Workiva Chains-kommandon artikel.
Krav
Innan du använder kontakten:
- En säkerhetsadministratör för org måste aktivera Workiva Chains-anslutningen via skärmen Konfigurationer.
- Om du vill köra kedjan i en testmiljö behöver du URL:erna för att åsidosätta API:ets värdar och bassökvägar.
- Du måste skapa en dedikerad integrationsanvändare med ett OAuth2 beviljande i din programvara.
- För att hitta dina kedje-ID:n, se den här artikeln om hitta ID:n i Workiva.
Ytterligare krav för integrationsanvändaren
Alla ägare av arbetsytor har åtkomst till kedjor som använder connectorn, men själva connectorn kräver en dedikerad integrationsanvändare för att utföra sina kommandon. Genom att använda en dedikerad integrationsanvändare - istället för en medarbetares användarkonto - kan du spåra connectorens aktivitet och begränsa dess åtkomst till endast det den behöver för att utföra sina kommandon.
Följande krävs när du konfigurerar integrationsanvändaren:
- Du måste känna till integrationsanvändarens OAuth2 ID för beviljande och hemlighet.
- Du måste ge integrationsanvändaren rätt behörighet för varje kommando som connectorn ska utföra
- Integrationsanvändaren måste logga in på Chain Builder innan han eller hon kan utföra några kommandon. Detta är nödvändigt för att skapa användarkontot.
Inställning av anslutning
Så här konfigurerar du Workiva Chains-anslutningen:
- Från Chain Builder, klicka på Connections , och sedan Create längst upp till höger.
- Under Connector Connection väljer du Workiva Chains och standard CloudRunner.
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kontakten.
- Under Properties anger du information om anslutningen:
Fastighet Detaljer Bas URL Den grundläggande URL:en ID Ange ID för integrationsanvändarnas OAuth beviljande. Hemlighet Ange hemligheten för fastigheten ID. Åsidosättande av IAM-värd Om du vill åsidosätta URL-värden och bassökvägen för IAM-slutpunkterna (Identify and Access Management), t.ex. för en testmiljö, anger du den URL som ska användas i stället. - Välj de miljöer som ska använda anslutningen och klicka på Save.
Åsidosättande av URL
Beroende på vilken region din produktionsmiljö tillhör kan en annan URL gälla. Du kan verifiera detta genom att jämföra med den URL som används för att logga in på Wdesk. Om URL:en innehåller EU eller APAC krävs en åsidosättning.
Obs: Information om USA-regionen anges som referens.
| Fält | Värde |
|---|---|
| Cerebral Host Override | https://h.app.wdesk.com/s/cerebral |
| Åsidosättande av värd för kalkylark | https://api.app.wdesk.com/spreadsheets/v1/ |
| Åsidosättande av IAM-värd | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Åsidosättande av administratörsvärd | https://api.app.wdesk.com/admin/v1 |
| Åsidosättande av Graph DB-värd | https://api.app.wdesk.com/graphdb/v1/ |
| Åsidosättande av värd för plattforms-API | https://api.app.wdesk.com/platform/v1 |
| Fält | Värde |
|---|---|
| Cerebral Host Override | https://h.eu.wdesk.com/s/cerebral |
| Åsidosättande av värd för kalkylark | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Åsidosättande av IAM-värd | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Åsidosättande av administratörsvärd | https://api.eu.wdesk.com/admin/v1 |
| Åsidosättande av Graph DB-värd | https://api.eu.wdesk.com/graphdb/v1/ |
| Åsidosättande av värd för plattforms-API | https://api.eu.wdesk.com/platform/v1 |
| Fält | Värde |
|---|---|
| Cerebral Host Override | https://h.apac.wdesk.com/s/cerebral |
| Åsidosättande av värd för kalkylark | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Åsidosättande av IAM-värd | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Åsidosättande av administratörsvärd | https://api.apac.wdesk.com/admin/v1 |
| Åsidosättande av Graph DB-värd | https://api.apac.wdesk.com/graphdb/v1/ |
| Åsidosättande av värd för plattforms-API | https://api.apac.wdesk.com/platform/v1 |