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édié à l'intégration de Workiva avec une subvention OAuth2.

  Remarque : Cet utilisateur d'intégration a besoin d'autorisations appropriées pour les commandes exécutées par le connecteur, telles que Propriétaire des feuilles de calcul ou de l'espace de travail avec lesquels il interagit.

• L'ID et le secret OAuth2 de l'utilisateur d'intégration.
• Pour exécuter la chaîne dans un environnement de test, les URL doivent 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 Chain Builder, cliquez sur Connections compare_arrows, puis 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. 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 en matière d'environnement. Lorsque vous enregistrez la connexion, ces fichiers sont automatiquement cryptés en AES-256. Pour plus d'informations, reportez-vous à la page Workiva Chain Builder security architecture Support page.

   Avantages :

   • Stockage sécurisé : Comme ces fichiers sont crypté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" à 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 ici les met à la disposition de 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 de l'agent d'exécution.

   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.

   Note : Toutes les données d'identification sensibles sont automatiquement cryptées et stockées à l'aide d'un cryptage 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 EU ou APAC, une dérogation 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 une substitution d'hôte, vérifiez que l'URL saisie pour le connecteur est correcte.

• Vérifiez que l'ID du fichier Workiva - tel que la table, 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/.