Avec Chains, vous pouvez automatiser les tâches de routine, avec une intégration facile pour récupérer ou envoyer des données à travers plusieurs systèmes d'enregistrement. Par exemple, vous pouvez créer une chaîne pour extraire automatiquement des informations financières d'une source de données dans un tableau, puis transmettre ces données à un autre système pour générer un rapport. Dans Chain Builder, vous organisez et reliez les tâches - ou commandes- qu'une chaîne doit effectuer.
Remarque : Seuls les propriétaires d'espaces de travail ou les propriétaires de chaînes peuvent accéder à Chain Builder. Dans Wdata, cliquez sur Chains, puis sur Open Chain Builder.
Avec les exercices de Get started with tables et Get started with queries, vous créez des tables et des requêtes comme celles utilisées pour les rapports financiers. Dans cet exercice, nous allons créer une chaîne pour exécuter cette requête et exporter ses résultats vers des feuilles de calcul.
Étape 1. Obtenir l'identifiant et les paramètres de la requête
Si vous ne l'avez pas encore fait, téléchargez l'exemple de données et effectuez les exercices Get started with tables et Get started with queries, car vous utiliserez la requête dans la chaîne. Notez l'identifiant de la requête, qui vous permettra de l'identifier dans la chaîne.
Note : Lorsque vous ouvrez une requête dans Wdata, son ID apparaît après /queries/ dans son URL.
Si vous avez créé les filtres de la requête avec des paramètres au lieu de valeurs statiques, notez également les noms des paramètres. Par exemple :
- PY ou Previous_Year
- CY ou Current_Year
- Période en cours
Étape 2. Créer la feuille de calcul
Avant de créer la chaîne, créez une feuille de calcul pour exporter les résultats de la requête.
Pour éviter toute utilisation abusive de la feuille de calcul, il convient d'identifier clairement son objectif éducatif dans son nom.
Après avoir créé la feuille de calcul, notez son URL ; vous l'utiliserez pour identifier l'endroit où exporter les résultats de la requête.
Étape 3. Créer la chaîne
Il est maintenant temps de construire la chaîne ! Enfin, il comprendra des commandes permettant d'exécuter la requête et d'exporter les derniers résultats vers des feuilles de calcul.
Avant de créer une chaîne, vérifiez que vous avez configuré le noyau du connecteur Workiva utilisé pour exécuter ses commandes. Bien que cette chaîne ne nécessite qu'un seul connecteur, les chaînes peuvent utiliser plusieurs connecteurs pour préparer et transférer des données entre vos différents systèmes d'enregistrement.
Une fois le connecteur mis en place, vous pouvez ajouter la chaîne sur Chain Builder:
- Dans Wdata, cliquez sur Chains , Chain Builder.
- Cliquez sur Build, Chains, puis cliquez sur Add, Create Chain dans le coin inférieur droit.
-
Saisissez un nom et une description uniques pour aider à identifier la chaîne.
Remarque : les chaînes apparaissent dans Chain Builder pour tous les membres de l'espace de travail ; nommez-les de manière à ce que les membres comprennent clairement leur intention. Reportez-vous à Leading practice : Conventions de dénomination des chaînes et de leurs objets pour plus d'informations sur la dénomination.
- Cliquez sur Enregistrer.
Étape 4. Commencez par un événement déclencheur Runtime Inputs
Pour que la chaîne commence par demander les variables dont elle a besoin pour ses commandes, ajoute un événement déclencheur Runtime Inputs .
Conseil : En plus des données d'exécution, vous pouvez ajouter des variables pour la chaîne ou l'espace de travail. Avec les variables, vous pouvez étendre l'utilisation d'une chaîne, comme par exemple avec n'importe quelle requête ou feuille de calcul au lieu d'une requête ou d'une feuille de calcul spécifique.
- Cliquez sur Événements déclencheurs , déplacez Entrées d’exécution vers Démarrez, et cliquez sur Modifiez .
- Sous Basic info, saisissez un nom et une description uniques permettant d'identifier l'événement.
-
Sous Variables, ajoutez les variables pour :
- L'ID de la requête
- Toutes les valeurs des paramètres de la requête
- L'URL de la feuille de calcul
Conseil : Pour chaque variable, cliquez sur Add Input, sélectionnez TextField, et saisissez son nom, sa description et sa valeur par défaut.
- Cliquez sur Enregistrer.
Étape 5. Ajouter une commande pour exécuter la requête
Ensuite, ajoutez une commande Run query pour que la chaîne obtienne les derniers résultats à chaque fois qu'elle est exécutée. Vous utiliserez les entrées d'exécution pour identifier l'ID de la requête et les valeurs des paramètres.
- Sous Available Connectors, sélectionnez Workiva, et faites glisser Run query sur le canevas.
-
Faites glisser un lien de Start vers Run query, et cliquez sur la commande Edit.
Note : Veillez à lier la commande à Démarrez pour qu'elle puisse utiliser les données d'entrée de la période d'exécution.
- Sous Basic info, saisissez un nom et une description uniques pour identifier la commande.
- Sous Propriétés de la commande, sélectionnez le connecteur Workiva pour exécuter la commande.
- Pour Query ID, sélectionnez l'entrée d'exécution de l'ID de la requête sous Trigger.
-
Si les filtres de la requête utilisent des valeurs de paramètres, cliquez sur Add ( ) sous Parameters, et saisissez leurs paires clé/valeur :
Clé Valeur PY ou Previous_Year Sous Trigger, sélectionnez l'entrée de durée d'exécution pour l'année précédente. CY ou Current_Year Sous Trigger, sélectionnez l'entrée de durée d'exécution pour l'année en cours. Période en cours Sous Trigger, sélectionnez l'entrée de durée d'exécution pour la période en cours. - Cliquez sur Enregistrer.
Étape 6. Ajouter une commande pour exporter les résultats
Ajoutez maintenant une commande pour exporter les résultats de la requête vers des feuilles de calcul :
- Sous Available Connectors, sélectionnez Workiva, et faites glisser Export query result sur le canevas.
- Faites glisser un lien de Run query vers Export query result, et cliquez sur Edit pour ce dernier.
- Sous Basic info, saisissez un nom et une description uniques pour identifier la commande.
- Sous Propriétés de la commande, sélectionnez le même connecteur Workiva que Exécutez la requête.
- Pour Query result ID, sélectionnez ID pour Query result sous Run query.
- Pour Spreadsheet URL, sélectionnez l'entrée d'exécution pour l'URL de la feuille de calcul sous Trigger.
- Cliquez sur Enregistrer.
Étape 7. Faire fonctionner la chaîne
Pour faire fonctionner la chaîne :
- Cliquez sur Publish, puis sur Publish.
- Cliquez sur Execute puis sur Run with inputs.
- Saisissez les valeurs des entrées de durée d'exécution et cliquez sur Start.
- Pour vérifier la réussite de la chaîne, consultez la feuille de calcul des résultats de la requête.
Si la chaîne échoue, cliquez sur les commandes dans l'historique d'exécution pour consulter leurs journaux et y trouver des messages qui vous aideront à résoudre l'erreur.