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

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

• ブレッドクラムの手動作成について
  ブレッドクラムを作成し、ブレッドクラム・エントリを追加した後、リージョンを作成してブレッドクラムをページに追加することにより、ブレッドクラムを手動で作成します。
• 「共有コンポーネント」からのブレッドクラムの作成
  「共有コンポーネント」からアクセスできる「ブレッドクラム」ページでブレッドクラムを作成します。
• ページ・デザイナでのブレッドクラム・リージョンの作成
  ブレッドクラムの作成ウィザードを実行して、ページ・デザイナでブレッドクラム・リージョンを手動で作成します。
• リージョンの作成によるページへのブレッドクラムの追加
  ブレッドクラムを作成したら、ブレッドクラム・リージョンを作成して、それをページに追加します。
• ブレッドクラムへのエントリの追加
  「共有コンポーネント」からブレッドクラム・エントリを追加します。
• 動的ブレッドクラムの作成について
  

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

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

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

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

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

「共有コンポーネント」からアクセスできる「ブレッドクラム」ページでブレッドクラムを作成します。

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
4. 「ナビゲーション」で、「ブレッドクラム」をクリックします。
   ブレッドクラム・ページが表示されます。
5. 「ブレッドクラムの作成」をクリックします。
6. 名前を入力して、「作成」をクリックします。
7. ブレッドクラム・エントリを追加します。

関連項目:

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

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

ブレッドクラムの作成ウィザードを実行して、ページ・デザイナでブレッドクラム・リージョンを手動で作成します。

ブレッドクラムの作成ウィザードによって、ブレッドクラム・リージョンおよびブレッドクラム・エントリが作成されます。

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

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. ページ上部のページ・デザイナ・ツールバーで、「作成」メニューをクリックして「ブレッドクラム・リージョン」を選択します。
   ブレッドクラムの作成ウィザードが表示されます。
3. 「リージョン属性」で、次のステップを実行します。
   1. リージョン・タイトル: リージョンのタイトルを入力します。
   2. リージョン・テンプレート: リージョン・テンプレートを選択します。
   3. 表示ポイント: 表示ポイントを指定します。
   4. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。
   5. 「次」をクリックします。
4. 「ブレッドクラム」で、次のステップを実行します。
   1. ブレッドクラム: このリージョンに関連付けるブレッドクラムを選択します。
   2. ブレッドクラム・テンプレート: ブレッドクラム・テンプレートを指定します。
   3. 「次」をクリックします。
5. 「ブレッドクラム・エントリ」で、次のステップを実行します。
   1. ブレッドクラム・エントリ・ラベル: このブレッドクラム・エントリのラベルを指定します。
   2. 親エントリ: このブレッドクラム・エントリの階層親を選択します。
   3. 「次」をクリックします。
6. 選択内容を確認して、「終了」をクリックします。

15.2.3.4 リージョンの作成によるページへのブレッドクラムの追加

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

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

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

   ノート:

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

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

   ヒント:

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

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

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

   ヒント:

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

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

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

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

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

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

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

Home > Orders > Orders for ACME Inc

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

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

&COMPANY_NAME.