変数と式エディター

[プロパティ] パネルの入力フィールドの横にある調整セレクターを使用して、テキスト、変数、式を切り替えます。

モード	使用すべき状況
変数	既存の変数値または要素出力値を参照する必要がある
式エディター	複雑なロジック (JavaScript) を記述する必要がある
JSON エディター	入力または出力が構造化された JSON ペイロードである
日付/時刻の選択	特定の日付または時刻の値を定義する必要がある
Data Fabric	Data Fabric エンティティのプロパティを参照する必要がある

テキスト ビルダーを使用して、自由形式のテキストを入力します。

変数

変数を使用して、要素のプロパティを設定し、要素、オートメーション、エージェント、アプリ タスク、コネクションそれぞれの間で値を渡します。プロセス全体を通して、要素の出力が変数として自動的に使用可能になります。

[変数] 選択パネルを開き、変数、引数、プロパティを選択します。[式を検証] パネルの右上にある [テスト] ボタンを使用し、値を指定してテストします。

テスト入力値: 式の精度を検証し、指定した入力に基づいて予想される出力が生成されることを確認します。

ヒント:

変数ピッカーには、折りたたまれたサブプロセス内のタスクからの出力が含まれます。

サブプロセスが折りたたみビューまたは展開ビューのどちらで表示されているかに関係なく、サブプロセスの変数を直接参照することができるため、モジュール式プロセスの設計で容易に作業できるようになります。

注:

変数の名前を変更すると、その変数の基本的な ID が新しい変数名に合わせて更新されます。古い変数 ID を参照している式は、変数名を変更すると機能しなくなります。

[Fix variables] ダイアログを使用し、破損した参照をプロセス全体で特定して更新します。

式エディター

式エディターを使用して複雑な式を記述し、要素のプロパティを設定します。変数、引数、メソッド、プロパティ、オブジェクト、キーワードに対応したインテリジェントなコード補完機能を備えています。

Ctrl + Space を使用すると、式の記述時に利用可能なオプションのリストが表示されます。

式エディターの下部にあるテキスト バーに式を記述すると、すぐに Autopilot によるヘルプが表示されます。

Maestro では式の保存時と実行中の両方で式が検証され、無効な構文や未定義の変数参照があれば警告が表示されます。警告が表示された場合は式エディターを開き、構文を修正するか、変数参照を更新します。

警告:

C# の式が非推奨になりました。JavaScript の式を使用してください。

移行のガイダンスについては「C# から JavaScript 式に移行する」をご覧ください。

JSON エディター

まず、[変数] ビューに未加工の JSON オブジェクトを追加して、入力ペイロードを定義します。追加したら、JSON エディターに切り替えて、構造化された形式のデータを確認および操作します。

このビューでは、ネストされたオブジェクトと配列が自動的に整理されるため、値を簡単に検査、展開、参照できます。データの形状を検証したり、フィールドを式にマッピングしたり、下流のコンポーネントに明確かつ正確に入力を提供したりするために使用します。

日付/時刻の選択

日付と時刻の選択を使用して、オートメーション フロー内の特定のスケジュールの詳細をキャプチャします。このコンポーネントを使用すると、標準化された形式で日付と時刻の値を定義できます。

提出物のタイムスタンプ付け、期限の設定、下流工程のスケジュール設定に使用します。値を手動で入力するか、カレンダーと時計のコントロールを使用してすばやく選択することで、一貫性を確保し、書式設定エラーを減らします。

Data Fabric エディター

データ連携を設定するには、Data Fabric エディターを開きます。エンティティを選択し、一意の識別子を使用して、取得するレコードを指定してから、取得または更新するフィールドを選択します。これらの入力により、プロセス内でのデータのやり取りの範囲が決まります。

フィールド値による Data Fabric エンティティのクエリ

次のように、qes: をプレフィックスとした構文を使用して、内部レコード ID ではなく、フィールド値で Data Fabric エンティティを検索します。

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

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

作業上意味のあるフィールド値はわかっているものの、内部レコード ID が不明な場合に、この構文を使用します。qes: 構文では、等価演算子のみがサポートされています。

Data Fabric へのアクティビティ出力の書き戻し

target 属性構文を使用して、DataFabric エンティティを直接アクティビティの出力対象にすることができます。

target="=datafabric.EntityName[...]"

アクティビティが完了すると、Maestro によって出力値が自動的にエンティティに書き戻されます。追加の構成手順は不要です。