- Démarrage
- Licences
- Paramétrage et configuration
- Utilisation de Data Service
- Référence (Reference)
- Exemples et tutoriels
![](https://docs.uipath.com/_next/static/media/grid.05ebd128.png?w=3840&%3Bq=100)
Utilisation d’entités dans les projets
En utilisant les entités créées dans Data Service, vous pouvez gérer et manipuler les données agrégées dans un seul objet, sans avoir à intervenir dans les détails. Pour ce faire, vous avez besoin de Studio v2020.8 ou d'une version ultérieure.
L'exemple suivant récupère des données sur les Jeux olympiques et les médailles des 10 premiers pays pour chaque catégorie de jeux, ainsi que les médailles qu'ils ont remportées.
En suivant les étapes détaillées sur la page Créer une entité ( Creating an Entity ), nous avons créé une entité pour stocker des informations sur les nations participantes, les dates d'ouverture et de clôture et les médailles qu'elles ont remportées.
L'entité Jeux olympiques (Olympics) comporte les champs suivants : Nom (Name), Nations (Nations), Dates d'ouverture (Opening) et Dates de clôture (Closing Dates). L'entité Médailles (Medals) comporte les cshamps suivants : Pays (Country), Or (Gold), Argent (Silver), Bronze (Brone) et le nombre total de médailles. Les deux entités sont liées l'une à l'autre par la balise Relationship (Relation).
Importez l'entité dans votre workflow dans Studio.
Le workflow suivant récupère les informations d'une édition des Jeux olympiques, mappe les données aux arguments et les transmet au workflow principal.
Pour ce faire, nous avons défini un argument pour chaque type d'informations que nous collectons, résultant ainsi en 5 arguments importés.
Avec les entités, nous n'avons besoin que d'importer et d'utiliser deux arguments pour effectuer la collecte des données.
inOlympics Year
et outOlympics
ainsi que leurs propriétés respectives, les mêmes que les champs définis dans l'entité. En utilisant des entités, nous réduisons le nombre d'arguments requis pour transmettre des informations en mappant correctement les données à leurs champs d'entité respectifs.
Une fois les données collectées, vous pouvez utiliser l'activité Créer un enregistrement d'entité ( Create Entity Record ) pour ajouter les informations à Data Service.
Dans cet exemple, nous avons utilisé les arguments importés pour transmettre les informations collectées à Data Service. Les enregistrements d' entrée ( Input ) et de sortie ( Output ) sont les valeurs des variables de type Jeux olympiques ( Olympics ) utilisées pour transmettre les données.
Après avoir exécuté le projet, l'enregistrement suivant est créé dans Data Service :
Les enregistrements structurés dans une table de données peuvent être transmis à Data Service à l'aide de l'activité Pour chaque ligne ( For Each Row) . Dans cet exemple, nous invoquons un workflow qui collecte des données structurées sur le nombre de médailles remportées par chaque pays et transmet ces enregistrements à Data Service.
Après avoir exécuté le workflow, les données suivantes sont stockées dans Data Service :
La relation établie entre les entités Jeux olympiques (Olympics) et Médailles (Medals) nous permet d'utiliser l'enregistrement de données de l'une dans l'autre. Par exemple, la valeur du champ Jeux olympiques (Olympics) dans l'entité Médailles (Medals) est la même que dans l'entité associée.
L'activité Rechercher des enregistrements d’entités ( Query Entity Records ) peut être utilisée pour extraire une liste d'enregistrements à partir de Data Service. Dans l'exemple suivant, nous utilisons l'activité pour interroger les enregistrements de données de l'entité Jeux olympiques (Olympics) afin de permettre à l'utilisateur de choisir une édition des Jeux olympiques et, à partir de l'entité Médailles (Medals), d'écrire le nombre de médailles remportées par chaque pays participant.
Name != NULL
du Générateur de requêtes (Query Builder). Elle parcourt tous les enregistrements de la colonne Nom (Name) et les génère dans la variable listOlympics
à utiliser dans l'activité Boîte de dialogue (Input Dialog).
listOlympics.Select(Function (o as Olympics) o.Name).ToArray
dans l'activité Boîte de dialogue (Input Dialog). Autrement, il est possible d'utiliser l'activité Pour chaque (For Each).
selectedOlympics
et utilisée dans une autre activité Rechercher des enregistrements d’entités (Query Entity Records) pour parcourir la liste des médailles remportées lors de cette édition. Cette condition a été définie à l'aide de l'option equals
dans le Générateur de requêtes (Query Builder).
La requête peut être effectuée sur l'entité sélectionnée ainsi que sur les enregistrements d'entités associés.
Les services de données peuvent stocker un grand nombre d'enregistrements. Pour interroger uniquement un nombre fixe d'enregistrements, utilisez les propriétés de pagination de l'activité Rechercher des enregistrements d’entités (Query Entity Records). La propriété Haut (Top) prend en charge un nombre maximum de 1 000, ce qui signifie que 1 000 enregistrements peuvent être interrogés à la fois.
Cet exemple interroge les cinq premiers enregistrements, puis les cinq enregistrements suivants jusqu'à ce que les derniers enregistrements de la liste soient récupérés.
skip
Int64 a reçu la valeur initiale de 0
, puis sa valeur a été incrémentée après chaque boucle jusqu'à ce que le dernier enregistrement soit récupéré.
Une fois les cinq premières médailles récupérées, l'activité Pour chaque (For Each) est utilisée pour écrire les pays participants et le nombre de médailles qu'ils ont remportées dans le fichier Bloc-notes.
Le scénario suivant explique les étapes de mise à jour d'un enregistrement d'entité dans Data Service, puis de synchronisation des données avec Studio.
Dans Data Service, accédez à l'entité Médailles (Medals), cliquez sur Créer un nouveau champ ( Create New Field) et ajoutez une nouvelle colonne HostCountry de type Oui/Non (Yes/No). Cliquez sur Enregistrer ( Save).
Dans Studio, cliquez sur Gérer les entités (Manage Entities), puis sur le bouton Actualiser (Refresh). Un changement a été détecté pour l'entité Médailles (Medals), comme illustré dans la colonne Modifications (Changes). Cliquez sur Enregistrer (Save) pour mettre l'entité à jour dans Studio.
L'activité Mettre à jour un enregistrement d’entité ( Update Entity Record ) peut être utilisée pour mettre à jour les enregistrements de votre workflow directement dans Data Service.
Dans cet exemple, nous interrogeons certains enregistrements de l'entité Médailles (Medals) et les mettons à jour automatiquement à l'aide de l'activité susmentionnée.
Dans l'entité Médailles (Medals), le nom du pays d'accueil de chaque édition est marqué d'un astérisque. Par exemple, pour l'édition 2012, le pays hôte enregistré est la Grande-Bretagne (GBR)* dans la colonne Jeux olympiques (Olympics).
listMedals
et utilisons l'activité Pour chaque (For Each) pour parcourir chaque élément et ensuite attribuer la valeur Vrai (True) dans la colonne HostCountry. au pays qui a accueilli une édition.
L'activité Mettre à jour un enregistrement d'entité ( Update Entity Record ) peut être utilisée dans de nombreux autres scénarios pour transmettre des données et mettre à jour des enregistrements dans Data Service.