16.3 ブレッドクラムの作成

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

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

関連項目:

• 新しいテーマへのアクセス

• ブレッドクラム・テンプレート

16.3.1 ブレッドクラムとは

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

図bc_menu.pngの説明

関連項目:

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

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

ページの作成中にブレッドクラムを作成するには:

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

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

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

関連項目:

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

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

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

• ブレッドクラムの手動作成について
  
• 共有コンポーネントとしてのブレッドクラムの作成
  
• ブレッドクラムの作成ウィザードを使用したブレッドクラム・リージョンの作成
  
• ページへのブレッドクラム・リージョンの追加
  
• ブレッドクラムへのエントリの追加
  
• 動的ブレッドクラムの作成について
  

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

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

1. ブレッドクラムの作成/編集ウィザードを実行してブレッドクラムを作成します。このウィザードには、次の2つの方法でアクセスできます。
   • 共有コンポーネント・ページに移動して、「ブレッドクラムの作成」を選択します。
   • ページ・デザイナで、「作成」メニューを選択してから「ブレッドクラム・リージョン」を選択します。
2. エントリをブレッドクラムに追加します。
3. リージョンを作成して、ブレッドクラムをページに追加します。

関連項目:

ブレッドクラムへのエントリの追加およびページへのブレッドクラム・リージョンの追加

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

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

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

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

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

関連項目:

ブレッドクラムへのエントリの追加

16.3.3.3 ブレッドクラムの作成ウィザードを使用したブレッドクラム・リージョンの作成

ページ・デザイナでブレッドクラム・リージョンを作成するには:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

16.3.3.4 ページへのブレッドクラム・リージョンの追加

ブレッドクラム・リージョンをページに追加するには:

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

   ノート:

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

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

   ヒント:

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

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

3. プロパティ・エディタで、ブレッドクラム属性を編集します。

   ヒント:

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

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

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

16.3.3.5 ブレッドクラムへのエントリの追加

ブレッドクラムにエントリを追加するには:

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. 「ブレッドクラム・エントリの作成」をクリックします。

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

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

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

Home > Orders > Orders for ACME Inc

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

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

&COMPANY_NAME.

16.3.4 ブレッドクラムの編集

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

ブレッドクラムを編集するには:

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

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

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

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

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

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

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

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

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

関連項目:

• ヘルプの表示

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

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

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

ブレッドクラム・エントリの親を変更するには:

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

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

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

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

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

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

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

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

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

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

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

未使用のブレッドクラム・エントリを削除するには:

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

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

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

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

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

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

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

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

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

ノート:

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

ブレッドクラム・レポートを表示するには:

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

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

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

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

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

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

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

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

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

関連項目:

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