Portail de support Workiva

Avez-vous regardé le webinaire Chains Foundations? Vous voulez suivre les cours à votre rythme ? Dans ce parcours d'apprentissage connecté, nous allons créer une chaîne qui télécharge des données à partir d'une source, les charge dans une table Wdata et actualise les connexions, en suivant les étapes du webinaire sur les fondements des chaînes.

Étape 1 : Créer une chaîne

Pour automatiser le transfert de nos données sources vers nos rapports finaux, nous devons d'abord créer une chaîne qui orchestrera le processus du début à la fin. Comme nous utiliserons toujours la même feuille de calcul et le même tableau, nous mettrons en place des variables en chaîne pour stocker ces détails afin d'y accéder de manière cohérente.

1. Créer une nouvelle Chaîne et nommer la Chaîne : CLP | Fondations chaînes.

2. Sous Chain Variables, cliquez deux fois sur le signe plus pour créer deux variables de chaîne et les configurer comme décrit ci-dessous :

   Variable 1 :

   • Type : Chaîne variable (cv)
   • Nom : cv-Spreadsheet ID
   • Valeur :L'ID de la feuille de calcul CLP Dépenses de l'entreprise par département qui a été créée dans Wdata Foundations CLP.
   • Pour trouver l'ID de la feuille de calcul :
     1. Naviguez jusqu'à la feuille de calcul CLP Company Spend by Department (Dépenses de l'entreprise par département).
     2. Dans l'URL, sélectionnez l'ID de la feuille de calcul, qui se trouve après "spreadsheet/" et avant "/sheet".
        Par exemple, l'ID de la feuille de calcul est indiqué en gras ici : app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13

   Variable 2 :

   • Type : Chaîne variable (cv)
   • Nom : cv-Table ID
   • Valeur : saisir l'ID du tableau des dépenses de l'entreprise CLP.
   • Pour trouver l'ID de la table :
     1. Naviguez jusqu'au tableau des dépenses de l'entreprise CLP.
     2. Dans l'URL, sélectionnez l'ID du tableau, qui se trouve après "table/".
        Par exemple, l'ID de la table est indiqué en gras ici : app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
3. Sauvez la chaîne.

Étape 2 : Télécharger le fichier

La commande HTTP Request Get sera utilisée pour télécharger le fichier qui sera chargé dans le tableau. Nous avons hébergé des fichiers en ligne pour que la chaîne puisse les télécharger afin de démontrer le téléchargement de fichiers à partir du nuage. Pour rendre ce processus dynamique, nous ajouterons la période actuelle à l'URL, ce qui correspond au mois dans lequel nous nous trouvons et garantira que nous extrayons l'ensemble de données actuel.

1. Ajoutez une commande Get du connecteur HTTP Request à la zone de démarrage.
2. Double-cliquez sur la commande pour la configurer.
   1. Remplissez le champ URL avec le contenu ci-dessous, en utilisant une variable pour générer le mois en cours, qui correspond à la période :
      https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv.
   2. Remplacez <System.DateTime> par la variable d'exécution pour la date et l'heure du système.
   3. Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Runtime.
   4. Sélectionnez System.DateTime.
   5. Cliquez sur la variable System.DateTime pour la transformer. Utilisez les valeurs suivantes :
      1. Pour Sélectionner une transformation :, sélectionnez Analyser date/heure.
      2. Cliquez sur le bouton +.
      3. Dans la liste déroulante Format :, sélectionnez ISO Extended (Platform Standard).
      4. Pour Format de la date de sortie :, sélectionnez %m.
         Cette sortie signifie que nous ne recevrons que les deux chiffres du mois de la date et de l'heure du système.
         Pour en savoir plus sur les transformations courantes de la date et de l'heure, cliquez sur.
      5. Dans les champs Input date timezone et Output date timezone, sélectionnez votre fuseau horaire actuel.
      6. Cliquez sur ACCEPTER.
         
3. Mettez à jour le champ Content type en le remplaçant par : application/csv.
4. Enregistrez la commande.

Étape 3 : 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 qu'il n'a pas encore été importé en tant qu'ensemble de données.

