|
Les types de fichiers classiques ne pourront plus être utilisés à partir de janvier 2021. Vous pouvez transférer vos fichiers classiques ou télécharger un PDF. En savoir plus

Portail de support Workiva

CLP - Transformation du connecteur guidon

CLP - Transformation du connecteur guidon

  • Dernière mise à jour le

Dans ce parcours d’apprentissage connecté, nous allons créer une chaîne qui illustre comment tirer parti du connecteur Handlebars pour analyser des données à partir d’une réponse HTTP et modéliser des variables qui peuvent être utilisées dans une chaîne.

Objectif d'apprentissage principal Capacités de commande du guidon
Objectifs d'apprentissage secondaires Connecteur de chaînes Workiva
Conditions préalables Configurez Handlebars Connector connection.
Configurez la connexion Workiva Chains Connector.
Modèle de support CLP | Configuration du connecteur guidon

Étape 1 : Créer une chaîne

  1. Ajoutez une nouvelle chaîne .
  2. Nommez la chaîne CLP | Handlebars Configuration.
  3. Créez une variable Chaîne. Saisissez les valeurs suivantes pour le nom et la valeur de la variable :
    • Nom de la variable : cv-AllStations
    • Valeur de la variable : https ://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
  4. Sauvez la chaîne.

Étape 2 : Récupérer les données JSON

Cette étape utilise le connecteur HTTP pour récupérer des données relatives à Citibike au format JSON à partir d’un site web.

  1. Ajoutez une commande GET du connecteur HTTP au nœud Start.

  2. Configurez la commande en utilisant les valeurs suivantes :

    Nom GET - Toutes les stations
    Nom de l'utilisateur <leave blank>
    Mot de passe <leave blank>
    Certificat CA <leave blank>
    Certificat <leave blank>
    Clé privée du certificat <leave blank>
    Afficher la réponse Vérifié
    URL cv-AllStations Chaîne variable
    Chaîne de requête <leave blank>
    Type de contenu application/json
    Réponse <leave blank>
  3. Sauvegarder la commande.
    image (79).png

Étape 3 : Itérer à travers les données JSON

