De Workiva Chains-connector biedt algemene commando's voor werkruimtes, omgevingen en ketens. Dit omvat lijst- en ophaalopdrachten die worden gebruikt voor het ophalen van eigenschappen, details van ketenuitvoeringen, gebeurtenissen met betrekking tot inlogactiviteiten en meer.
Voor een volledige lijst met compatibele commando's, zie het artikel Workiva Chains-commando's.
Vereisten
Voordat u de connector gebruikt:
- Een beveiligingsbeheerder van de organisatie moet de Workiva Chains - connector inschakelen via het configuratiescherm.
- Om de keten in een testomgeving uit te voeren, heb je de URL's nodig om de hosts en basispaden van de API te overschrijven.
- U moet een speciale integratiegebruiker aanmaken met een OAuth2-machtiging binnen uw software.
- Om uw keten-ID's te vinden, bekijk dit artikel over het vinden van ID's inWorkiva .
Aanvullende vereisten voor de integratiegebruiker
Hoewel alle eigenaren van werkruimtes toegang hebben tot ketens die de connector gebruiken, vereist de connector zelf een speciale integratiegebruiker om de bijbehorende opdrachten uit te voeren. Door een speciale integratiegebruiker te gebruiken – in plaats van het gebruikersaccount van een medewerker – kunt u de activiteit van de connector volgen en de toegang beperken tot alleen datgene wat nodig is om de opdrachten uit te voeren.
Bij het instellen van de integratiegebruiker zijn de volgende gegevens vereist:
- U moet de OAuth2-grant-ID en het geheim van de integratiegebruiker kennen.
- U moet de integratiegebruiker de juiste machtigingen geven voor elke opdracht die de connector uitvoert; deze gebruiker kan bijvoorbeeld de eigenaar zijn van het spreadsheet of de werkruimte waarmee de connector communiceert.
- De gebruiker die de integratie uitvoert, moet zich aanmelden bij Chain Builder voordat hij of zij opdrachten kan uitvoeren. Dit is nodig om het gebruikersaccount aan te maken.
Verbindingsinstellingen
Om de Workiva Chains-connector te installeren:
- Klik in Chain Builderop Connections in de linkerzijbalk en vervolgens op Create rechtsboven.
- Selecteer onder Connector Connectionde optie Workiva Chains en de standaard CloudRunner.
- Voer onder Basisinfoeen unieke naam en beschrijving in om de connector te identificeren.
-
Onder Eigenschappenkunt u de verbindingsgegevens invoeren:
Eigendom Details Basis-URL De basis-URL; deze is standaard ingesteld op https://h.app.wdesk.com/s/wdata/oc/api/ id Voer de ID in voor de OAuth-toekenning van de integratiegebruikers. Geheim Voer het geheim in voor de ID eigenschap. IAM-hostoverride Om de URL-host en het basispad voor de Identity and Access Management ( IAM )-eindpunten te overschrijven, bijvoorbeeld voor een testomgeving, voert u de te gebruiken URL in. - Selecteer de omgevingen die u voor de verbinding wilt gebruiken en klik op Opslaan.
URL-overrides
Afhankelijk van de regio van uw productieomgeving kan een afwijkende URL van toepassing zijn.Je kunt dit controleren door de URL te vergelijken die je gebruikt om in te loggen bij Wdesk.Als de URL .apac, .caof .eubevat, is een uitzondering vereist.
Opmerking: Informatie over de VS-regio wordt ter referentie weergegeven.
| Veld | Waarde |
|---|---|
| Cerebrale Host Override | h.app.wdesk.com/s/cerebral |
| Host voor spreadsheets overschrijven | https://api.app.wdesk.com/spreadsheets/v1/ |
| IAM-hostoverride | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Beheerder Host Override | https://api.app.wdesk.com/admin/v1 |
| Overschrijving van de host van de grafische database | https://api.app.wdesk.com/graphdb/v1/ |
| Platform-API-host overschrijven | https://api.app.wdesk.com/platform/v1 |
| Veld | Waarde |
|---|---|
| Cerebrale Host Override | h.apac.wdesk.com/s/cerebral |
| Host voor spreadsheets overschrijven | https://api.apac.wdesk.com/spreadsheets/v1/ |
| IAM-hostoverride | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Beheerder Host Override | https://api.apac.wdesk.com/admin/v1 |
| Overschrijving van de host van de grafische database | https://api.apac.wdesk.com/graphdb/v1/ |
| Platform-API-host overschrijven | https://api.apac.wdesk.com/platform/v1 |
| Veld | Waarde |
|---|---|
| Cerebrale Host Override | h.ca.wdesk.com/s/cerebral |
| Host voor spreadsheets overschrijven | https://api.ca.wdesk.com/spreadsheets/v1/ |
| IAM-hostoverride | https://api.ca.wdesk.com/iam/v1/oauth2/token |
| Beheerder Host Override | https://api.ca.wdesk.com/admin/v1 |
| Overschrijving van de host van de grafische database | https://api.ca.wdesk.com/graphdb/v1/ |
| Platform-API-host overschrijven | https://api.ca.wdesk.com/platform/v1 |
| Veld | Waarde |
|---|---|
| Cerebrale Host Override | h.eu.wdesk.com/s/cerebral |
| Host voor spreadsheets overschrijven | https://api.eu.wdesk.com/spreadsheets/v1/ |
| IAM-hostoverride | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Beheerder Host Override | https://api.eu.wdesk.com/admin/v1 |
| Overschrijving van de host van de grafische database | https://api.eu.wdesk.com/graphdb/v1/ |
| Platform-API-host overschrijven | https://api.eu.wdesk.com/platform/v1 |