プライマリ・コンテンツに移動
Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド
リリース5.0
E64891-02
  目次へ移動
目次
索引へ移動
索引

前
 
次
 

12.4 アプリケーションのヘルプの作成

アプリケーション・ビルダーで作成したヘルプは、専用の「ヘルプ」ページに表示されます。ヘルプを表示するには、専用の「ヘルプ」ページへのリンクをクリックします。このヘルプ・ページには、表示しているページに固有のページ・ヘルプおよびフィールドレベル・ヘルプのトピックが表示されます。

12.4.1 ページ・デザイナでのヘルプの作成

この項では、ページ・デザイナでヘルプを作成する方法について説明します。

12.4.1.1 ヘルプの作成について

アプリケーション・ビルダーには、アプリケーションのヘルプを作成するための組込み属性が含まれています。アプリケーションのヘルプを作成するには、次のステップを実行します。

12.4.1.2 ページ・デザイナでのヘルプ・ページおよびヘルプ・リージョンの作成

ページ・デザイナでヘルプ・ページおよびヘルプ・リージョンを作成するには、次のステップを実行します。

  1. ヘルプ用の空白ページを作成します。「アプリケーションのホームページからのページの作成」を参照してください。

  2. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。

    ページ・デザイナが表示されます。

  3. ギャラリから、「ヘルプ・テキスト」リージョンを選択して、グリッド・レイアウトの適切な場所にドラッグします。


    ヒント:

    「ヘルプ・テキスト」リージョンを右クリックして、「追加先」を選択し、適切な場所を選択することもできます。

  4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

  5. リージョン属性を編集します。


    ヒント:

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

    1. 指定、タイトル - リージョンのタイトルを入力します。

    2. レイアウト - 「順序」、「親リージョン」および「位置」を指定します。

    3. 外観 - 「テンプレート」および「アイテム表示位置」を指定します。

  6. 「保存」をクリックします。

12.4.1.3 ページ・デザイナでのページ・ヘルプの定義

ページ・デザイナでページ・ヘルプ・テキストを定義するには、次のステップを実行します。

  1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。

    ページ・デザイナが表示されます。

  2. 「レンダリング」ツリーで、ページ名をクリックします。

  3. 「プロパティ・エディタ - ページ」で、「ヘルプ」まで下にスクロールして「ヘルプ・テキスト」属性にテキストを入力します。


    ヒント:

    デフォルトでは、「ヘルプ」にはテキストNo help is available for this pageが入力されています。

  4. 「保存」をクリックします。

12.4.1.4 ページ・デザイナでのアイテム・ヘルプの定義

ページ・デザイナでページ・ヘルプ・テキストを定義するには、次のステップを実行します。

  1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。

    ページ・デザイナが表示されます。

  2. 「レンダリング」ツリーで、ヘルプを定義するアイテムをクリックします。

  3. 「プロパティ・エディタ - ページ・アイテム」で、「ヘルプ」まで下にスクロールして「ヘルプ・テキスト」属性にテキストを入力します。

  4. 「保存」をクリックします。

    ヘルプ・テキストが必要な各アイテムに対して、これらのステップを実行します。

12.4.2 コンポーネント・ビューでのヘルプの作成

この項では、コンポーネント・ビューでヘルプを作成する方法について説明します。

12.4.2.1 ヘルプの作成について

アプリケーション・ビルダーには、アプリケーションのヘルプを作成するための組込み属性が含まれています。アプリケーションのヘルプを作成するには、次のステップを実行します。

アプリケーション・ビルダーで作成したヘルプは、専用の「ヘルプ」ページに表示されます。ヘルプを表示するには、専用の「ヘルプ」ページへのリンクをクリックします。このヘルプ・ページには、表示しているページに固有のページ・ヘルプおよびフィールドレベル・ヘルプのトピックが表示されます。

12.4.2.2 コンポーネント・ビューでのヘルプ・ページおよびヘルプ・リージョンの作成

アプリケーションのヘルプを作成するための最初のステップは、専用のページおよび「ヘルプ・テキスト」リージョンを作成することです。次の構文を使用してコールすると、作成するリージョンに、カレント・ページのページ・ヘルプおよびアイテム・ヘルプが表示されます。

f?p=&APP_ID.:Page:Session:&APP_PAGE_ID.

コンポーネント・ビューでヘルプ・ページおよびヘルプ・リージョンを作成するには、次のステップを実行します。

  1. ヘルプ用の空白ページを作成します。「アプリケーションのホームページからのページの作成」を参照してください。

  2. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

  3. 新しいリージョンを作成します。「リージョン」で、「作成」アイコンをクリックします。

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

  4. 「リージョン」で、「作成」アイコンをクリックします。

  5. リージョン・タイプを選択するプロンプトが表示されたら、「ヘルプ・テキスト」を選択して「次へ」をクリックします。

  6. 「表示属性」で、次のステップを実行します。

    1. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示される際に、このタイトルが表示されます。

    2. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

    3. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

    4. 表示ポイント: このリージョンの表示ポイントを指定します。詳細は、フィールドレベル・ヘルプを参照してください。

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

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

  7. 「ソース」で、「次へ」をクリックします。

  8. 「条件付き表示」で、次のステップを実行します。

    1. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。「条件付きのレンダリングおよびプロセスの理解」を参照してください。

    2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。「認可を介したセキュリティの提供」を参照してください。

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

  9. 「リージョンの作成」をクリックします。

12.4.2.3 コンポーネント・ビューでのページ・ヘルプの定義

