プライマリ・コンテンツに移動

Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース5.1 E83810-03 |
| 目次 | 索引

前 | 次 |

# 14.3 ブレッドクラムの作成

ブレッドクラムを使用すると、階層的にナビゲートできます。ブレッドクラムは、テンプレートを使用して表示されるリンクの階層的なリストです。ブレッドクラムは、リンクのリストまたはブレッドクラム・パスとして表示できます。

トピック:

- ブレッドクラムとは
- ページ作成中のブレッドクラムの作成
- ブレッドクラムの手動作成
- ブレッドクラムの編集
- ブレッドクラム・エントリの親の変更
- 未使用のブレッドクラム・エントリの削除
- ブレッドクラム・レポートへのアクセス

関連項目:

- 「テーマの作成」

- 「ブレッドクラム・テンプレート」

## 14.3.1 ブレッドクラムとは

ブレッドクラムは、アプリケーション内のどの部分が表示されているかを階層で示すリンクの階層リストです。特定のブレッドクラム・リンクをクリックすると、すぐにページを表示できます。各ページの上部でナビゲーションの第2レベルとしてブレッドクラムを使用し、タブおよびリストなどの他のユーザー・インタフェース要素を補完します。

図GUID-8EE282AC-E549-431D-8AE2-524AF526ADEE-default.pngの説明

関連項目:

サンプル・データベース・アプリケーションの理解

## 14.3.2 ページ作成中のブレッドクラムの作成

ページの作成中にブレッドクラムを作成するには、次のステップを実行します。

1. ページの作成ウィザードを実行して、新規ページを追加します。

   ウィザードの途中で、「ブレッドクラム」オプションが表示されます。このリストが表示される実際のページは、作成するページのタイプによって異なります。

2. 「ブレッドクラム」リストから、「ブレッドクラム」を選択するか、既存のブレッドクラムを選択します(使用可能な場合)。
3. 「ブレッドクラム」を選択する場合は、次のステップを実行します。
   1. 親エントリ - 親ページ(使用可能な場合)を選択するか、「親エントリなし」を選択します。
   2. エントリ名 - ブレッドクラムの名前を入力します。
4. 画面に表示されるステップに従います。

関連項目:

データベース・アプリケーションのページの管理

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

この項では、ブレッドクラムを手動で作成する方法について説明します。

トピック:

- ブレッドクラムの手動作成について
- ブレッドクラムの作成
- ブレッドクラム・エントリの追加
- ブレッドクラム・リージョンの追加
- 動的ブレッドクラムの作成について

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

ブレッドクラムを手動で作成するには、次のように、アプリケーションの各ページにブレッドクラムを追加する必要があります。

1. ブレッドクラムの作成/編集ウィザードを実行してブレッドクラムを作成します。このウィザードには、共有コンポーネント・ページ、ページ・デザイナまたはコンポーネント・ビューからアクセスできます。
2. エントリをブレッドクラムに追加します。
3. リージョンを作成して、ブレッドクラムをページに追加します。

関連項目:

- ブレッドクラムの作成

- 「ブレッドクラム・エントリの追加」

- 「ブレッドクラム・リージョンの追加」

### 14.3.3.2 ブレッドクラムの作成

この項では、ブレッドクラムを作成する様々な方法について説明します。

トピック:

- 共有コンポーネントとしてのブレッドクラムの作成
- ページ・デザイナでのブレッドクラム・リージョンの作成
- コンポーネント・ビューからのブレッドクラムの作成

#### 14.3.3.2.1 共有コンポーネントとしてのブレッドクラムの作成

共有コンポーネント・ページからブレッドクラムを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
4. 「ナビゲーション」で、「ブレッドクラム」をクリックします。

   ブレッドクラム・ページが表示されます。

5. 「ブレッドクラムの作成」をクリックします。
6. 名前を入力して、「作成」をクリックします。
7. ブレッドクラム・エントリを追加します。

関連項目:

「ブレッドクラム・エントリの追加」

