Portail de support Workiva

Avec le connecteur Workiva, vous pouvez utiliser les commandes dans les chaînes pour interagir avec la plateforme Workiva, y compris d’autres fonctionnalités Wdata, feuilles de calcul et GraphDB. Par exemple, avec ce connecteur, vous pouvez :

• Créer et gérer des tableaux, requêtes et vues
• Lister les jeux de données d’un tableau ou les erreurs d’importation
• Créer et gérer des feuilles de calcul ou leurs feuilles
• Gérer les dossiers et les rapports

Exigences

Pour interagir avec la plateforme Workiva, le connecteur utilise les API REST de Workiva. Pour configurer le connecteur, vous aurez besoin de :

• Un utilisateur d’intégration Workiva dédié avec une autorisation OAuth2.

  Note : Cet utilisateur d’intégration nécessite les autorisations appropriées pour les commandes que le connecteur exécute, telles que la propriété des feuilles de calcul ou de l’espace de travail avec lesquels il interagit.

• L’identifiant et le secret de l’autorisation OAuth2 de l’utilisateur d’intégration.
• Pour exécuter la chaîne dans un environnement de test, les URL permettant de remplacer les hôtes et les chemins de base de l’API.

Note : les responsables de l’espace de travail peuvent accéder aux chaînes qui utilisent le connecteur, mais le connecteur lui-même nécessite un utilisateur d’intégration dédié pour exécuter ses commandes. L’utilisation d’un utilisateur d’intégration dédié (au lieu du compte utilisateur d’un collaborateur) vous permet de suivre l’activité du connecteur et de limiter son accès à ce dont il a besoin pour exécuter ses commandes.

Configurer le connecteur Workiva

1. Dans Chain Builder, cliquez sur compare_arrows Connexions dans la barre latérale gauche, puis sur compare_arrows Créer en haut à droite.
2. Sous Create Connection, sélectionnez Workiva et le CloudRunner par défaut.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.

4. Sous Resources, sélectionnez les ressources à associer à cette connexion.
   Cette section fournit un emplacement sécurisé pour tous les fichiers (scripts, jetons de sécurité, certificats, etc.) dont le connecteur a besoin pour fonctionner, par exemple pour l’authentification ou les exigences d’environnement. Lorsque vous enregistrez la connexion, ces fichiers sont automatiquement chiffrés en AES-256. Pour plus d’informations, consultez la page d’assistance Architecture de sécurité de Workiva Chain Builder.

   Avantages :

   • Stockage sécurisé : Comme ces fichiers sont chiffrés lors de l’enregistrement et stockés au niveau de la connexion, ils sont idéaux pour les données de configuration sensibles ou statiques qui ne doivent pas être codées en dur dans la chaîne elle-même.
   • Portabilité : Si vous déplacez votre chaîne d’un espace de travail « Test » vers un espace de travail « Production », les ressources restent liées aux paramètres de connexion, ce qui signifie que vous n’avez pas à réécrire les chemins d’accès aux fichiers dans les nœuds de votre chaîne.
   • Accessibilité : Le stockage des fichiers à cet endroit les rend disponibles pour le Runner (l’agent qui exécute la tâche) sans qu’il soit nécessaire de placer manuellement le fichier sur la machine hôte physique du runner.

   Inconvénients :

   • Comme ils sont chiffrés, ils ne peuvent pas être modifiés directement ; vous devez supprimer le fichier et charger la version modifiée.

5. Sous Propriétés, entrez les détails de la connexion :
   

   Propriété	Détails
   ID	Entrez l’ID de l’accord OAuth des utilisateurs de l’intégration.
   Clé secrète	Entrez le secret de la propriété ID.
   Remplacement de l’hôte cérébral	Pour remplacer l’URL hôte et le chemin de base pour les points de terminaison Wdata, par exemple pour un environnement de test, entrez l’URL à utiliser à la place.
   Remplacement de l’hôte des feuilles de calcul	Pour remplacer l’URL hôte et le chemin de base pour les points de terminaison des feuilles de calcul, par exemple pour un environnement de test, entrez l’URL à utiliser à la place.
   Remplacement de l’hôte IAM	Pour remplacer l’URL de l’hôte et le chemin de base pour les points de terminaison d’identification et de gestion des accès (IAM), par exemple pour un environnement de test, entrez l’URL à utiliser à la place.
   Remplacement de l’hôte administrateur	Pour remplacer l’URL hôte et le chemin de base pour les points de terminaison Admin, par exemple pour un environnement de test, entrez l’URL à utiliser à la place.
   Remplacement de l’hôte GraphDB	Pour remplacer l’URL hôte et le chemin de base pour les points de terminaison GraphDB, par exemple pour un environnement de test, entrez l’URL à utiliser à la place.
   Remplacement de l’hôte de l’API de la plateforme	Pour remplacer l’URL hôte et le chemin de base pour les points de terminaison de la plateforme Workiva, par exemple pour un environnement de test, entrez l’URL à utiliser à la place.

   Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement AES-256.

6. Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
7. Pour tester la connexion, créez et exécutez une chaîne avec la commande Lister les fichiers du connecteur et vérifiez qu’elle renvoie une sortie valide.

Remplacements d’URL

En fonction de la région de votre environnement de production, une URL de remplacement peut s’appliquer. Vous pouvez le vérifier en comparant avec l'URL utilisée pour se connecter à Wdesk. Si l’URL contient .apac, .ca, ou .eu, un remplacement est nécessaire.

Note : les informations relatives à la région des États-Unis sont données à titre de référence.

Dépannage

Si la connexion à la plateforme Workiva échoue :

• Vérifiez que les informations d’identification OAuth de l’application du connecteur sont présentes, correctes et valides. Les informations d'identification OAuth ont des dates d'expiration définies et le certificat peut avoir expiré. Si c'est le cas, vous devrez créer un nouveau certificat et entrer le nouveau secret client dans le connecteur. 
• Assurez-vous que l’utilisateur d’intégration dispose des permissions appropriées pour la commande exécutée.
• Si vous utilisez un remplacement d’hôte, vérifiez que l’URL saisie pour le connecteur est correcte.

• Vérifiez que l’identifiant du fichier Workiva - tel que le tableau, la requête ou la feuille de calcul - avec lequel vous interagissez est correct.

  Note : l’ID d’un fichier apparaît dans son URL lorsqu’il est ouvert dans Workiva. Par exemple, l’ID d’une feuille de calcul apparaît après spreadsheet/ dans son URL ; l’ID d’un tableau apparaît après tables/.