コンポーネント・ビューでページ・ヘルプ・テキストを定義するには、次のステップを実行します。

  1. ページ・ヘルプを追加するページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

  2. 「ページ」で、「編集」アイコンをクリックします。

  3. 「ヘルプ」までスクロールします。

  4. 表示されたフィールドにヘルプ・テキストを入力します。


    ヒント:

    デフォルトでは、「ヘルプ」にはテキストNo help is available for this pageが入力されています。

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

ページ・ヘルプ・テキストが必要な各ページに対して、これらのステップを実行します。

12.4.2.4 コンポーネント・ビューでのアイテム・ヘルプの定義

コンポーネント・ビューでアイテム・ヘルプを定義するには、次のステップを実行します。

  1. ヘルプを追加するページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

  2. 「アイテム」で、編集するアイテムを探します。

  3. アイテムの属性ページにアクセスします。「アイテム」で、アイテム名を選択します。

    「ページ・アイテムの編集」ページが表示されます。

  4. 「ヘルプ・テキスト」までスクロールします。

  5. 表示されたフィールドにヘルプ・テキストを入力します。

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

ヘルプ・テキストが必要な各アイテムに対して、これらのステップを実行します。

12.4.3 複数のアイテム・ヘルプ・トピックの同時編集

この項では、複数のヘルプ・トピックを一度に編集する様々な方法について説明します。

12.4.3.1 「アイテム・ヘルプをバルク編集」レポートへのアクセス

アプリケーションにヘルプを含める場合は、「アイテム・ヘルプをバルク編集」レポートを使用して、複数のヘルプ・トピックを一度に編集できます。

「アイテム・ヘルプをバルク編集」レポートを表示するには、次のステップを実行します。

  1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

  2. アプリケーションを選択します。

  3. 「ユーティリティ」アイコンをクリックします。

  4. 「ページ固有のユーティリティ」から、「アイテム・ユーティリティ」を選択します。

  5. 「すべてのアイテム・ヘルプ・テキストのグリッド編集」をクリックします。

  6. アイテム・ヘルプのバルクレポートでは、次の操作が可能です。

    • 既存のヘルプ・トピックを更新できます。表示されるヘルプ・テキストを編集し、「変更の適用」をクリックします。

    • ページ番号をクリックして、アイテムが含まれているページにリンクできます。

    • アイテム名をクリックして、ページ・アイテムにリンクできます。

12.4.3.2 アイテム・ヘルプ・トピックのシード

アプリケーションにヘルプが含まれていない場合は、デフォルトのヘルプ・テキストの一括更新を実行できます。

ヘルプ・トピックをシードするには、次のステップを実行します。

  1. 「「アイテム・ヘルプをバルク編集」レポートへのアクセス」の説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

  2. 「アイテム・ヘルプ・テキストのシード」をクリックします。

  3. 「デフォルトのヘルプ・テキスト」で、すべてのヘルプ・トピックに表示されるデフォルト・テキストを入力します。

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

12.4.3.3 既存のアイテム・ヘルプ・トピックの検索

既存のヘルプ・テキストまたはアイテム・ラベルを検索できます。

既存のヘルプ・トピックを検索するには、次のステップを実行します。

  1. 「「アイテム・ヘルプをバルク編集」レポートへのアクセス」の説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

  2. 「ヘルプの内容」にキーワードを入力します。

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

12.4.3.4 アイテム・ラベルの検索

アイテム・ラベルを検索するには、次のステップを実行します。

  1. 「「アイテム・ヘルプをバルク編集」レポートへのアクセス」の説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

  2. 「ヘルプの内容」にキーワードを入力します。

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

12.4.4 ヘルプ・ナビゲーション・バー・エントリの作成

ヘルプを作成したら、次に、ユーザーがリンクに使用するためのナビゲーション・バー・エントリを作成します。

ナビゲーション・バー・エントリを作成するには、次のステップを実行します。

  1. ナビゲーション・バー・エントリ・ページにナビゲートします。

    1. 「ワークスペース」ホームページにナビゲートします。

    2. 「アプリケーション・ビルダー」アイコンをクリックします。

    3. アプリケーションを選択します。

    4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

    5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

  2. 「作成」をクリックします。

    ナビゲーション・バー・エントリの作成ウィザードが表示されます。

  3. 「方法」で、「最初から」を選択し、「次へ」をクリックします。

  4. 「タイプ」で、「URLへのナビゲーション」を選択して「次へ」をクリックします。

  5. 「属性」で、次のように指定します。

    1. 順序: このコンポーネントの評価の順序を指定します。

    2. エントリ・ラベル: このナビゲーション・バー・エントリの表示テキストを入力します。

    3. アイコン・イメージ名: イメージ名を入力します。ネーミング規則の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

    4. イメージALT: イメージのナビゲーション・アイコンのALTテキストを入力します。イメージ名を指定しないと、このテキストが表示されます。

    5. イメージの高さ: イメージの高さをピクセルで定義します。

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

  6. 「ターゲット」で、次のステップを実行します。

    1. ターゲットは: 「このアプリケーションのページ」を選択します。

    2. ページ: 「ページ・デザイナでのヘルプの作成」で作成したヘルプ・ページのページ番号を指定します。

    3. リクエスト: 次を入力します。

      &APP_PAGE_ID.
      

      「リクエスト」に置換文字列&APP_PAGE_IDを指定することによって、Application Expressエンジンに対して、ユーザーがこのアイコンをクリックした場合にカレント・ページのヘルプ・テキストを表示するように指示します。

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

  7. ナビゲーション・バー・エントリを表示するための条件を設定するには、条件タイプを選択します。

  8. 「作成」をクリックします。