エンティティを作成する

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. [ エンティティの種類 ] セクションで、作成するエンティティの型を選択します。

   1. [ ネイティブ ] を選択して、エンティティのデータを UiPath に保存します。ネイティブ エンティティは、作成、読み取り、更新、削除の操作をサポートし、専用のフィールドのみを保持します。
   2. [ フェデレーション ] を選択すると、エンティティがクエリされるたびに外部システムまたはネイティブの Data Fabric エンティティからフィールドが読み取られる読み取り専用ビューが作成されます。フェデレーション エンティティは、独自のフィールドを保持しません。
      注:

      エンティティの型を一度選択した場合、変更することはできません。各型がサポートする内容については、「 エンティティの型」をご覧ください。

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

   注:

   ロールベースのレコード アクセスはフェデレーション エンティティには適用されず、トグルは表示されません。フェデレーション エンティティのレコードは、そのソース システムによって保持されます。

8. [場所] セクションで、次の手順を実行します。

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

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

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

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

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

    注:

    利用可能なソースの種類は、エンティティの型によって異なります。ネイティブ エンティティは ローカル フィールド のみを提供します。フェデレーション エンティティは、 外部ソース と ネイティブ ソースを提供します。

    1. Salesforce や SAP などの外部システムからフィールドを追加するには、[ 外部ソース] を選択します。選択できるシステムについては、「 外部システム」をご覧ください。[ 外部システム ] ドロップダウンから外部システムを選択すると、コネクションが既定で [ コネクション] フィールドに入力されるか、[ 新しいコネクションを追加] を選択して手動でコネクションを追加する必要があります。[ 新しい接続を追加] を選択する必要がある場合は、新しいブラウザー タブが開き、選択した外部システムに UiPath を接続するための認証情報を入力するよう求められます。[ 接続 ] フィールドに値が入力されたら、[ オブジェクト ] ドロップダウンからオブジェクトを選択します。

       

    2. ネイティブの Data Fabric/Data Service エンティティからフィールドを追加するには、[ ネイティブ ソース] を選択し、参照するエンティティを選択します。参照するエンティティは、作成するエンティティと同じ場所にある必要があります。

       

    3. ネイティブ エンティティの場合、UiPath でローカルに保存されたフィールドを追加するには、[ ローカル フィールド] を選択します。

    4. [続行] を選択します。

       オブジェクトを追加すると、開いたエディターで各フィールドを設定できます。フィールドの種類や [ 詳細オプション] の設定などがあります。

       注:

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

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

       

12. [ 結合を管理 ] を選択して、複数の異なるソースの種類のフィールド間で結合を接続します。[結合を 管理 ] セクションでは、ドロップダウンから [プライマリ オブジェクト]、[ プライマリ フィールド]、[ 参照されるオブジェクト]、[ 参照されるフィールド ] を選択し、2 つの異なるソースのフィールドをマッピングする必要があります。

    

13. [保存] を選択します。

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

外部システム

フェデレーション エンティティは、クエリが実行されるたびに外部システムからフィールドを読み取ります。データは記録システムに留まり、Data Fabric/Data Service ではマッピングのみが保持されるため、構築して最新の状態に保つためのコピー手順はありません。この方法で参照されるフィールドは、オートメーション、ワークフロー、Apps、Maestro の他のフィールドと同様に動作します。

フィールドの参照には、以下の外部システムが利用可能です。

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

外部システムからではなく別の Data Fabric/Data Service エンティティのフィールドを参照するには、[オブジェクトを追加] パネルで [ネイティブ ソース] を選択します。

外部システムから読み取るクエリには、一連の制限が適用されます。詳しくは、「 外部データのクエリ制限」をご覧ください。

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

マルチソース エンティティ モデリングでは、Salesforce や ServiceNow などの複数の外部システムのフィールドを 1 つのフェデレーション エンティティで参照できます。

複数のシステムを接続する場合は、スター スキーマのアプローチをお勧めします。接続されたすべてのシステムと外部オブジェクトは、互いにチェーンするのではなく、コア エンティティに直接マップする必要があります。

UiPath に格納されたフィールドを同じビューに含めるには、それらのフィールドをネイティブ エンティティ内に保持し、 ネイティブ ソースで参照します。ネイティブ エンティティ自体が、すべての外部オブジェクトが結合するコアとして機能できます。

注:

コア オブジェクトは、他のすべてのソースが結合するオブジェクトです。外部オブジェクトまたはネイティブ ソースのいずれかを指定します。

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