エンティティを作成する

Data Fabric/Data Service で新しいエンティティを作成し、ローカルまたは外部のソースからフィールドを設定し、テナントまたはフォルダーの範囲を設定します。

Data Fabric/Data Service で作成されたすべてのオブジェクトは、 エンティティと呼ばれます。

注:

また、エディターから移動することなく、ネイティブ エンティティを Maestro Flow VS Code ソリューション内で直接作成および編集することもできます。これはプレビュー機能であり、VS Code でのみ使用できます。詳細については、「 VS Code のエンティティ」を参照してください。

1. [Data Fabric]/[Data Service] に移動します。[エンティティ] ページが開きます。

2. [ 新しいエンティティを作成] を選択します。エンティティの作成パネルが開きます。

3. エンティティの [表示名] を入力します。[表示名] は、Studio にエンティティをインポートしたときに表示される名前です。このフィールドはエンティティの作成後に変更できます。

4. エンティティの [名前 ] を入力します。[名前] には英数字を使用できますが、先頭は文字である必要があります。使用できる文字数は 3 文字から 30 文字です。[名前] フィールドには、[表示名] に指定した値が自動的に入力されます。値は、エンティティの作成プロセス中にのみ変更できます。エンティティの作成後は [ 名前 ] フィールドは編集できなくなります。

5. (任意) エンティティの [説明] を追加します。

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.
      注:

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

7. レコードへのアクセスを制限するには、[ ロールベースのレコード アクセスを有効化 ] トグルを使用します。

   注:

   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. [場所] セクションで、次の手順を実行します。

   1. [ テナント ] を選択すると、テナント レベルのアクセス権を持つすべてのユーザーがテナント全体のデータを利用できるようになります。
   2. [フォルダー] を選択すると、選択した Orchestrator フォルダーへのアクセス権を持つユーザーのみにデータが表示されます。[フォルダー] を選択した場合は、[フォルダーを選択] ドロップダウンから対象の Orchestrator フォルダーを選択する必要があります。作成するエンティティのスコープは、選択したフォルダーに適用されます。
      注:

      一度選択したエンティティの場所は変更できません。

9. [作成] を選択します。

10. フィールドを手動で追加するには、エンティティ作成ウィザードで [ オブジェクトを追加 ] を選択します。

11. [ オブジェクトを追加 ] パネルでソースの種類を選択します。

    注:

    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. [続行] を選択します。

       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.

       注:

       顧客管理のキー (CMK) によるデータ暗号化は現在、 テキスト フィールドと 複数行テキスト フィールドでのみサポートされています。

       これらのフィールドのデータを暗号化するには、フィールドの [詳細オプション] パネルで [データを暗号化] チェックボックスをオンにします。

       

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. [保存] を選択します。

新しいエンティティが [エンティティ] リストに表示されます。

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.

複数のシステムに接続されたエンティティのモデリング

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.

注:

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

このスター スキーマのアプローチでは、次の例に示すように、すっきりとしたレイアウトが作成されます。