1. アプリケーション・ビルダー・ユーザーズ・ガイド
  2. ナビゲーションの追加
  3. ブレッドクラムの作成
  4. ブレッドクラムの手動作成

14.3.3 ブレッドクラムの手動作成

ブレッドクラムの作成ウィザードを使用するか、ページ・デザイナでブレッドクラム・リージョンを追加して、新しいページの作成時に共有コンポーネントとしてブレッドクラムを作成します。「共有コンポーネント」からブレッドクラム・エントリを追加します。

親トピック: ブレッドクラムの作成

14.3.3.1 ブレッドクラムの手動作成について

ブレッドクラムを作成し、ブレッドクラム・エントリを追加した後、リージョンを作成してブレッドクラムをページに追加することにより、ブレッドクラムを手動で作成します。

次に、ブレッドクラムを手動で作成するために必要なステップの概要を示します。

  1. ブレッドクラムを作成します。
    1. ブレッドクラムは2つの方法で作成できます:
    2. 「ブレッドクラムの作成」ダイアログで、新しいブレッドクラムの名前を入力して「作成」をクリックします。
  2. エントリをブレッドクラムに追加します。
  3. ブレッドクラム・リージョンを作成して、ブレッドクラムをページに追加します。

親トピック: ブレッドクラムの手動作成

14.3.3.2 ページ・デザイナからのブレッドクラムの作成

ページ・デザイナからブレッドクラムおよびブレッドクラム・エントリを作成します。

名前付きのブレッドクラムを作成した後、ブレッドクラム・エントリを追加できます。ブレッドクラム名によって、ブレッドクラム・エントリのコレクションに名前を付ける方法が提供されます。

ページ・デザイナから手動でブレッドクラムを作成するには:

  1. ページ・デザイナでページを表示します。
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
    2. アプリケーションを選択します。
    3. ページを選択します。
    ページ・デザイナが表示されます。
  2. ブレッドクラムを作成します。
    1. ページ・デザイナの左ペインで、「ページ共有コンポーネント」タブをクリックします。
    2. 「ブレッドクラム」を右クリックし、「作成」を選択します。
      「ブレッドクラムの作成」ダイアログが表示されます。
    3. ブレッドクラム名 - この新しいブレッドクラムの名前を入力します。名前付きのブレッドクラムを作成した後、ブレッドクラム・エントリを追加できます。
    4. 「作成」をクリックします。
    ブレッドクラムの編集ページが表示され、左側のペインにブレッドクラムが表示されます。
  3. 次に、ブレッドクラム・エントリを作成します。「新規エントリ」をクリックします。
    ブレッドクラム・エントリが表示されます。
  4. 「ブレッドクラム・エントリ」で、次の項目を指定します:
    1. ページ - このブレッドクラム・エントリが表示されるページを選択します。
    2. 親エントリ - このエントリの親を指定します。ブレッドクラムには、親IDを持たないアイテムとして識別されるルート・ノードが1つのみ必要です。
    3. 順序 - ブレッドクラム・エントリを表示する順序を指定します。これによって評価の順序が決まります。
    4. 短縮名 - このブレッドクラム・エントリの短縮名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。
    5. ページ名とタイトルの同期 - 対応する「ページ名」および「タイトル」をブレッドクラムの短縮名で更新するには、このオプションを有効にします。
    6. 詳細な名前 - このブレッドクラム・エントリの詳細名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。
  5. ターゲット - ターゲット位置を指定します。「ターゲットは」属性に対して、次のいずれかを選択します。
    • このアプリケーションのページ
    • URL
    UIは、選択した内容に応じて変わります。
  6. ターゲットが「このアプリケーションのページ」である場合、次のステップを実行します。
    1. ターゲットは - 「このアプリケーションのページ」を選択します。
    2. ページ - ターゲット・ページ番号を指定します。

      ページのページ区切りをリセットするには、「このページのページ区切りをリセット」を選択します。

    3. リクエスト - REQUESTと呼ばれる組込みアプリケーション・アイテムを設定するテキストを入力します。これは、クリックしたボタンの名前で設定されるアイテムでもあります。
    4. キャッシュのクリア - ユーザーのセッション・ステートをクリアするページのページ番号を、カンマで区切って入力します。
    5. セッション・ステートを設定するには(リストされたアイテムに値を与えます):

      • 次のアイテムを設定 - セッション・ステートを設定(リストしたアイテムに値を指定)するアプリケーション・アイテム名をカンマで区切って入力します。

      • 次の値を使用 - 次のアイテムを「設定」で指定したアイテムの値をカンマで区切って入力します。静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。

      静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

  7. ターゲットが「URL」である場合、次のステップを実行します。
    1. ターゲットは - 「URL」を選択します。
    2. URLターゲット - ブレッドクラム・エントリをクリックした場合に移動するURLを指定します。
  8. 「条件」で、次のステップを実行します。
    1. 条件タイプ - リストから条件タイプを選択します。この条件は、このコンポーネントをレンダリングまたは処理するために必要です。
    2. 表示されるフィールドに式を入力します。
  9. 認可 - オプションで認可スキームを選択します。この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。
  10. 構成 - このコンポーネントのビルド・オプションを選択します。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。
  11. 「エントリの作成」をクリックします。
    ブレッドクラムの編集ページが表示されます。左ペインのブレッドクラムに新しいエントリが表示されます。
  12. 別のブレッドクラム・エントリを作成します。
    1. 「新規エントリ」をクリックします。
      左ペインのブレッドクラムにブレッドクラム・エントリが表示されます。
    2. ステップ4から、作成するブレッドクラム・エントリごとに前のステップを繰り返します。