#### 14.3.3.2.2 ページ・デザイナでのブレッドクラム・リージョンの作成

ページ・デザイナでブレッドクラム・リージョンを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. ページ上部のページ・デザイナ・ツールバーに移動します。
3. ページ・デザイナ・ツールバーで、「作成」メニューをクリックして「ブレッドクラム・リージョン」を選択します。

   ブレッドクラムの作成ウィザードが表示されます。

4. 「リージョン属性」は、次のようにします。

   1. リージョン・タイトル: リージョンのタイトルを入力します。

   2. リージョン・テンプレート: リージョン・テンプレートを選択します。

   3. 表示ポイント: 表示ポイントを指定します。

   4. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

   5. 「次へ」をクリックします。

5. 「ブレッドクラム」は、次のようにします。

   1. ブレッドクラム: このリージョンに関連付けるブレッドクラムを選択します。

   2. ブレッドクラム・テンプレート: ブレッドクラム・テンプレートを指定します。

   3. 「次へ」をクリックします。

6. 「ブレッドクラム・エントリ」は、次のようにします。

   1. ブレッドクラム: このブレッドクラム・エントリのラベルを指定します。

   2. 親エントリ: このブレッドクラム・エントリの階層親を選択します。

   3. 「次へ」をクリックします。

7. 選択内容を確認して、「終了」をクリックします。

#### 14.3.3.2.3 コンポーネント・ビューからのブレッドクラムの作成

コンポーネント・ビューからブレッドクラムを作成するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。レガシー・コンポーネント・ビューでのページの表示を参照してください。
2. 「作成」メニューをクリックして、「共有コンポーネント」を選択します。
3. 「アプリケーション・コンポーネントの作成」で、「ブレッドクラム」を選択して「次へ」をクリックします。
4. 「ブレッドクラム名」に、このブレッドクラムの名前を入力して「作成」をクリックします。
5. 名前付きのブレッドクラムを作成した後、ブレッドクラム・エントリを追加できます。

関連項目:

「ブレッドクラム・エントリの追加」

### 14.3.3.3 ブレッドクラム・エントリの追加

ブレッドクラム・エントリを追加するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。
   1. 「ワークスペース」ホームページにナビゲートします。
   2. 「アプリケーション・ビルダー」アイコンをクリックします。
   3. アプリケーションを選択します。
   4. 「共有コンポーネント」をクリックします。
   5. 「ナビゲーション」で、「ブレッドクラム」をクリックします。

      ブレッドクラム・ページが表示されます。

2. エントリを追加するブレッドクラムを選択します。
3. 「ブレッドクラム・エントリの作成」をクリックします。
4. 「ブレッドクラム」で、このブレッドクラム・エントリが表示されるページを選択します。
5. 「エントリ」で、次のステップを実行します。
   1. 順序: ブレッドクラム・エントリを表示する順序を指定します。これによって評価の順序が決まります。
   2. 親エントリ: このエントリの親を指定します。ブレッドクラムには、親IDを持たないアイテムとして識別されるルート・ノードが1つのみ必要です。
   3. 短縮名: このブレッドクラム・エントリの短縮名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。
   4. 詳細な名前: このブレッドクラム・エントリの詳細名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。
6. 「ターゲット」で、ターゲットの場所を指定します。
   1. ターゲットは: 「このアプリケーションのページ」を選択します。
   2. ページ: ターゲット・ページ番号を指定します。

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

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

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

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

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

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

作成する各ブレッドクラム・エントリに対して、これらのステップを実行します。

### 14.3.3.4 ブレッドクラム・リージョンの追加

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。ブレッドクラムおよびブレッドクラム・テンプレートを作成した後、リージョンを作成します。ブレッドクラム・リージョンを作成すると、ページにブレッドクラムを追加できます。

トピック:

- ページ・デザイナでのブレッドクラム・リージョンの追加
- レガシー・コンポーネント・ビューでのブレッドクラム・リージョンの追加

関連項目:

- 「新しいテンプレートの作成」

