連携ポートレットの開発

連携ポートレット という用語は、情報を共用することによって相互作用するページ上のポートレットの機能を指します。 ポータル・ページ上の 1 つ以上の連携ポートレットは、 ソース・ポートレットのアクションまたはイベントによって起動されたソース・ポートレットからの変更に、 自動的に対応することができます。 イベントのターゲットであるポートレットは、 ユーザーがページ上の他のポートレットを繰り返し変更したり操作しなくて済むように対応できます。 これにより、ページ上のポートレット間の振る舞いを調整された一貫性のあるものにし、 ユーザーの操作全般を改善することができます。

連携ポートレットは、WebSphere® Portal プロパティー・ブローカーを使用して互いの情報を宣言、公開、および共用するためのモデルに加入します。 ポートレットは、プロバイダーまたは受信側として共用できる型付きデータ項目、 つまりプロパティー を公開することによって、ブローカーに加入します。

連携ポートレットは、ソース・ポートレット、ターゲット・ポートレット、またはその両方であることがあります。

ユーザーは、ソース・ポートレット上のアイコンから Click-to-Action イベントを起動します。連携ポートレットは さまざまな方法で実装できますが、Click-to-Action は、Rational® Developer ツール・インターフェースによってサポートされる固有の手法であることに注意してください。 このアイコンは、アクションのターゲットのリストを含むポップアップ・メニューを表示します。 ユーザーが特定のターゲットを選択すると、 プロパティーのブローカーは、対応するポートレット・アクションのフォームでターゲットにデータを配信します。

Click-to-Action 配信方法を使用すると、 ユーザーは、単にクリックするだけでソース・ポートレットから 1 つ以上のターゲット・ポートレットにデータを転送でき、 ターゲットはアクションに対応し、結果と共に新規ビューが表示されます。 ユーザーは、一致する入力プロパティーに関連したアクションが宣言されているページ上のすべてのポートレットに、 プロパティーをブロードキャストすることもできます。

Click-to-Action のサポート

Click-to-Action サポートは、 次のように基本、Faces、および Struts ポートレットで利用できます。

表 1. ポートレットのタイプ別の Click-to-Action タグ・サポート
ポートレットのタイプ WebSphere Portal 5.0.2.2 および 5.1
JSR 168 API IBM® ポートレット API
基本ポートレット サポートなし。
注: WebSphere プロパティー・ブローカーを 基にした汎用の WebSphere Portal 連携ポートレット機能が、v5.1 でサポートされます。
あり
Faces ポートレット あり
Struts ポートレット あり

Click-to-Action ポートレットは、<hx:pagerDelux> タグまたは <hx:pagerWeb> タグと共に<c2a:encodeProperty> タグを含む Faces JSP ページに含まれている場合、WebSphere Portal または WebSphere Portal テスト環境のページャー機能を処理しません。 Faces JSP ページで Click-to-Action およびデータ・テーブルのページャー機能を一緒に使用するには、 <hx:pagerDelux> タグまたは <hx:pagerWeb> タグではなく、 <hx:pagerSimple> タグまたは <hx:pagerGoto> タグを使用してください。

連携ポートレット・アイコン

表 2. 「プロジェクト・エクスプローラー」ビュー、「パレット」ビュー、 および Page Designer の連携ポートレット・アイコン
アイコン 説明 表示される場所
「Click-to-Action ソース・ポートレット」アイコン 連携ソース・ポートレット 「プロジェクト・エクスプローラー」ビューおよびポートレット・デプロイメント記述子エディター
「Click-to-Action ターゲット・ポートレット」アイコン 連携ターゲット・ポートレット 「プロジェクト・エクスプローラー」ビューおよびポートレット・デプロイメント記述子エディター
「Click-to-Action ソースおよびターゲット・ポートレット」アイコン 連携ソースおよびターゲット・ポートレット 「プロジェクト・エクスプローラー」ビューおよびポートレット・デプロイメント記述子エディター
「Click-to-Action 出力プロパティー (encodeProperty)」アイコン Click-to-Action 出力プロパティー (encodeProperty) Page Designer および「パレット」ビューの JSP ページ
「複数の Click-to-Action 出力プロパティー (encodeProperties)」アイコン Click-to-Action 出力プロパティー (encodeProperties) Page Designer および「パレット」ビューの JSP ページ

ワイヤー・サポート

ワイヤリングは、 ソース・ポートレットの変更によって、ユーザーとの相互作用なしで自動的にターゲット・ポートレットが更新されるように、 連携ポートレットを接続するための技法です。 ワイヤーは、Click-to-Action メニューをプロンプトすることなく、自動的にプロパティーをターゲット・ポートレットに 転送するために使用されます。

ポータル・ツールが提供する基本ワイヤリング機能は、WebSphere Portal v5.1 の IBM API と JSR 168 ポートレットの両方をサポートします。これらの機能は、WebSphere Portal 5.1 のポートレット・ ワイヤリング・ツールが提供する機能と同等です。

この製品のポートレット・ ワイヤリングには、次の一般的な制限があります。
  • ワイヤリングは、同一ページ上のポートレットでのみサポートされます (ページ間ワイヤリングは、WebSphere Portal 5.1 ではサポートされていません)。
  • 同一 API ワイヤリングのみがサポートされます (IBM API と JSR 168 API のワイヤーは、WebSphere Portal 5.1 ではサポートされていません)。
  • グローバル・ワイヤーのみがサポートされます。ユーザー固有のワイヤリングを 構成できるパーソナル・ワイヤーは、サポートされていません。
関連概念
連携ポートレットのワイヤリング
関連タスク
既存のポートレットを連携可能にする
連携ソースの使用可能化
連携ターゲットの使用可能化
Click-to-Action encodeProperty の挿入
Click-to-Action encodeProperties の挿入
Click-to-Action encodeProperty の編集
Click-to-Action encodeProperties の編集

(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005