ページへのポートレットの追加

ポートレットをページに追加する前に、コンポーネント・パレットでポートレットを使用できるようにポートレット・プロデューサをアプリケーションに登録する必要があります。また、特定のライブラリにアクセスできるJSF JSPを作成する必要があります。JSF JSPがあると、コンポーネント・パレットからポートレットを選択し、ページに配置できます。ソースでは、ポートレットはadfp:portletタグとして表示されます。

このトピックでは、これらのタスクを完了する1つの方法を示します。次の項目が含まれています。

ポートレット・プロデューサの登録

JSF JSPの作成

JSF JSPを作成する際は、JSPドキュメントの出力を選択します。JSPドキュメントが生成するファイルの拡張子はjspxです。jspxファイルはJSPのXML表現であり、XMLを使用することにより、次のようなメリットがあります。

JSPドキュメントは複雑性を減らし、柔軟性を高めます。あらゆるXML文書をJSPとして使用できます。XML要素は、標準的な構文で記述されたJSPで使用できます。

JSF JSPを作成する手順は、次のとおりです。

  1. 「アプリケーション・ナビゲータ」でプロジェクト(たとえばViewController)を右クリックし、ポップアップ・メニューから「新規」を選択します。
  2. 「新規ギャラリ」のWeb層ノードで、「カテゴリ」列の「JSF」「項目」列の「JSF JSP」を選択します。
  3. 「OK」をクリックします。
  4. ようこそページで「次へ」をクリックします。

    オプションで「次回にこのページを表示しない」を選択し、以後このウィザードを使用する際にようこそページをスキップできます。

  5. 「ファイル名」jspxファイルの名前を入力します。
  6. 「タイプ」「JSPドキュメント」を選択し、jspxファイルを作成します。
  7. 「次へ」をクリックします。
  8. オプションでコンポーネント・バインディング・ページ上の「新規マネージドBeanでのUIコンポーネントの自動公開」を選択します。
  9. 「次へ」をクリックします。
  10. タグ・ライブラリ・ページで次のライブラリを「選択可能」から「選択済」に移動します。

  11. 「次へ」をクリックします。
  12. HTMLオプション・ページで「HTMLバージョン」ドロップダウン・リストから4.0.1 Transitionalを選択します。
  13. 「タイトル」フィールドにページのタイトルを入力します。
  14. 残ったフィールドで必要に応じて、色、イメージおよびスタイル・シートを選択します。
  15. 「次へ」をクリックします。
  16. 「終了」をクリックしてjspxファイルを作成し、ウィザードを終了します。

JSF JSPへのpanelCustomizableコンポーネントの追加

JSF JSPにpanelCustomizableコンポーネントを追加するのは、ページにポートレットを追加するプロセスのオプションです。ポートレットはjspxページに直接追加できます。panelCustomizableコンポーネントを追加することで、ポートレットの操作に非表示/表示の切替えや、上下または左右の移動のような追加オプションが提供されます。オプションを使用可能にするには、panelCustomizable属性のisSeededInteractionAvailabletrueに設定する必要があります。

panelCustomizableコンポーネントをJSF JSPに追加する手順は、次のとおりです。

  1. 「アプリケーション・ナビゲータ」でjspxファイルを右クリックし、ポップアップ・メニューから「開く」を選択します。

    jspxファイルは次の場所にあります。

    アプリケーション
        <ApplicationName>
            <ProjectName>
                Webコンテンツ

  2. 「コンポーネント・パレット」で、「カスタマイズ可能コンポーネント・コア」を選択します。
  3. panelCustomizableコンポーネントを選択し、JDeveloperの「構造」ペインにあるh:formタグ上にドラッグします。

    panelCustomizableは「構造」ペインのh:form下に置かれます。「エディタ」ペインでは、panelCustomizableはフォームのアウトライン内に表示されます。

JSF JSPへのポートレットの追加

JSF JSPにポートレットを追加する手順は、次のとおりです。

  1. 「アプリケーション・ナビゲータ」でjspxファイルを右クリックし、ポップアップ・メニューから「開く」を選択します。

    jspxファイルは次の場所にあります。

    アプリケーション
        <ApplicationName>
            <ProjectName>
                Webコンテンツ

  2. 「コンポーネント・パレット」で、このプロセスの初めに登録したポートレット・プロデューサを選択します。
  3. ポートレットを選択し、JDeveloperの「構造」ペインのpanelCustomizableコンポーネント上にドラッグします。

    「構造」ペインでは、ポートレットはpanelCustomizableの下に表示されます。「エディタ」ペインの「ソース」ビューでは、ポートレットはadfp:portletのようなpanelCustomizableのオープン・タグとクローズ・タグの間に表示されます。

注意: Oracle Webcenter Frameworkのオンライン・ヘルプ・トピックは、Oracle Webcenter frameworkと関連付けられたウィザードやその他ユーザー・インタフェース・コンポーネントについて案内します。WebCenter Frameworkのアプリケーションおよびポートレットの開発やデプロイに関する詳細は、Oracle WebCenter Framework開発者ガイドを参照してください。


WSRPポートレット・プロデューサの登録
Oracle PDK-Javaポートレット・プロデューサの登録
カスタマイズ可能なコンポーネントについて
カスタマイズ可能なコンポーネントを使用したページの作成
規格に基づいたJavaポートレット(JSR 168)ウィザードの使用
Oracle PDK-Javaポートレット・ウィザードの使用
WebCenter Frameworkコンポーネント - <adfp:portlet>プロパティ