Workiva-ondersteuningscentrum

De Workiva Chains connector biedt algemene opdrachten voor workspaces, omgevingen en ketens. Dit omvat list en get commando's die gebruikt worden voor het ophalen van eigenschappen, details van chain runs, aanmeldingsactiviteitgebeurtenissen en meer. 

Voor een volledige lijst van compatibele commando's, zie het artikel Workiva Chains commando's.

Vereisten

Voordat u de connector gebruikt:

• Een org security administrator moet de Workiva Chains connector inschakelen via het Configuratiescherm.
• Om de keten in een testomgeving uit te voeren, hebt u de URL's nodig om de hosts en basispaden van de API te overschrijven.
• U moet een speciale integratiegebruiker met en een OAuth2-toelage binnen uw software aanmaken.
• Bekijk dit artikel op om uw keten-ID's te vinden in Workiva.

Extra vereisten voor de integratiegebruiker

Hoewel alle workspace-eigenaars toegang hebben tot ketens die de connector gebruiken, vereist de connector zelf een speciale integratiegebruiker om zijn opdrachten uit te voeren. Door een speciale integratiegebruiker te gebruiken - in plaats van een gebruikersaccount van een medewerker - kunt u de activiteiten van de connector volgen en de toegang beperken tot wat hij nodig heeft om zijn opdrachten uit te voeren.

Het volgende is vereist bij het instellen van de integratiegebruiker:

• U moet de OAuth2 grant ID en secret van de integratiegebruiker kennen.
• U moet de integratiegebruiker de juiste machtigingen geven voor elke opdracht die de connector zal uitvoeren; zij kunnen bijvoorbeeld de eigenaar zijn van de spreadsheet of werkruimte waarmee de connector interageert.
• De integratiegebruiker moet inloggen in Chain Builder voordat hij commando's kan uitvoeren. Dit is nodig om de account van de gebruiker aan te maken.

Verbindingsinstelling

Om de Workiva Chains connector in te stellen:

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection, Workiva Chains en de standaard CloudRunner.
3. Voer onder Basisinfo een unieke naam en beschrijving in om de connector te helpen identificeren.
4. Onder Eigenschappen, voert u de details van de verbinding in:
   

   Eigendom	Details
   Basis URL	De basis URL; staat standaard op https://h.app.wdesk.com/s/wdata/oc/api/
   id	Voer de ID voor de OAuth-subsidie van de integratiegebruikers in.
   Geheim	Voer het geheim in voor de eigenschap ID.
   IAM host opheffen	Om de URL-host en het basispad voor van de Identify and Access Management (IAM) eindpunten op te heffen, zoals voor een testomgeving, voert u de URL in die u in plaats daarvan wilt gebruiken.

5. Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.

URL overschrijven

Afhankelijk van de regio van uw productieomgeving kan een URL van toepassing zijn. U kunt dit controleren door een vergelijking te maken met de URL die gebruikt wordt om in Wdesk in te loggen. Als de URL EU of APAC bevat, is een overschrijven vereist.

Opmerking: regio-informatie voor de VS wordt ter referentie vermeld.