Portail de support Workiva

Note : Ce connecteur développé par Workiva vous permet de connecter les plateformes Workiva et Workday. L’équipe d’assistance de Workiva est heureuse de vous aider à configurer le connecteur dans votre espace de travail. Cependant, toute erreur ou dépannage au sein de la plateforme Workday doit être géré par votre administrateur Workday ou son équipe de support.

Avec le connecteur Workday, vous pouvez utiliser les commandes et dans une chaîne pour interagir avec Workday® HR et Financials pour :

• Télécharger des rapports personnalisés à partir de Workday
• Importer les données budgétaires dans Workday
• Lancer une intégration Workday Enterprise Interface Builder (EIB)

Exigences

Pour établir la connexion, vous aurez besoin des éléments suivants :

• Le locataire Workday auquel se connecter.
• L'hôte et le domaine de l'environnement Workday auquel se connecter.
• Les identifiants d'authentification d'un utilisateur du système d'intégration créé dans Workday.

Étape 1 : Récupérer les informations relatives au tenant Workday

Vous pouvez déterminer les informations relatives au locataire, à l’hôte et au domaine à partir du fichier XML WSDL du service web public Workday .

1. Saisissez « Public Web Services » dans la barre de recherche Workday et sélectionnez ce rapport.
2. Recherchez le service Web correspondant à l’intégration particulière que vous utilisez.
   On peut citer, par exemple : la gestion des effectifs pour Get Workers, la gestion financière pour Import Budget, les intégrations pour les commandes liées à la BEI, etc.
3. Cliquez sur le bouton « Actions associées » de ce service, puis sur « View WSDL » ( ) dans le menu « Service Web ».
4. Dans le fichier XML, localisez l’élément soapbind :address (il se trouve généralement vers le bas du fichier).
5. À partir de l'URL fournie par l'attribut « » de l'emplacement, extrayez les informations relatives au tenant, à l'hôte et au domaine contenues dans cette URL.
   L'URL respecte le format suivant :
   https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number

Exemple

En utilisant le format ci-dessus, nous pouvons identifier le locataire, l'hébergeur et le domaine à partir d'un exemple d'URL WSDL :
https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1

Vous aurez besoin de ces valeurs lors de la configuration de votre connecteur à l'étape suivante.

Étape 2 : Configurer l'authentification Workday

Ce connecteur propose deux méthodes d'authentification : OAuth2 via l'API et identifiant + mot de passe. 

Authentification via l'API OAuth2

Si vous utilisez l'authentification via l'API OAuth2 d' , vous devez avoir configuré un client API dans Workday. Consultez la page d'assistance Workday Register API Clients pour obtenir des instructions sur la création d'un client API. 

Dans le cadre de la configuration de ce client API, assurez-vous de disposer des éléments suivants :

• A choisi « » comme entité porteuse (Bearer) et « » comme type de jeton d'accès (Access Token Type).
• Les cases à cocher suivantes ont été cochées :
  • Jetons de rafraîchissement sans date d'expiration
  • Inclure le périmètre géré par Workday

URL de redirection

Workiva propose des URL de remplacement de connexion spécifiques à chaque région pour les configurations des connecteurs.  Utilisez le tableau ci-dessous pour sélectionner l'URL correspondant à votre localisation.

Points de terminaison OAuth2

Si vous utilisez OAuth2 pour authentifier votre connexion, vous devrez disposer des valeurs de point de terminaison suivantes. Ces éléments s'afficheront lorsque vous configurerez le client API Workday sur la page « Modifier le client API » ( ) de Workday, accessible à l'adresse.

ASTUCE : Si vous utilisez une instance de client API existante qui utilise un jeton et un secret OAuth2, vous pouvez consulter ces informations en haut de la page « Workday View API » ( ) de l'API.

Authentification de base 

Si vous utilisez l'authentification de base d' , consultez la page d'assistance WorkdayCréer un compte d'utilisateur du système d'intégration (ISU) dans Workday pour obtenir des instructions sur la création d'un compte d'utilisateur du système d'intégration (ISU).

Étape 3 : Configurer le connecteur Workday

Remarque : Pour que le connecteur soit disponible dans les chaînes de votre organisation, un administrateur de sécurité de l'organisation doit d'abord l'activer à partir de Configuration.

1. Depuis , dans « Chain Builder » (), cliquez sur « » (Connections) () compare_arrows, puis sur « » (Créer) ( ) en haut à droite.
2. Sous « » (Configuration du connecteur), dans « Connection » (Connexion), sélectionnez « » (Connecteur Workday) et « CloudRunner » (par défaut).
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.
   

4. Sous Properties, entrez les détails de la connexion.
   Si vous utilisez OAuth2, vous devrez saisir les valeurs suivantes : (point de terminaison REST Workday), (point de terminaison des jetons OAuth2 Workday), et (point de terminaison d'autorisation OAuth2 Workday).
    Si vous utilisez l'authentification de base d' (nom d'utilisateur + mot de passe), laissez ces champs vides.

   

   Champ	Contenu
   Locataire	Le locataire Workday auquel se connecter.
   Hôte	L’hôte de l’environnement Workday auquel se connecter. Dans l'URL de l'environnement, les caractères situés avant la propriété « Domain » correspondent à l'hôte.
   Domaine	Le domaine de l'environnement Workday auquel se connecter, , par exemple workday.com, ou myworkday.com,.
   Point de terminaison REST de Workday	L'URL du point de terminaison REST fournie par Workday. (Uniquement en cas d'utilisation de l'authentification OAuth2.)
   Point de terminaison des jetons OAuth2 de Workday	L'URL du point de terminaison du jeton OAuth2 fournie par Workday. (Uniquement en cas d'utilisation de l'authentification OAuth2.)
   Point de terminaison d'autorisation OAuth2 de Workday	L'URL du point de terminaison OAuth2 fournie par Workday.  (Uniquement en cas d'utilisation de l'authentification OAuth2.)

Dépannage

Si la connexion à Workday échoue :

• Vérifiez que les informations d'authentification de l'utilisateur du système d'intégration sont correctes.
• Vérifiez que l'utilisateur du système d'intégration dispose des autorisations nécessaires pour accéder aux groupes fonctionnels et aux domaines liés aux commandes de la connexion.
• Vérifiez que le tenant, l'hôte et le domaine Workday corrects ont bien été saisis pour le connecteur.
• Lorsque vous exécutez la commande Download custom report, assurez-vous que le type de rapport est défini sur Advanced. Les rapports composites ne sont pas disponibles via l'API Workday pour le moment.