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. In the Entity type section, select the type of entity to create:

   1. Select Native to store the entity's data in UiPath. A Native entity supports create, read, update, and delete operations, and holds only its own fields.
   2. Select Federated to create a read-only view whose fields are read from external systems, or from a native Data Fabric entity, each time the entity is queried. A Federated entity holds no fields of its own.
      Remarque :

      You cannot change the entity type once chosen. For what each type supports, refer to Entity types.

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

   Remarque :

   Role-based record access does not apply to Federated entities, and the toggle is not displayed for them. The records of a Federated entity are held by its source systems.

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 :

    The source types available depend on the entity type. A Native entity offers Local fields only. A Federated entity offers External source and Native source.

    1. To add fields from external systems, such as Salesforce or SAP, select External source. For the systems you can choose from, refer to External systems. After you select an external system from the External system dropdown, a connection is either populated by default in the Connection field, or you need to add a connection manually by selecting Add new connection. If you need to select Add new connection, a new browser tab opens prompting you to provide authentication information to connect UiPath to your selected external system. After the Connection field is populated, select the object from the Object dropdown.

       

    2. To add fields from a native Data Fabric / Data Service entity, select Native source, and then select the entity you want to reference. The entity you reference must be at the same location as the entity you are creating.

       

    3. For a Native entity, to add fields locally stored with UiPath, select Local fields.

    4. Sélectionnez Poursuivre (Proceed).

       Once the object is added, each of its fields can be configured in the editor that opens, including the field type and the settings under Advanced options.

       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. Select Manage joins to connect joins between fields from multiple, different source types. In the Manage joins section, you have to map the fields from two different sources by selecting the Primary object, Primary field, Referenced object, and Referenced field from the dropdowns.

    

13. Sélectionnez Enregistrer.

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

External systems

A Federated entity reads its fields from an external system each time it is queried. The data stays in the system of record, and Data Fabric / Data Service holds only the mapping, so there is no copying step to build and keep current. A field referenced this way behaves like any other field in automations, workflows, Apps, and Maestro.

The following external systems are available for field referencing:

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

To reference fields from another Data Fabric / Data Service entity rather than from an external system, select Native source in the Add object panel.

Queries that read from an external system are subject to a set of limits. For more information, refer to Query limits for external data.

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

With multi-source entity modeling, you can reference fields from multiple external systems, such as Salesforce and ServiceNow, in a single Federated entity.

We recommend a star schema approach when connecting more than one system. All connected systems and external objects should map directly to a core entity, rather than chaining through one another.

To include fields stored in UiPath in the same view, hold them in a native entity and reference it with Native source. The native entity can itself serve as the core that every external object joins to.

Remarque :

The core object is the one that every other source joins to. It can be an external object or a native source.

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