WebSphere Portal と HATS
IBM® WebSphere® Portal は、Web コンテンツおよびアプリケーションへの単一のアクセス・ポイントを提供するものであり、各ユーザーのニーズに合わせて個別に設定されます。
HATS を WebSphere Portal と統合することにより、HATS、WebSphere Portal、およびその他のポータル・アプリケーションの間でデータを自由にやり取りできます。WebSphere Portal の関連機能はすべて、組み込みツールや簡単な Java™ 開発によって HATS 内でも使用できます。WebSphere Portal 環境で HATS を実行した場合、HATS 機能の大部分は保持されます。詳細については、HATS ポートレットの考慮事項と制限を参照してください。
HATS アプリケーションはポートレットとして WebSphere Portal 内で直接動作可能なため、WebSphere Portal と HATS は直接対話できます。
IBM ポートレット API、または標準の Java Portlet Specification API (JSR 168、以降、標準ポートレット API と呼ぶ) に準拠した HATS ポートレットを作成できます。
注:
本書を通じて、標準ポートレット API (JSR 168) に準拠する HATS ポートレットは、標準ポートレットと呼ばれます。
HATS ビジネス・ロジック・クラスは WebSphere Portal API を使用でき、HATS JSP は WebSphere Portal JSP タグ・ライブラリーを組み込むことができます。ポートレットと拡張ポータル機能のプログラミングの詳細については、「HATS Web アプリケーション・プログラマーズ・ガイド」を参照してください。
HATS ポートレット・プロジェクトは、変換指向アプリケーションを対象としています。
WebSphere Portal で動作するようにモデル 1 統合オブジェクト・ベースのアプリケーションを適合させる方法については、「HATS Web アプリケーション・プログラマーズ・ガイド」を参照してください。
WebSphere Portal で実行するように Struts 統合オブジェクト・ベースのアプリケーションを変換する方法については、WebSphere Portal インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp) で「Struts」を検索してください。
ポータルのツールの詳細およびヘルプを参照するには、Rational® SDP ツールバーで「ヘルプ」メニューを選択し、「ヘルプ目次」を選択します。左側のヘルプ・リストの「ポータルおよびポートレット・アプリケーションの開発 (Developing portal and portlet applications)」をクリックして、ポートレット開発者用文書にアクセスします。
HATS ポートレットの作成
HATS ポートレットを作成する方法は 2 つあります。
- HATS の「プロジェクトの作成」ウィザードを使用し、サポートされる WebSphere Portal サーバーの 1 つを 「ターゲット・サーバー」とするよう指定することにより、新規ポートレットを作成できます。
- 既存の HATS Web プロジェクトからポートレットを生成する。この方法をとると、WebSphere Portal に HATS Web アプリケーションを移動する際に、そのアプリケーションの作成に費やした時間が無駄にならずに済みます。
新規 HATS ポートレット・プロジェクトの作成
新規 HATS ポートレット・プロジェクトを作成するには、次のいずれかの操作によって「プロジェクトの作成」ウィザードを起動します。
- メニュー・バーから「HATS」>「新規」>「プロジェクト」を選択します。
- メニュー・バーから「ファイル」>「新規」>「HATS プロジェクト」を選択します。
- ツールバーの「HATS プロジェクトを作成」アイコンをクリックします。
「プロジェクトの作成」ウィザードの「HATS プロジェクト」パネルで、以下のようにします。
- ポートレット・プロジェクトの名前を入力します。
- オプションで、説明を入力します。
- デフォルトの場所をそのまま使用します。
- 「Web」を選択して、これが Web プロジェクトであることを示します。
注:
Web デプロイメント・オプションが使用不可になっている場合、サーバー・ランタイムが定義されていないことを示しています。サーバー・ランタイムを定義するには、「ウィンドウ」>「設定」>「サーバー」>「ランタイム環境 (Runtime Environments)」と移動して、少なくとも 1 つのランタイム定義を追加します。
- 「ターゲット・サーバー」フィールドで、サポートされている WebSphere Portal サーバーの 1 つ (WebSphere Portal v6.0 または WebSphere Portal v6.1) を選択します。
注:
- 一般に、WebSphere Portal 6.0 をターゲットにしたポートレットは、WebSphere Portal 6.1 上に展開し、実行することができます。詳細については、
WebSphere インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp) にアクセスして「マイグレーションに関する計画」で検索してください。
- WebSphere Portal v6.0 または v6.1 のいずれかをターゲットとする標準 ポートレットは、WebSphere Application Server v6.1 または v7.0 上でも実行できます。
- 「エンタープライズ・アプリケーション・プロジェクト」フィールドに、ローカル・テスト環境でのテストに使用する EAR プロジェクトの名前を入力します。
注:
標準ポートレット・プロジェクトと IBM ポートレット・プロジェクトを同じ EAR プロジェクトに追加することができます。
- 「ポートレット API」フィールドで、このポートレットが準拠する API として、「 JSR 168 ポートレット」または「IBM ポートレット」のいずれかを選択します。
注:
「IBM ポートレット」を選択した場合は、これが非推奨 API であることを示す警告が表示されます。
- 管理コンソール用のサポート・ファイルを組み込むかどうかを選択します。
注:
このオプションは、HATS 標準ポートレットではサポートされていません。
- 「次へ」をクリックして、プロジェクトの作成を通常どおりに続行します。
これにより、ローカル・テスト環境でのテストに使用可能な EAR プロジェクトを含む単一の HATS ポートレット・プロジェクトが生成されます。
HATS Web プロジェクトからのポートレットの生成
既存の HATS Web プロジェクトをポートレットとして実行できるようにするには、ポートレットの仕様に合うように HATS プロジェクトの構造と内容を変更する必要があります。HATS Toolkit では、通常の HATS Web プロジェクトをポートレットに変換するプロセスが自動化されています。Rational SDP のポータル・ツール機能は、この変換プロセスの前提条件です。
既存の HATS Web プロジェクトから HATS ポートレット・プロジェクトを生成するには、「HATS プロジェクト」ビューで Web プロジェクトを右クリックし、「ポートレット・プロジェクトの生成」を選択します。
「ポートレット・プロジェクトの生成」ウィザードの「ポートレット・プロジェクト生成オプション」パネルで、以下のようにします。
- ポートレット・プロジェクトの名前を入力します。
- 「ターゲット・サーバー」フィールドで、ターゲットの WebSphere Portal サーバー (WebSphere Portal v6.0 または WebSphere Portal v6.1) を選択します。
注:
- HATS Web プロジェクトから HATS ポートレット・プロジェクトを生成する場合は、Web プロジェクトのターゲット・サーバーによってポートレット・プロジェクトのターゲット・サーバー・オプションが決まります。Web プロジェクトのターゲット・サーバーが WebSphere Application Server v6.0 の場合、生成されるポートレット・プロジェクトのターゲット・サーバー・オプションは WebSphere Portal v6.0 または v6.1 です。Web プロジェクトのターゲット・サーバーが WebSphere Application Server v6.1 の場合、生成されるポートレットのターゲット・サーバー・オプションは WebSphere Portal v6.1 です。Web プロジェクトのターゲット・サーバーが WebSphere Application Server v7.0 の場合、ポートレットを生成するオプションはありません。
- 一般に、WebSphere Portal 6.0 をターゲットにしたポートレットは、WebSphere Portal 6.1 上に展開し、実行することができます。詳細については、
WebSphere インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp) にアクセスして「マイグレーションに関する計画」で検索してください。
- WebSphere Portal v6.0 または v6.1 のいずれかをターゲットとする標準 ポートレットは、WebSphere Application Server v6.1 または v7.0 上でも実行できます。
- 「エンタープライズ・アプリケーション・プロジェクト」フィールドに、ローカル・テスト環境でのテストに使用する EAR プロジェクトの名前を入力します。
注:
標準ポートレット・プロジェクトと IBM ポートレット・プロジェクトを同じ EAR プロジェクトに追加することができます。
- 「ポートレット API」フィールドで、このポートレットが準拠する API として、「 JSR 168 ポートレット」または「IBM ポートレット」のいずれかを選択します。
注:
「IBM ポートレット」を選択した場合は、これが非推奨 API であることを示す警告が表示されます。
- 自動変換するファイルのタイプをこのリストから選択します。
- 変換
- 変換フラグメント
- テンプレート
- マクロ・ハンドラー
- カスケーディング・スタイル・シート
- 「完了」をクリックします。
選択した Web プロジェクトから HATS ポートレット・プロジェクトが作成されます。ポートレットが作成されたら、その他のカスタマイズを実行できます。HATS プロジェクトの変更の詳細については、HATS プロジェクトの変更を参照してください。
注:
- HATS Web プロジェクトを HATS ポートレット・プロジェクトに変換する場合、Web プロジェクトに対して構成されているプラグインがポートレット・プロジェクトに対してサポートされない場合は、Web 高速ログオン (WEL) 構成ファイル (hatswelcfg.xml) の手動での変更が必要になる可能性があります。WEL 構成ファイル (hatswelcfg.xml) が適切に更新されるようにするために、WEL 構成ユーザー・インターフェースを使用してサポートされるプラグインを追加することをお勧めします。
- HATS Web プロジェクトから HATS ポートレット・プロジェクトを生成したあとに、あるプロジェクトに変更が加えられても、その変更はほかのプロジェクトには反映されません。HATS Web プロジェクトに加えた変更を反映させるには、変更した HATS Web プロジェクトから新規 HATS ポートレット・プロジェクトを生成します。
- HATS ポートレット・プロジェクトを HATS Web プロジェクトに変換しなおすことはできません。
- 既存の HATS V4、V5、V6、V7.0、または V7.1 アプリケーションがある場合は、ポートレット・プロジェクトを生成する前に、そのアプリケーションを HATS V7.5.1 にマイグレーションする必要があります。
HATS V7.5.1 へのマイグレーションについて詳しくは、HATS V7.5.1 へのマイグレーションを参照してください。
IBM ポートレットの標準ポートレットへのマイグレーション
HATS IBM ポートレットの HATS 標準ポートレットへのマイグレーションは、手動で実行する必要があります。以下のようなステップになります。
- プロジェクト・ファセットのマイグレーション。
- Web デプロイメント記述子ファイルおよびポートレット・デプロイメント記述子ファイルのマイグレーション。
- 変換、テンプレート、およびマクロ・ハンドラーのマイグレーション。
- HATS 固有のファイルのマイグレーション。
- その他のポータル機能のマイグレーション (オプション)。
プロジェクト・ファセットのマイグレーション
- 組み込まれている場合、 HATS 標準ポートレットでは Struts をサポートしていないため、Struts ファセットを除去します。
- 「HATS プロジェクト」ビューでポートレット・プロジェクトを右クリックし、「プロパティー」を選択します。
- 「プロパティー」ページで、「プロジェクト・ファセット」を選択します。
- 選択されている場合は、「IBM ポートレット用 Struts」のチェック・ボックスをクリアします。
- 「OK」をクリックします。
- IBM ポートレットのファセットを JSR ポートレットのファセットで置き換えます。
- 「HATS プロジェクト」ビューでポートレット・プロジェクトを右クリックし、「プロパティー」を選択します。
- 「プロパティー」ページで、「プロジェクト・ファセット」を選択します。
- 「IBM ポートレット」のチェック・ボックスをクリアし、「JSR ポートレット (JSR Portlets)」のボックスを選択します。
「バージョン」列に、1.0 が表示されていることを確認します。表示されていない場合は、バージョン番号の横のドロップダウン・アイコンをクリックし、1.0 に変更します。
- 「OK」をクリックします。
Web デプロイメント記述子ファイルおよびポートレット・デプロイメント記述子ファイルのマイグレーション
- ナビゲーター・ビューで Web デプロイメント記述子 (Web Content/WEB-INF/web.xml) を編集し、以下のステップを実行します。
- 「サーブレット」タブで、ご使用のポートレット および HATSAdminServlet (ある場合) のサーブレットおよびマッピングを除去します。
- 「タグ・ライブラリー参照 (Tag Lib References)」セクションの「変数」タブで、admin.tld tag lib 参照がある場合は、それを除去します。
- 「タグ・ライブラリー参照 (Tag Lib References)」セクションの「変数」タブで、以下の設定を使用した std-portlet.tld の タグ・ライブラリー参照を追加します。
URL: http://java.sun.com/portlet
Location: /WEB-INF/tld/std-portlet.tld
- ナビゲーター・ビューでポートレット・デプロイメント記述子 (Web Content/WEB-INF/portlet.xml) を編集し、以下のステップを実行します。
- 標準準拠のポートレット・デプロイメント記述子にマイグレーションします。その方法については、WebSphere Portal インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp) の『IBM ポートレット API からのマイグレーション』というセクションを参照してください。
- ポートレット・デプロイメント記述子で、EntryPortlet (ご使用のポートレット) およびそのすべての参照を除去します。
- Jsr168EntryPortlet をポートレット・デプロイメント記述子に追加します。HATS JSR 168 のサンプル・ポートレットのポートレット・デプロイメント記述子を参照してください。
変換、テンプレート、およびマクロ・ハンドラーのマイグレーション
「HATS プロジェクト」ビューで変換、テンプレート、およびマクロ・ハンドラーのすべての JSP ファイルを編集し、「ソース」タブで以下のようにします。
- 以下のコードを追加します。
- <%@ taglib uri="http://java.sun.com/portlet" prefix="portletAPI"
%>
- <portletAPI:defineObjects/>
- response.encodeUrl("...") を renderResponse.encodeUrl(renderRequest.getContextPath()+"...") に変えます。
- request となっているすべての個所を renderRequest に変えます。
HATS 固有のファイルのマイグレーション
- <shared_install_directory>¥plugins¥com.ibm.hats_nnn¥predefined¥ projects¥portlet¥jsr フォルダーにあるすべてのファイルを、ポートレット・プロジェクト内の対応するフォルダーにそれぞれインポートします
(ここで、shared_install_directory は IBM Installation Manager を使用して HATS オファリングをインストールした共用リソース・ディレクトリー、nnn は HATS のバージョンおよびビルド・レベルです)。
- ナビゲーター・ビューで、以下のファイルおよびフォルダーがある場合は、それらを削除します。
- Web Content フォルダー内の HATSApplet.cab ファイルおよび HATSApplet.jar ファイル。
- Web Content フォルダー内の hatsadmin フォルダー。
- Web Content/WEB-INF/tld フォルダー内の hatsadmin.tld ファイル。
その他のポータル機能のマイグレーション
- Web 高速ログオン (WEL) を使用している場合、IBM ポートレットの場合と標準ポートレットの場合で一部のプラグイン・クラスが異なるため、WEL プラグイン・クラスの変更が必要になる可能性があります。
例えば、IBM ポートレットで使用される WEL プラグイン・クラスは以下のとおりです。
- WebSphere Portal ネットワーク・セキュリティー: com.ibm.hats.common.wel.WebSpherePortalNS
- WebSphere Portal Credential Vault Credential Mapper : com.ibm.eNetwork.security.sso.cms.CredentialVaultCM
標準ポートレットで使用される WEL プラグイン・クラスは以下のとおりです。
- WebSphere Portal ネットワーク・セキュリティー: com.ibm.hats.common.wel.StandardPortletNS
- WebSphere Portal Credential Vault Credential Mapper : com.ibm.hats.common.wel.StandardPortletCredentialVaultCM
- ポートレット・アプリケーションに信任状ボールトを実装する場合は、その信任状ボールト・サービスにアクセスするコードをマイグレーションする必要があります。詳しくは、WebSphere Portal インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp) の『ポートレット認証』というセクションを参照してください。
- ポートレット通信を実装する場合、使用される通信メカニズムを変換する必要があります。詳しくは、ポートレット通信を参照してください。
HATS ポートレットの処理
HATS ポートレット・プロジェクトが HATS プロジェクトであることに変わりはありません。つまり、すべての HATS ウィザードおよびエディターをこのプロジェクト上で引き続き使用することができます。また、HATS ポートレット・プロジェクトもポートレット・プロジェクトです。つまり、プロジェクトですべての Portal Tools のエディターおよびランタイム構成が使用できるということです。HATS ポートレット・プロジェクトは、異なるアイコン
でツリーに表示されます。
接続パラメーターおよびグローバル変数のオーバーライド
ポートレットの接続パラメーターおよびグローバル変数は、プロジェクト設定をカスタマイズすることによってオーバーライドできます。詳しくは、接続パラメーターのオーバーライドおよび グローバル変数のオーバーライドを参照してください。
IBM ポートレット
HATS IBM ポートレットでプロジェクト設定のオーバーライドを許可した場合は、EntryPortlet クラスを拡張し、doView() メソッドをオーバーライドすることによって、オーバーライドを実行することができます。
EntryPortlet クラスの拡張について詳しくは、「HATS Web アプリケーション・プログラマーズ・ガイド」を参照してください。
標準ポートレット
HATS 標準ポートレットでプロジェクト設定のオーバーライドを許可した場合、ユーザーは、ポートレットのツールバーから編集モードに切り替えて、接続パラメーターおよびグローバル変数をオーバーライドすることができます。
WebSphere Portal V6.0 および V6.1 の場合は、ツールバーのポートレット・メニューから「個別設定 (Personalize)」を選択します。
注:
WebSphere Application Server V6.1 または V7.0 の場合、HATS では、ポートレット編集モードをサポートしていません。ポートレット編集モードを使用する代わりに、WebSphere Application Server V6.1 または V7.0 上で直接稼働するように HATS 標準ポートレットを展開すると、ユーザーは、ポートレットへのアクセスに使用する URL に含まれる接続パラメーターおよびグローバル変数をオーバーライドすることができます。
ポートレット編集モードに切り替わると、ユーザーに対して設定ページが表示されます。このページで、ユーザーは接続パラメーターおよびグローバル変数の設定をオーバーライドできます。これらの機能は、アプリケーションへの初回アクセス時に URL を使用して設定をオーバーライドすることをユーザーに許可する、HATS の Web アプリケーション用機能と同等のものです。
この設定ページの接続パラメーター・セクションにある接続パラメーターのドロップダウンには、プロジェクト設定でのオーバーライドを許可する Host On-Demand セッション・パラメーターがリストされます。ユーザーがオーバーライドを設定するには、このドロップダウン・リストからパラメーターを選択して「値」フィールドに値を入力し、「追加」をクリックします。デフォルトでは、最初に追加されるときにオーバーライド設定が使用可能になります。
「使用可能」ドロップダウンから「false」を選択すると、この設定を無効にできます。オーバーライドを削除するには、パラメーター名の横にあるチェック・ボックスを選択して、「削除」をクリックします。
グローバル変数セクションでユーザーがオーバーライドを設定するには、グローバル変数の名前および値を入力して、「追加」をクリックします。オーバーライドの追加後に「共用」ドロップダウンから「true」を選択すると、そのグローバル変数が共用グローバル変数として識別されるようになります。デフォルトでは、最初に追加されるときにオーバーライド設定が使用可能になります。
「使用可能」ドロップダウンから「false」を選択すると、この設定を無効にできます。オーバーライドを削除するには、グローバル変数名の横にあるチェック・ボックスを選択して、「削除」をクリックします。
ユーザーが「保存して終了」をクリックすると、ポートレット設定に設定が保存されます。
注:
- ユーザーが入力した値は検証されません。
- 新しい値を有効にするには、ポートレット・アプリケーションを切断してから再始動する必要があります。
ユーザーによるオーバーライド設定を許可するほかに、HATS JSR 168 入力ポートレットを拡張することによって、接続パラメーターおよびグローバル変数のオーバーライドをプログラマチックに指定することができます。詳しくは、「HATS Web アプリケーション・プログラマーズ・ガイド」のセクション『Entry ポートレットの拡張』を参照してください。
注:
こちらが拡張ポートレット・クラスを使用して接続パラメーターまたはグローバル変数のオーバーライドを指定した際に、ユーザーがポートレット編集モードを使用して同じオーバーライドを指定した場合は、こちらが拡張ポートレット・クラスで指定した値が、ユーザーが編集モードで指定した値によってオーバーライドされます。
ポートレット通信
WebSphere Portal は、ポートレットが情報を交換または共用するための複数の方法をサポートします。詳しくは、WebSphere Portal インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp) の『ポートレット通信』というセクションを参照してください。
このセクションでは、WebSphere Portal ポートレット通信の HATS サポートについて説明します。
IBM ポートレット
HATS IBM ポートレットは、ポートレット通信ソリューションを提供するための Click-to-Action 実装をサポートしています。詳しくは、「HATS Web アプリケーション・プログラマーズ・ガイド」の『連携ポートレット』というセクションを参照してください。
標準ポートレット
HATS 標準 (JSR 168) ポートレット・サポートは、WebSphere Portal 連携ポートレット・メカニズムを使用してポートレット通信ソリューションを提供します。
JSR 168 ポートレットは、プロパティーを使用して相互に通信します。
HATS JSR 168 ポートレットは、その他の JSR 168 ポートレット (HATS または非 HATS) との間でプロパティーの送受信を行うための機能をサポートします。通信するためには、ポートレットをワイヤリングする必要があります。
HATS JSR 168 ポートレットからのプロパティーの送信
- 送信するプロパティーの値を含むグローバル変数を作成します。これは、「グローバル変数を抽出」アクションや「グローバル変数を設定」アクションの実行など、いくつかの方法で行うことができます。JSR 168 ポートレット通信では、ゼロ個以上のストリングを含む (それ以外のタイプは含まない) ことができるグローバル変数のみを使用できます。グローバル変数は、JSR 168 プロパティーの値のラッパーと考えることができます。
- HATS 画面イベントまたは一致しない画面アプリケーション・イベントに「グローバル変数の送信」アクションを追加して、グローバル変数の値をプロパティーとして送信します。これを行う方法については、「グローバル変数を送信」アクションを参照してください。
このアクションを「グローバル変数を抽出」アクションとともに使用することによって、ユーザーが入力したデータを、あるポートレットから別のポートレットに送信することができます。例えば、「変換を適用」アクションと「グローバル変数の送信」アクションの間に「グローバル変数を抽出」アクションを追加することで、ユーザーが入力したデータを取り込み、それを他のポートレットに送信することができます。
- HATS JSR 168 ポートレット・プロジェクトが実行されているときに「グローバル変数の送信」アクションを実行すると、指定されたグローバル変数のプロパティー名とストリング内容が WebSphere Portal に渡され、そこからこの HATS JSR 168 ポートレットにワイヤリングされているポートレットにプロパティーを受信するように通知します。
HATS JSR 168 ポートレットでのプロパティーの受信
- ポートレット設定を使用して、プロパティー名および、このポートレットで受信するプロパティーの値を含む、対応するグローバル変数を定義します。ポートレット設定には、プロジェクト設定エディターで「その他」タブをクリックしてから「ポートレット」をクリックすることによりアクセスします。これを行う方法の詳細については、ポートレットの設定を参照してください。
- WebSphere Portal がソース・ポートレットからプロパティーを受信すると、ターゲット・ポートレットに通知されます。HATS JSR 168 ポートレット・ランタイム・サービスは、WebSphere Portal からプロパティー値を取得し、指定されたグローバル変数に格納します。繰り返しますが、JSR 168 通信では、ストリング (複数可) を含むグローバル変数のみを使用できます。
非 HATS JSR 168 ポートレットとの通信
Rational SDP には、連携ポートレットを実装するための GUI サポートがあります。
HATS JSR 168 ポートレットと通信するように非 HATS JSR 168 ポートレットを構成する場合は、以下のステップを実行します。
- 「ウィンドウ」>「ビューの表示」>「その他」>「一般」>「プロジェクト・エクスプローラー」と選択して、Rational SDP メニュー・バーから「プロジェクト・エクスプローラー」ビューを開きます。
- 「プロジェクト・エクスプローラー」ビューで、ポートレット・プロジェクトの下にある「ポートレット・デプロイメント記述子」ノードを右クリックします。
- 「連携 (Cooperative)」>「このポートレットによるデータ (ソース) の送信を使用可能にする」、または「連携 (Cooperative)」>「このポートレットによるデータ (ターゲット) の受信を使用可能にする」と選択し、選択したポートレットの連携ポートレット・サポートを有効にするためのウィザードを開始します。
- このウィザードでは、以下の項目を正しく設定してください。
データ型 URI の編集
「グローバル変数の送信」アクションまたはプロパティーを受信するためのポートレット設定を構成するときに、HATS は、そのプロパティーのデータ型 URI をデフォルトで http://com.ibm.hats.portlet.pb#<property_name>Type に設定します。この URI を使用するのは、ソース・ポートレットとターゲット・ポートレットをワイヤリングする場合のみです。
WebSphere Portal でプロパティーを送信および受信するには、ソース・ポートレットとターゲット・ポートレットで同じ URI を使用する必要があります。何らかの理由でこの URI をデフォルト以外の値に構成する必要がある場合は、Portal のツールキットで以下のステップを実行することにより、プロパティーの URI を変更することができます。
- 「ウィンドウ」>「ビューの表示」>「その他」>「一般」>「プロジェクト・エクスプローラー」と選択して、Rational SDP メニュー・バーから「プロジェクト・エクスプローラー」ビューを開きます。
- 「プロジェクト・エクスプローラー」ビューでプロジェクトを展開し、変更の対象となるプロパティーを表示します。プロパティーは、「ポートレット・デプロイメント記述子」ノードの下にあります。
- プロパティーを右クリックし、「データ型の編集」を選択します。
- 「連携ソースの編集」ウィザードまたは「連携ターゲットの編集」ウィザードで、「データ型 URI」を変更します。
通信のためのポートレットのワイヤリング
ポートレットのワイヤリングは、 WebSphere Portal 連携ポートレット API を使用して通信するポートレット間の情報フローを誘導するために使用されます。ポートレットのワイヤリングとは、連携ポートレット・プロパティーの送受信を目的として、ポータル・サーバーのワイヤリング・ツールを使用して 2 つのポートレットを接続することです。ポートレットは、単一のプロパティー についてのみワイヤリングされ、両方のポートレットがこのプロパティー に同じ名前を指定する必要があります。ただし、関連付けられたグローバル変数の名前は異なっていてもかまいません。言い換えると、2 つのポートレットが 2 つのプロパティーを送受信する場合、それらを接続する 2 つのワイヤー (それぞれのプロパティー に対して 1 つ) が必要です。ワイヤリング手順を実行しないと、データは伝送されません。
カスタム PDT およびカスタム・テーブル
カスタム・プリンター定義テーブル (PDT) またはカスタム・テーブルを含むポートレット・プロジェクトをポータル・サーバーにデプロイする前に、ファイルまたはフォルダーを HATS ポートレット・プロジェクトの \Web Content ディレクトリーにコピーする必要があります。各追加のタイプのファイルまたはフォルダーを以下に示します。
- カスタム・プリンター定義テーブル (PDT): コンパイルされた PDT ファイル、またはコンパイルされた PDT ファイルを含むフォルダー
- カスタム・テーブル: カスタム・テーブルの定義を含む customtable フォルダー
Web Services for Remote Portlets
Web Services for Remote Portlets (WSRP) は、ポータルで、ポートレット、アプリケーション、およびコンテンツを WSRP サービスとして提供する際に使用可能な規格です。他のポータルは、ポータル・ユーザーのリモート・ポートレットとして、これらの WSRP サービスを統合できます。
標準ポートレットおよび IBM HATS ポートレットを、他のポータルで消費可能なリモート・ポートレットとして指定できます。詳細については、
WebSphere インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp) にアクセスして「WSRP サービスの使用」で検索してください。
HATS ポートレットのテスト
Rational SDP 内に WebSphere Portal テスト環境が構成されている場合は、その環境を使用して、HATS 標準ポートレットまたは IBM ポートレットを実動ポータル・サーバーに展開する前にテストすることができます。
展開する前に、必要に応じて、WebSphere Application Server V6.1 または V7.0 ローカル・テスト環境を使用して HATS 標準ポートレットをテストすることもできます。
HATS ポートレット・プロジェクトをテストする場合は、HATS Web プロジェクトのテストと同じ手順を使用します。詳しくは、概要を参照してください。
HATS ポートレットのエクスポート
HATS ポートレットをデプロイメントのためにエクスポートするには、「HATS プロジェクト」ビューでポートレット・プロジェクトを右クリックして、「プロジェクトのエクスポート」を選択します。エクスポートする .war ファイルのターゲット・ファイル名を 「宛先」ドロップダウンで入力し、「完了」をクリックします。.war ファイルのみがエクスポートされます。.ear ファイルを使用するのは、ローカル・テスト環境でのテストの場合のみです。
HATS ポートレットの .war ファイルをエクスポートしたら、WebSphere Portal の管理ツールを使用して、それを WebSphere Portal にインストールします。
標準ポートレットを WebSphere Application Server V6.1 または V7.0 にインストールする場合は、 WebSphere Application Server 管理コンソールを使用し、以下の説明を考慮します。
- インストール中に、コンテキスト・ルート名を指定する必要があります。このコンテキスト・ルート名は、インストール完了後にポートレット .war ファイルを開始するために必要です。インストール中に、.war ファイルを server1、または定義済み Web サーバー・インスタンスにデプロイします。
- ポートレット .war ファイルのインストール後、「アプリケーション」を展開して「エンタープライズ・アプリケーション」をクリックすることにより、WebSphere Application Server 管理コンソールを使用してコンテキスト・ルート名とポートレット名を確認できます。ご使用の .war ファイルをクリックし、「Web モジュールのコンテキスト・ルート」をクリックします。
Web モジュールと ContextRoot の値をメモします。これらの値は、HATS アプリケーションを開始するために使用されます。
- HATS アプリケーションを実行するには、ブラウザーに URL を入力します。例えば、http://host:port/context_root_name/portlet_name と入力します。ここで、host と port は、ポートレットをインストールした WebSphere Application Server ホストのホスト名とポートを表します。context_root_name には、ポートレット .war ファイルのインストール時にコンテキスト・ルートに指定した値を使用し、portlet_name には、Web モジュールに指定した値を使用します。
HATS ポートレットの管理
HATS ポートレットは、HATS 管理コンソールを使用して管理できます。
HATS 標準ポートレットは、Portal Server または WebSphere Application Server のどちらにインストールしたかには関係なく、独立型の HATS 管理アプリケーションを使用して管理できます。HATS IBM ポートレットは、独立型の HATS 管理アプリケーション、またはそのポートレット自体に組み込まれている管理コンソール・サポートを使用して管理できます。
独立型の HATS 管理アプリケーションの使用
HATS 標準ポートレットおよび HATS IBM ポートレットを独立型の HATS 管理アプリケーションを使用して管理するには、以下のステップに従います。
- HATS Toolkit で「ファイル」>「新規」>「プロジェクト」>「HATS」>「HATS 管理プロジェクト」と選択して、独立型の HATS 管理プロジェクトを作成します。
HATS 管理プロジェクトは、HATS Toolkit の「ナビゲーター」タブにのみ表示されます。
- その HATS 管理 .ear プロジェクトを右クリックし、「エクスポート」>「Java EE」>「EAR」を選択することによって、.ear プロジェクトを .ear ファイルにエクスポートします。
- 独立型の HATS 管理アプリケーションの .ear ファイルを、WebSphere Application Server 管理コンソールを使用して WebSphere Application Server に展開します。
注:
- .ear ファイルは、WebSphere Portal サーバーと同じ WebSphere Application Server システムにインストールしてください。標準 HATS ポートレットを WebSphere Application Server に直接インストールする場合は、.ear ファイルを同じサーバーにインストールしてください。
- モジュールは、WebSphere Portal Server ではなく、WebSphere Application Server にマップするようにしてください (例えば、server1)。
- WebSphere Application Server V6.x の場合、HATS 管理者役割について、「セキュリティー・ロールをユーザー/グループにマップ」パネルで「認証済みすべて」オプションに必ずチェックマークを付けてください。WebSphere Application Server V7.x の場合、「セキュリティー・ロールをユーザー/グループにマップ」パネルの「特殊サブジェクトのマップ (Map Special Subjects)」ドロップダウンを使用して、「アプリケーション・レルム内の認証済みすべて (All Authenticated in Application Realm)」オプションが選択されていることを確認してください。
- ポートレットの管理に使用するユーザー ID は、管理者権限を付与されたWebSphere Application Server 管理コンソール・ユーザーとして定義されている必要があります。これを実行するには、以下のステップを実行します。
- WebSphere Application Server 管理コンソールで、「ユーザーおよびグループ」>「 管理ユーザーのロール」>「追加」を選択します (WebSphere Application Server V6.1 より前の場合は、「システム管理」>「コンソール設定」>「コンソール・ユーザー」>「追加」を選択)。
- ポートレットの管理に使用するユーザー ID を入力し、このユーザー ID を管理者の役割にマップします。
注:
- WebSphere Application Server 管理コンソールを使用して HATS 管理アプリケーションを開始します。
- 独立型の HATS 管理コンソールにアクセスします。例えば、http://<washostname>/<hatsadminprojectname>/hatsadmin/admin という URL を使用します。
注:
HATS 管理コンソールにアクセスする際は、ポートレットにアクセスする際とは異なるブラウザーを使用する必要があります。
- 「スタートアップ・ガイド」>「管理の有効範囲」と選択します。
- 「新規」をクリックします。
- 「ホスト」フィールドに、ターゲット WebSphere Application Server ホストと同じホスト名を入力します。
- 「ポート」フィールドに、ターゲット・サーバーの BOOTSTRAP_ADDRESS ポートを入力します。ターゲット・サーバーの BOOTSTRAP_ADDRESS ポートを調べるには、WebSphere Application Server 管理コンソールにアクセスして、以下のステップに従います。
- 「サーバー」>「アプリケーション・サーバー」と選択します。
- ターゲット・サーバー (WebSphere Portal サーバーまたは WebSphere Application Server (例: server1、標準 HATS ポートレットが WebSphere Application Server に直接インストールされている場合) のいずれか) をクリックします。
- 「構成」タブの「通信 (Communications)」にある「ポート (Ports)」を展開します。
- ターゲット・サーバーの BOOTSTRAP_ADDRESS ポートをメモします。
- 「OK」をクリックします。
- 新しく追加したホストを選択します。
- 「上記で選択した有効範囲内のすべてのアプリケーションを管理」は選択しないでください。
- HATS ポートレットのリストが表示されます。
HATS 管理コンソールを使用して、このリストから 1 つを選択することにより、一度に 1 つのポートレット・アプリケーションを管理します。
ポートレットに組み込まれた管理サポートの使用
HATS 管理コンソール・サポートの組み込まれたポートレットを使用して HATS IBM ポートレットを管理するには、以下のステップに従います。
注:
このオプションは、HATS 標準ポートレットではサポートされていません。
- HATS Toolkit で「ファイル」>「新規」>「HATS プロジェクト」と選択して、HATS IBM ポートレット・プロジェクトを作成します。
IBM ポートレットの「プロジェクトの作成」ウィザードで、オプション「管理コンソール・サポートを追加」を選択します。
- 「HATS プロジェクト」ビューでポートレット・プロジェクトを右クリックし、「プロジェクトのエクスポート」を選択して、そのプロジェクトを .war ファイルにエクスポートします。
- その HATS IBM ポートレットの .war ファイルを、ご使用の WebSphere Portal サーバーに展開します。
- ご使用の WebSphere Portal サーバーがインストールされている WebSphere Application Server 管理コンソールにアクセスします。
- 「アプリケーション」>「エンタープライズ・アプリケーション」と選択します。
- HATS 管理ポートレットの名前をクリックして、「デプロイメント記述子の表示 (View Deployment Descriptor)」をクリックします。
- デプロイメント記述子に示された PA_値 をメモします。例えば、PA_#uaj0rfu (WebSphere Portal
V6.0) または PA_projectname (WebSphere Portal
V6.1) です。
- 「サーバー」>「アプリケーション・サーバー」と選択します。
- ご使用の WebSphere Portal サーバーをクリックして、「構成」タブの「通信 (Communications)」にある「ポート (Ports)」を展開します。
- ご使用の Portal サーバーの BOOTSTRAP_ADDRESS ポートをメモします。
- 先ほどメモしたデプロイメント記述子内の PA_値 を使用して、ポートレットに組み込まれている HATS 管理コンソールにアクセスします。例えば、http://<portalhostname>/wps/PA_値/hatsadmin/admin という URL を使用します。
注:
HATS 管理コンソールにアクセスする際は、ポートレットにアクセスする際とは異なるブラウザーを使用する必要があります。
- 「スタートアップ・ガイド」>「管理の有効範囲」と選択します。
- 「新規」をクリックし、「ホスト」フィールドに、ご使用の WebSphere Portal サーバー・ホストと同じホスト名を入力します。また、「ポート」フィールドに、先ほどメモした WebSphere Portal サーバーの BOOTSTRAP_ADDRESS ポートを入力します。
「OK」をクリックします。
- 新しく追加したホストを選択します。
- 「上記で選択した有効範囲内のすべてのアプリケーションを管理」は選択しないでください。
- HATS ポートレットのリストが表示されます。
HATS 管理コンソールを使用して、コンソールが組み込まれているポートレット・アプリケーションのみを管理します。
HATS ポートレットの考慮事項と制限
一般的な考慮事項と制限
以下に、HATS IBM ポートレットまたは HATS 標準ポートレットを使用する際の考慮事項および制限をリストします。
- ポートレットは、Web アプリケーション・アーカイブ (.war ファイル) としてインストールする場合にのみ、実動環境にインストールできます。
HATS では .war ファイルごとに 1 つのプロジェクトしかないため、HATS アプリケーションのセットを単一のポートレット・アプリケーションとしてエクスポートすることはできません。
- WebSphere Portal 内での認証には Cookie が必要であるため、WebSphere Portal 内の HATS は Cookie を有効にして稼働させる必要があります。
- HATS Web プロジェクトから HATS IBM ポートレット・プロジェクトまたは HATS 標準ポートレット・プロジェクトにコピーされた JSP ファイル (テンプレート、変換、変換フラグメント、およびマクロ・ハンドラーなど) は、変換しない限り動作しません。これらの JSP ファイルを変換するには、「ポータルの JSP の変換」アクションを使用します。同様に、HATS IBM ポートレット・プロジェクトから HATS 標準ポートレット・プロジェクト (またはその逆) にコピーされた JSP ファイルは、「ポータルの JSP の変換」アクションを使用して変換する必要があります。
- Rational SDP の「新規ポートレット」ウィザードに HATS オプションが表示されますが、これらのオプションを選択しても、HATS リソースのない空のポートレットが生成されるだけです。
- HATS IBM ポートレットと HATS 標準ポートレットを、互いに干渉し合うことなく同じポータル・ページ上で実行することはできません。標準ポートレットで実行されたすべての入力またはアクションが、IBM ポートレットに転送または継承されます。
IBM と標準の要求パラメーター処理の違いの詳細については、WebSphere Portal インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp) で「ポートレットにおける要求パラメーターの処理および可視性」を検索してください。
- HATS ポートレットがその他のポートレット (HATS または非 HATS) と同じポータル・ページにある場合、HATS ポートレット を切断すると、同じポータル・ページ上のその他のポートレットとの対話で発生するページ最新表示の結果として、ポートレットは自動的に再始動されます。
HATS IBM ポートレットは、テーマがデフォルトの Inherited に設定されている場合にこの動作を示します。
HATS 標準ポートレットは、ポータル・ページのテーマが PortalWeb2 に設定されている場合にこの動作を示します。
- 以下の HATS 機能、アクション、および設定は、HATS ポートレットではサポートされていません。
- 変換とテンプレートの編集時における Page Designer の「プレビュー」機能。
- 「HTTP 圧縮を有効にする」設定。
- 「非同期更新」アプレット。
- 「disconnectOnClose」接続パラメーター。
- 画面組み合わせのオプション「動的キャッシュ・コンテンツ・ロードを使用する」。
- WebFacing アプリケーションとの HATS の相互運用性。
IBM ポートレットの考慮事項と制限
以下に、HATS IBM ポートレットを使用する際の考慮事項および制限をリストします。
-
IBM ポートレット API は、HATS V7.5.1 および WebSphere Portal V6.0 と V6.1 では非推奨です。
- HATS IBM ポートレットは、WebSphere Portal サーバー上でのみ実行することができます。例えば、HATS IBM ポートレットを WebSphere Application Server 上で直接実行することはできません。
- 「URL に転送」アクションおよび「HATS アプリケーションへの転送の挿入」機能。
JSP フロー制御を使用する HATS アプリケーションは、HATS IBM ポートレットでは正常に動作しません。
IBM ポートレットはサーブレット駆動のエンティティーであるため、ナビゲーションを実行するには、URL にエンコードされたアクションを使用する必要があります。
標準ポートレットの考慮事項と制限
以下に、HATS 標準ポートレットを使用する際の考慮事項および制限をリストします。
- HATS 標準ポートレットは、WebSphere Portal サーバー上か WebSphere Application Server V6.1 または V7.0 上でのみ実行できます。
- WebSphere Portal 信任状ボールト・プラグインを使用して HATS 標準ポートレットに Web 高速ログオン (WEL) サポートを追加すると、サポートされる WebSphere Portal サーバーで実行されます。ただし、信任状ボールト・サービスのサポートがない WebSphere Application Server v6.1 または v7.0 で実行している場合、ホスト・システムへのログオンは失敗します。
- 以下の HATS アクション、設定、および機能は、HATS 標準ポートレットではサポートされていません。
- ポートレット・プロジェクトに HATS 管理コンソール・サポートを追加する機能。
- 「新規ビジネス・ロジック」ウィザードで、認証データへのアクセス、認証データの取得、ポートレット・メッセージング、またはプロパティー・ブローカーの使用などの機能のサンプル・コードを生成する機能。
- 「ポートレットのプレプレゼンテーション (Portlet Prepresentation)」(「ブロック区切り文字を追加」) アクション。
- 「グローバル変数の送信」アクションを使用する際、「変換を適用」アクションと「グローバル変数の送信」アクションの間でサポートされるアクションは、以下のアクションだけです。
- ビジネス・ロジックを実行
- グローバル変数を抽出
- データを挿入
- グローバル変数を設定
- グローバル変数を除去
- マクロ・トランザクションを実行
- 一時停止
- 統合オブジェクトを使用する際は、以下のことが適用されます。
- HATS 管理コンソールを使用してアクティブなホスト接続を表示する際、HATS 標準ポートレットのクライアント接続に、ブランクの IP アドレスが表示されます。