フローインスタンスのプロパティ
Flowインスタンスのプロパティは、目的のビジネス機能を実現するために、異なるタスクや決定ポイント間でデータをやり取りするために使用されます。
概要
「 URL 」の実行は、『 フローデザイナーの管理 』に記載されている手順に従い、特定のフローがオーケストレーションされ公開された後、システムによって共有されます。 「 URL 」をクリックするたびに、フローの新しいインスタンスが生成されます。 そのような各インスタンスに対して、一連のデフォルトプロパティまたは組み込みプロパティが設定されます。 デフォルトのプロパティに加え、使用されるタスクによって一連のカスタムプロパティを追加することができます。
これらのプロパティは、異なるタスクや意思決定ポイント間のデータ交換に使用され、適切なビジネス機能の構築を支援します。
フローインスタンスのプロパティ
各インスタンスの起動時に初期化されるデフォルトのプロパティについては、以下のリストを参照してください。
| 属性名 | 説明 | タイプ |
|---|---|---|
__tenantid |
ユーザーが所属するテナントの名前。 | ストリング |
__locale |
ユーザーインターフェースに関する、言語または国に基づく設定のセット。 | ストリング |
status |
タスクのステータス（成功または失敗）。 | ストリング |
statusDetails |
タスクの状態の説明。 | ストリング |
error |
フローで発生したエラーの詳細情報を取得するためのオブジェクト。 | JSON |
themeId |
ユーザーがフローに対して設定したいカスタムテーマのUUID。 フロー「 URL 」がトリガーされる際、これをクエリパラメータとして宣言する必要があります。 | ストリング |
user |
CDから取得したユーザーの詳細情報。 | SCIM |
- タスクの実行中、特定のタスクからの出力パラメータがワークフローコンテキストに追加されます。
- 各タスクの開始時に、プロパティのステータス、ステータスの詳細、およびエラーがリセットされます。 Page の場合、これらの値を使用して、ユーザーに関連するエラーやステータスの詳細を表示することができます。
- URL の実行時には、追加のクエリパラメータを指定することで、デフォルトのプロパティに加えて新しいプロパティを挿入することができます。
- 「ページ 」タスクで設定された入力フィールドは、フローインスタンスにも保持されます。
<input type="text" name="username"></input>たとえば、 ページタスクに入力フィールドがある場合、プロパティ「username」がフローインスタンスに保存され、これは入力フィールドに入力された名前に対応します
| 属性名 | 説明 | タイプ |
|---|---|---|
applicationId |
アクセスを要求するアプリケーションのID。 | ストリング |
requestorId |
アクセスを要求したユーザーのID。 | ストリング |
requestId |
承認タスクの開始を使用して生成されたリクエストのID。 | ストリング |
entitlementId |
アクセスを要求する権限のID。 | ストリング |
フローインスタンスのエラープロパティ
フローの実行中にエラーが発生した場合、フローインスタンスにエラープロパティが生成されます。 このエラーはJSON型です。
回復不可能なエラーが発生した場合、処理はデフォルトの error_page にリダイレクトされ、インスタンスが終了します。 回復可能なエラーが発生した場合、その後の対応についてはユーザーが判断することになります。 この判断は、errorプロパティに含まれる messageId,、 messageDescription,、または taskName, に基づいて行うことができます。
failed特定のタスクで何らかのエラーが発生した場合、そのタスクのステータスは となります。
テンプレートのレンダリング中のプロパティの使用
他のタスクと同様、 Page タスクの実行中もフローインスタンスのプロパティを利用できます。 これらのプロパティを使用することで、マクロを置き換え、さまざまなビジネスシーンで必要となる、適切なエラーページや入力フォームを生成することができます。 @context.propertyName@これらのプロパティは、次のようにマクロとして使用できます：。
@context.propertyName.nestedPropertyName@特定のプロパティがネストされている場合、マクロは次のように記述できます：.
エラープロパティの例を見てみましょう。 @context.error@フローの設計中は、以下の手順でこのプロパティにアクセスできます。 @context.error.messageId@同様に、エラーに対応する messageId には、次のようにしてアクセスできます：。
ユーザーは、プロパティ名と「.」を指定することで、マクロを介してそのプロパティ内のn番目のレベルのノードにアクセスできます 区切り文字として。