Import des entités

Les entités vous permettent d'utiliser les enregistrements du Data Service UiPath, un service de modélisation et de stockage de données centralisé. Les entités sont disponibles à l'importation dans Studio v2020.8 et versions ultérieures et peuvent être utilisées dans les processus d'automatisation qui collectent, mettent à jour et transmettent des données à d'autres processus. Tous les types de projets peuvent être utilisés pour importer et utiliser de tels objets métier.

Remarque : Un robot moderne doit être créé dans l’instance Orchestrator sur le locataire où le service de données est activé.

Pour importer une entité :

1. Cliquez sur le bouton du ruban Gérer les entités (Manage Entities) pour ouvrir la fenêtre Gérer les entités (Manage Entities) et afficher toutes les entités disponibles. Si aucune entité n'a encore été ajoutée, toutes les entités sont sélectionnées par défaut.

   Vous pouvez également faire glisser une entité depuis le panneau Ressources (Resources) et la déposer sur le panneau Projet (Project). Si aucune entité n'a encore été ajoutée, cela ouvre la fenêtre Gérer les entités (Manage Entities) avec uniquement cette entité sélectionnée.

   
   

   

   
   

2. Sélectionnez l'entité que vous souhaitez importer. Pour rechercher une entité spécifique, utilisez la barre Rechercher des entités et saisissez le nom de l'entité, le nom d'affichage ou la description.

   Vous pouvez survoler les entrées de la colonne Champs (Fields) pour voir tous les champs définis de chaque entité, ou cliquer sur le nombre de champs ou d'enregistrements d'une entité pour accéder à la page correspondante dans Data Service.

3. Entrez un espace de noms pour l'entité importée. L'espace de noms par défaut est le même que le nom du projet. L'espace de noms ne peut être modifié que la première fois que vous importez une entité.

4. Cliquez sur Enregistrer (Save) pour importer l'entité dans votre projet.

   Remarque : Si vous apportez des modifications à l’entité au niveau du locataire, utilisez le bouton Actualiser (Refresh) à l’intérieur de la fenêtre Gérer les entités (Manage Entities) avant de l’importer.

Les entités importées sont visibles dans le panneau Projet (Project) en tant qu’objets faisant partie de votre projet.

Les entités importées peuvent désormais être utilisées localement dans votre projet en tant qu’objets. Si vous souhaitez également effectuer sur elles des opérations CRUD dans le Data Service, vous devez installer le pack UiPath.DataService.Activities.

Après avoir installé le pack UiPath.DataService.Activities, glissez-déposez une entité au-dessus d’un signe Plus dans le panneau Concepteur (Designer) pour utiliser les activités recommandées du pack.

Glissez-déposez une entité du panneau Projet (Project) dans le panneau Variables (Variables) ou Arguments (Arguments) pour créer une variable ou un argument avec le type de l'entité.

Espaces de noms pour les Entités

Après avoir importé une entité dans votre workflow, son espace de noms est également importé. Vous pouvez le trouver lorsque vous recherchez des types sous Assemblies référencés (Referenced assemblies).

Tous les champs faisant partie d’une entité importée sont disponibles en tant que propriétés pour l’espace de noms de l’entité. Ainsi, lorsque vous travaillez avec des entités, le nombre de variables ou d’arguments de gestion des données est réduit.

Dans l’exemple ci-dessous, l’argument est du type défini par l’entité StockPortfolio. Ses propriétés visibles dans le panneau Ressources (Resources) sont les mêmes que les champs définis dans l’entité et disponibles en tant que propriétés pour l’argument.

Consultez la page Utilisation d'entités dans les projets (Using Entities in Projects) pour savoir comment les utiliser.