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 informations d'authentification d'un utilisateur du système d'intégration créé dans Workday.

Étape 1 : Obtenir les informations sur le locataire 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.
   Voici quelques exemples : Dotation en personnel pour l'obtention de travailleurs, gestion financière pour le budget d'importation, intégrations pour les commandes liées à la BEI,....
3. Cliquez sur le bouton "Related Actions" de ce service, puis sur View WSDL dans le menu "Web Service".
4. Dans le fichier XML, localisez l’élément soapbind :address (il se trouve généralement vers le bas du fichier).
5. En utilisant l'URL de l'attribut location, extrayez les informations relatives au locataire, à l'hôte et au domaine de l'URL.
   L'URL utilise le format suivant :
   https://{host}.{domaine}/ccx/service/{tenant}/nom_du_service_web_public/numéro_de_version

Exemple

En utilisant le format ci-dessus, nous pouvons trouver le locataire, l'hôte 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 offre deux façons de s'authentifier : OAuth2 via API, et Utilisateur+Mot de passe. 

Authentification de l'API par OAuth2

Si vous utilisez OAuth2 API authentication, vous devez avoir un client API configuré dans Workday. Reportez-vous à la page du support Workday Register API Clients pour obtenir des instructions sur la création d'un client API. 

Dans le cadre de la configuration du client de l'API, assurez-vous que vous avez :

• Sélectionné Bearer comme type de jeton d'accès .
• Les cases à cocher suivantes sont activées (marquées) :
  • Jetons de rafraîchissement non expirés
  • Inclure le champ d'application de Workday

URL de redirection

Workiva dispose d'URL de remplacement de connexion spécifiques à chaque région pour les configurations de connecteur. Utilisez le tableau suivant pour sélectionner l'URL correspondant à votre situation géographique.
Si vous vous trouvez en Amérique du Nord, centrale ou du Sud, utilisez l'URL par défaut. Si vous vous trouvez dans la région Asie-Pacifique, utilisez l'URL APAC. Si vous êtes dans la zone EMEA, utilisez l'URL de l'UE. 

Points de terminaison OAuth2

Si vous utilisez OAuth2 pour vérifier votre connexion, vous devez avoir les valeurs de point de terminaison suivantes. Ils seront répertoriés lorsque vous configurerez le client API Workday sur la page Edit API Client dans Workday.

CONSEIL : Si vous utilisez une instance de client API existante qui utilise un jeton et un secret OAuth2, vous pouvez voir ces informations en haut de la page Workday View API.

Authentification de base

Si vous utilisez Basic Authentication, reportez-vous à la page du support Workday Create an Integration System User (ISU) account in Workday pour obtenir des instructions sur la création d'un Integration System User (ISU).

Étape 3 : Configurer le connecteur Workday

Note : Pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un administrateur de la sécurité de l'organisation doit d'abord l'activer à partir de Configuration.

1. À partir de Chain Builder, cliquez sur Connectionscompare_arrows, puis sur Create en haut à droite.
2. Sous Connector Connection, sélectionnez Workday Connector et le 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 pour Workday REST Endpoint, Workday OAuth2 Token Endpoint, et Workday OAuth2 Authorization Endpoint.
   Si vous utilisez Basic Authentication (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 précédant la propriété Domain représentent l'hôte.
   Domaine	Le domaine de l'environnement Workday auquel se connecter, tel que workday.com ou myworkday.com.
   Point de terminaison REST du jour ouvrable	L'URL du point de terminaison REST fourni par Workday. (Uniquement si vous utilisez l'authentification OAuth2)
   Point de terminaison du jeton OAuth2 de Workday	L'URL du point de terminaison du jeton OAuth2 fourni par Workday. (Uniquement si vous utilisez l'authentification OAuth2)
   Point final d'autorisation OAuth2 pour Workday	L'URL du point de terminaison OAuth2 fourni par Workday. (Uniquement si vous utilisez 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 locataire, l'hôte et le domaine de Workday sont correctement 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 encore disponibles via l'API Workday.