22.4 ポートレットへのパラメータ値の受渡し

ポートレットは、ページ・パラメータ、システム変数、またはページから渡された定数からパラメータの値を受け取ることができます。つまり、ポートレット内に表示される情報は、ページまたはユーザーに応じて変化します。ポートレットのパラメータは、provider.xmlファイルで指定します。

値は、標準、モバイルおよび検索ページ、これらのページ・タイプに基づくカスタム・ページ、ナビゲーション・ページのポートレット・パラメータにのみ渡すことができます。

Oracle Portalでは、特定のページまたはPortalテンプレートにポートレット・パラメータ値を指定できます。ページ用のPortalテンプレートにポートレット・パラメータ値を指定すると、そのPortalテンプレートに基づくすべてのページに値が継承されます。ページ設計者は、テンプレートの編集時にテンプレートのパラメータ値を編集できますが、このテンプレートに基づくページの編集時には変更できません。アイテム用のPortalテンプレートにパラメータ値を指定すると、これらはそのテンプレートに表示されるアイテムのデフォルト値になります。詳細は、12.1.1項「Portalテンプレートとは」を参照してください

ポートレット・パラメータに値を渡すには、次の手順を実行します。

パラメータ値を渡すポートレットがあるページ（またはテンプレート）に移動します。
編集モードに切り替えます。
ページ・ツールバーの「ページ」（または「テンプレート」）の横にある「プロパティ」リンクをクリックします。

ページ・グループではなくページ（またはテンプレート）のリンクをクリックしてください。
「プロパティ」ページで、「パラメータ」タブをクリックして前面に表示します。

ページ・グループでは、パラメータとイベントはデフォルトで有効になります。「パラメータ」タブが表示されない場合は、「パラメータおよびイベントを有効にする」ページ・グループ設定が無効になっています。詳細は、第4章「ページ・グループの使用」を参照してください。
「ポートレット・パラメータ値」セクションには、ページに含まれるポートレットのリストが表示され、それらのポートレットにパラメータがあるかどうかが示されます。

ポートレット名をクリックしてポートレットを開き、パラメータを表示します。ポートレットにパラメータが定義されていない場合は、このリストで開くことはできません。

ページ上のすべてのポートレットのパラメータを表示するには、「すべて開く」をクリックします。ただし、ポートレットにパラメータがない場合は、このリストで開くことはできません。
各ポートレット・パラメータに対して、次のようにします。
1. 入力パラメータのドロップダウン・リストから次のいずれかを選択します。
  
  NULL: このポートレット・パラメータに値を指定しません。
  
  ページ・パラメータ: あるページ・パラメータの値をポートレット・パラメータに渡します。
  
  システム変数: システム変数の値をポートレット・パラメータに渡します。たとえば、USER_NAMEです。
  
  定数: 特定の値をポートレット・パラメータに渡します。
2. 値フィールドまたはリストで、ポートレットに値を渡すページ・パラメータまたはシステム編集を選択するか、定数値を入力します。
「OK」をクリックして変更を保存し、ページまたはテンプレートに戻ります。

OTNの追加情報
ポートレットへのパラメータ追加方法の詳細は、Oracle Fusion Middleware開発者ガイド for Oracle Portalを参照してください。このマニュアルは、Oracle Technology NetworkのOracle Portalドキュメント・ページ（http://www.oracle.com/technology/products/ias/portal/documentation.html）で入手できます。