次に、リージョンを作成して、ブレッドクラムをページに追加します。

親トピック: ブレッドクラムの手動作成

14.3.3.3 「共有コンポーネント」からのブレッドクラムの作成

共有コンポーネントでブレッドクラムおよびブレッドクラム・エントリを作成します。

名前付きのブレッドクラムを作成した後、ブレッドクラム・エントリを追加できます。ブレッドクラム名によって、ブレッドクラム・エントリのコレクションに名前を付ける方法が提供されます。

共有コンポーネントから手動でブレッドクラムを作成するには:

  1. ブレッドクラム・ページにナビゲートします。
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
    2. アプリケーションを選択します。
    3. 「共有コンポーネント」をクリックします。
    4. 「ナビゲーションと検索」で、「ブレッドクラム」をクリックします。
    ブレッドクラム・ページが表示されます。
  2. ブレッドクラムを作成します。
    1. 「ブレッドクラムの作成」をクリックします。
    2. 「ブレッドクラムの作成」ダイアログで、次の項目を指定します:
      「ブレッドクラムの作成」ダイアログが表示されます。
    3. ブレッドクラム名 - この新しいブレッドクラムの名前を入力します。名前付きのブレッドクラムを作成した後、ブレッドクラム・エントリを追加できます。
    4. 「作成」をクリックします。
    ブレッドクラムの編集ページが表示され、左側のペインにブレッドクラムが表示されます。
  3. 次に、ブレッドクラム・エントリを作成します。「新規エントリ」をクリックします。
    ブレッドクラム・エントリが表示されます。
  4. 「ブレッドクラム・エントリ」で、次の項目を指定します:
    1. ページ - このブレッドクラム・エントリが表示されるページを選択します。
    2. 親エントリ - このエントリの親を指定します。ブレッドクラムには、親IDを持たないアイテムとして識別されるルート・ノードが1つのみ必要です。
    3. 順序 - ブレッドクラム・エントリを表示する順序を指定します。これによって評価の順序が決まります。
    4. 短縮名 - このブレッドクラム・エントリの短縮名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。
    5. ページ名とタイトルの同期 - 対応する「ページ名」および「タイトル」をブレッドクラムの短縮名で更新するには、このオプションを有効にします。
    6. 詳細な名前 - このブレッドクラム・エントリの詳細名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。
  5. ターゲット - ターゲット位置を指定します。「ターゲットは」属性に対して、次のいずれかを選択します。
    • このアプリケーションのページ
    • URL
    UIは、選択した内容に応じて変わります。
  6. ターゲットが「このアプリケーションのページ」である場合、次のステップを実行します。
    1. ターゲットは - 「このアプリケーションのページ」を選択します。
    2. ページ - ターゲット・ページ番号を指定します。

      ページのページ区切りをリセットするには、「このページのページ区切りをリセット」を選択します。

    3. リクエスト - REQUESTと呼ばれる組込みアプリケーション・アイテムを設定するテキストを入力します。これは、クリックしたボタンの名前で設定されるアイテムでもあります。
    4. キャッシュのクリア - ユーザーのセッション・ステートをクリアするページのページ番号を、カンマで区切って入力します。
    5. セッション・ステートを設定するには(リストされたアイテムに値を与えます):

      • 次のアイテムを設定 - セッション・ステートを設定(リストしたアイテムに値を指定)するアプリケーション・アイテム名をカンマで区切って入力します。

      • 次の値を使用 - 次のアイテムを「設定」で指定したアイテムの値をカンマで区切って入力します。静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。

      静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

  7. ターゲットが「URL」である場合、次のステップを実行します。
    1. ターゲットは - 「URL」を選択します。
    2. URLターゲット - ブレッドクラム・エントリをクリックした場合に移動するURLを指定します。
  8. 「条件」で、次のステップを実行します。
    1. 条件タイプ - リストから条件タイプを選択します。この条件は、このコンポーネントをレンダリングまたは処理するために必要です。
    2. 表示されるフィールドに式を入力します。
  9. 認可 - オプションで認可スキームを選択します。この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。
  10. 構成 - このコンポーネントのビルド・オプションを選択します。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。
  11. 「エントリの作成」をクリックします。
    ブレッドクラムの編集ページが表示されます。左ペインのブレッドクラムに新しいエントリが表示されます。
  12. 別のブレッドクラム・エントリを作成します。
    1. 「新規エントリ」をクリックします。
      左ペインのブレッドクラムにブレッドクラム・エントリが表示されます。
    2. ステップ4から、作成するブレッドクラム・エントリごとに前のステップを繰り返します。

