RecordContext
RecordContextを使用すると、オブジェクトに関連するイベントおよび操作をリスニングできます。 たとえば、フィールド値の変更、イベント保存前、イベント保存後ONなどをリスニングできます。
サポートされているイベント
| イベント名 | 説明 | 例 |
|---|---|---|
| FieldValueChange | SRタイトル・フィールドの変更など、フィールド値が変更されたときに開始されます。 | フィールド値変更イベント |
| OnBeforeSave | サーバーにデータをコミットするためのREST APIリクエストの開始前に開始されました。 エンド・ユーザーは、このコールバックで非同期操作を実行するか、このイベントを取り消すことができます。 このイベントは、非同期操作が完了するまで待機できます。 | OnBeforeSaveイベント |
| OnAfterSave | レコードがVBアプリケーションに保存された後に開始されます。 たとえば、SRの保存後などです。 | 保存後イベント |
| OnDataLoad | データのロード時に開始されます。 たとえば、SRオブジェクト・データをフェッチした後です。 | DataLoadイベント |
| CustomEvent | ビジネス固有のカスタム・イベントをサポートするために使用されます。 | カスタム・イベントのサブスクライブ |
| OnBeforeSmartAction | スマートアクションの実行前に開始されました。 エンド・ユーザーは、このコールバックで非同期操作を実行するか、このイベントを取り消すことができます。 このイベントは、非同期操作が完了するまで待機できます。 | OnBeforeSmartActionイベント |
| OnAfterSmartAction | スマート・アクションの完了後に開始されます。 | OnAfterSmartActionイベント |
| OnBeforeMessageSend | このイベントは、メッセージの作成スマート処理から受信者にメッセージを送信するREST APIリクエストを起動する前に起動されます。 エンド・ユーザーは、このコールバックで非同期操作を実行し、このメッセージ送信プロセスを許可または取り消すことができます。 つまり、このイベントは非同期操作が完了するまで待機できます。 | OnBeforeMessageSend |
| OnAfterMessageSent | このイベントは、メッセージの作成スマート処理から受信者にメッセージを正常に送信した後に起動される通知イベントです。 | OnAfterMessageSentイベント |
サポートされている操作
| 工程名 | 説明 | 例 |
|---|---|---|
| GetFieldValue | フィールドの現在の値を取得するために使用されます。 たとえば、SRの「タイトル」フィールドの現在の値を取得します。 | 「GetFieldValue操作」を公開します。 |
| レコードを保存 | 開いているレコードを保存するために使用します。 たとえば、これを使用して、編集ページからSRフォームを保存したり、作成フォームからSRを保存します。 | 「レコード保存操作」を公開します。 |
| SetFieldValue | 特定のフィールドの値を更新するために使用します。 たとえば、SRの「タイトル」フィールドを更新する場合に使用します。 | 「SetFieldValue操作」を公開します。 |
| CustomEvent | ビジネス固有のカスタム・イベントをサポートするために使用されます。 | 「CustomEvent操作の公開」. |
| GetFieldsInUI | レンダリングされた動的フォームのフィールドのリストをフェッチするために使用されます。 | 「GetFieldsInUI操作の公開」. |
サポートされているメソッド
| メソッド名 | 説明 |
|---|---|
| サブスクライブ | Fusionアプリケーションからイベントをサブスクライブします。 たとえば、「フィールド値変更イベント」 |
|
subscribeOnce |
Fusionアプリケーションのレコード・コンテキストからイベントに1回サブスクライブします。イベントが起動されると、サブスクリプションは破棄されます。 次に例を示します: フィールド値変更イベント. |
| 公開 | たとえば、レコード・コンテキストでの操作の公開: SetFieldValue操作, GetFieldValue操作. |
| 処分 | recordContextを処分します。 |
| getSupportedEvents | たとえば、そのレコード・コンテキストでサポートされているイベントを配列として返します: GetFieldValue操作, SetFieldValue操作, レコード保存操作, カスタム・イベントのサブスクライブ. |
| getSupportedActions | たとえば、そのレコード・コンテキストでサポートされているアクションを配列として返します: DataLoadイベント, OnBeforeSaveイベント, 保存後イベント, フィールド値変更イベント, カスタム・イベントのサブスクライブ. |
| getRecordType | たとえば、レコードのタイプを返します: ServiceRequestまたはCase。 |
| getRecordId | レコードIDを返します。 まだ作成されていないレコードのレコード・コンテキストの場合、IDはマイナスの数値になります。 |
RecordContextの参照を取得するには、TabContextオブジェクト (ブラウザTabContextまたはMSI-TabContextのいずれか)上でgetActiveRecord() APIをコールします。 getActiveRecord API以外に、RecordContextオブジェクトをContextOpenイベント・サブスクリプションのレスポンスとして取得できます。