Portail de support Workiva

Anciennement connu sous le nom d'Adaptive Insights, le connecteur Workday Adaptive Planning utilise les commandes dans une chaîne pour importer ou exporter des données ou des métadonnées.

Note : Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Exigences

Pour activer la connexion, le connecteur utilise l'API REST de Workday Adaptive Planning. Pour configurer le connecteur, vous aurez besoin de :

• Un utilisateur d'intégration configuré dans Adaptive Planning qui s'est vu attribuer un rôle avec les permissions appropriées pour exécuter les commandes du connecteur.
• Le nom d'utilisateur et le mot de passe de l'utilisateur d'intégration.
• Si l'utilisateur de l'intégration peut accéder à plusieurs instances de Adaptive Planning, le code d'instance auquel il se connectera.

  Remarque : Pour déterminer les codes d'instance disponibles de l'utilisateur d'intégration, vous pouvez utiliser le point de terminaison de l'API Adaptive Planning exportInstances.

Configurer le connecteur Workday Adaptive Planning

Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.

1. À partir du Générateur de chaînes, cliquez sur Connexions   compare_arrows, puis sur Créer en haut à droite.
2. Sous Connector Connection, sélectionnez Workday Adaptive Planning et le CloudRunner par défaut.
   

Workiva propose deux méthodes d’authentification (Basic et JWT Bearer Grant (Workday Credentials)). Vous pouvez sélectionner celle que vous souhaitez utiliser sous Credentials dans la configuration de la connexion.

Authentifier avec l’authentification de base

1. Sous Propriétés, saisissez éventuellement le code d’instance de l’Adaptive Planning instance.
2. Sélectionnez ’Basic Credential’ comme type d’authentification.
3. Entrez les valeurs suivantes :
   Username : Le nom d’utilisateur de l’utilisateur d’intégration à utiliser avec le connecteur.
   Password : Le mot de passe de l’utilisateur fourni dans le champ Username.

Authentifiez vous avec un JWT Bearer Grant (Workday Credentials)

Cette méthode d’authentification utilise les informations d’identification Workday pour s’authentifier avec Adaptive Planning, et nécessite que : SSO soit activé :

• Le SSO est activé.
• Les paramètres du locataire Workday pour l’ouverture de session utilisateur d’Adaptive Planning et les API publiques sont activés.
• Un ISU d’API publique est mappé entre Workday et Adaptive Planning.

Pour plus de détails sur cette configuration, reportez-vous à la documentation Workday suivante :

• Configurer SAML SSO dans Adaptive Planning pour les utilisateurs synchronisés
• Dépannage : Synchronisation des utilisateurs avec Adaptive Planning

Dans le cadre de cette configuration, une clé privée x509 doit être téléchargée dans la partie Connection Resources de cette connexion, et un certificat public créé par cette clé doit être téléchargé dans Workday et associé à un client API de type « JWT Bearer Grant ». Ce client doit à son tour être associé à l’ISU que vous utilisez pour les requêtes à Adaptive Planning, avec des identifiants mappés entre les deux systèmes.

Pour plus de détails sur cette configuration, reportez-vous à la documentation Workday suivante : Enregistrer des clients API.

Détails de la clé

Le format de clé privée pris en charge est PKCS#8 et peut être protégé ou non par un mot de passe. Une nouvelle clé peut être créée à l’aide d’openssl avec la commande suivante :

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

Détermination de l’hôte, du domaine et du locataire de Workday

En utilisant le point de terminaison de l’API REST Workday indiqué sous le client API, identifiez l’hôte, le domaine et le locataire, selon le format suivant : https ://{host}.{domain}/ccx/api/v1/{tenant}

Exemple

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

Configurer le type d’informations d’identification du porteur dans le connecteur Adaptive Planning

1. Téléchargez votre clé privée dans la partie Ressources de la connexion.
   
2. Sélectionnez le type d’authentification ’Bearer’.
   
3. Saisissez les informations suivantes :

   Propriété	Détails
   Clé privée x509	Entrez le nom de la clé privée téléchargée exactement comme indiqué dans les ressources de connexion.
   Mot de passe	Saisissez le mot de passe de la clé privée. Laissez ce champ vide si votre clé n’est pas protégée par un mot de passe.
   Identifiant du client	Saisissez l’ID du client de l’API d’octroi de JWT Bearer.
   Utilisateur du service d’intégration	Saisissez le nom de l’utilisateur du service d’intégration (ISU) associé au client API.
   Hôte	Saisissez 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.
   Locataire	Saisissez le locataire Workday auquel se connecter.
   Domaine	Saisissez le domaine de l'environnement Workday auquel vous souhaitez vous connecter, par exemple workday.com ou myworkday.com.

Une fois l’authentification établie :

1. Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
2. Pour tester la connexion, créez et exécutez une chaîne avec la commande Export Versions du connecteur et vérifiez qu’elle renvoie un résultat valide.

Dépannage

Si la connexion à Workday Adaptive Planning échoue :

• Vérifiez les informations d'authentification de l'utilisateur d'intégration.
• Assurez-vous que le rôle de l'utilisateur d'intégration dispose des autorisations appropriées pour les commandes exécutées par le connecteur.
• Si l'utilisateur de l'intégration peut accéder à plusieurs instances de Adaptive Planning, vérifiez le code d'instance saisi pour le connecteur.

Pour plus d’informations sur la façon d’effectuer des requêtes API Adaptive Planning en utilisant les informations d’identification Workday, consultez cette page Workday : Effectuer des requêtes API pour Adaptive Planning avec des informations d’identification Workday.