Carte de données

Ce tutoriel montre comment créer et utiliser un composant Data Map. Vous apprendrez à lui transmettre des données, à les mettre à jour dynamiquement pendant que le formulaire est affiché et à extraire les données. Dans cet exemple, nous nous concentrerons sur les taux de change, en utilisant un dictionnaire avec des paires clé-valeur représentant différentes devises et leurs valeurs équivalentes en USD. En interagissant avec les boutons, vous pouvez extraire et modifier les taux de change en temps réel pendant que le formulaire reste visible.

1. Créez un nouveau formulaire et ajoutez les composants suivants :
   1. Ajoutez un composant Carte de données (Data Map ). N'oubliez pas le nom de propriété que vous lui attribuez, car vous l'utiliserez pour extraire et mettre à jour dynamiquement les données dans le composant.
      Dans cet exemple, utilisez dataMap comme Nom de la propriété (Property Name).
   2. Ajoutez un composant Bouton (Button) pour extraire les données du composant. Définissez l' Action du bouton sur Événement.
      Nommez le bouton Extract data.
   3. Ajoutez un autre composant Bouton (Button) pour modifier les données dans le composant. Définissez l' Action du bouton sur Événement.
      Nommez le bouton Update value.
2. Dans le workflow principal, créez une variable de dictionnaire et ajoutez-y des paires clé-valeur.
   Dans cet exemple, utilisez les paires clé-valeur affichées dans l'image ci-dessous.

   
   

   

   
   
3. Ajoutez une activité Afficher le formulaire (Show Form) avec l'option Continuer l'exécution du workflow (Continue workflow execution ) activée. Cela permet au formulaire de s'afficher pendant que d'autres workflows de déclencheur s'exécutent simultanément.
   1. Dans la collection Arguments , transmettez la variable de dictionnaire précédemment créée au composant Carte de données (Data Map) de votre formulaire.
4. Ajoutez une activité Exécuter les déclencheurs locaux (Run Local Triggers ) pour activer tous les déclencheurs de votre projet.
5. Créez un workflow de déclencheur pour mettre à jour les valeurs dans la carte de données au moment de l'exécution.
   Nommez le déclencheur de workflow fieldChangedTrigger.
   1. Ajoutez une activité de déclencheur de formulaire et définissez l' événement comme bouton utilisé pour mettre à jour les valeurs de la carte de données.
      Dans cet exemple, définissez l ' Événement sur Update value clicked.
   2. Ajoutez une activité Obtenir les valeurs de formulaire ( Get Form Values) pour extraire les valeurs actuelles de la carte de données dans une variable de dictionnaire.
      Dans cet exemple, enregistrez les valeurs actuelles dans une variable nommée dataMap2.
   3. Utilisez une activité For Each pour parcourir chaque paire clé-valeur et les mettre à jour avec une valeur spécifique.
   4. Dans l'activité For Each , ajoutez une activité Assign pour initialiser une nouvelle paire clé-valeur avec laquelle vous souhaitez mettre à jour la carte de données.
      • Enregistrez la paire dans une variable nommée newItem à l'aide du champ Enregistrer dans ( Save to ).
      • Spécifiez la nouvelle paire clé-valeur dans le champ Valeur à enregistrer ( Value to save ) : New KeyValuePair(Of String, String)(currentKeyValuePairOfTextAndText.Key, currentKeyValuePairOfTextAndText.Value).
   5. Dans l'activité For Each , ajoutez une activité If pour modifier conditionnellement la paire EUR . Configurez la condition à l'aide de l'objet utilisé pour parcourir la carte de données.
      Dans cet exemple, configurez la condition suivante : currentKeyValuePairOfTextAndText.Key = "EUR"
   6. Dans le corps Then de l'activité If , ajoutez une activité Assign pour mettre à jour la valeur newItem avec la nouvelle valeur souhaitée.
      • Utilisez le champ Enregistrer vers (Save to) pour affecter la variable newItem .
      • Utilisez le champ Valeur à enregistrer ( Value to save ) pour indiquer la nouvelle valeur de la paire : CType(New KeyValuePair(Of String, String)("EUR", "1.19 USD"), KeyValuePair(Of String, String)).
   7. Ajoutez une autre activité Assign pour mapper la nouvelle valeur dans le dictionnaire.
      • Utilisez le champ Enregistrer vers (Save to) pour mettre à jour la paire clé-valeur correspondante dans la variable dataMap2 .
      • Utilisez le champ Valeur à enregistrer ( Value to save ) pour attribuer newItem.Value à dataMap2(newItem.Key).
      
      

      

      
      
   8. À la fin du workflow, ajoutez une activité Définir les valeurs du formulaire ( Set Form Values) pour mettre à jour la carte de données à l’intérieur du formulaire avec les valeurs modifiées.
6. Créez un workflow de déclencheur pour extraire des valeurs de la carte de données au moment de l'exécution.
   Nommez le déclencheur de workflow extractDataTrigger.
   1. Ajoutez une activité de déclencheur de formulaire et définissez l' événement comme bouton utilisé pour l'extraction des données.
      Dans cet exemple, définissez l'événement sur Extract data clicked.
   2. Ajoutez une activité Get Form Values pour extraire les valeurs actuelles de la carte de données au moment de l'exécution. Enregistrez la carte de données dans une variable de dictionnaire.
   3. Utilisez une activité For Each pour parcourir chaque paire clé-valeur dans le mappage de données et les générer dans la console.
      
      

      

      
      

Dans l'image animée ci-dessous, assistez à la mise à jour dynamique des valeurs dans la carte de données en cliquant sur le bouton Update value .

Exemple de workflow

Pour suivre les étapes et essayer le tutoriel vous-même, consultez l'exemple de projet ici.