アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。この項では、コンポーネント・ビューでページ・レベル・アイテムを作成する方法について説明します。
トピック:
この項では、ページ・レベル・アイテムの作成方法と編集方法について説明します。
コンポーネント・ビューでは、アイテムがセクション「アイテム」の下に表示されます。アイテムを編集、コピーおよび作成するには、セクション・タイトルの横にある次のアイコンをクリックします。
すべて編集 - 「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。すべてのアイテムを一度に編集する場合に、このアイコンを使用します。複数のアイテムの同時編集を参照してください。
コピー - 「コピー」アイコンは、小さいページが2つ重なった形をしています。既存のアイテムをコピーする場合に、このアイコンを使用します。
作成 - 「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。アイテムを作成する場合に、このアイコンを使用します。
アイテムはリージョンごとに編成されます。アイテムを編集するには、アイテム名をクリックします。
この項では、アイテムの作成ウィザードを実行して、ページ・レベル・アイテムを作成する方法について説明します。
トピック:
ページ・レベル・アイテムを作成するには、次のステップを実行します。
適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。
必要に応じて、リージョンを作成します。リージョンについてを参照してください。
「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。
「アイテムの作成」で、次のステップを実行します。
アイテム・タイプ - アイテム・タイプを選択します。アイテム・タイプについてを参照してください。
ポップアップLOV、カラー・ピッカーまたはポップアップ計算機付きテキスト・フィールドを作成する場合は、「ポップアップLOV」を選択し、特定のポップアップLOVタイプを選択します。
非サポートの表示 - 「いいえ」を選択すると、カレント・ページのユーザー・インタフェース用に設計されているアイテム・タイプのみが表示されます。「はい」を選択すると、他のユーザー・インタフェース用に設計されているその他のアイテム・タイプが表示されます。
「次へ」をクリックします。
アイテム・タイプを選択します。アイテム・タイプについてを参照してください。
「表示位置および名前」で、次のステップを実行します。
アイテム名 - アイテム名を入力します。この名前によって、アイテムの値を取得するためのハンドルが提供されます。30文字以上のアイテム名はバインド変数構文を使用して参照できません。アイテムのネーミング規則についてを参照してください。
順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。
リージョン - アイテムが配置されるリージョンを決定します。
「次へ」をクリックします。
画面に表示されるステップに従います。
属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。
静的値リストを作成する方法の1つに、アイテムのLOV定義の編集があります。このタイプのLOVは再使用できないことに注意してください。LOVをいつでも使用可能な共有コンポーネントとして作成することをお薦めします。
関連項目:
静的値リストを作成するには、次のステップを実行します。
適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。
必要に応じて、リージョンを作成します。リージョンについてを参照してください。
「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。
「アイテムの作成」で、次のステップを実行します。
アイテム・タイプ - 「選択リスト」を選択します。
非サポートの表示 - 「いいえ」を選択すると、カレント・ページのユーザー・インタフェース用に設計されているアイテム・タイプのみが表示されます。「はい」を選択すると、他のユーザー・インタフェース用に設計されているその他のアイテム・タイプが表示されます。
「次へ」をクリックします。
アイテム・タイプを選択します。アイテム・タイプについてを参照してください。
「表示位置および名前」で、次のステップを実行します。
アイテム名 - アイテム名を入力します。この名前によって、アイテムの値を取得するためのハンドルが提供されます。30文字以上のアイテム名はバインド変数構文を使用して参照できません。アイテムのネーミング規則についてを参照してください。
順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。
リージョン - アイテムが配置されるリージョンを決定します。
「次へ」をクリックします。
「アイテム属性」は、次のようにします。
ラベル - アイテム・ラベルを入力します。ラベルは、アイテムが表示される際に、その横に表示されるテキストです。ラベルが不要な場合は、ラベル属性を空白のままにします。
高さ - アイテム表示の行の高さの数値を入力します。大部分のアイテムでは、これは1です。
テンプレート - オプションで、アイテムの表示を制御するフィールド・テンプレートを選択します。
「次へ」をクリックします。
「設定」は、次のようにします。
必須の値 - 「はい」に設定し、ページ・アイテムが表示されている場合、Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。
ヒント:
「共有コンポーネント」の「テキスト・メッセージ」でメッセージAPEX.PAGE_ITEM_IS_REQUIRED
を定義すると、事前定義されたエラー・テキストをアプリケーション固有のエラー・テキストに置換できます。メッセージの表示位置は、アプリケーション・レベル設定の「デフォルトのエラー表示位置」によって定義します。
選択時のページ・アクション - LOVから複数の値を選択できるようにするか、単一の値を選択できるようにするかを指定します。複数の値の場合、カンマ区切りのリストで返されます。
複数選択を許可 - LOVから複数の値を選択できるようにするか、単一の値を選択できるようにするかを指定します。複数の値の場合、カンマ区切りのリストで返されます。
「次へ」をクリックします。
「LOV」で、次のようにします。
「名前付きLOV」で、「名前付きLOVの選択」を選択します。
LOV問合せ - 次の構文を使用して問合せを入力します。
STATIC[2]:Display Value[;Return Value],Display Value[;Return Value]
内容は次のとおりです。
最初のキーワードはSTATIC
またはSTATIC2
になります。
STATIC
では、値が表示値のアルファベット順でソートされます。STATIC2
では、値がリストに入力された順序で表示されます。
セミコロンは各エントリで表示値と戻り値を区切ります。
Return Value
はオプションです。Return Value
が含まれない場合、戻り値は表示値と同じになります。
残りの属性を編集し、「次へ」をクリックします。
必要に応じて残りの属性を編集し、「アイテムの作成」をクリックします。
次に例として、3つの異なる静的値リストに対する構文を示します。
この例では、アルファベット順で表示される4つの値(Cow、Dog、Cat、Lion)が値リストにあります。各エントリの戻り値は表示値と同じです。
STATIC:Cow,Dog,Cat,Lion
この例では、定義にリストされた順序で表示される10の値が値リストにあります。各エントリの戻り値は表示値と同じです。
STATIC2:10,15,20,25,50,100,200,500,1000,10000
カスケードLOVを作成すると、ページ上の1つのアイテムによって別のアイテムのLOVが決定されます。アプリケーション・ビルダーでは、選択リスト、シャトル、チェック・ボックス、ラジオ・グループ、ポップアップLOVおよびリスト・マネージャの各アイテム・タイプに対して、カスケードLOVがサポートされています。
ヒント:
アイテム・タイプの詳細は、アイテム・タイプについてを参照してください。
カスケードLOVは、2つのアイテムを作成することによって作成します。2つ目のアイテムに値を移入するには、アイテムの作成ウィザードを実行しているときか、またはアイテムの属性を編集することによって、カスケードLOV親アイテムを指定します。
次の項では、2つの関連する選択リストを作成する方法を示します。この場合、最初のリストの値が2つ目のリストに移入されます。
値のカスケード・リストを作成するには、次の手順を実行します。
最初のアイテムを作成し、そのアイテムにP1_DEPTNO
という名前を付けます。
適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。
必要に応じて、リージョンを作成します。リージョンについてを参照してください。
「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。
「アイテム・タイプ」で、「選択リスト」を選択します。
「表示位置および名前」で、次のステップを実行します。
アイテム名: 次のように入力します。
P1_DEPTNO
残りのデフォルト値を受け入れ、「次へ」をクリックします。
「アイテム属性」は、次のようにします。
ラベル - Department
と入力します
残りのデフォルト値を受け入れ、「次へ」をクリックします。
「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。
「LOV」で、次のようにします。
NULL値の表示: デフォルトの「はい」を受け入れます。
NULL表示値: 「- Select Department -」と入力します。
- Select Department -
「LOV定義」で、次のように入力します。
SELECT dname as d, deptno as r FROM dept ORDER BY dname
「次へ」をクリックします。
残りのデフォルト値を受け入れます。
「アイテムの作成」をクリックします。
P1_EMPNO
という名前の2つ目のアイテムを作成します。
適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。
必要に応じて、リージョンを作成します。リージョンについてを参照してください。
「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。
「アイテム・タイプ」で、「選択リスト」を選択します。
「表示位置および名前」で、次のステップを実行します。
アイテム名: 次のように入力します。
P1_EMPNO
残りのデフォルト値を受け入れ、「次へ」をクリックします。
「アイテム属性」は、次のようにします。
ラベル - Employee
と入力します。
残りのデフォルト値を受け入れ、「次へ」をクリックします。
「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。
「LOV」で、次のようにします。
NULL値の表示: デフォルトの「はい」を受け入れます。
NULL表示値: 「- Select Department -」と入力します。
- Select Employee -
カスケードLOV親アイテム: 「P1_DEPTNO」を選択します。
「LOV定義」で、次のように入力します。
SELECT ename as d, empno as r FROM emp WHERE deptno = :P1_DEPTNO ORDER BY ename
「次へ」をクリックします。
残りのデフォルト値を受け入れます。
「アイテムの作成」をクリックします。
「実行」をクリックし、レンダリングされたページを表示します。
2つの選択リストが表示されます。「Department」選択リストで選択を行うと、「Employees」選択リストに表示される個人が決定されます。
複数のアイテムを同時に作成するには、次のステップを実行します。
適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。
必要に応じて、リージョンを作成します。リージョンについてを参照してください。
アイテムの作成ウィザードにアクセスします。「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。
ページ下部の「表形式フォームを使用した複数アイテムの作成」リンクをクリックします。
複数のアイテムの作成ページで、次のように指定します。
リージョンにアイテムの作成: アイテムを含めるリージョンを選択します。
アイテム・テンプレート: アイテム・テンプレートを選択します。
各アイテムの「順序」、「名前」、「ラベル」、「タイプ」を入力し、アイテムがキャッシュする必要があるかどうかを指定します。
「複数のアイテムの作成」をクリックします。
ページ・アイテム属性を編集するか、または「すべて編集」アイコンか「アイテムの順序変更」アイコンを使用して、ページ・レベル・アイテムを編集できます。
トピック:
関連項目:
アイテムのデフォルト値は、ページ・アイテムの編集ページの「デフォルト」の下にある属性を使用して定義します。デフォルト値は、アイテムの値がセッション・ステートから導出されない場合およびソース値がNULL
の場合に使用されます。
アイテムのデフォルト値を定義するには、次のステップを実行します。
「ページ・アイテムの編集」ページで、「セキュリティ」リージョンのアイテムのセキュリティを構成できます。
ページ・アイテムのセキュリティを構成するには、次のステップを実行します。
アイテム・タイプでクイック選択がサポートされている場合は、「クイック選択」属性を使用して、特定のアイテムの下に表示される選択項目を最大10個定義できます。クイック選択をクリックすると、アイテムの値が設定されます。次の例は、5%、10%、15%および20%のクイック選択を示しています。
クイック選択を作成するには、次のステップを実行します。
アイテムを作成します。コンポーネント・ビューでのページ・レベル・アイテムの作成を参照してください。
アイテム属性を表示します。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。
「クイック選択」までスクロールします。
「クリック選択の表示」で、「はい」を選択します。
各クイック選択のラベルと値を定義します。
「ラベル」で、各選択項目に表示するラベルを入力します。
「値」で、対応する値を入力します。
「リンク属性」で、クイック選択の追加属性を入力します。
「変更の適用」をクリックします。
読取り専用アイテムを表示するには、次のステップを実行します。
アイテムを作成します。コンポーネント・ビューでのページ・レベル・アイテムの作成を参照してください。
アイテム属性を表示します。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。
「読取り専用」までスクロールします。「読取り専用」で、次のステップを実行します。
「読取り専用条件タイプ」から選択します。
アイテムのタイプに応じ、読取り専用アイテムはプレイン・テキストまたは入力不可フィールドとしてレンダリングされます。条件を選択しない場合、アイテムは通常どおりレンダリングされます。
ヒント:
条件タイプを「なし」に設定すると、アイテムは常に入力可能なフィールドとしてレンダリングされます。この設定では、リージョンまたはページ・レベルで定義した読取り専用条件設定がすべて上書きされます。
表示されるフィールドに式を入力します。
「読取り専用の要素表のセル属性」で、HTML表セル・タグ<td>
に含める属性を入力します。このタグには、読取り専用モードで表示される際のアイテムも含まれます。次に例を示します。
bgcolor="#FF0000"
ヒント:
読取り専用の要素表のセル属性は、アプリケーションでリージョンおよびページ・アイテムのレイアウトにHTML表を使用する場合のみ、表示されます。
「変更の適用」をクリックします。
アイテム属性でページ上のアイテムの表示方法を制御します。ページ・アイテム・ページを使用して順序、フィールド・ラベル、テンプレート、リージョン、およびページ上のすべてのアイテムの全体的な配置を編集できます。次に続くセクションでは、これらのページを使用したアイテムの編集方法について説明します。
リージョン・アイテムの再割当てページを使用してアイテムを新しいリージョンに割り当てます。
リージョン・アイテムの再割当てページで新しいリージョンにアイテムを割り当てるには、次のステップを実行します。
アイテムを含むページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。
ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。
「リージョン・アイテムの再割当て」をクリックします。
リージョン・アイテムの再割当てページが表示されます。
ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。使用可能なオプションは次のとおりです。
ページ: 新しい番号を選択または入力して「実行」をクリックします。
リージョンの表示: 表示するリージョンを選択して「実行」をクリックします。
アイテムを他のリージョンに再割当てするには、次のステップを実行します。
再割当てするアイテムを選択します。
「リージョンへの割当て」から、新しいリージョンを選択します。
「再割当て」をクリックします。
複数のアイテムを一度に削除するには、複数のアイテムの削除ページを使用します。
複数のアイテムを削除するには、次のステップを実行します。
アイテムを含むページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。
ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。
「複数のアイテムの削除」をクリックします。
複数のアイテムの削除ページが表示されます。
ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。新しいページにナビゲートするには、「ページ」フィールドを使用します。新しい番号を選択または入力して「実行」をクリックします。
アイテムを削除するには、次のステップを実行します。
アイテムを選択します。
「アイテムの削除」をクリックします。
ユーティリティ・ページには、グリッド編集ページが含まれ、選択したアプリケーション内の複数のページのアイテムを編集できるユーティリティが表示されます。
ユーティリティ・ページにアクセスするには、次のステップを実行します。