- メニュー表示の変更方法については、「ブレッドクラム・テンプレート」を参照してください

#### 14.3.3.4.1 ページ・デザイナでのブレッドクラム・リージョンの追加

ページ・デザイナでブレッドクラム・リージョンを作成するには、次のステップを実行します。

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

   注意:

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

2. ギャラリで、「リージョン」タブをクリックします。次に、「ブレッドクラム」を右クリックして「追加先」を選択し、適切な位置を選択します。

   ヒント:

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

   ページ・デザイナは、次に必要なアクションを示します。

   「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

   - エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

   - 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。
4. プロパティ・エディタで、ブレッドクラム属性を編集します。

   ヒント:

   属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

   1. 指定、タイトル - リージョン・タイトルを入力します。リージョン・タイトルは、リージョン・テンプレートに定義されている場合にのみ表示されます。
   2. レイアウト、順序 - このアイテムの表示順序を入力します。順序および他のレイアウト設定によって、リージョン内の他のアイテムに対して相対的に、このアイテムの表示位置が決定されます。
   3. レイアウト、位置 - このリージョンの表示に使用されるテンプレートの位置を選択します。使用可能な選択肢は、ページのユーザー・インタフェースに対して現在のテーマ内に定義されている適切なテンプレートの位置から導出されます。
   4. 外観、テンプレート - リージョン・テンプレートを選択して、このリージョンの外観とレイアウトを定義します。詳細は、中央ペインで「ヘルプ」タブをクリックします。
   5. 外観、アイテム表示位置 - メイン・リージョン・コンテンツに対して相対的に、ページ・アイテムの表示位置を指定します。
5. 「保存」をクリックします。

ブレッドクラム・ナビゲーションを追加する各ページに対して、これらのステップを実行します。

#### 14.3.3.4.2 レガシー・コンポーネント・ビューでのブレッドクラム・リージョンの追加

コンポーネント・ビューでブレッドクラム・リージョンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。
2. 「リージョン」で、「作成」アイコンをクリックします。

   「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプについて、「ブレッドクラム」を選択して「次へ」をクリックします。
4. 「ブレッドクラム・コンテナ・リージョン」で、次のステップを実行します。
   1. リージョン・タイトル: リージョンのタイトルを入力します。
   2. リージョン・テンプレート: リージョン・テンプレートを選択します。
   3. 表示ポイント: 表示ポイントを選択します。

      リージョンは、位置(または表示ポイント)別に編成されています。リージョンの適切な位置を決定するには、懐中電灯アイコンをクリックします。グラフィカルな画面が表示されます。

   4. 順序: 順序の番号を入力します。これによって評価の順序が決まります。
   5. 「次へ」をクリックします。
5. 「ブレッドクラム」は、次のようにします。
   1. ブレッドクラム: このリージョンに関連付けるブレッドクラムを選択します。
   2. ブレッドクラム・テンプレート: テンプレートを選択します。
   3. 「次へ」をクリックします。
6. ブレッドクラム・リージョンの情報を確認し、「次へ」をクリックします。
7. 「終了」をクリックします。

ブレッドクラム・ナビゲーションを追加する各ページに対して、これらのステップを実行します。

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

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

    Home > Orders > Orders for ACME Inc

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

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

    &COMPANY_NAME.

## 14.3.4 ブレッドクラムの編集

作成したブレッドクラムは、ブレッドクラム・ページで編集できます。

ブレッドクラムを編集するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。
   1. 「ワークスペース」ホームページにナビゲートします。
   2. 「アプリケーション・ビルダー」アイコンをクリックします。
   3. アプリケーションを選択します。
   4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
   5. 「ナビゲーション」で、「ブレッドクラム」を選択します。

      ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。
3. ブレッドクラム・エントリを選択します。

   作成/編集ページが表示されます。

4. 対象となる属性を編集します。

   特定のアイテムの詳細は、フィールドレベル・ヘルプを参照してください。

