Création d’une entité

Créez une nouvelle entité dans Data Fabric/Data Service, configurez ses champs à partir de sources locales ou externes et définissez son étendue de locataire ou de dossier.

Tous les objets créés dans Data Fabric/Data Service sont appelés Entités.

Remarque :

Vous pouvez également créer et modifier des entités natives directement dans une solution Maestro Flow VS Code, sans quitter votre éditeur. Il s'agit d'une fonctionnalité d'aperçu disponible uniquement dans VS Code. Pour plus d'informations, consultez Entités dans VS Code.

1. Accédez à Data Fabric/Data Service. La page Entités s'ouvre.

2. Sélectionnez Créer une nouvelle entité. Le panneau de création d’entités s’ouvre.

3. Saisissez un Nom d'affichage pour votre entité. Le Nom complet est le nom affiché lorsque vous importez l'entité dans Studio. Ce champ peut être modifié après la création de l'entité.

4. Saisissez un nom pour votre entité. Le nom peut être alphanumérique, mais il doit commencer par une lettre. Il doit comprendre entre trois et 30 caractères. Le champ Nom est automatiquement renseigné avec la même valeur que celle fournie pour le Nom d'affichage. Vous ne pouvez modifier sa valeur que lors du processus de création de l'entité. Une fois l’entité créée, le champ Nom ne peut pas être modifié.

5. Vous pouvez également ajouter une Description pour votre entité.

6. Dans la section Type d'entité , sélectionnez le type d'entité à créer:

   1. Sélectionnez Native pour stocker les données de l'entité dans UiPath. Une entité native prend en charge les opérations de création, de lecture, de mise à jour et de suppression et ne contient que ses propres champs.
   2. Sélectionnez Federated pour créer une vue en lecture seule dont les champs sont lus à partir de systèmes externes ou d'une entité Data Fabric native, chaque fois que l'entité est interrogée. Une entité fédérée ne contient aucun champ lui étant propre.
      Remarque :

      Vous ne pouvez pas modifier le type d’entité une fois choisi. Pour ce que chaque type prend en charge, reportez-vous à Types d’entités.

7. Pour restreindre l’accès aux enregistrements, utilisez le bouton bascule Activer l’accès aux enregistrements en fonction du rôle .

   Remarque :

   L’accès aux enregistrements en fonction du rôle ne s’applique pas aux entités fédérées et la bascule n’est pas affichée pour elles. Les enregistrements d'une entité fédérée sont conservés par ses systèmes sources.

8. Dans la section Emplacement :

   1. Sélectionnez Locataire pour que les données soient disponibles sur l'ensemble du locataire à tous les utilisateurs disposant d'un accès au niveau du locataire.
   2. Sélectionnez Dossier pour que les données soient visibles uniquement par les utilisateurs ayant accès au dossier Orchestrator sélectionné. Si vous sélectionnez Dossier, vous devez sélectionner un dossier Orchestrator cible dans la liste déroulante Sélectionner un dossier . L’entité que vous créez est limitée au dossier que vous sélectionnez.
      Remarque :

      Vous ne pouvez pas modifier l’emplacement de l’entité une fois choisi.

9. Sélectionnez Créer.

10. Pour ajouter manuellement des champs, sélectionnez Ajouter un objet dans l'assistant de création de l'entité.

11. Dans le panneau Ajouter un objet , sélectionnez un type de source.

    Remarque :

    Les types de sources disponibles dépendent du type d'entité. Une entité native propose uniquement des champs locaux . Une entité fédérée propose une source externe et une source native.

    1. Pour ajouter des champs provenant de systèmes externes, tels que Salesforce ou SAP, sélectionnez Source externe. Pour les systèmes que vous pouvez choisir, reportez-vous à Systèmes externes. Après avoir sélectionné un système externe dans la liste déroulante Système externe , une connexion est soit renseignée par défaut dans le champ Connexion , soit vous devez ajouter une connexion manuellement en sélectionnant Ajouter une nouvelle connexion. Si vous devez sélectionner Ajouter une nouvelle connexion, un nouvel onglet de navigateur s’ouvre, vous invitant à fournir des informations d’authentification pour connecter UiPath au système externe sélectionné. Une fois le champ Connexion renseigné, sélectionnez l'objet dans la liste déroulante Objet .

       

    2. Pour ajouter des champs à partir d'une entité Data Fabric/Data Service native, sélectionnez Source native, puis sélectionnez l'entité que vous souhaitez référencer. L'entité que vous référencez doit se trouver au même emplacement que l'entité que vous créez.

       

    3. Pour une entité native, afin d’ajouter des champs stockés localement avec UiPath, sélectionnez Champs locaux.

    4. Sélectionnez Poursuivre (Proceed).

       Une fois l'objet ajouté, chacun de ses champs peut être configuré dans l'éditeur qui s'ouvre, y compris le type de champ et les paramètres sous Options avancées.

       Remarque :

       Le chiffrement des données avec des clés gérées par le client est actuellement pris en charge uniquement pour les champs Texte et Texte multiligne .

       Pour chiffrer les données dans ces champs, cochez la case Chiffrer les données dans le module Options avancées du champ.

       

12. Sélectionnez Gérer les jointures pour connecter les jointures entre les champs provenant de différents types de source. Dans la section Gérer les jointures , vous devez mapper les champs de deux sources différentes en sélectionnant Objet principal, Champ principal, Objet référencé et Champ référencé dans les listes déroulantes.

    

13. Sélectionnez Enregistrer.

La nouvelle entité s'affiche dans la liste Entités (Entities).

Systèmes externes

Une entité fédérée lit ses champs à partir d'un système externe chaque fois qu'elle est interrogée. Les données restent dans le système d’enregistrement et Data Fabric/Data Service détient uniquement le mappage, il n’y a donc pas d’étape de copie pour créer et maintenir à jour. Un champ référencé de cette manière se comporte comme n'importe quel autre champ dans les automatisations, les workflows, Apps et Maestro.

Les systèmes externes suivants sont disponibles pour le référencement des champs:

• Database Hub (Databricks, Oracle DB, PostgreSQL, RedShift et MS SQL Server)
• Microsoft Azure Active Directory
• Salesforce
• SAP
• ServiceNow
• Snowflake

Pour référencer les champs d'une autre entité Data Fabric/Data Service plutôt que d'un système externe, sélectionnez Source native dans le panneau Ajouter un objet .

Les requêtes lues à partir d'un système externe sont soumises à un ensemble de limites. Pour plus d’informations, consultez la section Limites de requête pour les données externes.

Modélisation pour les entités connectées à plusieurs systèmes

Avec la modélisation d'entités multi-sources, vous pouvez référencer les champs de plusieurs systèmes externes, tels que Salesforce et ServiceNow, dans une seule entité fédérée.

Nous recommandons une approche de schéma en étoile lorsque vous connectez plus d’un système. Tous les systèmes connectés et les objets externes doivent être mappés directement à une entité principale plutôt que de s'enchaîner les uns aux autres.

Pour inclure des champs stockés dans UiPath dans la même vue, conservez-les dans une entité native et référencez-la avec la source native. L'entité native peut elle-même servir de cœur auquel chaque objet externe se joint.

Remarque :

L’objet principal est celui auquel toutes les autres sources se connectent. Il peut s'agir d'un objet externe ou d'une source native.

Cette approche de schéma en étoile crée une mise en page claire, comme présenté dans l’exemple suivant :