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 compte utilisateur dédié à l'intégration Workiva avec et une autorisation OAuth2.

  Remarque : Cet utilisateur d'intégration doit disposer des autorisations nécessaires pour les commandes exécutées par le connecteur, telles que le statut de propriétaire des feuilles de calcul ou de l'espace de travail avec lesquels il interagit.

• L'identifiant d'autorisation OAuth2 et la clé secrète de l'utilisateur de l'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. Depuis , dans la section « Chain Builder », cliquez sur compare_arrows « Connections » dans la barre latérale gauche, puis sur compare_arrows « Create » 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. Dans la section « Ressources » ( ), sélectionnez les ressources à associer à cette connexion.
   Cette section offre un emplacement sécurisé pour tous les fichiers (scripts, jetons de sécurité, certificats, etc.) dont le connecteur a besoin pour fonctionner, notamment à des fins d'authentification ou pour répondre aux exigences de l'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 » sur .

   Avantages :

   • Stockage sécurisé : Comme ces fichiers sont chiffrés lors de leur enregistrement et stockés au niveau de la connexion, ils constituent la solution idéale pour les données de configuration sensibles ou statiques qui ne doivent pas être intégré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 associées aux paramètres de connexion, ce qui signifie que vous n'avez pas besoin de réécrire les chemins d'accès dans les nœuds de votre chaîne.
   • Accessibilité : Le stockage des fichiers à cet emplacement permet de les mettre à la disposition du Runner (l'agent chargé d'exécuter la tâche) sans qu'il soit nécessaire de les placer manuellement sur la machine hôte physique du Runner.

   Inconvénients :

   • Comme ils sont cryptés, ils ne peuvent pas être modifiés directement ; vous devez supprimer le fichier et télé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.

   Remarque : Toutes les informations d'identification sensibles sont automatiquement chiffrées et stockées à l'aide du 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, une redirection 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 identifiants OAuth de l'application du connecteur sont bien présents, corrects 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 une redirection d'hôte, vérifiez que l'URL saisie pour le connecteur est correcte.

• Vérifiez que l'identifiant du fichier Workiva — qu'il s'agisse d'une table, d'une requête ou d'une 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/.