Utilisez la commande Handlebars - Render Text template pour itérer à travers les données des stations CitiBike afin d’obtenir un format permettant de combiner les données de chaque station.

  1. Ajoutez la commande Handlebars - Render Text Template au canevas Chain.
  2. Connectez la commande GET - All Stations à la commande Handlebars - Render Text Template.
  3. Double-cliquez sur la commande pour la modifier.
    1. Nommez la commande : RTT - Parsing JSON Response.
    2. Ajoutez une variable JSON et nommez-la citibikeData.
    3. Pour le champ Value, utilisez la variable Response de la commande Get - All Stations.

    4. Remplissez le champ "modèle" avec la valeur suivante :

      {{#each citibikeData.data.stations}} {{@index}} | {{name}} | {{capacity}} {{/each}}

      Cela permettra à la commande d’itérer dans la réponse JSON, en utilisant un chemin racine de data.stations pour fournir les valeurs textuelles de chaque clé : (« name », « capacity »). En outre, elle ajoutera une valeur index pour chaque ligne traitée.

  4. Sauvegarder la commande.
    image (80).png

Étape 4 : Modélisation des variables d'exécution

Utilisez la commande Handlebars - Render Text Template pour modéliser les variables. Cela permettra à la chaîne de rendre un modèle de texte qui fournit un contexte sur différents composants de la chaîne en fonction de son temps d’exécution.

  1. Ajoutez la commande Handlebars - Render Text Template au canevas Chain.
  2. Connectez la commande GET - All Stations à la commande Handlebars - Render Text Template.
  3. Double-cliquez sur la commande pour la modifier, en utilisant les valeurs suivantes : Nom de la commande : RTT - Templatizing Variables :
    1. Nommez la commande : RTT - Templatizing Variables.
    2. Ajoutez et complétez les informations suivantes pour les variables section :
      Les champs Value seront remplis à partir du menu déroulant Runtime du volet gauche des variables.
      • Variable 1
        • Nom de la variable : Chain-Exec-Time Chaîne-Env
        • Valeur : <Chain.Enviroment> (Variable d'exécution)
      • Variable 2
        • Nom de la variable : Chain-Exec-Time Temps d’exécution en chaîne
        • Valeur : <Chain.ExecutionDateTime> (Variable d'exécution)
      • Variable 3
        • Nom de la variable : Temps d’exécution du système - mois
        • Valeur : <System.DateTime> (Variable d'exécution)
          1. Cliquez sur la variable d’exécution &lt ;System.DateTime&gt ; pour transformer la variable.
          2. Sur Sélectionnez Transformation, choisissez Parse Date/Time, et cliquez sur « + ».
          3. Dans le premier champ de valeur, choisissez « ISO Extended (Platform Standard) ».
          4. Dans le champ Output date format, entrez « %m ».
          5. Dans le champ Input date timezone, choisissez « UTC (Etc/UTC) ».
          6. Dans le champ Output date timezone, choisissez « UTC (Etc/UTC) ».
          7. Cliquez sur Acceptez.
      • Variable 4
        • Nom de la variable : System-RunTime-Year
        • Valeur : &lt ;System.DateTime&gt ; (Runtime Variable)
          1. Cliquez sur la variable d'exécution <System.DateTime> pour la transformer.
          2. Dans Select Transformation, choisissez Parse Date/Time, et cliquez sur « + ».
          3. Dans le premier champ de valeur, choisissez « ISO Extended (Platform Standard) ».
          4. Dans le champ Output date format, entrez « %Y ».
          5. Dans le champ Input date timezone, choisissez « UTC (Etc/UTC) ».
          6. Dans le champ Output date timezone, choisissez « UTC (Etc/UTC) ».
          7. Cliquez sur Acceptez.
    3. Remplissez le champ du modèle avec les valeurs suivantes :
      • Environnement de la chaîne : {{Chain-Env}}
      • Date d’exécution de la chaîne : {{Heure d’exécution de la chaîne}}
      • Mois d’exécution du système : {{Temps d’exécution du système-Mois}}-{{Temps d’exécution du système-Année}}
  4. Sauvegarder la commande.
    2023-08-16_12-49-57.gif

Étape 5 : Modélisation des variables de l’espace de travail - Obtenir des espaces de travail

Utilisez Handlebars - Render Text Template pour modéliser les composants d’un espace de travail. Cela permettra à la chaîne de rendre un modèle de texte qui fournit le contexte des différents composants de l’espace de travail dans lequel la chaîne est située.

  1. Ajoutez la commande Get Workspaces du connecteur Workiva Chains au canevas Chain.
  2. Connectez la commande GET - All Stations à la commande Get Workspaces.
  3. Double-cliquez sur la commande pour la modifier et confirmez que la connexion est correcte.
  4. Sauvegarder la commande.
    image (48).png

Étape 6 : Modélisation des variables de l'espace de travail - RTT - WorkspaceID

  1. Ajoutez la commande Handlebars - Render Text Template au canevas Chain.
  2. Connectez la commande Get Workspaces à la commande Handlebars - Render Text Template.
  3. Double-cliquez sur la commande pour la modifier.
    • Nom de la commande RTT - WorkspaceID.

    • Saisissez la valeur suivante dans le champ Template :

      {{#each workspaces}} {{#if (equal name « <(chain.workspace)> ») }} {{id}}{{/if}}{{/each}}
  4. Sélectionnez la variable <Chain.Workspace> dans la section des variables d’exécution du panneau de gauche.
  5. Dans le champ JSON Variables, entrez les informations suivantes :
    • Nom de la variable : workspaces
    • Valeur de la variable : : &lt ;Espaces de travail&gt ;
  6. Développez la variable Get Workspaces dans le panneau des variables à gauche et sélectionnez Workspaces.
  7. Sauvegarder la commande.
    image (49).png

Étape 7 : Modélisation des variables de l'espace de travail - Obtenir des environnements

  1. Ajoutez la commande Get Environments du connecteur de chaînes Workiva au canevas Chain.
  2. Connectez la commande RTT - WorkspaceID à la commande Get Environments.
  3. Double-cliquez sur la commande pour la modifier et entrez la variable Rendered Text de la commande RTT-WorkspaceID dans le champ Workspace ID.
  4. Sauvegarder la commande.
    image (50).png

Étape 8 : Modélisation des variables de l'espace de travail - RTT - EnvironmentID

  1. Ajoutez la commande Handlebars - Render Text Template au canevas Chain.
  2. Reliez la commande Get Environments à la commande Handlebars - Render Text Template.

  3. Double-cliquez sur cette commande pour la modifier, en utilisant les valeurs suivantes :

    1. Nom de la commande : RTT - EnvironmentID.

    2. Saisissez la valeur suivante dans le champ Template :

      {{#each environments}} {{#if (equal name « <(chain.environment)> ») }} {{id}}{{/if}}{{/each}}

      La variable <Chain.Environment> est une variable Runtime, et se trouve dans le panneau de gauche.

    3. Dans le champ JSON variables, entrez les informations suivantes :
      • Nom de la variable : environments
      • Valeur de la variable : &lt ;Environments&gt ;
        Cette valeur se trouve dans le panneau de gauche de la commande Get Environments.
    4. Sauvegarder la commande.
      image (51).png

    Étape 9 : Tester l'exercice

    1. Publier la chaîne.
    2. Cliquez sur Execute, puis sélectionnez Run Chain.
    3. Une fois que la chaîne a terminé son exécution :
      Confirmez que tous les nœuds ont été exécutés avec succès en cliquant sur la commande RTT - Parsing JSON Response Command et en vérifiant que les premières lignes de la sortie sont les suivantes : RTT - Parsing JSON Response Command et en vérifiant que les premières lignes de la sortie sont les suivantes :
      image (52).png

    4. Cliquez sur la commande RTT - Templatizing Variables exécutée et vérifiez que le texte rendu est exact dans l’onglet « Logs ».
      image (53).png

      Note : Ces valeurs changent en fonction de l’environnement dans lequel la chaîne est exécutée et du moment où elle est exécutée.
    5. Cliquez sur le nœud RTT - Environment ID et sélectionnez l’onglet Outputs.
    6. Confirmez qu’une valeur a été ajoutée à la variable texte rendue (là encore, ce résultat varie en fonction de votre environnement).
      2023-08-10_16-56-22.gif

    En savoir plus

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

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 1
Dans ce parcours d’apprentissage connecté, nous allons créer une chaîne qui illustre comment tirer parti du connecteu...