次に、リージョンを作成して、ブレッドクラムをページに追加します。

親トピック: ブレッドクラムの手動作成

14.3.3.4 ウィザードを使用したブレッドクラム・リージョンの追加

ギャラリからブレッドクラム・リージョンを追加します。

ヒント:

ブレッドクラム・リージョンを作成する前に、ブレッドクラムを作成します。まだ定義されていない場合は、ブレッドクラム・エントリを作成するようにウィザードによって指示されます。

ウィザードを使用してブレッドクラム・リージョンを作成するには:

  1. ページ・デザイナでページを表示します。
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
    2. アプリケーションを選択します。
    3. ページを選択します。
    ページ・デザイナが表示されます。
  2. ページ上部のページ・デザイナ・ツールバーで、「作成」メニューをクリックして「ブレッドクラム・リージョン」を選択します。
    ブレッドクラムの作成ウィザードが表示されます。
  3. 「リージョン属性」で、次のステップを実行します。
    1. リージョン・タイトル - リージョンのタイトル(Breadcrumbなど)を入力します。
    2. リージョン・テンプレート - リージョン・テンプレートを選択します。
      ユニバーサル・テーマの場合、アプリケーション・ブレッドクラムには配置用の特別な場所があります。Oracleでは、「タイトル・バー」リージョン・テンプレートを使用することをお薦めします。
    3. 表示ポイント - 表示ポイントを指定します。
    4. 順序 - このコンポーネントの順序を指定します。これによって評価の順序が決まります。
    5. 「次」をクリックします。
  4. ブレッドクラムを指定します。
    1. ブレッドクラム - このリージョンに関連付けるブレッドクラムを選択します。
    2. ブレッドクラム・テンプレート - ブレッドクラム・テンプレートを指定します。
    3. 「次」をクリックします。
  5. ブレッドクラム・エントリが作成されていない場合、ウィザードから作成するよう求められます。「ブレッドクラム・エントリ」で、次の項目を指定します:
    1. ブレッドクラム・エントリ・ラベル - このブレッドクラム・エントリのラベルを指定します。
    2. 親エントリ - このブレッドクラム・エントリの階層親を選択します。
    3. 「次」をクリックします。
  6. 選択内容を確認して、「終了」をクリックします。

