Le connecteur Workiva Chains fournit des commandes communes pour les espaces de travail, les environnements et les chaînes. Il s'agit notamment des commandes list et get utilisées pour récupérer les propriétés, les détails de l'exécution des chaînes, les événements liés à l'activité de connexion, etc.
Pour une liste complète des commandes compatibles, voir l'article Workiva Chains commands.
Exigences
Avant d'utiliser le connecteur :
- Un administrateur de sécurité de l'org doit activer le connecteur Workiva Chains via l'écran Configurations.
- Pour exécuter la chaîne dans un environnement de test, vous aurez besoin des URL pour remplacer les hôtes et les chemins de base de l'API.
- Vous devez créer un utilisateur d'intégration dédié avec une subvention OAuth2 dans votre logiciel.
- Pour trouver vos identifiants de chaîne, consultez cet article sur trouver des identifiants dans Workiva.
Exigences supplémentaires pour l'utilisateur d'intégration
Bien que tous les propriétaires d'espaces de travail puissent accéder aux chaînes qui utilisent le connecteur, 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.
Les éléments suivants sont nécessaires pour configurer l'utilisateur d'intégration :
- Vous devez connaître l'ID de subvention OAuth2 et le secret de l'utilisateur d'intégration.
- Vous devez fournir à l'utilisateur de l'intégration les autorisations appropriées pour chaque commande que le connecteur exécutera ; par exemple, il peut être le propriétaire de la feuille de calcul ou de l'espace de travail avec lequel le connecteur interagit.
- L'utilisateur de l'intégration doit se connecter à Chain Builder avant de pouvoir exécuter des commandes. Cette opération est nécessaire pour établir le compte de l'utilisateur.
Configuration de la connexion
Pour configurer le connecteur Workiva Chains :
- À partir du Générateur de chaînes, cliquez sur Connexions , puis sur Créer en haut à droite.
- Sous Connector Connection, sélectionnez Workiva Chains et le CloudRunner par défaut.
- Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.
- Sous Propriétés, entrez les détails de la connexion :
Propriété Détails URL de base L'URL de base ; la valeur par défaut est https://h.app.wdesk.com/s/wdata/oc/api/ 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 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. - Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
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.
| Champ | Valeur |
|---|---|
| Remplacement de l’hôte cérébral | https://h.app.wdesk.com/s/cerebral |
| Remplacement de l’hôte des feuilles de calcul | https://api.app.wdesk.com/spreadsheets/v1/ |
| Remplacement de l’hôte IAM | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Remplacement de l’hôte administrateur | https://api.app.wdesk.com/admin/v1 |
| Remplacement de l’hôte GraphDB | https://api.app.wdesk.com/graphdb/v1/ |
| Remplacement de l’hôte de l’API de la plateforme | https://api.app.wdesk.com/platform/v1 |
| Champ | Valeur |
|---|---|
| Remplacement de l’hôte cérébral | https://h.eu.wdesk.com/s/cerebral |
| Remplacement de l’hôte des feuilles de calcul | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Remplacement de l’hôte IAM | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Remplacement de l’hôte administrateur | https://api.eu.wdesk.com/admin/v1 |
| Remplacement de l’hôte GraphDB | https://api.eu.wdesk.com/graphdb/v1/ |
| Remplacement de l’hôte de l’API de la plateforme | https://api.eu.wdesk.com/platform/v1 |
| Champ | Valeur |
|---|---|
| Remplacement de l’hôte cérébral | https://h.apac.wdesk.com/s/cerebral |
| Remplacement de l’hôte des feuilles de calcul | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Remplacement de l’hôte IAM | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Remplacement de l’hôte administrateur | https://api.apac.wdesk.com/admin/v1 |
| Remplacement de l’hôte GraphDB | https://api.apac.wdesk.com/graphdb/v1/ |
| Remplacement de l’hôte de l’API de la plateforme | https://api.apac.wdesk.com/platform/v1 |