CLP - Remplacer des données dans un tableau – Centre d’assistance

Il est possible de rationaliser encore davantage la gestion des données en combinant les étapes dans une même chaîne. Dans ce parcours d'apprentissage connecté, nous verrons la meilleure façon de remplacer des données dans une table Wdata, qui est un processus en deux étapes utilisant une chaîne.

Cas d'utilisation principal	Gestion des tables
Objectif d'apprentissage principal	Remplacer des données dans une table Wdata à l'aide de chaînes
Conditions préalables	Configurez le connecteur Workiva Configurez le connecteur de requête HTTP Complétez CLP - Téléchargement de données dans une table Chemin d’accès Identifiez la table ID de la table CLP Employee Detail.
Modèle de support	CLP - Remplacer des données dans une table

Étape 1 : Exécuter la chaîne

Naviguez jusqu’à la chaîne CLP | Upload Data to a Table.
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’ID.
- Nom du fichier - le nom que vous souhaitez donner au fichier, pour cet exemple, nous appelons le fichier « Détail de l’employé ».
- Emplacement du fichier - https ://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
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.
Il y a maintenant des données disponibles dans le tableau détaillé des employés CLP, que nous allons remplacer par l'ensemble de données mis à jour, en utilisant une seule chaîne pour supprimer les anciennes données et télécharger les nouvelles données.

Étape 2 : Créer une chaîne

Ajoutez une nouvelle chaîne .
Nommez la chaîne : CLP | Remplacer les données dans un tableau.
Sauvez la chaîne.

Étape 3 : Entrées en cours d'exécution

Nous utilisons la commande Runtime Inputs 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.

Ajoutez une commande Runtime Inputs à partir de la zone de démarrage de Chain Trigger Events.
Modifiez l’événement en chaîne Runtime Inputs en double-cliquant sur la commande.
Ajoutez les trois entrées ci-dessous :
- Entrée 1 :
  - Type : Champ de texte
  - Nom d'affichage : ID du tableau
  - Requis : Coché
- Entrée 2 :
  - Type : Champ de texte
  - Nom d'affichage : Nom du fichier
  - Requis : Coché
- Entrée 3 :
  - Type : Champ de texte
  - Nom d'affichage : Emplacement du fichier
  - Requis : Coché
Sauvegarder la commande.

Étape 4 : Lister les fichiers

Pour supprimer l'ancien fichier de la table, nous avons besoin de l'identifiant du fichier. Pour trouver par programme l'ID de fichier, nous utiliserons la commande List Files. Cette commande utilise l'ID de la table pour rechercher tous les fichiers de cette table et nous fournit une sortie des fichiers ainsi que des informations sur ces fichiers, y compris l'ID du fichier.

Ajoutez une commande Lister les fichiers au canevas de chaîne
Connectez l’événement de chaîne Runtime Inputs à la commande List Files.
Double-cliquez sur la commande pour la configurer et cliquez sur le champ Table ID.
Dans le panneau gauche Variables, cliquez sur la flèche vers le bas pour développer Trigger.
1. Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
2. Sélectionnez TableID.
Sauvegarder la commande.

Étape 5 : Annuler l'importation du fichier dans le tableau

Comme pour le téléchargement de données dans un tableau, la suppression de données d’un tableau se fait en deux étapes. Le fichier devra d'abord être mis en statut « indexé » avant de pouvoir être supprimé. Pour définir le fichier comme étant indexé, il faudra en annuler l'importation. Nous utiliserons la commande Un-Import File from Table pour préparer l’ensemble de données à supprimer.

Ajoutez une commande Un-import File from Table au canevas Chain.
Connectez la commande List Files à la commande Un-import File from Table.
Double-cliquez sur la commande pour la configurer.
1. Cliquez sur le champ Table ID.
  1. Dans le panneau gauche Variables, cliquez sur la flèche vers le bas pour développer Trigger.
  2. Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
  3. Sélectionnez TableID.
