Portail de support Workiva

Dans ce parcours de formation connectée, nous allons créer une chaîne qui illustre comment tenir compte dynamiquement d'une année bissextile.

Étape 1 : Créer une chaîne

• Dans le module des chaînes de votre espace de travail, sélectionnez l'environnement DEV.
• Ajouter une nouvelle chaîne
  • Nommez la chaîne, CLP | Transformation de variable | Analyse de date et heure.
  • Ajouter une description : Le modèle Connected Learning Path Chain illustre comment une entrée d'exécution pour le mois et l'année peut générer dynamiquement divers formats de clés de période et tenir compte des années bissextiles.Ce modèle utilise la transformation variable pour reformater les dates et calculer la clé de période finale tout en tenant compte dynamiquement des années bissextiles.
• Sauver la chaîne

Étape 2 : Ajouter une entrée d'exécution

Entrées au moment de l'exécution illustre la manière dont une chaîne peut demander des valeurs au moment de l'exécution. Il s'agit d'un moyen précieux de permettre l'utilisation des chaînes dans le cadre de plusieurs processus.

• Créer la commande
  • Ajouter une entrée Runtime au nœud de départ
    Utilisez la barre de recherche pour rechercher "runtime". Double-cliquez ensuite pour charger automatiquement la commande dans le cercle de démarrage.
  • Cliquez sur Add Input et sélectionnez DropdownField.
  • Configurez le champ d'affichage DropdownField comme suit :
    

    Nom d’affichage	Mois
    Obligatoire	Vérifié
    Description	Sélectionner le mois en cours

  • Cliquez sur Ajouter une option
  • Configurer avec l'option suivante :
    

    Valeur	{"display":"January","value":"01-01"}
    Nom d’affichage	Janvier
    Par défaut	Non vérifié

• Compléter le champ de la liste déroulante
  • Ajouter des options pour les onze mois restants de l'année. Mettre à jour les noms de valeur et d'affichage en conséquence
    • Exemple : {"display":"February","value":"02-01"}
• Ajouter une entrée d'exécution NumberField
  • Après avoir complété la saisie du champ Dropdown, ajoutez une saisie NumberField.
  • Configurez le champ NumberField comme suit :
    

    Nom d’affichage	Année
    Obligatoire	Vérifié
    Description	Saisir l'année en cours au format AAAA
    Valeur par défaut	<leave blank>
    Valeur minimale (vérifiée)	2000
    Valeur maximale (vérifiée)	2050

• Enregistrer l'entrée de la durée d'exécution

Étape 3 : Ajouter une commande pour créer une clé périodique

Nous utilisons le connecteur Handlebars pour prendre les valeurs spécifiées dans les entrées d'exécution et créer une clé de période au format AAAA-MM-JJ.

• Ajouter un modèle de texte de rendu Commande à partir du guidon Connecteur à la chaîne
• Connecter le nœud de départ (Runtime Inputs) à la commande Render Text Template
• Modifier la commande
  • Nommez la commande : Rendre le modèle de texte - Créer une clé de période
  • Dans le paramètre Template, entrez ce qui suit :
    

    {{Year}}-{{Period}}

  • Dans la section Variables, ajoutez deux variables en cliquant deux fois sur le bouton Add dans la section Variables.
  • Pour la première variable, indiquez que le nom de la variable est Year.
    • Note : Les noms de variables sont sensibles à la casse.
  • Cliquez sur le champ Value
    • Dans le volet Variable, développez Trigger ➡ Runtime Inputs et sélectionnez Year
  • Dans la deuxième variable, indiquez le nom Période
  • Cliquez sur le champ Value
    • Dans le volet Variable, développez Trigger ➡ Runtime Inputs et sélectionnez Mois
    • Cliquez sur la variable Month (indiquée par la bulle) qui a été affectée à la valeur
    • Cliquez sur le menu déroulant Sélectionner la transformation
      • Sélectionner Analyser le texte en JSON
      • Cliquez sur le symbole plus (+)
      • Cliquez à nouveau sur la liste déroulante Select transformation
        • Sélectionner Obtenir une valeur à partir de JSON
        • Cliquez sur le symbole plus
      • Dans le champ Get Value from JSON ,
        • Dans le menu déroulant de la colonne Sortie, sélectionnez "T"
          • Note : Le site T est la variable "mois" établie à l'étape précédente.
        • Dans le champ de la colonne Valeur, entrez "value" et appuyez sur la touche Entrée.
          • Note : La valeur du texte doit être en minuscules et apparaîtra sous la forme d'une bulle grise après avoir appuyé sur la touche Entrée.
      • Cliquez sur Accepter
• Enregistrer la commande

Étape 4 : Ajouter une commande pour effectuer des opérations sur les dates

Nous utilisons le connecteur Handlebars pour effectuer plusieurs opérations sur les dates, y compris le calcul et le reformatage des dates.

