ポートレットは、ページ・パラメータ、システム変数、またはページから渡された定数からパラメータの値を受け取ることができます。つまり、ポートレット内に表示される情報は、ページまたはユーザーに応じて変化します。ポートレットのパラメータは、provider.xml
ファイルで指定します。
値は、標準、モバイルおよび検索ページ、これらのページ・タイプに基づくカスタム・ページ、ナビゲーション・ページのポートレット・パラメータにのみ渡すことができます。
Oracle Portalでは、特定のページまたはPortalテンプレートにポートレット・パラメータ値を指定できます。ページ用のPortalテンプレートにポートレット・パラメータ値を指定すると、そのPortalテンプレートに基づくすべてのページに値が継承されます。ページ設計者は、テンプレートの編集時にテンプレートのパラメータ値を編集できますが、このテンプレートに基づくページの編集時には変更できません。アイテム用のPortalテンプレートにパラメータ値を指定すると、これらはそのテンプレートに表示されるアイテムのデフォルト値になります。詳細は、12.1.1項「Portalテンプレートとは」を参照してください
ポートレット・パラメータに値を渡すには、次の手順を実行します。
パラメータ値を渡すポートレットがあるページ(またはテンプレート)に移動します。
編集モードに切り替えます。
ページ・ツールバーの「ページ」(または「テンプレート」)の横にある「プロパティ」リンクをクリックします。
ページ・グループではなくページ(またはテンプレート)のリンクをクリックしてください。
「プロパティ」ページで、「パラメータ」タブをクリックして前面に表示します。
ページ・グループでは、パラメータとイベントはデフォルトで有効になります。「パラメータ」タブが表示されない場合は、「パラメータおよびイベントを有効にする」ページ・グループ設定が無効になっています。詳細は、第4章「ページ・グループの使用」を参照してください。
「ポートレット・パラメータ値」セクションには、ページに含まれるポートレットのリストが表示され、それらのポートレットにパラメータがあるかどうかが示されます。
ポートレット名をクリックしてポートレットを開き、パラメータを表示します。ポートレットにパラメータが定義されていない場合は、このリストで開くことはできません。
ページ上のすべてのポートレットのパラメータを表示するには、「すべて開く」をクリックします。ただし、ポートレットにパラメータがない場合は、このリストで開くことはできません。
各ポートレット・パラメータに対して、次のようにします。
入力パラメータのドロップダウン・リストから次のいずれかを選択します。
NULL: このポートレット・パラメータに値を指定しません。
ページ・パラメータ: あるページ・パラメータの値をポートレット・パラメータに渡します。
システム変数: システム変数の値をポートレット・パラメータに渡します。たとえば、USER_NAMEです。
定数: 特定の値をポートレット・パラメータに渡します。
値フィールドまたはリストで、ポートレットに値を渡すページ・パラメータまたはシステム編集を選択するか、定数値を入力します。
「OK」をクリックして変更を保存し、ページまたはテンプレートに戻ります。
ポートレットへのパラメータ追加方法の詳細は、Oracle Fusion Middleware開発者ガイド for Oracle Portalを参照してください。このマニュアルは、Oracle Technology NetworkのOracle Portalドキュメント・ページ(http://www.oracle.com/technology/products/ias/portal/documentation.html
)で入手できます。