2. Cliquez sur le champ File ID.
  1. Dans le panneau Variables de gauche, cliquez sur la flèche vers le bas pour développer List Files.
  2. Sélectionnez Liste des fichiers.
  3. Cliquez sur la variable List Files - Files List pour transformer la variable.
    1. Cliquez sur Select Transformation puis sélectionnez Get Value from JSON.
    2. Cliquez sur le signe plus pour ajouter la transformation de la variable.
    3. Dans le champ Valeur, tapez ’0’ puis appuyez sur Entrez.
    4. Après l’apparition de =0, tapez ’id’ et appuyez sur Entrez à nouveau.
      La variable va maintenant lire la sortie JSON de la commande List Files et trouver l'identifiant du premier fichier dans le tableau.
      Astuce : faites attention aux majuscules et aux minuscules lorsque vous analysez des valeurs JSON. Faites attention aux majuscules et aux minuscules lors de l’analyse des valeurs JSON.
    5. Cliquez sur Acceptez.
3. Enregistrez la commande.
Étape 6 : Télécharger le fichier

Ensuite, nous pouvons soit supprimer le fichier de la table, soit préparer le nouveau fichier à télécharger. Nous vous recommandons de télécharger un nouveau fichier après avoir désimporté l’ancien fichier afin de vous assurer que le processus est réussi avant que les données ne soient officiellement supprimées.

Pour préparer le nouveau fichier au téléchargement, nous devons d’abord télécharger le fichier à l’aide de la commande HTTP Request Get. Nous avons hébergé un fichier en ligne que la chaîne peut télécharger pour démontrer le téléchargement de fichiers à partir du nuage.
1. Ajoutez une commande Get du connecteur HTTP Request au canevas Chain.
2. Connectez la commande Un-import File from Table à la commande Get.
3. Double-cliquez sur la commande pour la configurer.
  1. Cliquez sur le champ URL.
    1. Dans le panneau gauche Select a Variable, cliquez sur la flèche vers le bas pour développer Trigger.
    2. Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
    3. Sélectionnez File Location (Emplacement du fichier).
  2. Mettez à jour le champ Content type avec la valeur : application/csv.
4. Enregistrez la commande.
Étape 7 : Créer un fichier

Tout comme nous l'avons fait dans la formation connectée Upload Data to Table, nous allons suivre le processus en deux étapes pour télécharger des données dans les tables Wdata. Le fichier devra d'abord être créé dans l'état "Indexé" avant d'être importé pour l'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 qu'il n'a pas encore été importé en tant qu'ensemble de données.
1. Ajoutez une commande Create File du connecteur Workiva Connector au canevas Chain.
2. Connectez la commande Get à la commande Create File.
3. Double-cliquez sur la commande pour la configurer.
  1. Cliquez sur le champ Table ID.
    1. Dans le panneau gauche Select a Variable, cliquez sur la flèche vers le bas pour développer Trigger.
    2. Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
    3. Sélectionnez Table ID.
  2. Cliquez sur le champ Fichier.
    1. Dans le panneau de gauche Select a Variable, cliquez sur la flèche vers le bas pour développer GET.
    2. Sélectionnez Response.
  3. Cliquez sur le champ Name.
    1. Dans le panneau gauche Select a Variable , cliquez sur la flèche vers le bas pour développer Trigger.
    2. Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
    3. Sélectionnez File Name.
    4. Dans le panneau de gauche Select a Variable , cliquez sur la flèche vers le bas pour développer Runtime.
    5. Sélectionnez Chain.ExecutionDateTime.
    6. Tapez « .csv » après vos deux variables.
      La variable Chain.ExecutionDateTime est utilisée pour indiquer quand le fichier a été généré et pour s’assurer que chaque fichier porte un nom unique.
Étape 8 : Importer un fichier dans un tableau