• Ajouter un modèle de texte de rendu Commande à partir du guidon Connecteur à la chaîne
• Relier la commande Render Text Template - Create Period Key à la commande Render Text Template
• Modifier la commande
  • Nommez la commande : Rendre le modèle de texte - Analyse de la date
  • Dans le paramètre Template, entrez ce qui suit :

Période sélectionnée : 

  Mois : {{Month_Name}} 

  Année : 

  Clé de période : {{Period_Key}} 

  Clé de période de fin de mois : {{EOM_Key}}

• • Dans la section Paramètres du modèle
    • Cliquez après l'année
    • Développez ensuite Trigger ➡ Runtime Inputs et sélectionnez Year.

Étape 5 : Section des variables

• Ajoutez trois variables en cliquant sur le bouton Ajouter dans la section Variables
  • Pour la première variable :
    • Spécifiez le premier nom de variable comme Month_Name
      • Cliquez dans le champ Valeur
        • Dans le volet Variable, développez Trigger ➡ Runtime Inputs et sélectionnez Month
      • Cliquez sur la bulle de la variable Month dans le champ Value.
        • Cliquez sur le menu déroulant Sélectionner la transformation
          • Sélectionnez Analyser le texte comme JSON, puis cliquez sur le symbole plus (+)
        • Cliquez à nouveau sur la liste déroulante Select transformation
          • Sélectionnez Obtenir la valeur de JSON, puis cliquez sur le symbole plus (+)
            • Dans la ligne Get Value from JSON, sélectionnez T dans le menu déroulant Output.
            • Dans la même ligne Get Value from JSON, saisissez display dans le champ Value et appuyez sur la touche Entrée.
            • Cliquez sur Accepter

• Pour la deuxième variable :
  • Spécifiez le nom de la variable comme suit : Period_Key
    • Cliquez sur le champ Value
      • Dans le volet Variable, développez Render Text Template - Create Period Key (Modèle de rendu de texte - Créer une clé de période).
        • Sélectionnez Rendered Text
    • Cliquez sur la bulle de la variable Rendered Text dans le champ Valeur.
      • Cliquez sur le menu déroulant Select transformation et sélectionnez Parse Date / Time, puis cliquez sur le bouton plus ( ).
      • Dans la première liste déroulante, entrez %Y-%m-%d et assurez-vous d'appuyer sur Entrée.
      • Dans le champ Format de la date de sortie, entrez %m/%d/%Y
      • Dans le menu déroulant du fuseau horaire de la date d'entrée, tapez UTC et sélectionnez le fuseau horaire (UTC) Dublin, Edinburgh, Lisbon, London.
      • Répétez la sélection UTC pour le champ Output date timezone (fuseau horaire de la date de sortie).
      • Cliquez sur Accepter

• Pour la troisième variable :
  • Spécifiez le nom de la variable comme suit : EOM_Key
    • Cliquez dans le champ Valeur. Dans le volet Variable, développez Render Text Template - Create Period Key et sélectionnez Rendered Text
    • Cliquez sur la variable Rendered Text qui a été affectée à la valeur
      • Cliquez sur le menu déroulant Sélectionner la transformation et sélectionnez Ajouter / Soustraire date et heure, puis cliquez sur le symbole plus (+)
        • Dans le menu déroulant Format, entrez %Y-%m-%d et assurez-vous d'appuyer sur Entrée.
        • Dans le menu déroulant Opération, sélectionnez Ajouter
        • Dans le champ Montant, saisissez 1
        • Dans le menu déroulant Unité, sélectionnez Mois
      • Ajouter un site supplémentaire Ajouter / soustraire la date et la transformation de l'heure
        • Dans le menu déroulant Format, entrez %Y-%m-%d et assurez-vous d'appuyer sur Entrée.
        • Dans le menu déroulant Opération, sélectionnez Soustraire
        • Dans le champ Montant, saisissez 1
        • Dans le menu déroulant Unité, sélectionnez Jour
      • Date de sortie champ de fuseau horaire
      • Cliquez sur Accepter
• Enregistrer la commande

Étape 6 : Test de la chaîne

Maintenant que la chaîne est terminée, nous pouvons tester le résultat.

• Publier la chaîne
• Cliquez sur Exécuter et sélectionnez ensuite Exécuter avec des entrées
• Dans la liste déroulante Mois, sélectionnez Février. Dans l'entrée Année, saisissez 2024
• Cliquez sur Démarrer. Examinez les résultats de la chaîne dans l'onglet Log de la commande Render Text Template - Create Period Key.
  • Vérifier la clé pour la période de fin de mois, c'est-à-dire une année bissextile.

• Exécutez à nouveau la chaîne en février, mais entrez 2025 pour l'année de cette exécution.
  • Confirmer que le mois s'est terminé le bon jour, c'est-à-dire qu'il ne s'agit pas d'une année bissextile.

Pour en savoir plus sur la transformation des données à l'aide des chaînes, consultez le site Connected Learning Paths - Transformation Introduction!