ユーザー定義イベント

ビューは、データ・バインディングを使用して他のビューと通信します。 ただし、イベントを使用して他のビューと対話することもできます。 このトピックの概念を説明するために、3 つの関連するビュー (Revenue、Expenses、および Profit) がクライアント・サイド・ヒューマン・サービスに追加されています。 これらのビューはすべて、イベントを使用して互いに対話し、「10 進数」タイプのビューです。 このトピックの残りの部分では、ビュー用のイベント・フレームワークの主要機能のいくつかについて説明します。

コントロール ID は、ビューを参照するために JavaScript コード内に指定できる ID です。 コントロール ID を他のビューで参照して、イベントを使用してビュー間で対話することができます。 例えば、一般プロパティーで、ビューのコントロール ID を「コントロール ID」フィールドに指定できます。

ビューのすべてのユーザー定義イベント・ハンドラーが、イベント・プロパティーに表示されます。 各イベント・ハンドラーには、ビジネス・ロジックを追加するための拡張可能な JavaScript エディターがあり、Ctrl + Space を押すと起動できるコンテンツ・アシストが用意されています。 以下の図では、「ロード時」および「変更時」イベント・ハンドラーが表示されています。

ユーザー定義イベントを定義 するには、「オブジェクト」組み込みタイプと「サービス」組み込みタイプを補足するために追加された「イベント」組み込みタイプを使用します。 「変数宣言」で、1 つ以上の構成オプションを追加します。 「データ」で、「イベント」ラジオ・ボタンを選択し、名前とラベルを指定することにより、イベントに対する 1 つ以上の構成オプションを変更します。 以下の図では、「変数宣言」で eventON_LOAD ユーザー定義イベントが選択され、このユーザー定義イベントの対応する名前、ラベル、および文書が「データ」の下に表示されています。

eventON_LOAD ユーザー定義イベントは、特殊イベント・ハンドラーです。 eventON_LOAD という名前でイベント構成オプションを定義した場合、それは load イベント・ハンドラーで自動的に実行されます。

ユーザー定義イベントを定義した後に登録 するには、「動作」プロパティーでイベント・ハンドラーを選択し、「コード」で JavaScript エディターを使用して登録ロジックをオプションで追加します。 イベント・ハンドラーに渡す追加の変数がある場合は、関数 registerEventHandlingFunction を呼び出すことができます。 ただし、登録関数を明示的に呼び出さなかった場合、イベント・ハンドラーは、追加変数なしで登録されます。

ユーザー定義イベントをいつ起動するかを指定 するには、「動作」プロパティーでイベント・ハンドラーを選択し、「コード」で JavaScript エディターを使用して必要なロジックを追加します。 ロジックで、関数 executeEventHandlingFunction を呼び出して、イベント・ロジックを実行する必要があります。 以下の図では、valueChange イベントが change イベント・ハンドラーで実行されます。 this. ステートメントで Ctrl-Space を選択して関数 executeEventHandlingFunctionを検索して選択することにより、コンテンツ・アシストが呼び出されました。

ビューのユーザー定義イベント・ハンドラーが、イベント・プロパティーに表示されます。 各イベント・ハンドラーには、ビジネス・ロジックを追加するための拡張可能な JavaScript エディターがあり、Ctrl + Space を押すと起動できるコンテンツ・アシストが用意されています。 JavaScript エディターを使用して、イベント・ハンドラーにカスタム・コードを入力できます。 これにより、ビューで他のビューと対話し、値の設定や検証の実行などのタスクを実行できます。 以下の図では、コンテンツ・アシストは、「変更時」ユーザー定義イベント・ハンドラーの JavaScript エディターで呼び出されます。${VIEW_ID}変数を選択しようとしています:

以下を追加するとします。${VIEW_ID}ユーザー定義イベント・ハンドラーの JavaScript エディターの変数に対して、トークン VIEW_ID を別のビューのコントロール ID に置き換える必要があります。これにより、ユーザー定義イベント・ハンドラーがそのビューに完全にアクセスできるようになります。 例えば、次のように置き換えることができます。${VIEW_ID}${Revenue} の変数 (「収益」ビューのコントロール ID)。 次に、次のような関数を呼び出すことができます。${Revenue}.getData()「収益」ビューの現在の境界値を取得します。