Med Workiva Connector kan du använda kommandon i kedjor för att interagera med Workiva-plattformen, inklusive andra Wdata-funktioner, kalkylark och GraphDB. Med den här kontakten kan du t.ex:
- Skapa och hantera tabeller, frågor och vyer
- Lista en tabells dataset eller importfel
- Skapa och hantera kalkylark eller deras ark
- Hantera poster och rapporter
Krav
För att interagera med Workiva-plattformen använder anslutningen Workiva REST API:er. För att sätta upp kontakten behöver du:
-
En dedikerad Workiva-integrationsanvändare med ett OAuth2-tillstånd.
Obs: Den här integrationsanvändaren kräver lämpliga behörigheter för de kommandon som kopplingen utför, till exempel ägare av kalkylarken eller arbetsytan den interagerar med.
- Integrationsanvändarens OAuth2-beviljande-ID och hemlighet.
- För att köra kedjan i en testmiljö, ska URL:erna åsidosätta API:ets värdar och bassökvägar.
Obs: Arbetsytans ägare 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.
Konfigurera Workiva-anslutningen
- Från Kedjebyggareklickar du på Anslutningaroch sedan på Skapa längst upp till höger.
- Under Create Connection väljer du Workiva och standard CloudRunner.
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kontakten.
-
Under Resurserväljer du de resurser som ska associeras med den här anslutningen.
Det här avsnittet tillhandahåller en säker plats för alla filer (skript, säkerhetstokens, certifikat etc.) som anslutningsprogrammet behöver för att fungera, till exempel för autentisering eller miljökrav. När du sparar anslutningen krypteras dessa filer automatiskt med AES-256. För mer information, se supportsidan för säkerhetsarkitekturen för Workiva Chain Builder.Fördelar:
- Säker lagring: Eftersom dessa filer krypteras när de sparas och lagras på anslutningsnivå är de idealiska för känsliga eller statiska konfigurationsdata som inte bör hårdkodas in i själva kedjan.
- Portabilitet: Om du flyttar din kedja från en "Test"-arbetsyta till en "Produktions"-arbetsyta förblir resurserna knutna till anslutningsinställningarna, vilket innebär att du inte behöver skriva om filsökvägarna i dina kedjenoder.
- Tillgänglighet: Genom att lagra filerna här blir filerna tillgängliga för Runner (agenten som utför uppgiften) utan att filen behöver placeras manuellt på runnerns fysiska värddator.
Nackdelar:
- Eftersom de är krypterade kan de inte redigeras direkt; du måste ta bort filen och ladda upp den ändrade versionen.
-
Under Properties anger du information om anslutningen:
Egenskap Information ID Ange ID för integrationsanvändarnas OAuth beviljande. Hemlighet Ange hemligheten för fastigheten ID. Cerebral värdöverstyrning Om du vill åsidosätta URL-värden och bassökvägen för Wdata-slutpunkterna, t.ex. för en testmiljö, anger du den URL som ska användas i stället. Åsidosättande av värd för kalkylark Om du vill åsidosätta URL-värden och bassökvägen för slutpunkterna för Kalkylark, t.ex. för en testmiljö, anger du den URL som ska användas i stället. Å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. Åsidosättande av administratörsvärd Om du vill åsidosätta URL-värden och bassökvägen för Admin-slutpunkterna, t.ex. för en testmiljö, anger du den URL som ska användas i stället. Åsidosättande av GraphDB-värd Om du vill åsidosätta URL-värden och bassökvägen för GraphDB-slutpunkterna, t.ex. för en testmiljö, anger du den URL som ska användas istället. Åsidosättande av värd för plattforms-API Om du vill åsidosätta URL-värden och bassökvägen för Workiva-plattformens ändpunkter, t.ex. för en testmiljö, anger du den URL som ska användas i stället. Obs: Alla känsliga inloggningsuppgifter krypteras automatiskt och lagras med AES-256-kryptering.
- Välj de miljöer som ska använda anslutningen och klicka på Save.
- Testa anslutningen genom att skapa och köra en kedja med -anslutningens List Files kommando och kontrollera att den returnerar en giltig utdata.
Å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 |
Felsökning
Om anslutningen till Workiva-plattformen inte fungerar:
- Kontrollera att kopplingens OAuth-autentiseringsuppgifter är aktuella, korrekta och giltiga. OAuth-autentiseringsuppgifter har definierade utgångsdatum och certifikatet kan ha löpt ut. Om så är fallet måste du skapa ett nytt certifikat och ange den nya klienthemligheten i Connector.
- Se till att integrationsanvändaren har rätt behörighet för det kommando som utförs.
- Om du använder en värdöverstyrning, kontrollera att den angivna URL:en för anslutningen är korrekt.
-
Kontrollera att ID:t för Workiva-filen – till exempel tabellen, frågan eller kalkylbladet – som interageras med är korrekt.
Obs: En fils ID visas i dess URL när den öppnas i Workiva. Till exempel visas ett kalkylblads ID efter
spreadsheet/i dess URL; ett tabells ID visas eftertables/.