EGL の Page Designer サポート

EGL Web プロジェクトで JSP ファイルを作成する場合、EGL は自動的に PageHandler を作成します。 その PageHandler には、ユーザーがカスタマイズできるスケルトン EGL コードがインクルードされます。 その後、Page Designer で、次のようにします。
  1. コンポーネントをパレットから JSP へドラッグします。
  2. 「Attributes (属性)」ビューを使用して色などのコンポーネント固有の特性を設定し、バインディング ( コンポーネントとデータまたはロジックとの間の関係) をセットアップします。
次のような EGL 固有の作業を行うことができます。

Page Designer でソース・タブを使用した場合は、JSP ファイル (特に、JavaServer Faces ファイル) 内のコンポーネントを、PageHandler 内のデータ域および関数に手動でバインドできます。 EGL に大/小文字の区別はありませんが、JSP ファイル内で参照される EGL 名は EGL 変数または関数の宣言と大/小文字が同じである必要があり、完全に一致しなかった場合は JavaServer Faces エラーが発生します。 EGL 変数または関数を JSP フィールドにバインドした後は、EGL 変数または関数の大/小文字を変更しないようにすることをお勧めします。

命名問題の詳細については、『JSP ファイルおよび生成された Java™ Bean 内の EGL ID の変更』を参照してください。

PageHandler のデータ域へのコンポーネントのバインディング

JSP 上のコンポーネントは、ほとんどの場合、データと 1 対 1 で対応しています。 例えば、 テキスト・ボックスには、テキスト・ボックスのバインド先の EGL 項目の内容が表示されています。入力テキスト・ボックスでは、 ユーザーがデータを変更すると、EGL 項目も更新されます。

チェック・ボックス・グループ、リスト・ボックス、ラジオ・ボタン・グループ、またはコンボ・ボックスを指定する場合、 状態は複雑になります。この場合、以下の 2 種類のバインディングが必要になります。
  • ユーザーに対して表示するテキストにコンポーネントをバインドするバインディング。例えば、リスト・ボックス内の項目のテキストです。
  • ユーザーの選択を表す値を受け取る PageHandler データ域にコンポーネントをバインドするバインディング。例えば、 ユーザー選択リスト・ボックス項目の数値索引を受け取るデータ項目を作成できます。
プロパティー・ビューでは、次のいずれかの手順を実行して、ユーザーに対して表示するテキストにコンポーネントをバインドできます。
  • 「選択項目の追加」を使用して、コンポーネントが単一文字ストリングに 関連付けられることを指示する。 これは、明示的に指定したり、または PageHandler 項目を識別することによって指定できます。
  • 「選択項目のセットを追加」を使用して、 コンポーネントが文字ストリングのリストに関連付けられることを指示する。 これは、明示的に指定したり、または PageHandler 域 (データ・テーブルまたは文字項目の配列など) を識別することによって指定できます。

または、単一選択コンポーネント (コンボ・ボックス、単一選択リスト・ボックス、またはラジオ・ボタン・グループ) を 文字項目の配列にバインドできます。これを行うには、ページ・データ・ビューから配列をコンポーネントにドラッグします。

ユーザーの選択を表す値を受け取るデータ域にコンポーネントをバインドするには、 ページ・データ・ビューまたはプロパティー・ビューで作業します。 どのコンポーネントをバインドする場合でも (単純なテキスト・ボックスの場合でも) 手順は同じです。

値が 2 つの選択肢の 1 つにしかならない場合は、項目プロパティー booleanyes になっている EGL 項目にコンポーネントをバインドできます。 コンポーネントは、次の 2 つの値のいずれかで項目を取り込みます。
  • 文字項目の場合、値は Y (はい) または N (いいえ)
  • 数値項目の場合、値は 1 (はい) または 0 (いいえ)

チェック・ボックスが表示される場合は、状況 (チェックマークが付いているかどうか) は、バインドされた項目の値によって異なります。

PageHandler 内のデータ項目に適用できるプロパティーの詳細については、『PageHandler フィールド・プロパティー』を参照してください。

関数へのコンポーネントのバインド

コマンド・ボタンまたはコマンド・ハイパーリンクをページ面にドラッグした後は、次のようにして、既存の EGL 関数または Page Designer が作成するイベント・ハンドラーにコンポーネントをバインドできます。
  • 次のいずれかの方法で、既存のイベント・ハンドラーにコンポーネントをバインドする
    • ページ・データ・ビュー内のアクション・ノードからイベント・ハンドラーをコンポーネントにドラッグする
    • クイック編集ビューでコンポーネントをオープンする
    • コンポーネントを右マウス・ボタンでクリックして、「Edit Faces Command Event (Faces コマンド・イベントの編集)」を選択する
  • クイック編集ビューでコンポーネントをオープンしたとき、またはコンポーネントを右マウス・ボタンでクリックして 「Edit Faces Command Event (Faces コマンド・イベントの編集)」を選択したときに、新規イベント・ハンドラーが Page Designer によって作成されるようにする

Page Designer が PageHandler 内にイベント・ハンドラーを作成し、その PageHandler 関数へのアクセスをユーザーに与える場合、関数の名前は、ツールに割り当てられたボタン ID にストリング「Action」を付け加えたものとなります。名前が PageHandler 固有ではない場合は、Page Designer は関数名に番号を付加します。

フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.