Portail de support Workiva

Étape 1 : Créer une feuille de contrôle

Nous allons créer une feuille de contrôle pour stocker les variables utilisées pour charger des données dans une table Wdata et ensuite rafraîchir les connexions pour ces données. Plutôt que de spécifier ces variables sous Runtime Inputs chaque fois que la chaîne s'exécute, nous ajouterons nos variables à une feuille de contrôle que la chaîne lira et utilisera tout au long de son exécution. 

Bien que cette feuille de contrôle démontre le téléchargement de plusieurs fichiers dans une seule table Wdata et l'actualisation des connexions sur une seule feuille de calcul, le processus peut être étendu pour inclure plusieurs tables et feuilles de calcul en ajoutant simplement l'identifiant unique de la table ou de la feuille de calcul à la feuille de contrôle.

• Naviguez vers la plateforme Workiva pour créer une nouvelle feuille de calcul.
• Cliquez sur Créer et sélectionnez Feuille de calcul
• Nommez la feuille de calcul : Feuille de contrôle CLP
  • Nommez la première feuille : Feuille de contrôle primaire
• Dans la feuille de contrôle primaire, créez les en-têtes suivants
  • Drapeau actif
    • Cette colonne indique si le flux de travail doit être exécuté pour cette ligne de la feuille de contrôle.
  • Nom de fichier
    • Cette colonne indique le nom de l'ensemble de données tel qu'il apparaîtra dans le tableau Wdata.
  • TableID
    • ID du tableau dans Wdata où les données seront téléchargées
  • ID feuille de calcul
    • ID de la feuille de calcul où les données seront actualisées
  • Emplacement du fichier
    • Emplacement du fichier qui sera téléchargé
• Remplissez la feuille avec les valeurs suivantes, en remplissant la colonne <TableID> avec l'identifiant du tableau détaillé des employés CLP et la colonne <SpreadsheetID> avec l'identifiant de la feuille de calcul de la vue d'ensemble des employés CLP, ces identifiants ont été créés dans les parcours d'apprentissage connectés précédents, reportez-vous aux conditions préalables pour voir les parcours d'apprentissage connectés requis.
  • Consultez ce document pour vous aider à trouver les identifiants.

ActiveFlag,FileName,TableID,FileLocation
VRAI,EmployeeDetailsP01,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
VRAI,EmployeeDetailsP02,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
VRAI,EmployeeDetailsP03,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv

Étape 2 : Mise à jour des autorisations de la feuille de calcul

Pour garantir une communication efficace entre une commande Workiva et une feuille de calcul, la subvention API générée doit être associée à un utilisateur qui possède des droits de propriétaire ou d'éditeur sur la feuille de calcul.accorder

• Dans la feuille de contrôle CLP, cliquez sur File dans le ruban en haut de la page.
• Cliquez sur Permissions, puis sur Feuille de calcul
  • Fournir l'accès à l'utilisateur Workiva associé à l'API Grant configuré dans la connexion Workiva

Étape 3 : Créer une chaîne

Pour utiliser les variables que nous avons créées dans la feuille de contrôle, nous allons créer une chaîne qui les lira. Comme nous utiliserons toujours la même feuille de calcul et la même feuille, nous mettrons en place des variables de chaîne pour stocker ces détails afin d'y accéder de manière cohérente.

• Naviguer vers Chain Builder
• Créer une nouvelle chaîne
  • Nommez la chaîne : CLP | Lecture d'une feuille de contrôle
• Sous Variables de chaîne, cliquez deux fois sur le signe Plus pour créer deux variables de chaîne et les configurer comme ci-dessous :
  • Variable 1 :
    • Type : Chaîne variable (cv)
    • Nom : cv-ID de la feuille de calcul de contrôle
    • Valeur : saisir l'adresse ID de la feuille de calcul de contrôle CLP
      • Pour trouver l'identifiant de la feuille de calcul, naviguez jusqu'à la feuille de calcul de la feuille de contrôle CLP .
        • 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 en gras ici : app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fae937e6f0f63b13 
  • Variable 2 :
    • Type : Chaîne variable (cv)
    • Nom : cv-Nom de la feuille de contrôle
    • Valeur : Feuille de contrôle primaire
• Sauver la chaîne

Étape 4 : Obtenir les données de la feuille

Nous utilisons la commande Get Sheet Data pour lancer la chaîne. Cela nous permet d'extraire des informations de la feuille de contrôle pour les transmettre à la chaîne.

• Ajouter une commande Get Sheet Data à partir du connecteur Workiva dans la zone de départ de la chaîne.
• Double-cliquez sur la commande pour la configurer
  
  • Cliquez sur le champ ID de la feuille de calcul
    • Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Chain
    • Sélectionnez l'ID de la feuille de calcul cv-Control Variable de chaîne 
  • Cliquez sur le champ ID/Nom de la feuille
    • Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Chain
    • Sélectionnez le nom de la feuille de contrôle cv Variable de chaîne 
  • Région : n'hésitez pas à spécifier une région. Si elle est laissée à " :", la commande récupérera les données dans l'ensemble de la feuille de calcul.
• Enregistrer la commande

Étape 5 : Tester l'exercice

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

• Publier la chaîne
• Cliquez sur Exécuter et sélectionnez ensuite Exécuter la chaîne
• Une fois la chaîne terminée, cliquez sur le nœud Get Sheet Data pour vérifier le succès de la chaîne.
  • La commande doit fournir une sortie .csv des données de la feuille spécifiée dans la feuille de calcul, vous pouvez voir le .csv en cliquant sur l'icône du globe oculaire.

Apprenez-en plus sur l'utilisation des feuilles de contrôle en complétant le chemin suivant : Utiliser les valeurs d'une feuille de contrôle!