Portail de support Workiva

Que se passe-t-il en cas de défaillance de la chaîne ? Il est essentiel que les utilisateurs finaux soient pleinement informés des résultats potentiels. Dans ce parcours d'apprentissage connecté, nous améliorerons notre chaîne primaire en y incorporant des branches supplémentaires qui communiqueront avec notre feuille de contrôle, en indiquant spécifiquement toute défaillance. Cette chaîne élargie offrira un niveau supplémentaire de transparence, permettant aux utilisateurs d'identifier facilement la dernière date d'exécution réussie de la commande. En outre, il permettra de savoir si la chaîne a fonctionné avec succès ou s'il y a eu des problèmes. Cette amélioration garantit que les utilisateurs disposent des informations nécessaires pour surveiller et traiter rapidement toute défaillance potentielle.

Étape 1 : Modifier la chaîne existante

• Naviguez vers Chain Builder et localisez la chaîne CLP | Exécuter des processus et enregistrer des résultats dans une feuille de contrôle
• Cliquez sur le bouton "crayon" pour modifier la chaîne
• Cliquez sur Paramètres de chaîne en haut à droite. 
  • Renommer la chaîne : CLP | Enregistrement des défaillances dans une fiche de contrôle
• Sauver la chaîne

Étape 2 : Ajouter une branche d'échec pour le processus de téléchargement des données

Nous allons maintenant ajouter les commandes qui seront utilisées pour générer et remplir les valeurs qui seront renvoyées à la feuille de contrôle pour indiquer que le processus de téléchargement des données a échoué. La première étape consiste à créer le fichier contenant le statut et l'heure.

• Ajouter une commande Create File de File Utilities Connector au canevas Chain.
• Connecter l'événement de la chaîne Run Chain - Upload Data à la commande Create File
• Double-cliquez sur le lien pour en modifier les conditions
  • Cliquez sur l'option d'échec
    
    Une fois l'option d'échec sélectionnée, le lien devient rouge, indiquant que la chaîne se poursuivra avec cette branche uniquement si l'événement de chaîne "Exécuter la chaîne - Télécharger les données" échoue.
    
• Double-cliquez sur la commande Créez fichier pour la configurer.
  • Nommez la commande : Remplir l'échec de l'envoi des données et l'horodatage
  • Dans le champ Text, saisissez les informations suivantes : 

Échec du téléchargement des données (*<System.DateTime>*)

• • • Remplacer l'espace réservé (*System.DateTime*) par la variable d'exécution appropriée, ce qui permettra d'extraire la date et l'heure des chaînes de manière programmatique.
      • Dans le panneau Sélectionner une Variable sur la gauche, développez Temps d'exécution
      • Sélectionnez la valeur System.DateTime
• Enregistrer la commande

Étape 3 : Écrire l'échec du transfert de données sur la feuille de contrôle

Nous allons maintenant utiliser la commande Écrire les données de la feuille pour écrire dans la feuille de contrôle les informations recueillies lors de la commande précédente. Cela permettra à nos utilisateurs finaux de connaître les échecs de téléchargement des données et la date de l'échec.

• Ajouter une commande Write Sheet Data du connecteur Workiva au canevas de la chaîne. 
• Lier la commande Populate Data Upload Failure & Time Stamp à la commande Write Sheet Data
• Double-cliquez sur la commande pour la configurer
  • Nommez la commande : Écrire les données de la feuille - Échec du téléchargement des données
  • Cliquez sur le champ ID de la feuille de calcul
    • Dans le panneau de gauche Sélectionner une variable, cliquez sur la flèche vers le bas pour développer Chaîne.
    • 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 de gauche Sélectionner une variable, cliquez sur la flèche vers le bas pour développer Chaîne.
    • Sélectionnez le nom de la feuille de contrôle cv Variable de chaîne 
  • Cliquez sur le champ Fichier de données
    • Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Populate Data Upload Failure & Time Stamp.
    • Sélectionnez la sortie Fichier créé
  • Le champ Région sera rempli avec une combinaison de variables de la chaîne et de données JSON pour indiquer à la chaîne la cellule spécifique de la feuille de contrôle dans laquelle écrire pour l'itération en cours :
    • Cliquez sur le champ Region et remplissez-le avec les données ci-dessous :
      
    • cv-Status Column Letter - variable trouvée dans le panneau Variables sous Chain Variables
    • Fichier JSON Iteration - nous utilisons le numéro de ligne de l'itération plus un, pour spécifier la région dans laquelle écrire les données. Nous en ajoutons un pour tenir compte de la ligne d'en-tête.
      • Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Group Iterator 
      • Sélectionnez <> JSON File Iteration
      • Cliquez sur la pilule verte JSON File Iteration pour transformer la Variable
        • Cliquez sur Sélectionner une transformation et choisissez Get Value from JSON
        • Appuyez sur le signe vert +
        • Dans le champ de valeur, tapez Row Number et appuyez sur la touche "Entrée".
        • Sélectionnez une autre transformation et choisissez Analyser le nombre
        • Cliquez sur le signe vert +
        • Sélectionnez une autre transformation et choisissez Ajouter
        • Cliquez sur le signe vert +
        • Dans le champ de la valeur, entrez 1
        • Cliquez sur Accepter
          
    • Saisir deux points après la première itération du fichier JSON:
    • cv-Time Stamp Column Letter - variable trouvée dans le panneau Variables sous Chain Variables
    • Fichier JSON Iteration - nous utilisons le numéro de ligne de l'itération plus un, pour spécifier la région dans laquelle écrire les données. Nous en ajoutons un pour tenir compte de la ligne d'en-tête.
      
      • Suivez les mêmes étapes que ci-dessus pour la deuxième itération du fichier JSON.

