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 . 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 du composant.

      Dans cet exemple, utilisez dataMap comme Nom de la propriété.

   2. Ajoutez un composant Bouton pour extraire les données dans le composant. Définissez l' Action du bouton sur Événement.

      Nommez le bouton Extract data.

   3. Ajoutez un autre composant Bouton pour modifier les données du 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 avec l'exécution Continuer du workflow 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 de votre formulaire.

4. Ajoutez une activité Exécuter les déclencheurs locaux 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 du runtime. 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é 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é Pour chaque pour parcourir chaque paire clé-valeur et les mettre à jour avec une valeur spécifique.

   4. Dans l'activité Pour chaque , ajoutez une activité Attribuer 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 .
      • Spécifiez la nouvelle paire clé-valeur à l'aide du champ Valeur à enregistrer : New KeyValuePair(Of String, String)(currentKeyValuePairOfTextAndText.Key, currentKeyValuePairOfTextAndText.Value).

   5. Dans l'activité For Each , ajoutez une activité If pour modifier de manière conditionnelle 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 Puis de l'activité Si , ajoutez une activité Affecter pour mettre à jour la valeur newItem avec la nouvelle valeur souhaitée.

      • Utilisez le champ Enregistrer dans pour attribuer la variable newItem .
      • Utilisez le champ Valeur à enregistrer 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é Attribuer pour mapper la nouvelle valeur dans le dictionnaire.

      • Utilisez le champ Enregistrer dans pour mettre à jour la paire clé-valeur correspondante dans la variable dataMap2 .
      • Utilisez le champ Valeur à enregistrer pour affecter newItem.Value à dataMap2(newItem.Key).

      

   8. À la fin du workflow, ajoutez une activité Définir les valeurs du formulaire 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 du runtime. Nommez le déclencheur de workflow extractDataTrigger.

   1. Ajoutez une activité 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 en tant que variable de dictionnaire.

   3. Utilisez une activité Pour chaque pour parcourir chaque paire clé-valeur dans la carte 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 vous-même le tutoriel, consultez l'exemple de projet ici.