ソリューション内のエンティティ

ソリューションの Data Fabric エンティティのライフサイクル。依存関係の自動包含、インストール、アップグレード、アンインストールの管理、およびデバッグ時と実行時のエンティティの上書きに対応します。

Data Fabric エンティティは、 ソリューションにリソースとして含めることができます。ソリューションに属するワークフローでフォルダー レベルのエンティティを使用すると、そのエンティティとその依存関係は、ソリューション ライフサイクルの一部としてパッケージ化、デプロイ、管理されます。

このページでは、モデリングからデプロイ、実行、アップグレード、アンインストールまでの各段階でエンティティがどのように動作するかについて説明します。

エンティティがソリューション リソースになる方法

Data Service アクティビティをソリューション内のワークフローに追加し、フォルダー レベルのエンティティを選択すると、そのエンティティが自動的にソリューション リソースとして登録されます。手動で追加する必要はありません。

依存関係の自動包含

エンティティをソリューション リソースとして追加すると、そのすべての依存関係も含まれます。含まれる依存関係はエンティティの種類によって異なります。

ネイティブ エンティティ

• 関連エンティティ — エンティティ A にエンティティ B を指すリレーションシップ フィールドがある場合、両方のエンティティがソリューション リソースとして追加されます。
• チョイス セット — エンティティでフィールドの種類として使用されるすべてのチョイス セットが含まれます。
• 入れ子になった依存関係 — エンティティ B 自体がエンティティ C を参照している場合、そのエンティティも含まれます。完全な依存関係チェーンは自動的に解決されます。

フェデレーション エンティティ

• コネクション — フェデレーション エンティティで使用される Integration Service のコネクションが含まれます。
• ネイティブ ソース エンティティ — フェデレーション エンティティがネイティブ エンティティをデータ ソースとして参照する場合、そのネイティブ エンティティとその完全な依存関係チェーンが含まれます。

注:

ワークフローで使用されるテナント レベルのエンティティは、自動的にはパッケージ化されません。デプロイされたワークフローが機能するには、ターゲット環境にこれらの要素がすでに存在している必要があります。フォルダー レベルのエンティティのみがソリューション リソースとして含まれます。

サポートされているサーフェス

ソリューションの Data Fabric エンティティは、以下の種類のワークフローでサポートされています。

表面	フォルダー範囲のエンティティ	備考
RPA (Studio Web)	✅	ビルド、デバッグ、デプロイの完全サポート
RPA (デスクトップ版の Studio 26.10 LTS)	✅	ソリューションのコンテキストのみ。クラシック アクティビティには UiPath.DataService.Activities v26.10.0 が必要です
Maestro BPMN	✅
Maestro Case	✅
API ワークフロー	✅
Agents	✅ (プレビュー)
Maestro Flow	ネイティブ エンティティ ノード経由	コネクタ アクティビティではなく、組み込みノードを使用します
Coded Apps	✅
コーディング エージェント	✅
スタンドアロンの VB Apps	❌
RPA (UB) Apps	❌

注:

Data Service コネクタ アクティビティを介したフォルダー範囲のエンティティでは、ローカル ワークスペースはサポートされません。フォルダー範囲は、クラウド ワークスペースでのみ利用できます。

ライフ サイクル

1. エンティティを作成およびモデル化する

Data Fabric の UI でフォルダー レベルのエンティティを作成します。[ 場所 ] を [ フォルダー ] に設定し、対象の Orchestrator フォルダーを選択します。ネイティブ エンティティとフェデレーション エンティティの両方を作成できます。必要に応じて、フィールド、リレーションシップ、チョイス セットを追加します。

リレーションシップのスコープ ルールについては、「 リレーションシップを作成する」をご覧ください。フェデレーション エンティティの設定については、「 仮想エンティティ」をご覧ください。

2. ワークフローを構築する

Studio Web またはデスクトップ版の Studio (26.10 LTS) で、Data Service アクティビティをワークフローに追加します。各アクティビティには スコープ セレクター があります。フォルダーで限定されたエンティティを扱うには 、[フォルダー ] を選択します。

クラシック アクティビティのフォルダー スコープには、一般提供されている UiPath.DataService.Activities v26.10.0 以降が必要です。詳しくは、「 クラシック アクティビティ」をご覧ください。

自分がアクセス権を持つフォルダーのエンティティのみが表示されます。

3. デバッグ

ソリューション内のワークフローをデバッグすると、[ デバッグ設定] ウィンドウ にエンティティを含むすべてのソリューション リソースが表示されます。

各エンティティについて、次のことが可能です。

• 既存のエンティティを使用 — デバッグは、現在のフォルダー内のエンティティに対して実行されます。
• 別のエンティティで上書き — 互換性のあるエンティティを別のフォルダーから選択します。
• 選択項目を削除 — 新しいエンティティが、その依存関係とともに個人用ワークスペースのデバッグ フォルダーに作成されます。

オーバーライドは、アクティビティから直接参照されるエンティティでのみ使用できます。関連エンティティ (たとえば、エンティティ A がリレーションシップ フィールドを通じて参照するエンティティ B) は、[ プラットフォームのリソース] から直接参照する個別のアクティビティを追加しない限り、上書きできません。

注:

オーバーライドするときは、置換エンティティのスキーマが対応していることを確認してください。リレーションシップが一致していないか、フィールドが欠落していると、実行中にエラーが発生する可能性があります。

4. パブリッシュ

Studio Web またはデスクトップ版の Studio からソリューションをパブリッシュします。パッケージには、ワークフロー、エンティティ スキーマ、チョイス セット、リレーションシップが含まれています。スキーマのみがパッケージ化され、データは含まれません。