親トピック: ブレッドクラムの手動作成

14.3.3.5 ギャラリからのブレッドクラム・リージョンの追加

ギャラリからブレッドクラム・リージョンを追加します。

ヒント:

ブレッドクラム・リージョンを作成する前に、Oracleではブレッドクラムを作成してブレッドクラム・エントリを追加することをお薦めします。

ギャラリからブレッドクラム・リージョンを作成するには:

  1. ページ・デザイナでページを表示します。
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
    2. アプリケーションを選択します。
    3. ページを選択します。
    ページ・デザイナが表示されます。

    ノート:

    ページ下部にギャラリが表示されます。コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。

  2. ページ下部のギャラリから、次の手順を実行します。
    1. 「リージョン」タブをクリックします。
    2. 「ブレッドクラム」を右クリックします。
    3. 「追加先」を選択し、ブレッドクラム・バーなどの適切な場所を選択します。

    ヒント:

    ギャラリで「ブレッドクラム」リージョンを選択して、「レイアウト」タブの適切な位置までドラッグすることもできます。

    ページ・デザイナは、次に必要なアクションを示します。エラーが発生した場合は、「保存」ボタンの横に「メッセージ」が表示されます。「メッセージ」アイコンをクリックすると、すべてのエラーを示すダイアログが表示されます。エラーを選択すると、プロパティ・エディタの関連する属性がハイライトされます。

  3. プロパティ・エディタで、次のリージョン属性を編集します。

    ヒント:

    属性についてさらに学習するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

    1. 指定、タイトル - リージョン・タイトルを入力します。リージョン・タイトルは、リージョン・テンプレートに定義されている場合にのみ表示されます。
    2. ソース、ブレッドクラム - ページに追加するブレッドクラムを選択します。
    3. レイアウト、順序 - このアイテムの表示順序を入力します。順序および他のレイアウト設定によって、リージョン内の他のアイテムに対して相対的に、このアイテムの表示位置が決定されます。
    4. レイアウト、位置 - このリージョンの表示に使用されるテンプレートの位置を選択します。使用可能な選択肢は、ページのユーザー・インタフェースに対して現在のテーマ内に定義されている適切なテンプレートの位置から導出されます。
    5. 外観、テンプレート - リージョン・テンプレートを選択して、このリージョンの外観とレイアウトを定義します。
      ユニバーサル・テーマの場合、アプリケーション・ブレッドクラムには配置用の特別な場所があります。Oracleでは、「タイトル・バー」リージョン・テンプレートを使用することをお薦めします。
    6. 外観、コンポーネントのレンダリング - リージョン・コンポーネントがメイン・リージョン・コンテンツの上または下に表示する場合に選択します。
  4. 「保存」をクリックします。

ブレッドクラムを追加する各ページに対して、これらの手順を実行します。

親トピック: ブレッドクラムの手動作成

14.3.3.6 動的ブレッドクラムの作成について

より詳細なコンテキストを表示するために、ブレッドクラムにセッション・ステートを含めて、ブレッドクラムを動的にすることができます。たとえば、アプリケーションのページに特定の会社への注文リストが表示される場合に、次のブレッドクラムを含めるとします。

Home > Orders > Orders for ACME Inc

この例で、ACME Incは、ユーザーが現在表示しているページおよびナビゲーション・パスも示しています。Oracle APEXエンジンによって、ACME Inc.の値がセッション・ステートに格納されます。

このタイプの動的メニューを作成するには、ブレッドクラムの短縮名または詳細な名前に、セッション・ステート・アイテムへの参照を含める必要があります。たとえば:

&COMPANY_NAME.

親トピック: ブレッドクラムの手動作成