Workiva-ondersteuningscentrum

Opmerking: Deze door Workiva ontwikkelde connector maakt het mogelijk om de Workiva- en Workday-platformen met elkaar te verbinden. Workiva Support helpt u graag bij het configureren van de connector in uw werkruimte. Eventuele fouten of problemen met het Workday-platform moeten echter worden opgelost door uw Workday-beheerder of diens ondersteuningsteam.

Met de Workday-connector kunt u -opdrachten in een keten gebruiken om met Workday® HR en Financials te communiceren en het volgende te doen:

• Download aangepaste rapporten van Workday
• Budgetgegevens importeren in Workday
• Start een Workday Enterprise Interface Builder (EIB)-integratie

Vereisten

Om de verbinding tot stand te brengen, heb je het volgende nodig:

• De Workday-tenant waarmee verbinding moet worden gemaakt.
• De host en het domein van de Workday-omgeving waarmee verbinding moet worden gemaakt.
• De authenticatiegegevens van een gebruiker van een integratiesysteem die in Workday is aangemaakt.

Stap 1: Verzamel de Workday-tenantgegevens

U kunt de tenant-, host- en domeininformatie achterhalen via het WSDL XML-bestand van de openbare Workday-webservice.

1. Voer 'Openbare webservices' in de zoekbalk van Workday in en selecteer dat rapport.
2. Zoek de webservice voor de specifieke integratie die u gebruikt.
   Voorbeelden zijn: Personeelsplanning voor Get Workers, Financieel beheer voor Import Budget, Integraties voor EIB-gerelateerde opdrachten, enz.
3. Klik op de knop "Gerelateerde acties" van die service en klik vervolgens op WSDL bekijken onder het menu "Webservice".
4. Zoek in het XML-bestand naar het element soapbind:address (dit bevindt zich meestal onderaan het bestand).
5. Gebruik de URL uit het location attribuut om de tenant-, host- en domeininformatie uit de URL te extraheren.
   De URL gebruikt het volgende formaat:
   https://{host}.{domein}/ccx/service/{tenant}/naam_van_de_openbare_webservice/versienummer

Voorbeeld

Met behulp van het bovenstaande formaat kunnen we de tenant, host en het domein vinden in een voorbeeld-WSDL-URL:
https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1

Je hebt deze waarden nodig bij het instellen van je connector in de volgende stap.

Stap 2: Workday-authenticatie configureren

Deze connector biedt twee manieren om te authenticeren: OAuth2 via API en gebruikersnaam en wachtwoord. 

OAuth2 API-authenticatie

Als u gebruikmaakt van OAuth2 API-authenticatie, moet u een API-client in Workday hebben ingesteld. Raadpleeg de Workday-ondersteuningspagina API-clients registreren voor instructies over het aanmaken van een API-client. 

Zorg er bij deze API-clientconfiguratie voor dat u het volgende hebt:

• Geselecteerd Bearer als het Toegangstokentype.
• De volgende selectievakjes zijn ingeschakeld (aangevinkt):
  • Niet-verlopende vernieuwingstokens
  • Inclusief Workday Owned Scope

Omleidings-URL's

Workiva biedt regiospecifieke Connection Override-URL's voor connectorconfiguraties. Gebruik de onderstaande tabel om de juiste URL voor uw locatie te selecteren.
Als u zich in Noord-, Midden- of Zuid-Amerika bevindt, gebruik dan de standaard-URL. Als u zich in de regio Azië-Pacific bevindt, gebruik dan de APAC-URL. Als u zich in EMEA bevindt, gebruik dan de EU-URL. 

OAuth2-eindpunten

Als u OAuth2 gebruikt om uw verbinding te verifiëren, heeft u de volgende eindpuntwaarden nodig. Deze worden weergegeven wanneer u de Workday API-client instelt op de pagina API-client bewerken in Workday.

TIP: Als u een bestaande API-clientinstantie gebruikt die een OAuth2-token en -geheim gebruikt, kunt u deze informatie bovenaan de Workday API bekijken -pagina zien.

Basisverificatie

Als u gebruikmaakt van Basisverificatie, raadpleeg dan de Workday-ondersteuningspaginaEen Integration System User (ISU)-account aanmaken in Workday voor instructies over het aanmaken van een Integration System User (ISU).

Stap 3: De Workday-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een Organisatiebeveiligingsbeheerder deze eerst inschakelen viaConfiguratie.

1. Klik in Chain Builderop Connectionscompare_arrowsen vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connectionde optie Workday Connector en de standaard CloudRunner.
   
3. Voer onder Basisinfoeen unieke naam en beschrijving in om de verbinding te identificeren.
   

4. Voer onder Eigenschappende verbindingsgegevens in.Als u OAuth2 gebruikt, moet u de waarden invoeren voor Workday REST-eindpunt, Workday OAuth2-token
   -eindpunt en Workday OAuth2 - autorisatie-eindpunt.
   Als u gebruikmaakt van Basisverificatie (gebruikersnaam + wachtwoord), laat deze velden dan leeg.

   

   Veld	Inhoud
   Huurder	De Workday-tenant waarmee verbinding moet worden gemaakt.
   Gastheer	De host van de Workday-omgeving waarmee verbinding moet worden gemaakt. In de URL van de omgeving vertegenwoordigen de tekens vóór de eigenschap Domain de host.
   Domein	Het domein van de Workday-omgeving waarmee verbinding moet worden gemaakt, zoals workday.com of myworkday.com.
   Workday REST-eindpunt	De door Workday verstrekte REST-eindpunt-URL. (Alleen bij gebruik van OAuth2-authenticatie.)
   Workday OAuth2-token-eindpunt	De door Workday verstrekte OAuth2-token-eindpunt-URL. (Alleen bij gebruik van OAuth2-authenticatie.)
   Workday OAuth2-autorisatie-eindpunt	De door Workday verstrekte OAuth2-eindpunt-URL. (Alleen indien OAuth2-authenticatie wordt gebruikt.)

Probleemoplossing

Als de verbinding met Workday mislukt:

• Controleer of de authenticatiegegevens van de gebruiker van het integratiesysteem correct zijn.
• Controleer of de gebruiker van het integratiesysteem de juiste machtigingen heeft om toegang te krijgen tot de functionele groepen en domeinen die gerelateerd zijn aan de opdrachten van de verbinding.
• Controleer of de juiste Workday-tenant, host en domein zijn ingevoerd voor de connector.
• Zorg er bij het uitvoeren van de opdracht Download aangepast rapport voor dat het rapporttype is ingesteld op Geavanceerd. Samengestelde rapporten zijn momenteel niet beschikbaar via de Workday API.