5. デプロイ (インストール)

Orchestrator または Studio Web からターゲット フォルダーにパッケージをデプロイします。

デプロイ中:

• フォルダー レベルのエンティティは、ターゲット フォルダーに自動的に作成されます。
• チョイス セットとリレーションシップが再作成されます。
• ワークフローは、新たに作成されたエンティティにバインドされます。

スキーマのみが作成されます。既存のデータはコピーされません。各環境で独自のデータが保持されます。

重要:

デプロイ時のインライン エンティティ作成はサポートされていません。エンティティは、ソリューション パッケージで定義されたスキーマから作成されます。ソリューションの外部でエンティティを作成する必要がある場合は、Data Fabric の UI を使用します。

6. 実行 (ランタイム)

デプロイ後、Orchestrator からワークフローを実行します。オートメーションは、開発時とまったく同じように、ターゲット フォルダー内のエンティティを操作します。

[パッケージ要件] によるランタイムの上書き

ソリューションのデプロイ後、ワークフローで使用するエンティティを再パブリッシュせずに変更できます。デプロイされたプロセスに移動し、[ パッケージ要件 ] タブを開きます。エンティティを、同じフォルダーまたは別のフォルダーにある別の互換性のあるエンティティに置き換えます。

置換エンティティには、対応するスキーマが必要です。ワークフローは、上書きされたエンティティを使用して実行されますが、すべてのロジックは変更されません。

上書き対象として [パッケージ要件] には、アクティビティから直接参照されたエンティティのみが表示されます。

注:

デプロイ時の上書きはサポートされていません。エンティティの上書きは、デバッグ時および実行時に [パッケージ要件] で使用できます。

7. アップグレード

エンティティ スキーマを変更した場合 (新しいフィールドの追加など)、ソリューションを再パブリッシュし、Orchestrator でデプロイをアップグレードします。

アップグレード時:

• ターゲット フォルダーのエンティティ スキーマが新しいバージョンと一致するように更新されます。
• 既存のデータは保持され、レコードは削除または上書きされません。
• 新しいフィールドがスキーマに追加されます。削除されたフィールドはスキーマから削除されますが、基になるデータは保持されます。
• エンティティにすでにデータが含まれている場合は、アップグレードを確定する前に、適用された変更を確認できます。
• スキーマの変更に対応しない場合 (フィールドの種類の変更など)、アップグレードでは競合が表示されます。アップグレードをリトライする前に、Data Fabric UI に移動し、ソース エンティティ スキーマと貼り付け先エンティティ スキーマの競合を確認して解決してください。

8. アンインストール

ソリューションをアンインストールすると、ワークフローと関連するリソースがターゲット フォルダーから削除されます。

アンインストール中のエンティティの動作は、エンティティにデータが含まれているかどうかによって異なります。

• データのないエンティティ — チョイス セットおよび関係とともに削除されます。
• データを含むエンティティ — 偶発的なデータ損失を防ぐために保持されます。エンティティはフォルダー内に残り、フォルダーが削除されない限り、Data Fabric の UI で直接管理できます。

ライフサイクル動作の概要

操作	エンティティ スキーマ	エンティティ データ	チョイス セット	リレーションシップ
インストール	ターゲット フォルダーに作成	未コピー — 空で開始します。	再作成	再作成
アップグレード	新しいバージョンに合わせて更新されました	保持	更新日	更新日
アンインストール (データなし)	Removed	N/A	Removed	Removed
アンインストール (データあり)	保持	保持	保持	保持

スキーマの更新

アクティビティでエンティティ スキーマを選択した後に Data Fabric で変更された場合は、Studio Web のエンティティ セレクターの横にある [ 更新 ] ボタンを使用します。[更新] ボタンを選択すると、選択したエンティティとそのすべての関連エンティティのスキーマが 1 回の操作で更新されます。

• コネクタ アクティビティ (Data Fabric コネクタ) — [更新] ボタンは常に有効化されています。新しく追加または削除されたフィールドを表示するには、まずエンティティのソリューション リソースを開いて [ 設定を更新] を選択してから、アクティビティに戻って [ スキーマを更新] を選択します。
• レガシ アクティビティ (Data Service クラシック パッケージ) — ネイティブ エンティティの場合、[更新] ボタンは、選択したエンティティでスキーマの変更が検出された場合にのみ有効化されます。これを選択すると、スキーマが直接更新されます。これらのアクティビティでは、フェデレーション エンティティのスキーマの更新はサポートされていません。

複数のスコープにわたってエンティティを複製する

エクスポートとインポートを使用して、あるスコープから別のスコープにエンティティ スキーマをコピーできます。たとえば、フォルダーでテナント レベルのエンティティのデザインを使用するには、Data Fabric UI でテナント レベルからスキーマをエクスポートします。これにより、テナント レベルのすべてのネイティブ エンティティ スキーマが一度にエクスポートされます。次に、そのファイルをターゲット フォルダー レベルでインポートし、エクスポートしたエンティティとチョイス セットのうち、どのエンティティとチョイス セットをフォルダーに取り込むかを選択します。

選択したエンティティは、ターゲット フォルダーに同じスキーマで作成されます。データはコピーされません。エクスポートとインポートの詳細な手順については、「 スキーマのエクスポートとインポート」をご覧ください。

既知の制限事項

ソリューションのフォルダー レベルのエンティティには、デプロイ時の上書き、クロススコープのリレーションシップ、エンティティの命名、サポートされていないサーフェスに関する制限があります。完全なリストについては、「 既知の制限事項」をご覧ください。