Simplifier le téléchargement d'un fichier de données dans une table Wdata est une compétence essentielle pour rationaliser la gestion des tables. Dans ce parcours d'apprentissage connecté, nous verrons comment télécharger des données dans une table Wdata à l'aide de chaînes.
| Cas d'utilisation principal | Gestion des tables |
| Objectif d'apprentissage principal | Téléchargement de données à partir d’une table Wdata à l’aide de chaînes |
| Conditions préalables | Configurez le connecteur Workiva Configurez le connecteur HTTP Requestor |
| Modèle de support | CLP | Télécharger des données à partir d’une table |
Étape 1 : Créer un tableau
- Naviguez jusqu’à Wdata
- Suivez les étapes pour créer une table avec les propriétés suivantes :
- Nom de la table : « Détail de l’employé CLP »
-
Colonnes :
Nom d’affichage ID de la colonne Type Format d’importation emp_idemp_idTexte nom d'utilisateurnom d'utilisateurTexte prénomprénomTexte nom de famillenom de familleTexte titre du postetitre du posteTexte serviceserviceTexte villevilleTexte payspaysTexte devisedeviseTexte date_d'embauchedate_d'embaucheDate M/d/yyy ftefteDécimale 1,000.00 appeléappeléValeur booléenne
Notes :
- Remarquez que le format d’importation des valeurs
hire_dateest modifié. Ceci afin qu’il corresponde au format des données qui seront chargées dans le tableau. Vous trouverez des informations sur les formats de date et d’heure sur cette page. - Enregistrez l’ID du tableau , car il sera utilisé plus tard dans cette procédure.
Étape 2 : Créer une chaîne
- Naviguez jusqu’à Chain Builder.
- Ajoutez une nouvelle chaîne .
- Nommez la chaîne : CLP | Charger des données dans une table.
- Sauvez la chaîne.
Étape 3 : Entrées en cours d'exécution
Utilisez l’événement Runtime Inputs Chain Event pour lancer la chaîne. Cela nous permet de spécifier le nom du fichier et l'ID de la table dans laquelle le fichier sera importé lors de l'exécution de la chaîne. En savoir plus sur Runtime Inputs.
- Ajoutez au nœud de départ un événement en chaîne Runtime Inputs à partir de Chain Trigger Events.
- Modifiez l’événement de chaîne Runtime Inputs en double-cliquant sur la commande.
- Ajoutez les valeurs de vos Runtime Inputs.
Il s’agit de champs de texte qui doivent être marqués comme « obligatoires ».- Table ID - ID de la table « CLP Employee Detail ».
Consultez ce document pour trouver l’identifiant. - Nom du fichier - le nom que vous souhaitez donner au fichier.
Dans cet exemple, appelez le fichier « Détails sur l’employé ».
- Table ID - ID de la table « CLP Employee Detail ».
- Emplacement du fichier - Emplacement du fichier CSV.
Pour cet exemple, utilisez :https ://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
- Ajoutez les valeurs de vos Runtime Inputs.
- Cliquez sur Enregistrer pour enregistrer la commande.
Étape 4 : Télécharger le fichier
La commande HTTP Request Get sera utilisée pour télécharger le fichier qui sera téléchargé dans la table. Nous avons hébergé un fichier en ligne à télécharger par la chaîne pour démontrer le téléchargement de fichiers à partir du nuage.
- Ajoutez une commande Get du connecteur HTTP Request au canevas Chain.
- Connectez l’événement de chaîne Runtime Inputs à la commande Get.
- Double-cliquez sur la commande pour la configurer.
- Cliquez sur le champ URL.
- Dans le panneau de gauche Select a Variable, cliquez sur la flèche vers le bas pour développer Trigger.
- Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
- Sélectionnez File Location.
- Dans le champ Content type sélectionnez : application/csv.
- Cliquez sur le champ URL.
- Sauvegarder la commande.
Étape 5 : Créer un fichier
Le téléchargement d'un fichier dans une table Wdata se fait en deux étapes. Le fichier devra d'abord être créé dans le statut Staged avant de pouvoir être importé pour une utilisation finale. Nous utiliserons la commande « Create File » pour créer le fichier dans la table Wdata dans l’état Staged, indiquant qu’il a été créé mais pas encore importé en tant qu’ensemble de données.
- Ajoutez une commande Create File du connecteur Workiva Connector au canevas Chain.
- Connectez la commande Get à la commande Create File.
- Double-cliquez sur la commande pour la configurer.
- Cliquez sur le champ Table ID.
- Dans le panneau de gauche Select a Variable, cliquez sur la flèche vers le bas pour développer Trigger.
- Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
- Sélectionnez Table ID.
- Cliquez sur le champ Fichier.
- Dans le panneau de gauche Select a Variable, cliquez sur la flèche vers le bas pour développer GET.
- Sélectionnez Réponse.
- Cliquez sur le champ Name.
- Dans le panneau de gauche Select a Variable , cliquez sur la flèche vers le bas pour développer Trigger.
- Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
- Sélectionnez File Name.
- Dans le panneau de gauche Select a Variable, cliquez sur la flèche vers le bas pour développer Runtime.
- Sélectionnez Chain.ExecutionDateTime.
- Tapez « .csv » après vos deux variables.
- Cliquez sur le champ Table ID.
- Enregistrer la commande
Étape 6 : Importation d'un fichier dans un tableau
La deuxième étape du processus de chargement des fichiers dans les tables Wdata consiste à importer les données pour les rendre utilisables dans les requêtes. Cette étape prend le fichier indexé et l’importe dans le tableau désigné comme jeu de données.
- Ajoutez une commande Import File into Table du connecteur Workiva Connector au canevas Chain.
- Connectez la commande Create File à la commande Import File into Table.
- Double-cliquez sur la commande pour la configurer.
- Cliquez sur le champ Table ID.
- Dans le panneau de gauche Select a Variable, cliquez sur la flèche vers le bas pour développer Trigger.
- Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
- Sélectionnez Table ID.
- Cliquez sur le champ File ID.
- Dans le panneau Sélectionner une variable de gauche, cliquez sur la flèche vers le bas pour développer Créer un fichier.
- Sélectionnez Result.
- Cliquez sur Create File - Result pour le transformer.
- Dans la liste déroulante Select Transformation, sélectionnez Get Value from JSON.
- Cliquez sur le bouton + .
- Dans le champ Valeur, tapez « id" et cliquez sur la touche Entrée de votre clavier.
- Cliquez sur ACCEPTER.
- Cliquez sur le champ Table ID.
- Sauvegarder la commande.
Étape 7 : Tester l'exercice
Maintenant que la chaîne est terminée, testez le résultat.
- Publier la chaîne.
- Cliquez sur Execute, puis sélectionnez Run With Inputs.
- Saisissez les valeurs de vos entrées d’exécution.
- Table ID - ID de la table « CLP Employee Detail ».
Consultez ce document pour trouver l’identifiant. - Nom du fichier - le nom que vous souhaitez donner au fichier.
Dans cet exemple, appelez le fichier « Détails sur l’employé ». - Emplacement du fichier - Emplacement du fichier CSV.
Pour cet exemple, utilisez :https ://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
- Table ID - ID de la table « CLP Employee Detail ».
- Cliquez sur Démarrer.
-
Une fois la chaîne terminée, cliquez sur le nœud Import File into Table pour vérifier la réussite.
La chaîne devrait avoir pris le fichier, créé un fichier Workiva et l’avoir importé dans votre tableau. Vous pouvez vérifier que les données ont été téléchargées dans votre tableau en naviguant vers le tableau dans Wdata et en examinant l’ensemble de données dans le panneau de droite.
Pour en savoir plus sur la gestion des ensembles de données dans les tables Wdata à l'aide de chaînes, consultez le chemin suivant : Supprimer des données d'une table!