L’étape suivante du processus de téléchargement de fichiers vers des 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.
1. Ajoutez une commande Import File into Table du connecteur Workiva Connector au canevas Chain.
2. Connectez la commande Create File à la commande Import File into Table.
3. Double-cliquez sur la commande pour la configurer.
  - Pour le champ Table ID :
    1. Dans le panneau de gauche Select a Variable , cliquez sur la flèche vers le bas pour développer Trigger.
    2. Cliquez sur la flèche vers le bas pour développer Runtime Inputs.
    3. Sélectionnez Table ID.
  - Pour le champ File ID.
    1. Dans le panneau Sélectionner une variable de gauche, cliquez sur la flèche vers le bas pour développer Créer un fichier.
    2. Sélectionnez Result.
    3. Cliquez sur Create File - Result pour le transformer.
      1. Dans la liste déroulante Select Transformation, sélectionnez Get Value from JSON.
      2. Cliquez sur le bouton + (plus).
      3. Dans le champ Valeur, tapez « id" et appuyez sur Entrez.
      4. Cliquez sur ACCEPTER.
4. Enregistrer la commande
Étape 9 : Supprimer le fichier

Maintenant que les nouvelles données ont été téléchargées et sont prêtes à être utilisées et que l'ancien ensemble de données a été mis à disposition, la dernière étape consiste à supprimer officiellement les anciennes données. Cette étape utilise la commande Delete File pour supprimer l’ensemble de données du tableau.
1. Ajouter une commande Delete File à partir de Workiva Connector au canevas Chain
2. Relier la commande Importer un fichier dans le tableau à la commande Supprimer un fichier
3. Double-cliquez sur la commande pour la configurer.
  Pour nous assurer que nous supprimons le même fichier que celui que nous avons désimporté, nous générerons l’identifiant du fichier de la même manière que pour la commande Un-import File from Table (Désimporter un fichier du tableau) :
  - Dans le champ File ID :
    1. Dans le panneau gauche Variables, cliquez sur la flèche vers le bas pour développer List Files.
    2. Sélectionnez Liste des fichiers.
    3. Cliquez sur la variable List Files - Files List pour transformer la variable.
      1. Cliquez sur Select Transformation puis sélectionnez Get Value from JSON.
      2. Cliquez sur le signe plus (+) pour ajouter la transformation de la variable.
        
        Dans le champ Value, tapez ’0’ puis appuyez sur Enter.
        
        Après l’apparition de =0, tapez ’id’ et appuyez sur Enter .
        La variable va maintenant lire la sortie JSON de la commande List Files et trouver l'identifiant du premier fichier dans le tableau.
        Astuce : faites attention aux majuscules et aux minuscules lorsque vous analysez des valeurs JSON. Faites attention aux majuscules et aux minuscules lors de l’analyse des valeurs JSON.
        
        Cliquez sur Accepter
        
        Sauvegardez la commande.xx
        
        Étape 10 : Tester l'exercice
        
        Maintenant que la chaîne est terminée, testez le résultat.
        
        Cliquez sur Exécutez puis sélectionnez Exécutez avec les entrées.
        
        Ajoutez des valeurs pour vos entrées d’exécution.
        
        Table ID - ID de la table CLP Employee Detail
        Consultez ce document pour trouver l’ID.
        
        Nom du fichier - le nom que vous souhaitez donner au fichier ; pour cet exemple, nous appelons le fichier « Détail de l’employé ».
        
        Emplacement du fichier - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
        
        Cliquez sur Démarrer.
        
        La chaîne devrait avoir supprimé l’ancien fichier et l’avoir remplacé par le nouveau fichier dans votre tableau.
        
        Vous pouvez vérifier que les données ont été remplacées dans votre tableau en naviguant vers le tableau dans Wdata et en examinant les ensembles de données dans le panneau de droite.
        
        Pour en savoir plus sur l'utilisation des chaînes pour rationaliser la collecte de données, consultez le reste du site Data Centralization Paths!

Support

Communauté

Portail de support Workiva