1. Ajoutez une commande Create File à partir de Workiva Connector dans le canevas Chain.
2. Reliez 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 de gauche Select a Variable, cliquez sur la flèche vers le bas pour développer Chain.
      2. Sélectionnez cv-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 Réponse.
   3. Remplissez le champ Name avec les informations ci-dessous, en suivant les mêmes étapes que précédemment pour remplir la période dans le champ name :
      ERPSpendData<System.DateTime>.csv
   4. Remplacez <System.DateTime> par la variable d'exécution pour la date et l'heure du système.
      1. Dans le panneau de gauche Select a Variable, cliquez sur la flèche vers le bas pour développer Runtime.
      2. Sélectionnez System.DateTime.
      3. Cliquez sur la variable System.DateTime pour la transformer.
         1. Pour Sélectionner une transformation, sélectionnez Analyser date/heure.
         2. Cliquez sur le bouton + .
         3. Pour Format, sélectionnez ISO Extended (Platform Standard).
         4. Pour Format de la date de sortie, sélectionnez %m-%d-%Y@T%H:%M.
            Cela signifie que nous ne recevrons que la date et l'heure complètes de l'exécution de la chaîne.
            Pour en savoir plus sur les transformations courantes de la date et de l'heure, cliquez sur.
         5. Dans les champs Input date timezone et Output date timezone, sélectionnez votre fuseau horaire actuel.
         6. Cliquez sur ACCEPTER.
            
4. Cliquez sur Enregistrer pour enregistrer la commande.

Étape 4 : Importer 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.

1. Ajoutez une commande Import File into Table à partir de Workiva Connector dans le canevas Chain.
2. Connectez la commande Créer un fichier à la commande Importation de fichier dans un tableau.
3. Double-cliquez sur la commande pour la configurer.
4. Cliquez sur le champ Table ID.
   1. Dans le panneau de gauche Select a Variable, cliquez sur la flèche vers le bas pour développer Chain.
   2. Sélectionnez cv-Table ID.
5. Cliquez sur 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. Cliquez sur la flèche vers le bas pour développer Résultat.
   3. Sélectionnez Id.
6. Enregistrez la commande.

Étape 5 : Lister les connexions

Nous utiliserons la commande List Connections pour récupérer la liste des ID de connexion associés à l'ID de la feuille de calcul. La sortie de la commande Lister les connexions est un fichier JSON contenant chaque connexion de la feuille de calcul ainsi que les détails relatifs à la connexion, y compris l'identifiant de la connexion.

1. Ajoutez une commande List Connections à partir de Workiva Connector dans le canevas Chain.
2. Reliez la commande Import File to Table à la commande List Connections.
3. Double-cliquez sur la commande pour la configurer.
   • Type de destination : Feuille de calcul
   • Destination ID : Utilisez la variable Spreadsheet ID Chain.
     1. Cliquez sur le champ ID de destination.
     2. Dans le panneau des variables de gauche, développez le menu déroulant Chain.
     3. Sélectionnez la variable Spreadsheet ID.
4. Enregistrez la commande.

Étape 6 : Groupe de commandement

Nous utiliserons un groupe de commande pour permettre l'itération sur chaque connexion. L'itérateur de groupe fait passer chaque connexion de la feuille de calcul par les étapes suivantes, une par une.

1. Ajoutez un groupe de commandes au canevas de chaîne.
2. Connectez la commande List Connections à la section In du groupe de commandes.
3. Double-cliquez sur la commande pour la configurer.
   1. Nommez le groupe : L'itération des connexions
   2. Accédez à l'onglet Iterators.
   3. Activez la case à cocher Iterations et cliquez sur le champ Iterations.
      1. Dans le panneau Sélectionner une variable, cliquez sur la flèche vers le bas pour développer Lister les connexions.
      2. Sélectionnez la sortie Connections.
4. Sauvegarder le groupe de commande.

Étape 7 : Actualiser la connexion

Nous utiliserons la commande Rafraîchir la connexion pour rafraîchir nos connexions en utilisant l'identifiant de connexion de l'itération.

1. Ajoutez une commande Refresh Connection à partir de Workiva Connector dans le canevas Chain.
2. Reliez la section Start de l'itérateur de groupe à la commande Refresh Connection.
3. Double-cliquez sur la commande pour la configurer.
   • Pour Connection ID : utilisez l'ID de connexion de l'itérateur de groupe - Connections Iteration. Cela nous permet de transmettre l'ID de l'itération actuelle à la commande Actualiser les connexions.
     1. Cliquez sur le champ Connection ID.
     2. Dans le panneau de gauche, développez la liste déroulante Group Iterator.
     3. Développez la liste déroulante Connections Iteration.
     4. Sélectionnez la variable ConnectionId.
   • Cochez la case Utiliser les paramètres de source précédents.

Étape 8 : Tester l'exercice

Maintenant que la chaîne est terminée, testez le résultat.

1. Publier la chaîne.
2. Cliquez sur Execute puis sur Run Chain.
3. Une fois la chaîne terminée, revenez au tableau et constatez que les données ont été chargées, revenez à la feuille de calcul et constatez que la connexion a été actualisée avec succès.

Succès de la chaîne

Données ajoutées au tableau

Connexions rafraîchies