Data Fabric の操作

Supported query prefixes and output actions for querying and updating Data Fabric records directly from BPMN task expressions in Maestro Orchestrate.

Maestro Orchestrate processes can query and update Data Fabric records directly from BPMN task expressions and output mappings. This page documents the supported query prefixes and output actions.

クエリ プレフィックス

Data Fabric の式のクエリ プレフィックスを使用すると、レコードを内部レコード ID ではなくフィールド値で取得できます。次の 2 つのプレフィックスがサポートされています。

プレフィックス	フル ネーム	戻り値の型	一致がない場合の動作	複数の一致がある場合の動作
qes:	Query Expansion Single	単一のレコード	空の結果を返します。	エラーを返します。
qem:	Query Expansion Multiple	最大 1,000 件のレコードの配列	空の配列を返します。	一致するすべてのレコードを返します。

式の構文

datafabric.EntityName["qes:FieldName=Value"].FieldToRead
datafabric.EntityName["qem:FieldName=Value"]

例 — 単一のレコードの検索

datafabric.LoanApplicationCase["qes:CaseId=HL-999"].LoanAmount

例 — 複数のレコードの検索

datafabric.LoanApplicationCase["qem:Status=Pending"]

各プレフィックスを使用すべき状況

qes: is suited for lookups where exactly one record is expected. When the query matches more than one record, Maestro Orchestrate returns an error and the workflow stops. When no record is found, Maestro Orchestrate returns an empty result and continues execution.

qem: is suited for queries that may return more than one record. Maestro Orchestrate returns an array of up to 1,000 matching records. A process can iterate over the array using a multi-instance marker or a loop, enabling fan-out patterns across multiple Data Fabric records in a single step.

注:

式を qes: から qem: に移行する場合は、下流の変数参照を更新してください。qes: は単一のレコード オブジェクトを返し、qem: は配列を返します。

出力アクション

Data Fabric エンティティを対象とする BPMN タスクの出力では、以下の 3 つのアクションがサポートされます。各アクションでは、一致するレコードが存在するかどうかに応じて、出力で新しいレコードを挿入するか、既存のレコードを変更するか、その両方を行うかが判断されます。

操作	動作	レコードが存在する必要があるかどうか
create	新しいレコードを挿入します。	いいえ
update	レコード ID で識別される既存のレコードを変更します。	はい
upsert	一致が見つからない場合は新しいレコードを挿入します。一致が見つかった場合は既存のレコードを更新します。	いいえ

出力アクションは、タスクの [プロパティ] パネルの [出力] セクションで設定します。[プロパティ] パネルについて詳しくは、「プロパティとデータを設定する」をご覧ください。

関連ページ

• システムとデータを連携する
• Maestro Orchestrate プロセスでファイルを操作する
• 変数と式エディター
• プロパティとデータを設定する