Travailler avec la source de données et la liaison de valeur (Work with Data Source ans Value Bind)

Informations d'arrière-plan

Les champs Source de données (Data Source) et Liaison de valeur (Value Bind) d'une commande sont liés dans les deux sens, ce qui signifie qu'ils peuvent tous deux mettre à jour les données racine liées à cette commande.

Pour mieux comprendre cela, nous pouvons utiliser un exemple simple. Vous pouvez essayer d'ajouter une étiquette et une zone de texte à une application, puis créer une variable d'application. Attribuez la propriété Liaison de valeur (Value binding) de la commande de zone de texte et la propriété Texte (Texte) de la commande de libellé à la variable. Lors de la prévisualisation de l'application, notez que lorsque vous modifiez la valeur de votre zone de texte, la variable d'application est également mise à jour. D'autre part, la propriété Texte (Text) est un champ lié à sens unique, affichant uniquement les données qui ne peuvent pas être mises à jour.

Exemple

Dans cet exemple, nous allons créer une application dans laquelle l'utilisateur peut sélectionner plusieurs éléments dans une liste personnalisée issue d'un processus.

Pour cet exemple, nous allons construire ce qui suit :

• Un processus d'automatisation
• Une application utilisant UiPath Apps

Construire le workflow

La première étape de cet exemple consiste à créer le workflow dans UiPath Studio. Il s'agit d'un workflow simple, composé de quelques arguments.

1. Ouvrez Studio et démarrez un nouveau Processus (Process).

2. Créez les arguments suivants :

   Argument name	Direction	Types d'arguments	Valeur par défaut
   out_DataTable	Sortie	DataTable	-
   in_SelectedItems	dans	DataTable	new DataDable
   filtered_SelectedItems	Sortie	DataTable	-

3. Faites glisser une Séquence vers le concepteur de workflow (Workflow Designer).

4. Ajoutez une activité Créer une table de données (Build Data Table) dans le conteneur Sequence.

   • Ajoutez l'argument out_DataTable dans le champ TableDonnées.
   • Ajoutez une colonne nommée Sélectionnée (Selected).

   • Configurez la table comme dans la figure ci-dessous.

     
     

     

     
     

5. Ajoutez une activité Si (If) sous l'activité Créer une table de données (Build Data Table) et suivez les étapes ci-dessous pour la configurer.

   • Ajoutez in_SelectedItems.Rows.Count > 0 dans le champ Condition.

   • Configurez Then (Then) et Else (Else) comme indiqué ci-dessous.

     Then

     1. Faites glisser une Séquence dans le conteneur Puis (Then).

     2. Ajoutez une activité Attribuer (Assign) dans le conteneur Sequence.

     - Ajoutez filtered_SelectedItems dans le champ À .

     - Add (from r In in_SelectedItems.Select() Where r("Selected").Equals(true) Select r).CopyToDataTable dans le champ Value (Valeur).

     3. Ajoutez une activité Message du journal (Log Message) sous l'activité Attribuer (Assign).
     - Définissez NiveauJournalisation (LogLevel) sur Info.
     - Ajoutez filtered_SelectedItems.ToString dans le champ Message .

     Else

     1. Faites glisser une Séquence dans le conteneur Sinon (Else).

     2. Ajoutez une activité Message du journal (Log Message) sous l'activité Attribuer (Assign).

     - Définissez NiveauJournalisation (LogLevel) sur Info.
     - Ajoutez "First run or empty" dans le champ Message .

Résultat

Au final, le workflow devrait ressembler à celui de la figure ci-dessous.

Important :

Si votre processus utilise un objet .NET complexe dans son entrée ou sa sortie (par exemple, DataTable), App Studio ne saura pas quels sont les champs de cet objet par défaut. Vous pouvez le spécifier de deux manières :

• Exécutez votre processus avant de l'ajouter à votre application. Si un processus utilise un objet, Apps vérifie son historique des tâches pour détecter automatiquement le schéma/les champs de cet objet.
• Spécifiez manuellement les champs d'objet des entrées/sorties de processus. Si votre processus n'a pas d'historique de travail, une fois qu'il a été ajouté à votre application, vous devez spécifier manuellement ses champs afin de les utiliser dans votre application.

Les paramètres ajoutés manuellement à un processus seront supprimés si le processus est actualisé.

Développer votre application

Après avoir publié la génération du workflow lors de la procédure Créer le workflow (Générer le workflow) sur votre Orchestrator, il est temps de créer l'application elle-même.

1. Créer une nouvelle application
2. Référencez le processus construit ci-dessus.
3. Ajoutez une commande Liste personnalisée (Custom List) et une commande Table à votre application, l'un à côté de l'autre.
4. Dans le champ Source de données (Data source) de la table, ajoutez Out: out_DataTable à partir du processus.
   
   

   

   
   
5. Ajoutez une commande Case à cocher (Checkbox) et une commande Zone de texte (Textbox) à la liste personnalisée et configurez-les comme suit :
   • Ajoutez l'élément Out: Item de la section Out: out_DataTable du processus dans le champ Libellé (Label) de la commande de case à cocher.
   • Ajoutez l'élément Out: Selected de la section Out: out_DataTable du processus dans le champ Liaison de valeur (Value binding) de la commande de case à cocher.
   • Ajoutez l'élément Out: Quantity de la section Out: out_DataTable du processus dans le champ Liaison de valeur (Value binding) de la commande de zone de texte.
6. Ajoutez une commande Bouton (Button) et nommez-le Run. Configurez la règle Cliqué (Clicked on) comme suit :
   • Ajoutez une règle Déclencher le processus (Start Process).
   • Ajoutez un nom dans le champ Nom de tâche (Job name) et marquez-le comme Assisté (Attended).
   • Ajoutez in_SelectedItems et Out.out_DataTable dans le champ Remplacement d'entrée (Input Override).
     
     

     

     
     
7. Ajoutez un conteneur sous le bouton.
8. Ajoutez deux commandes Libellé (Label) l'une à côté de l'autre.
   • Ajoutez l'élément filtered_SelectedItems.Item de la section Out: filtered_SelectedItems du processus dans le champ Libellé (Label) de la commande de case à cocher.
     • Ajoutez l'élément filtered_SelectedItems.Quantity de la section Out: filtered_SelectedItems du processus dans le champ Libellé (Label) de la commande de case à cocher.

Conclusions

Lors de la prévisualisation de l'application, vous pourrez sélectionner des éléments dans une liste personnalisée issue d'un processus.

La clé de cet exemple est de mieux comprendre la différence entre Source de données, Liaison de valeur et Entrée :

• La source de données et la liaison de valeur sont liées dans les deux sens. Cela signifie qu'ils peuvent tous les deux mettre à jour les données racine liées à une commande.
• Le remplacement d'entrée vous permet de transmettre des objets provenant d'autres sources, telles qu'une table de données d'un processus ou une entité de Data Service.