5. オプション)ページ右側にある「ブレッドクラム・エントリ」リストで、ページ名とタイトルとのブレッドクラムの同期化に関するオプションを選択できます。

   このオプションを選択することで、ページ名とブレッドクラムの変更が1ステップでできるようになります。ブレッドクラム名に指定した情報は、参照ページ名とタイトルの更新に使用されます。

6. 「変更の適用」をクリックします。

関連項目:

- 「フィールドレベル・ヘルプの表示」

- ブレッドクラム・レポートへのアクセス

## 14.3.5 ブレッドクラム・エントリの親の変更

エントリの親の変更ページの選択ブレッドクラム・エントリに新たな親を選択できます。

ブレッドクラム・エントリの親を変更するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。
   1. 「ワークスペース」ホームページにナビゲートします。
   2. 「アプリケーション・ビルダー」アイコンをクリックします。
   3. アプリケーションを選択します。
   4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
   5. 「ナビゲーション」で、「ブレッドクラム」を選択します。

      ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。

   エントリ・ページが表示されます。

3. 「タスク」リストから、「このブレッドクラム内におけるエントリの親の変更」をクリックします。

   エントリの親の変更ページが表示されます。

4. ビューを編集またはフィルタを適用するためにナビゲーション・バーを使用するには、次のステップを実行します。

   - ブレッドクラム: 編集するブレッドクラムを指定して、「実行」をクリックします。

   - 開始: ブレッドクラム階層のサブセットの表示の制限を選択し、「実行」をクリックします。

5. 「親の変更先」から、新たな親を選択します。
6. 移動するブラッドクラム・エントリを選択し、「チェックしたエントリの親の変更」をクリックします。

## 14.3.6 未使用のブレッドクラム・エントリの削除

未使用のブレッドクラム・エントリを削除するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。
   1. 「ワークスペース」ホームページにナビゲートします。
   2. 「アプリケーション・ビルダー」アイコンをクリックします。
   3. アプリケーションを選択します。
   4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
   5. 「ナビゲーション」で、「ブレッドクラム」を選択します。

      ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。

   ブレッドクラム・エントリ・ページが表示されます。

3. 「タスク」リストで、「未使用のブレッドクラム・エントリの削除」をクリックします。

   削除ページが表示されます。

4. 削除するエントリを選択し、「チェックした項目の削除」をクリックします。

## 14.3.7 ブレッドクラム・レポートへのアクセス

ブレッドクラム・ページ上部の該当するタブをクリックして、「ブレッドクラム階層」、「ブレッドクラムのグリッド編集」、「ブレッドクラムの例外」、「ブレッドクラムの使用状況」および「ブレッドクラム履歴」レポートを表示できます。

注意:

これらのレポートが表示されるのは、ブレッドクラムを作成した後のみです。

ブレッドクラム・レポートを表示するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。
   1. 「ワークスペース」ホームページにナビゲートします。
   2. 「アプリケーション・ビルダー」アイコンをクリックします。
   3. アプリケーションを選択します。
   4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
   5. 「ナビゲーション」で、「ブレッドクラム」を選択します。

      ブレッドクラム・ページが表示されます。

2. 該当するタブをクリックします。

   - 階層 - 「階層」をクリックすると、ブレッドクラムがページおよび階層別に表示されます。ページにリンクするにはページ番号をクリックします。

   - グリッド編集 - 「グリッド編集」をクリックすると、一度にすべてのブラッドクラム名を編集できます。ページにリンクするにはページ番号をクリックします。

   - 例外 - 「例外」をクリックすると、例外ページが表示されます。

   - 使用状況 - 「使用状況」をクリックすると、ブレッドクラム・レポートにアクセスできます。このレポートには、ブレッドクラムがページごとに表示されます。ページ番号をクリックして、特定のページに進みます。

   - 履歴 「履歴」をクリックすると、ブレッドクラムの履歴レポートにアクセスできます。このレポートには、ブレッドクラムの最近の変更が示されます。

ページの外観は、ページ上部にある検索バーを使用して変更できます。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」