Grille de données

Ce tutoriel fournit des instructions étape par étape sur la façon de créer et d'utiliser un composant Data Grid. Vous apprendrez à transmettre des données dans la grille de données, à les mettre à jour en temps réel et à extraire les informations. Le tutoriel utilise un fichier CSV pour la saisie des données dans la grille de données.

Cette automatisation utilise un enregistrement CSV des étudiants et de leurs résultats d'examen et l'affiche dans un formulaire, où vous pouvez mettre à jour les résultats de l'examen et leur statut correspondant (« réussi » ou « échec ») en temps réel. De plus, l'automatisation vous permet de déclencher l'extraction de l'enregistrement et de la sortir dans la console.

1. Créez un nouveau formulaire. Pour cet exemple, nommez-le DataGrid.
   1. Ajoutez un composant Data Grid à l'intérieur du formulaire.
   2. Ajoutez les composants correspondants pour chaque colonne du fichier CSV que vous souhaitez transmettre dans le formulaire.
      Pour cet exemple, ajoutez un champ de texte (fullName), une case à cocher (seniorYear) et une liste déroulante (examResults).
      
      

      

      
      
      Remarque : Notez que les noms de propriété des composants sont sensibles à la casse et doivent correspondre précisément aux noms de colonne du fichier CSV, ainsi qu'aux noms de colonne des tables de données.
   3. En outre, ajoutez un champ de texte supplémentaire à l'intérieur de la grille de données nommé Statut. Sera utilisé pour les mises à jour du formulaire.
   4. Ajoutez un bouton en dehors de la grille de données. Ce bouton déclenchera l'extraction de la grille de données.
   
   

   

   
   
2. Dans le workflow principal , ajoutez et configurez les activités suivantes :
   1. Lire CSV (Read CSV) : saisissez le fichier CSV contenant les données de la grille de données. Créez une variable DataTable pour stocker le fichier CSV de sortie.
      Pour cet exemple, nommez-le dataGridDataTable.
   2. Revenez à votre formulaire et définissez le nom de propriété du composant Data Grid comme la variable DataTable que vous avez créée à la sous-étape a, où vous stockez le fichier CSV de sortie. Pour cet exemple, définissez le nom de la propriété sur dataGridDataTable.
   3. Afficher le formulaire (Show Form) - Sélectionnez le formulaire DataGrid et transmettez les données de la DataTable à la Data Grid.
   4. Dans le dictionnaire Arguments , ajoutez une entrée pour l'argument dataGrid avec le type System.Data.DataTable et la direction In et définissez la valeur sur dataGridDataTable.

      Clé (Key)	Saisie de texte	Direction	Valeur (Value)
      dataGrid (le nom de la propriété de la grille de données)	System.Data.DataTable	In	dataGridTable

   5. Exécuter les déclencheurs locaux (Run Local Triggers ) : activez tous les déclencheurs à l'intérieur du projet.
3. Créez un workflow de déclencheur nommé fieldChangedTrigger, responsable de la définition du statut d'un étudiant comme échec ou réussite, en fonction de son résultat à l'examen.
   1. Ajoutez une activité de déclencheur de formulaireet définissez l'événement lorsque le champ examResults change.
   2. Ajoutez une activité Créer une table de données (Build Data Table ) pour créer une DataTable dans laquelle les valeurs DataGrid seront stockées lorsque le déclencheur se déclenchera.
      Nommez la variable de sortie comme suit : editedDataTable.
   3. Ajoutez une activité Obtenir les valeurs de formulaire ( Get Form Values) pour récupérer la grille de données dans la table de données que vous avez créée à la sous-étape b (editedDataTable).
   4. Ajoutez une activité For Each Row pour parcourir chaque résultat d'examen et définir le champ Status en conséquence. Saisissez la table de données que vous avez créée à la sous-étape b (editedDataTable) dans le champ Table de données (Data Table ).
   5. Dans le corps de l' activité For Each Row, ajoutez une activité If et définissez la condition sur CurrentRow("examResults").ToString="f".
      Notez que les valeurs sont sensibles à la casse. C'est la raison pour laquelle nous avons utilisé un « f » minuscule à l'intérieur de la condition, au lieu d'un « F » majuscule.

      
      

      

      
      
   6. Dans le corps Alors (Then), ajoutez une activité Attribuer (Assign) pour attribuer le statut de l'élève comme « Échec » lorsque le résultat de son examen est F.

      Enregistrer dans	Valeur à enregistrer
      CurrentRow("status")	"failed"

   7. Dans le corps Sinon ( Else ), ajoutez à nouveau une activité Affecter (Assign), cette fois pour la situation où le statut d'un étudiant est « Réussite », car le résultat de l'examen n'est pas F.

      Enregistrer dans	Valeur à enregistrer
      CurrentRow("status")	"passed"

   8. En dehors de l'activité For Each Row , ajoutez une activité Set Form Values pour renvoyer la grille de données mise à jour dans le formulaire. Dans le champ Clé , utilisez dataGrid avec le Type System.Data.DataTable et définissez la valeur sur editedDataTable.

      Clé (Key)	Saisie de texte	Valeur (Value)
      dataGrid	System.Data.DataTable	editedDataTable

4. Créez un workflow de déclencheur nommé extract Clicked(Extract Clicked), responsable de l'extraction du DataGrid et de sa sortie sous forme de String au format CSV.
   1. Ajoutez une activité de déclencheur de formulaire et définissez l'événement lorsque le bouton extract est cliqué.
   2. Ajoutez une activité Get Form Values pour extraire la grille de données dans une DataTable. Ajoutez une entrée dans le dictionnaire Arguments pour dataGrid avec le Type System.Data.DataTable et définissez la Valeur sur output.

      dataGrid	System.Data.DataTable	output

   3. Ajoutez une activité Output Data Table pour générer la grille de données extraite sous forme de chaîne au format CSV. Dans le champ Table de données (Data Table ), saisissez la variable que vous avez utilisée pour extraire la grille de données à la sous-étape b (output). Saisissez une variable String que vous enregistrerez dans la console de sortie dans le champ Texte (Text)
   4. Ajoutez une activité Log Message pour générer la grille de données extraite.
   5. Ajoutez une activité Arrêter les déclencheurs locaux (Stop Local Triggers ) pour fermer le formulaire et arrêter l'exécution, en supposant que vous ne voulez pas interagir avec le formulaire après l'avoir extrait.

L'image ci-dessous montre le résultat de la mise à jour des données alors que le formulaire est toujours affiché.

Exemple de workflow

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