• Enregistrer la commande

Étape 4 : Ajouter une branche d'échec pour le processus d'actualisation des connexions

Nous allons maintenant ajouter les commandes qui seront utilisées pour générer et remplir les valeurs qui seront renvoyées à la feuille de contrôle pour indiquer que le processus d'actualisation des connexions a échoué. Cette fois, nous copierons les deux commandes que nous avons déjà créées afin de rationaliser le processus.

• Cliquez sur la commande Populate Data Upload Failure & Time Stamp et cliquez sur le bouton Copy.
  
• Connecter la chaîne d'exécution - Actualiser les connexions de l'événement de la chaîne à l'événement de la chaîne Remplir l'échec du téléchargement des données et l'horodatage - Copier la commande qui vient d'être copiée.
• Double-cliquez sur le lien pour en modifier les conditions
  • Cliquez sur l'option de défaillance
    
• Double-cliquez sur la commande Populate Data Upload Failure & Time Stamp - Copy pour la configurer.
  • Nommez la commande : Remplir le champ Échec de la connexion et horodatage
  • Dans le champ Text, mettez à jour les informations suivantes :

    Refresh Connection Failed,(*<System.DateTime>*)

    • Vous remarquerez que la variable Date et heure du système n'a pas besoin d'être mise à jour ou ajoutée.
• Enregistrer la commande

Étape 5 : Noter l'échec de l'actualisation de la connexion dans la feuille de contrôle

Nous allons maintenant utiliser la commande Écrire les données de la feuille pour écrire dans la feuille de contrôle les informations recueillies lors de la commande précédente. Cela permettra à nos utilisateurs finaux d'avoir une visibilité sur les échecs de connexion et la date de l'échec. Une fois de plus, nous copierons une commande créée précédemment pour gagner du temps.

• Cliquez sur la commande Write Sheet Data - Data Upload Failure et cliquez sur le bouton Copy.
  
• Connecter la commande Populate Refresh Connection Failure & Time Stamp à la commande Write Sheet Data - Data Upload Failure - Copy Commande qui vient d'être copiée
• Double-cliquez sur le lien pour en modifier les conditions
  • Cliquez sur l'option de défaillance
    
• Double-cliquez sur la commande Write Sheet Data - Data Upload Failure - Copy pour la configurer.
  • Nommez la commande : Écriture des données de la feuille - Actualisation de la connexion Échec
  • Cliquez sur le champ Fichier de données et supprimez la variable .
    • Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Populate Refresh Connection Failure & Time Stamp
    • Sélectionnez la sortie Fichier créé
      • Vous remarquerez que les autres champs ont été remplis avec les mêmes informations que pour la commande Write Sheet Data - Data Upload Failure (Écrire les données de la feuille - Échec du téléchargement des données).
• Enregistrer la commande

Étape 6 : Tester l'exercice

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

• Publier la chaîne
• Afin de tester nos nouvelles commandes, nous allons forcer un échec en modifiant notre feuille de contrôle
  • Accédez à la feuille de calcul Feuille de contrôle CLP dans la plateforme Workiva
  • Supprimer la valeur TableID dans l'une des lignes
  • Supprimer la valeur SpreadsheetID dans une autre ligne
    
• Retournez à la chaîne CLP | Logging Failures within a Control Sheet et cliquez sur Execute. Sélectionner Chaîne d'exécution
• Une fois la chaîne terminée, vérifiez que le flux de travail s'est bien déroulé en cochant la case ci-dessous :

Branche d'échec suivie pour l'échec du téléchargement des données :

Branche d'échec suivie pour l'échec de l'actualisation des connexions :

Les résultats sont inscrits sur la feuille de contrôle en indiquant les échecs et les réussites :

Félicitations ! Vous avez terminé la série de parcours de formation sur la centralisation des données ! Relevez un nouveau défi avec le site Transformation Connected Learning Paths.