リストは、リンクの共有コレクションです。リージョンを作成してリージョン・タイプを「リスト」に指定することによって、リストをページに追加します。リストの外観は、リスト・テンプレートで制御します。
各リスト要素には、いつ表示するかを制御できる表示条件があります。特定のページのカレントまたは非カレントとしてリスト要素を定義できます。テンプレート属性を使用してカレントの外観を指定することもできます。
この項に含まれる内容は次のとおりです。
アプリケーションのページにリストを追加するには、次のステップを実行します。
次の方法のうち1つを使用してリストを作成します。
リストにエントリを追加します。
リスト・エントリを最初から作成します。
現行のリストから単一のリスト・エントリをコピーします。これによってリスト・エントリの属性がコピーされます。
その他のリストから現行のリストへリスト・エントリをコピーします。これによって現行リストにコピーされるエントリのリストを変更することなく、2つのリスト・エントリがマージされます。
リスト・リージョンを作成して、ページにリストを作成します。
この項に含まれる内容は次のとおりです。
リストを作成するには、次の手順を実行します。
リストの作成/編集ウィザードへのアクセス
共有コンポーネント・ページからウィザードにアクセスするには、次のステップを実行します。
「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーション・ビルダーのホームページで、「共有コンポーネント」をクリックします。
「ナビゲーション」で、「リスト」をクリックします。
「作成」をクリックします。
「ページ定義」からウィザードにアクセスするには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
「共有コンポーネント」で、「リスト」セクションの「作成」アイコンをクリックします。
作成/編集のウィザードで、次のステップを実行します。
名前 - リストの名前を入力します。
リスト・テンプレート - リスト・テンプレートを選択します。
ビルド・オプション: このコンポーネントのビルド・オプションを選択します(使用可能な場合)。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。
「作成」をクリックします。
リストをコピーするには、次のステップを実行します。
リストのコピー・ウィザードへのアクセス
共有コンポーネント・ページからウィザードにアクセスするには、次のステップを実行します。
「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーション・ビルダーのホームページで、「共有コンポーネント」をクリックします。
「ナビゲーション」で、「リスト」をクリックします。
「コピー」をクリックします。
「ページ定義」からウィザードにアクセスするには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
「共有コンポーネント」で、「リスト」セクションの「コピー」アイコンをクリックします。
このページにリストが存在する場合にのみ「コピー」アイコンが表示されます。
コピー・ウィザードで、コピーするリストの位置を選択して、「次へ」をクリックします。
「別のアプリケーションのリスト」を選択した場合、アプリケーションを選択して、「次へ」をクリックします。
「リストを指定」で、新しいリストの名前を入力して、「コピー」をクリックします。
ページにリストを表示するには、ページにリストを追加する必要があります。
リストの作成後、リストにエントリを追加する必要があります。リスト・エントリを最初から作成すること、あるリスト・エントリをリスト内でコピーすること、または既存のエントリをあるリストから別のリストにコピーすることが可能です。
サブリストを含む階層的なリストも作成できます。階層的なリストを作成するには、次のステップを実行します。
階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。
各リスト・エントリの作成時には親リスト・アイテムを選択します。
エントリまたはサブリストを最初から追加するには、次のステップを実行します。
リスト・ページにナビゲートします。
「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「共有コンポーネント」をクリックします。
「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。
リストを選択します。
「リスト・エントリの作成」をクリックします。
リスト・エントリの作成/編集ページが表示されます。
「エントリ」で、次の項目を指定します。
親リスト・アイテム - このリスト・エントリの親を指定します。サブリストを含む階層的なリストを作成する場合は、この属性を使用します。
順序 - リスト・エントリを表示する順序を指定します。
イメージ: このリスト・エントリの表示に使用するイメージのファイル名を指定します。この属性の制御はリスト・テンプレートによって行われます。
属性 - リスト要素イメージのイメージ属性(width="12" height="12"など)を指定します。
リスト・ラベル・テキストを参照するには、#LIST_LABEL#
置換文字列を使用します。この置換文字列を使用すると、リスト・ラベル・テキストの値に基づいてタイトル・イメージ属性を自動的に設定できます。次に例を示します。
title="#LIST_LABEL#"
リスト・エントリ・ラベル: このリンクのラベル・テキストを入力します。
ターゲット位置を指定します。
ターゲット位置がURLの場合、次のように指定します。
ターゲットは: 「URL」を選択します。
URLターゲット: URLを入力します。次に例を示します。
http://www.yahoo.com
ターゲット位置がページの場合、次のステップを実行します。
ターゲット・タイプ: 「このアプリケーションのページ」を選択します。
ページ: ターゲット・ページ番号を指定します。
「このページのページ区切りをリセット」を選択することもできます。このオプションを選択すると、ユーザーの新規問合せに合うデータの最初のセットにページが戻されます。
「印刷用」も選択できます。このオプションを選択すると、アプリケーションの「印刷用」テンプレートを使用するターゲット・ページが表示されます。「印刷用」テンプレートにより、印刷用ページが最適化されます。「テーマのデフォルトのテンプレートの変更」および「印刷用ページの最適化」を参照してください。
リクエスト: 使用するリクエストを指定します。
キャッシュのクリア: キャッシュをクリアするページ番号を指定します。
セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。
「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。
「次の値を使用」で、前述のステップで指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_NAME.
など)を指定できます。URLのf?p=
に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\
など)を除いて、カンマも使用しないでください。
カレント・リスト・エントリの項目は次のとおりです。
リスト・エントリがカレントとなるページ・タイプ: ページ・タイプに基づいて、このリスト・エントリがカレントとなる時点を指定します。
リスト・アイテムはカレントまたは非カレントにできます。カレント・リスト・アイテムではカレント・テンプレートが使用され、非カレント・リスト・アイテムでは非カレント・リスト・アイテム・テンプレートが使用されます。実際の条件およびテンプレートは後続の属性で定義されます。
リスト・エントリがカレントとなる条件 - 先に選択した内容に基づいて、評価する条件を定義します。この条件がTRUEの場合は、リスト・アイテムがカレントになります。
リスト・エントリを条件付きにするには、「条件」で適切な情報を指定します。
「認可」で、認可スキームを指定できます。
この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。
「構成」で、このコンポーネントのビルド・オプションを選択できます。
ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。
「クリック・カウント」で、リスト・エントリをクリック・カウントに含むかどうかを指定できます。
これがwww.google.comのような外部ページへのリンクである場合、クリックをカウントできます。詳細は、Oracle Application Express APIリファレンスの「COUNT_CLICKプロシージャ」を参照してください。
追加属性を指定するには、「ユーザー定義属性」セクションを使用します。たとえば、次にtabindexやaccesskeyを追加します。
tabindex="15" accesskey="D"
リスト属性の定義の終了後、「作成」または「作成後、別のものの作成」をクリックします。
リスト・エントリをコピーするには、次のステップを実行します。
リスト・エントリ・ページにナビゲートします。
「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「共有コンポーネント」をクリックします。
「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。
リスト・ページで、コピーするエントリのリスト名をクリックします。
リスト・エントリ・ページが表示されます。
現行リストに表示される単一リスト・エントリをコピーするには、次のステップを実行します。
コピーする行で「コピー」アイコンをクリックします。「コピー」アイコンは、リスト内の「コピー」列に表示されます。
イメージや親など、選択したリスト・エントリのすべての属性は、新規エントリにコピーされます。
「リスト・エントリのコピー」で、適切な情報を入力して「リスト・エントリのコピー」をクリックします。
1つのリストからその他のリストにリスト・エントリをコピーするには、次のステップを実行します。
ページ右側にある「タスク」リストで、「あるリストから別のリストへのリスト・エントリのコピー」をクリックします。
「コピーのターゲットを指定」で、エントリを追加するターゲット・リストを選択し、「次へ」をクリックします。
「リスト・エントリのコピーの確認」で、「新規の結合リストのレポート」をクリックして、「コンポジット」リストを確認します。
「リスト・エントリのコピー」をクリックします。
リスト・エントリの親を変更するには、次のステップを実行します。
リスト・エントリ・ページにナビゲートします。
「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「共有コンポーネント」をクリックします。
「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。
リスト・ページで、更新するエントリのリスト名をクリックします。
リスト・エントリ・ページが表示されます。
右側にある「タスク」リストで、「このリスト内におけるリスト・エントリの親の変更」をクリックします。
リスト・エントリの親の変更ページで、次のステップを実行します。
リストおよび開始に関する適切な情報を入力して、「実行」をクリックします。
「開始」フィールドを使用して、親を変更する必要のあるエントリを特定するために、大きな階層的なリストをフィルタ処理できます。また、これらのフィールドを使用して、編集するリストのサブセットに絞り込むことができます。
「親の変更先」で、リスト・エントリの新しい親を選択します。
含めるリスト・エントリのチェック・ボックスを選択します。
「チェックしたエントリの親の変更」をクリックします。
孤立リスト・エントリとは、親が現在のリストのメンバーではないリスト・エントリです。リスト・エントリが孤立している場合は、親のエントリを削除します。
孤立リスト・エントリの親を削除するには、次のステップを実行します。
リスト・エントリ・ページにナビゲートします。
「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「共有コンポーネント」をクリックします。
「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。
リスト・ページで、更新するエントリのリスト名をクリックします。
リスト・エントリ・ページが表示されます。
右側にある「タスク」リストで、「孤立リスト・エントリの管理」をクリックします。
孤立リスト・エントリの管理ページで、次のステップを実行します。
「表示」リストから「孤立」を選択し、「実行」をクリックします。
孤立リスト・エントリのチェック・ボックスを選択します。
「親エントリの削除」をクリックします。
リストとリスト・エントリの作成後、リージョンを作成してリージョン・タイプを「リスト」に指定することによって、このリストをページに追加します。
ページにリストを追加するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
「リージョン」で、「作成」アイコンをクリックします。
「リージョン」で、リージョン・タイプとして「リスト」を選択し、「次へ」をクリックします。
「表示」で、適切な情報を指定して「次へ」をクリックします。
タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。
リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。
表示ポイント: このリージョンの表示ポイントを指定します。
ページ・テンプレート・ボディ - これらの位置は、ページ・テンプレートの#BODY#
置換文字列によって示される場所を表示します。
ページ・テンプレート・リージョン - これらの位置は、ページ・テンプレートの置換文字列(#REGION_POSITION_01#..#REGION_POSITION_08#
)で制御されます。ページ・テンプレート・リージョンの位置によって、テンプレート内にリージョンを正確に配置できます。
順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。
列 - このリージョンを表示する列を指定します。1つのページに複数のリージョンを配置でき、それらのリージョンを異なる列に表示できます。この属性はページ・テンプレート・ボディ位置に表示されるリージョンのみに適用されることに注意してください。
「ソース」で、追加するリストを選択します。
「リスト・リージョンの作成」をクリックします。
リストを追加する各ページに対して、これらのステップを実行します。
作成したリストは、リスト・ページで編集できます。
リストを編集するには、次のステップを実行します。
リスト・ページにナビゲートします。
ページ定義から、次の操作を実行します。
「ワークスペース」ホームページにナビゲートします。
「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
ページを選択します。
「共有コンポーネント」で、「すべて編集」をクリックします。
「共有コンポーネント」ページから、次のステップを実行します。
「ワークスペース」ホームページにナビゲートします。
「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「共有コンポーネント」をクリックします。
「ナビゲーション」で、「リスト」をクリックします。
リスト・ページで、「ビュー」リストから選択して、ページの外観を変更できます。
アイコン(デフォルト): 各リストを大きいアイコンとして表示します。リストを編集するには、該当するアイコンをクリックします。
詳細: 各リストをレポートで1行に表示します。リストを編集するには、リスト名をクリックします。
リストを選択します。
リスト・エントリ・ページが表示されます。
適切なリスト名を選択します。
リスト・エントリの作成/編集ページは複数のセクションに分かれています。これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。
対象となる属性を編集します。
ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。
「変更の適用」をクリックします。
リスト・エントリ・ページの「グリッド編集」をクリックすると、複数のリスト・エントリを同時に編集できます。
複数のリスト・エントリを一度に編集するには、次のステップを実行します。
「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーション・ビルダーのホームページで、「共有コンポーネント」をクリックします。
「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。
リスト名を選択します。
リスト・エントリ・ページが表示されます。
「グリッド編集」をクリックします。
該当するアイテムを編集し、「変更の適用」をクリックします。
「リスト」ページ上部の該当するタブをクリックすると、ページ別のリストの使用状況、未使用のリストおよびリスト履歴のレポートを表示できます。
注意: 「リストの使用状況」、「未使用のリスト」および「履歴」ボタンが表示されるのは、リストを作成した後のみです。 |