Studio でフォルダー レベルのエンティティを使用する

Studio Web およびデスクトップ版の Studio のフォルダー レベルの Data Fabric エンティティで、ソリューション内にワークフローを構築します。

フォルダー レベルの Data Fabric エンティティは、ソリューション内で作業する場合、Studio Web およびデスクトップ版の Studio (26.10 LTS) で使用できます。クラシック アクティビティの場合、フォルダー スコープを使用するには UiPath.DataService.Activities v26.10.0 以降が必要です。このページでは、Studio 環境でエンティティを選択して設定する方法について説明します。ライフサイクル全体 (パッケージ化、デプロイ、上書き、アップグレード、アンインストール) については、「 ソリューションのエンティティ」をご覧ください。

エンティティ スコープを選択する

各 Data Service アクティビティには、 スコープ セレクターが含まれています。スコープによって、利用可能なエンティティが決まります。

• テナント — テナント全体で利用可能なエンティティが表示されます。
• フォルダー — 自分がアクセス権を持つすべての Orchestrator フォルダーのツリーと、各フォルダー内のエンティティが表示されます。

注:

フォルダー スコープは、どのサーフェスのローカル ワークスペースでも利用できません。クラウド ワークスペースでのみ使用できます。

スキーマの更新

エンティティ セレクターの横に [更新 ] ボタンがあります。[ 更新 ] を選択すると、選択したエンティティとそのすべての関連エンティティ (子エンティティ) のスキーマが 1 回の操作で更新されます。

[更新] ボタンの動作は、アクティビティの種類によって次のように異なります。

• コネクタ アクティビティ (Data Fabric コネクタ) — [更新] ボタンは常に有効化されています。スキーマの変更後に新しく追加または削除されたフィールドを表示するには、以下の手順を実行します。
  1. エンティティのソリューション リソースを開き、[ 設定を更新 ] を選択して、最新のスキーマをソリューションにプルします。
  2. アクティビティに戻り、[ スキーマを更新 ] を選択して、更新されたフィールドを読み込みます。
• クラシック アクティビティ (Data Service クラシック パッケージ) — [更新] ボタンは、選択したエンティティでスキーマの変更が検出された場合にのみ有効になります。これを選択すると、スキーマが直接更新されます。

リソースの自動インクルージョン

ソリューション内の Data Service アクティビティでフォルダー レベルのエンティティを使用すると、そのエンティティがソリューション リソースとして自動的に追加されます。すべての依存関係 (関連するエンティティ、チョイス セット、およびそれらを入れ子にした依存関係) が自動的に含まれます。手動で追加する必要はありません。

Studio Web

• フォルダー スコープのエンティティを扱うには、アクティビティの [ フォルダー スコープ] を選択します。
• ワークフローで使用されるフォルダー レベルのエンティティは、ソリューションに自動的に追加されます。
• デバッグ時に、エンティティのバインドを上書きしたり、既存のエンティティを使用したり、個人用ワークスペース内に新しいエンティティを作成したりできます。

デスクトップ版の Studio

デスクトップ版の Studio 26.10 LTS では、ソリューションを使用する際にフォルダー レベルのエンティティがサポートされます。同じスコープ セレクターを使用して、テナント エンティティとフォルダー エンティティのいずれかを選択します。これには、 UiPath.DataService.Activities v26.10.0 以降が必要です。

注:

デスクトップ版の Studio のサポートは、ソリューションのコンテキストで使用されるフォルダー レベルのエンティティに適用されます。

デバッグとランタイムの上書き

エンティティの上書きは、次の 2 つの段階で利用可能です。

デバッグ中 — [ デバッグ設定] ウィンドウで、既存のエンティティを保持するか、別のフォルダーの対応するエンティティに置き換えるか、選択項目を削除して個人用ワークスペース内に新しいエンティティを作成できます。

実行時 — デプロイ後、再パブリッシュすることなく、[ パッケージ要件 ] を使用して Orchestrator でエンティティのバインドを変更します。

デプロイ時の上書きはサポートされていません。

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

注:

• 上書きにより、異なるフォルダーから互換性のあるエンティティにマッピングできます。テナント間のマッピングはサポートされていません。
• 不一致エラーを回避するため、置換エンティティで互換性のあるスキーマ関係が維持されていることを確認します。

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

表面	フォルダー範囲のエンティティ
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	❌
ローカル ワークスペース	❌