| Oracle Database Application Express 2日で開発者ガイド リリース2.2 B31495-01 |
|
 戻る |
 次へ |
Oracle Application Expressでは、チェック・ボックスをフォーム要素として作成するか、またはレポート内に作成できます。 フォームのチェック・ボックスは、LOVと同様に動作します。 アイテムをチェック・ボックスとして定義する場合は、「アイテム属性」ページの「LOV」セクションにチェック・ボックス値を指定する必要があります。 既存のファンクションAPEX_ITEM.CHECKBOXを使用して、レポートにチェック・ボックスを定義します。
このチュートリアルでは、デモンストレーション・アプリケーション（サンプル・アプリケーション）内にチェック・ボックスを作成する様な方法、およびチェック・ボックスの値を参照して処理する方法について説明します。 チュートリアルを始める前に、サンプル・アプリケーションがインストールされていることを確認します。 「サンプル・アプリケーションのインストールの確認」を参照してください。
内容は次のとおりです。
図 6-1に示すように、「Add/Modify Products」フォームによってユーザーは新しい製品をデータベースに追加できます。
次の演習では、「Product Available」ラジオ・グループをチェック・ボックスに変更した後、ラベルの位置を変更します。
このセクションの内容は次のとおりです。
「Product Available」ラジオ・グループをチェック・ボックスに変更するには、次のステップを実行します。
「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「サンプル・アプリケーション」をクリックします。
「アプリケーション」ホームページが表示されます。
ページ6のページ定義にナビゲートします。
「ページ」フィールドに、6と入力して「実行」をクリックします。
「6 - Add/Modify」アイコンをクリックします。
ページ6のページ定義が表示されます。 「Product Available」ラジオ・グループは、P6_PRODUCT_AVAILというアイテムです。
「アイテム」で、「P6_PRODUCT_AVAIL」をクリックします。
「名前」セクションの「表示形式」リストから、「チェックボックス」を選択します。
「LOV」までスクロールします。
「LOV」で、次のステップを実行します。
「名前付きLOV」で、「- 名前付きLOVの選択 -」を選択します。
「LOV定義」で、次のように入力します。
STATIC:;Y
このLOVは、静的リストです。 ここでは、表示値はNULLで、戻り値はYです。表示値が指定された場合はチェック・ボックスの左側に表示され、ラベルのかわりに使用できます。
静的LOVの詳細は、『Oracle Database Application Expressユーザーズ・ガイド』の「LOVの作成」を参照してください。
ページ上部の「変更の適用」をクリックします。
ページ定義が表示されます。
右上にある「ページの実行」アイコンをクリックします。 （図6-2を参照。）
図6-2 「ページの実行」アイコン
ユーザー名とパスワードを入力するように要求されたら、次のステップを実行します。
「ユーザー名」に、demoまたはadminのいずれかを入力します。
「パスワード」に、作業領域名を小文字で入力します。
「ログイン」をクリックします。
「サンプル・アプリケーション」が表示されます。
ページ下部の「開発者」ツールバーから「ページ1の編集」を選択します。
ページ定義が表示されます。
「ページ」フィールドに、6と入力して「実行」をクリックします。
「ページの実行」アイコンをクリックします。
図6-3に示すとおり、「Product Available」アイテムがチェック・ボックスとして表示されます。
次に、チェック・ボックスのラベル「Product Available」をチェック・ボックスの右側に移動します。
チェック・ボックスのラベルの位置を変更するには、次のステップを実行します。
「開発者」ツールバーから「ページ6の編集」をクリックします。
ページ定義が表示されます。
「アイテム」で、「P6_PRODUCT_AVAIL」を選択します。
「ラベル」までスクロールします。
「ラベル」で、テキストProduct Availableを削除します。
「LOV」までスクロールします。
「LOV」で、LOV定義を次のように変更します。
STATIC:Product Available;Y
ページ上部の「変更の適用」をクリックします。
「ページの実行」アイコンをクリックします。
図6-4に示すとおり、「Product Available」ラベルがチェック・ボックスの右に表示されます。
ラベルを削除したり、LOVに表示値を追加すると、Application Expressエンジンによって、まずチェック・ボックス、次に表示値「Product Available」がレンダリングされます。
特定の環境では、チェック・ボックスをデフォルトで有効にする必要がある場合があります。 これは、チェック・ボックス・アイテムの「デフォルト値」属性を設定して行うことができます。 この方法には、無効にする場合に追加のステップを実行する必要があるという欠点があります。 「Product Available」チェック・ボックスは、その定義方法のため、実際には無効にできません。
次に例を示します。
サンプル・アプリケーションの「Add/Modify Products」ページから、「ホーム」タブをクリックします。
「タスク」リストから「Add a New Product」をクリックします。
「Add/Modify Product」ページが表示されます。
「Add/Modify Products」ページで、次のステップを実行します。
必須フィールド（アスタリスク付きのフィールド）に入力します。
「Product Available」チェック・ボックスを選択解除します。
「作成」をクリックします。
「Product Available」チェック・ボックスが選択されてないことを確認して、「変更の適用」をクリックします。
「Products」ページが表示されます。
追加した製品の「編集」アイコンを選択します。
「Product Available」チェック・ボックスが、製品の追加時に2回無効にしたにもかかわらず、有効になっていることに注意してください。 この動作の原因は次のとおりです。
「Product Available」チェック・ボックスに、デフォルト値Yが指定されている。
「Product Available」がNULLの場合、チェック・ボックスを有効にするデフォルト値Yが指定される。
この動作は、チェック・ボックスの状態を追跡する計算を追加して変更できます。
チェック・ボックスの状態を追跡する計算を追加するには、次のステップを実行します。
「開発者」ツールバーから「ページ6の編集」をクリックします。
「ページ・プロセス」の「計算」で、「作成」アイコンをクリックします。
「位置」で、「このページのアイテム」を選択して「次へ」をクリックします。
「アイテム」で、次のステップを実行します。
「計算アイテム」で、「P6_PRODUCT_AVAIL」を選択します。
「計算ポイント」で、「送信後」を選択します。
「計算タイプ」で、「静的割当て」を選択します。
「次へ」をクリックします。
「計算」で、次のように入力し、「次へ」をクリックします。
N
|
注意: このアイテムはチェック・ボックスであるため、アイテムの値をYまたはNULL以外に設定します。 |
次に、計算を実行するタイミングを制御する条件を作成します。
「条件」で、次のステップを実行します。
「条件タイプ」で、「式1のアイテムの値がNULL」を選択します。
「式1」に、次のように入力します。
P6_PRODUCT_AVAIL
これらの設定によって、この計算は、チェック・ボックス・アイテムP6_PRODUCT_AVAILの値がNULLの場合にのみ実行されます。
「作成」をクリックします。
新しい計算をテストするには、次のステップを実行します。
「ページの実行」アイコンをクリックします。
「サンプル・アプリケーション」が表示されます。
「ホーム」タブをクリックします。
「タスク」リストから「Add a New Product」を選択します。
「Add/Modify Product」ページが表示されます。
「Add/Modify Product」ページで、次のステップを実行します。
必須フィールドに入力します。
「Product Available」チェック・ボックスを選択解除します。
「作成」をクリックします。
「Product Available」チェック・ボックスが選択されてないことを確認して、「変更の適用」をクリックします。
「Products」ページが表示されます。
追加した製品の「編集」アイコンを選択します。
「Product Available」チェック・ボックスは選択されていないことに注意してください。
次の演習では、「Product」ページに複数値チェック・ボックスを作成します。 ユーザーは、このチェック・ボックスによって、カテゴリを選択してレポートをフィルタ処理できるようになります。
このセクションの内容は次のとおりです。
複数値チェック・ボックスを作成するには、次のステップを実行します。
ページ3のページ定義にナビゲートします。
「開発者」ツールバーの「ページの編集」リンクをクリックします。
「ページ」フィールドに、3と入力して「実行」をクリックします。
ページ3のページ定義が表示されます。
「アイテム」で、「作成」アイコンをクリックします。
「アイテム・タイプ」で、「チェックボックス」を選択して「次へ」をクリックします。
「表示位置および名前」で、次のステップを実行します。
「アイテム名」に、P3_SHOWと入力します。
「順序」で、デフォルトを受け入れます。
「リージョン」で、「Products (1) 10」を選択します。
「次へ」をクリックします。
「LOV」で、次のステップを実行します。
「名前付きLOV」で、デフォルトを受け入れます。
「NULLオプションの表示」で、「いいえ」を選択します。
「LOV問合せ」に、次のように入力します。
SELECT distinct category a, category b FROM demo_product_info ORDER BY 1
|
注意: 複数値チェック・ボックスを作成するには、LOB問合せで複数の行が戻される必要があることに注意してください。 |
「次へ」をクリックします。
「アイテム属性」で、次のステップを実行します。
「ラベル」で、「消去」をクリックしてデフォルトのテキストを削除します。
残りのデフォルト値を受け入れ、「次へ」をクリックします。
「ソース」で、次のステップを実行します。
「アイテム・ソース」で、「静的割当て」（値がソース属性に等しい）を選択します。
「アイテム・ソース値」に、次のように入力します。
Audio:Computer:Phones:Video
複数値チェック・ボックスを送信する場合、アイテムの値はコロンで区切られた文字列にします。 この文字列をソースとして使用すると、Application Expressエンジンによってページのレンダリングが行われる際にすべてのボックスが選択されます。
「アイテムの作成」をクリックします。
ページ3のページ定義が表示されます。
次に、チェック・ボックスの表示値（ラベル）が太字で表示されるように編集します。
チェック・ボックスの表示値（ラベル）が太字で表示されるように編集するには、次のステップを実行します。
ページ3のページ定義にナビゲートします。
「アイテム」で、「P3_SHOW」をクリックします。
「要素」までスクロールします。
「フォーム要素オプション属性」に、次のように入力します。
class="fielddatabold"
「フォーム要素オプション属性」は、チェック・ボックスおよびラジオ・ボタン専用で、Application Engineエンジンによる個のオプションのレンダリング方法を制御します。
「変更の適用」をクリックします。
ページ3のページ定義が表示されます。
次に、カテゴリ・チェック・ボックスがレポートの上に表示されるように属性を編集します。 これを行うには、P3_SHOWに関連付けられたリージョンの「表示ポイント」属性を変更する必要があります。
「Products」リージョンの表示ポイントを変更するには、次のステップを実行します。
ページ3のページ定義にナビゲートします。
「リージョン」で、「Products」をクリックします。
「ユーザー・インタフェース」セクションの「表示ポイント」から、「ページ・テンプレート・ボディ (3. リージョン・コンテンツより上のアイテム)」を選択します。
「変更の適用」をクリックします。
ページ3のページ定義が表示されます。
ページ3を実行すると、カテゴリ・チェック・ボックスは縦に並んで表示されます。 次に、カテゴリ・チェック・ボックスが横に並んで表示されるように表示を変更する必要があります。
カテゴリ・チェック・ボックスを横に並べて表示するには、次のステップを実行します。
ページ3のページ定義にナビゲートします。
「アイテム」で、「P3_SHOW」をクリックします。
「LOV」までスクロールします。
「列の数」に、4と入力します。
ページ上部の「変更の適用」をクリックします。
ページ3のページ定義が表示されます。
右上にある「ページの実行」アイコンをクリックします。
図 6-5に示すように、チェック・ボックスがページの上部に横に並んで表示されていることに注意してください。
製品カテゴリ・チェック・ボックスでレポートを生成するには、ページを送信する必要があります。
ページを送信するボタンを作成するには、次のステップを実行します。
ページ3のページ定義にナビゲートします。
「ボタン」で、「作成」アイコンをクリックします。
「ボタン・リージョン」で、「Products (1) 10」を選択して「次へ」をクリックします。
「位置」で、「このリージョン・アイテムで表示されるボタンの作成」を選択して「次へ」をクリックします。
「ボタン属性」で、次のステップを実行します。
「ボタン名」に、P3_GOと入力します。
「順序」に、40と入力します。
残りのデフォルトを受け入れて「ボタンの作成」をクリックします。
次に、ユーザーが「Go」ボタンをクリックした後に移動する位置をApplication Expressエンジンに通知するブランチを作成する必要があります。
ページ3へのブランチを作成するには、次のステップを実行します。
ページ3のページ定義にナビゲートします。
「ページ・プロセス」の「ブランチ」で、「作成」アイコンをクリックします。
「ブランチ・ポイント」および「ブランチ・タイプ」で、デフォルトを受け入れて「次へ」をクリックします。
「ページ」で、「3」を選択して、残りのデフォルト値を受け入れ、「次へ」をクリックします。
「ブランチの作成」ページが表示されます。
「ブランチの作成」をクリックします。
製品カテゴリ・チェック・ボックスに基づいてレポートを生成するには、レポート問合せを変更する必要があります。
レポート問合せを編集するには、次のステップを実行します。
「リージョン」で、「Products」をクリックします。
「ソース」までスクロールします。
「リージョン・ソース」で、WHERE句を検索します。
WHERE句を次のように変更します。
WHERE p.image_id = i.image_id (+)AND instr(':'||:P3_SHOW||':',category) > 0
ページ上部の「変更の適用」をクリックします。
ページを実行します。
図6-6に示すとおり、カテゴリ・チェック・ボックスを選択し、ページの上部にある「Go」をクリックして、レポートをフィルタ処理できることに注意してください。
図6-6 カテゴリ・チェック・ボックスおよび「Go」ボタンが表示された「Products」ページ
ページ3のコンテンツは、カテゴリ・チェック・ボックスで正常にフィルタ処理されますが、すべてのチェック・ボックスを選択解除すると、すべての製品がレポートされることに注意してください。 チェック・ボックスをNULL値にする（選択解除する）と、デフォルト値Yが設定されるため、この動作が発生します。デフォルト値Yによって、チェック・ボックスが有効になります。
この動作は、チェック・ボックスの状態を追跡する計算を追加して変更できます。
チェック・ボックスの状態を追跡する計算を追加するには、次のステップを実行します。
ページ3のページ定義にナビゲートします。
「ページ・プロセス」の「計算」で、「作成」アイコンをクリックします。
「アイテムの位置」で、「このページのアイテム」を選択して「次へ」をクリックします。
「アイテム」で、次のステップを実行します。
「計算アイテム」で、「P3_SHOW」を選択します。
「順序」で、デフォルトを受け入れます。
「計算ポイント」で、「送信後」を選択します。
「計算タイプ」で、「静的割当て」を選択します。
「次へ」をクリックします。
「計算」に、次のように入力します。
「計算」で、次のように入力します。
none(bogus_value)
「次へ」をクリックします。
|
注意: アイテムの静的割当てには、YまたはNULL以外の値を指定する必要がありあます。 |
次に、計算を実行するタイミングを制御する条件を作成します。
「条件」で、次のステップを実行します。
「条件タイプ」で、「式1のアイテムの値がNULL」を選択します。
「式1」に、次のように入力します。
P3_SHOW
これらの設定によって、この計算は、チェック・ボックス・アイテムP3_SHOWの値がNULLの場合にのみ実行されます。
「作成」をクリックします。
ページを再度実行して、すべてのカテゴリ・チェック・ボックスを選択解除し、「Go」をクリックします。 今回は、レポートに予期した結果（戻されたレコードがない）が示されます。
次の演習では、「Product」ページの各行に削除チェック・ボックスを追加します。 これを行うには、レポート問合せを編集してAPEX_ITEMパッケージをコールする必要があります。
APEX_ITEMは、特定のフォーム要素を動的に生成するために提供されているパッケージです。 ここでは、APEX_ITEM.CHECKBOXを使用して「Products」レポートにチェック・ボックスを生成します。 ページを送信すると、チェック・ボックスの値がグローバル・パッケージ配列に格納されます。 これらの値は、渡されたp_idxパラメータ値に基づいてPL/SQL変数APEX_APPLICATION.G_F01からAPEX_APPLICATION.G_F50を使用して参照できます。
このセクションの内容は次のとおりです。
|
参照: 『Oracle Database Application Expressユーザーズ・ガイド』の「APEX_ITEM」 |
APEX_ITEM.CHECKBOXをコールするように問合せを編集するには、次のステップを実行します。
ページ3のページ定義にナビゲートします。
「リージョン」で、「Products」をクリックします。
「ソース」までスクロールします。
「リージョン・ソース」で、太字で示されている新しい行を問合せに追加します。
SELECT p.product_id edit_product, p.product_id view_product_id,
apex_item.checkbox(1,p.product_id) del,
p.product_name, p.product_description, p.category, p.product_avail, p.list_price,
'<img src="p?n=' || nvl(i.file_object_id,0) || '" height="50" width="50" />' img
FROM demo_product_info p, demo_images i
WHERE p.image_id = i.image_id (+)
AND instr(':'||:P3_SHOW||':',category) > 0
APEX_ITEMは、特定のフォーム要素を動的に生成する場合に使用可能なOracle Application Expressで提供されるパッケージです。 前述の例で、p_idxに渡される値は1であることに注意してください。後で、チェック・ボックスの値を参照するには、グローバル変数APEX_APPLICATION.G_F01を使用します。
ページ上部までスクロールして「レポート属性」タブを選択します。
「列属性」で、DEL列を検索します。
DEL列がVIEW_PRODUCT_IDのすぐ下になるまで、右側の上矢印をクリックします。 （図6-7を参照。）
チェック・ボックス配列値を送信するボタンを追加するには、次のステップを実行します。
ページ3のページ定義にナビゲートします。
「ボタン」で、「作成」アイコンをクリックします。
「ボタン・リージョン」で、「Products 1 (10)」を選択して「次へ」をクリックします。
「位置」で、「リージョン位置にボタンの作成」を選択して「次へ」をクリックします。
「ボタン属性」で、次のステップを実行します。
「ボタン名」で、「DELETE_PRODUCTS」を選択します。
「ラベル」に、Delete Productsと入力します。
残りのデフォルトを受け入れて「次へ」をクリックします。
「ボタン・テンプレート」で、デフォルトの選択内容を受け入れて「次へ」をクリックします。
「表示プロパティ」で、次のステップを実行します。
「位置」で、「リージョンの上部」を選択します。
残りのデフォルトを受け入れて「次へ」をクリックします。
「ブランチ」で、「3 Products」を選択して「ボタンの作成」をクリックします。
「Delete Products」ボタンをクリックすると実行されるプロセスを追加するには、次のステップを実行します。
「ページ・プロセス」の「プロセス」で、「作成」アイコンをクリックします。
「プロセス・タイプ」で、「PL/SQL」を選択して「次へ」をクリックします。
「プロセス属性」で、次のステップを実行します。
「名前」に、Delete Productsと入力します。
「順序」で、デフォルトを受け入れます。
「ポイント」で、「送信時 - 計算および検証の後」を選択します。
「次へ」をクリックします。
次のPL/SQLプロセスを入力して「次へ」をクリックします。
FOR i in 1..APEX_APPLICATION.G_F01.count LOOP DELETE FROM demo_product_info WHERE product_id = APEX_APPLICATION.G_F01(i); END LOOP;
APEX_ITEMは、特定のフォーム要素を動的に生成する場合に使用可能なOracle Application Expressで提供されるパッケージです。 ページを送信すると、各列の値がグローバル・パッケージ配列に格納されます。これらの値は、PL/SQL変数APEX_APPLICATION.G_F01からAPEX_APPLICATION.G_F50を使用して参照できます。 この演習で、EMPNO列のproduct_idに渡される値は1です。そのため、EMPNO列の値は、グローバル変数APEX_APPLICATION.G_F01を使用して参照します。
「メッセージ」で、次のステップを実行します。
「成功メッセージ」に、次のように入力します。
Product(s) deleted.
「失敗メッセージ」に、次のように入力します。
Unable to delete product(s).
「次へ」をクリックします。
「プロセスの作成」をクリックします。
ページを実行します。
サンプル・アプリケーションの「Products」ページで、カテゴリを選択し、「Go」をクリックします。
図6-8に示されるように、レポートの上に「Delete Products」ボタンが表示されていることに注意してください。 レポートから製品を削除するには、「Del」チェック・ボックスを選択して「Delete Products」をクリックします。
図6-8 「Delete Products」チェック・ボックスが表示された「Products」レポート
