Workiva-ondersteuningscentrum

Voorheen bekend als Adaptive Insights, gebruikt de Workday Adaptive Planning connector opdrachten in een keten om gegevens of metadata te importeren of exporteren.

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of anderszins helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de verbinding mogelijk te maken, gebruikt de connector de Workday Adaptive Planning REST API. Om de connector in te stellen, hebt u het volgende nodig:

• Een integratiegebruiker die is ingesteld in Adaptive Planning en aan wie een rol met de juiste rechten is toegewezen om de opdrachten van de connector uit te voeren.
• De gebruikersnaam en het wachtwoord van de integratiegebruiker.
• Als de integratiegebruiker toegang heeft tot meerdere instanties van Adaptive Planning, welke instantiecode wordt dan gebruikt.

  Opmerking: Om de beschikbare instance-codes van de integratiegebruiker te bepalen, kunt u het Adaptive Planning exportInstances API endpoint gebruiken.

De Workday Adaptive Planning-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connections compare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection, Workday Adaptive Planning en de standaard CloudRunner.
   

Workiva biedt twee verificatiemethoden (Basic en JWT Bearer Grant (Workday Credentials)). U kunt degene die u wilt gebruiken selecteren onder Credentials in de verbindingsconfiguratie.

Authenticeren met basisverificatie

1. Voer onder Eigenschappen optioneel de instantiecode voor de instantie Adaptieve planning in.
2. Selecteer "Basic Credential" als verificatietype.
3. Voer de volgende waarden in:
   Gebruikersnaam: De gebruikersnaam van de integratiegebruiker die u met de connector wilt gebruiken.
   Wachtwoord: Het wachtwoord voor de gebruiker in het veld Gebruikersnaam.

Authenticeren met een JWT Bearer (Workday Credentials)

Deze verificatiemethode gebruikt Workday referenties om te verifiëren met Adaptive Planning, en vereist dat:

• SSO is ingeschakeld.
• De Workday tenant instellingen voor Adaptive Planning User Sign-on en Public API's zijn ingeschakeld.
• Er wordt een Publieke API ISU toegewezen tussen Workday en Adaptive Planning.

Raadpleeg de volgende Workday-documentatie voor specifieke details over deze instelling:

• SAML SSO instellen in Adaptive Planning voor gesynchroniseerde gebruikers
• Problemen oplossen: Gebruikerssynchronisatie met adaptieve planning

Als onderdeel van deze configuratie moet een x509 privésleutel worden geüpload naar het gedeelte Connection Resources van deze verbinding, en een publiek certificaat dat door deze sleutel is aangemaakt, moet worden geüpload naar Workday en worden geassocieerd met een API-client van het type 'JWT Bearer Grant'. Deze client moet op zijn beurt gekoppeld zijn aan de ISU die u gebruikt voor aanvragen bij Adaptive Planning, met gekoppelde referenties tussen de twee systemen.

Raadpleeg de volgende Workday documentatie voor specifieke details over deze setup: API-clients registreren.

Belangrijke details

Het ondersteunde formaat voor privésleutels is PKCS#8, en kan al dan niet met een wachtwoord beveiligd zijn. Een nieuwe sleutel kan worden aangemaakt met openssl met het volgende commando:

openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem -out cert.pem -days 3650

De Workday host, domein en tenant bepalen

Met behulp van het Workday REST API Endpoint dat onder API Client staat, identificeert u de host, het domein en de tenant, in het formaat https://{host}.{domain}/ccx/api/v1/{tenant}

Voorbeeld

https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany

Lager type referenties instellen in de Adaptive Planning-connector

1. Upload uw privésleutel naar het gedeelte Resources van de verbinding.
   
2. Selecteer het verificatietype "Bearer".
   
3. Voer de volgende informatie in:

   Eigendom	Details
   x509 privésleutel	Voer de naam van de geüploade privésleutel in, precies zoals weergegeven in de verbindingsbronnen.
   Wachtwoord	Voer het wachtwoord voor de privésleutel in. Laat dit veld leeg als uw sleutel niet met een wachtwoord beveiligd is.
   Klant-ID	Voer het Client ID van de JWT Bearer Grant API client in.
   Integratie Service Gebruiker	Voer de naam in van de Integratie Service Gebruiker (ISU) die aan de API-client is gekoppeld
   Gastheer	Voer de host van de Workday-omgeving in waarmee verbinding moet worden gemaakt. In de URL van de omgeving vertegenwoordigen de tekens voor de eigenschap Domein de host.
   Huurder	Voer de Workday tenant in waarmee u verbinding wilt maken.
   Domein	Voer het domein van de Workday-omgeving in waarmee u verbinding wilt maken, zoals workday.com of myworkday.com.

Nadat u de verificatie hebt ingesteld:

1. Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.
2. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de connector's Export Versions opdracht, en controleer of deze een geldige uitvoer oplevert.

Probleemoplossing

Als de verbinding met Workday Adaptive Planning mislukt:

• Controleer de verificatiegegevens van de integratiegebruiker.
• Zorg ervoor dat de rol van de integratiegebruiker de juiste rechten heeft voor de opdrachten die de connector uitvoert.
• Als de integratiegebruiker toegang heeft tot meerdere instanties van Adaptive Planning, controleer dan de instantiecode die is ingevoerd voor de connector.

Voor aanvullende informatie over het maken van Adaptive Planning API verzoeken met Workday referenties, zie deze Workday pagina: Adaptive Planning API-aanvragen doen met Workday Credentials.