ポータル・ツール - リリース情報


1.0 サポートされるソフトウェアおよび仕様
2.0 制限
   2.1 JSR 168 ポートレットには ID 属性が必要
   2.2 関連レコードと Portal V5.1
   2.3 * 連携ポートレットの制限
   2.4 * 個人タグの制限
   2.5 * EIS ツールの制限
   2.6 WebSphere Portal サーバーでの SAP JCo の構成
   2.7 「問題」ビューにリンク切れに関する警告メッセージが表示される
   2.8 Portal Designer のマークアップ・サポート
   2.9 * 社内 URL を設定できない
   2.10 * Admin テーマはデフォルトとして選択できない
3.0 既知の問題
   3.1 (インストール) WebSphere Portal テスト環境のインストール中に障害
   3.2 (ポートレットの作成) 最新 WebSphere Portal でコンパイル・エラー
   3.3 (ポートレットの作成) Click-to-Action を使用可能にすると予期しないポートレット・アイコンが表示される
   3.4 * (ポートレットの作成) 既存の IBM API ポートレット・プロジェクトにてポートレットを作成する際のサーブレット参照の誤りについてのエラー
   3.5 (ポートレットのデバッグとテスト) WebSphere Portal テスト環境を開始できない
   3.6 (ポートレットのデバッグとテスト) テスト環境で管理ポートレットを使用してポートレットをインストールできない
   3.7 (ポートレットのデバッグとテスト) ポートレット・アプリケーションが Cloudscape 以外のデータベースを使用するとエラーが発生する
   3.8 (ポートレット・デプロイメント記述子) JSR 168 ポートレット・デプロイメント記述子エディターによる編集
   3.9 (実行およびデバッグ) 内部ブラウザーが更新済みポータルまたはポートレット・プロジェクトを表示しない
   3.10 <f:view> の代わりに <f:subview> を使用すると、Faces ポートレットが正しく機能しない
   3.11 * 最大化された Faces ポートレットで Click-to-Action が機能しない
   3.12 (ポートレットのマイグレーション) Portal V4.2 ポートレットの V5.0 へのマイグレーションが失敗
   3.13 *(インポート、エクスポート、およびデプロイ) 「ローカル・ホスト」をターゲットとする「インポート、エクスポート、およびデプロイ」サーバーを作成できない
   3.14 * (ポータルのインポート) インポート操作をキャンセルすると新規ポータル・プロジェクトが使用不可になる
   3.15 (ポータルのインポート) インポートされたポータル・プロジェクトの「問題」ビューに WSRP 関連エラーが表示される
   3.16 (ポータルのカスタマイズ) インポートされたポータル・プロジェクトで license.html ファイルおよび privacy.html ファイルを開くことができない
   3.17 * (ポータル・プロジェクトの実行およびデバッグ) ポータル・プロジェクトで WebSphere Portal 5.0 テスト環境を開始できない
   3.18 Rational Application Developer のニュースグループ (フォーラム)

1.0 サポートされるソフトウェアおよび仕様

ポータル・プロジェクトは WebSphere Portal v5.0.2.2 をサポートします。

2.0 制限

2.1 JSR 168 ポートレットには ID 属性が必要

ポートレット・ウィザードを使用して JSR 168 ポートレットを作成するとき、Rational Developer は ID 属性を自動的に割り当てます。サーバーにポートレットを一意的に識別するためには、portlet.xml ファイルの <portlet-app/> エレメントに ID 属性を含める必要があります。 (この属性は IBM ポートレット API ポートレットが使用する UID 属性に対応します。)

portlet.xml <portlet-app/> エレメントに ID 属性を持たない JSR 168 ポートレットがある場合は、ワークスペースにポートレットをインポートしたら即時に固有値のある ID 属性を追加してください。ID 属性を追加するには、ポートレット・デプロイメント記述子を開き、「ソース」ビューを使用して編集します。 JSR 168 ポートレットをデプロイした後、またはポータル・プロジェクトで JSR 168 ポートレット・プロジェクトを使用した後は、ID 値を変更しないでください。

ID 属性のない JSR 168 ポートレットには次の制限があります。

2.2 関連レコードと Portal V5.1

関連レコード・リストまたは関連レコード (SDO) のいずれかを含むポートレットを実行すると、サーバー・ログに次のエラーが記録されることがあります。

[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError: クラス org/eclipse/emf/ecore/EClass がローダー制約に違反: 親ローダーと子ローダー間の定義不一致
このエラーは無視できます。

2.3 * 連携ポートレットの制限

連携ソース・ポートレットを作成するときは、WSDL ファイルに手動で actionNameParameter 属性および name 属性を追加する必要があります。例えば、以下のようにします。

<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>

このリリースでは、ポータル・ツールは WSDL ファイルに caption 属性を生成しません。WebSphere Portal v5.1 とのワイヤーを使用する際は、手動で WSDL ファイルに caption 属性を指定し、リソース・ファイルに表題値を指定する必要があります。たとえば、次のように指定します。

<portlet:param name="orderId" partname="order_id" caption="order.id" />
詳しくは WebSphere Portal インフォメーション・センターの「連携のためのポートレットの開発」トピックを参照してください。

注: この問題は V6.0.0.1 で修正されました。

2.4 * 個人タグの制限

WebSphere Portal v5.1 で IBM API 基本ポートレットに個人タグを使用する場合は、次の構文を使用して指定できます。

<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />

WebSphere Portal v5.1 で IBM API Faces ポートレットに個人タグを使用する場合は、次の構文を使用して指定できます。
注: この問題は V6.0.0.1 で修正されました。基本ポートレットには、前述の構文と同じものを使用してください。

<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>

個人タグは、JSR 168 ポートレットではサポートされません。

2.5 * EIS ツールの制限

SAP BAPI および RFM SDO ウィザードの制限: 「main および pre/post 関数」ページより先に進み、異なる main 関数をピックした後で戻ろうとしたとき、Pre/Post マッピング・ページが正しく機能しません。

解決策: pre および post 関数マッピングを新規に設定する必要がある場合は、ウィザードを再開しなければなりません。

注: この問題は V6.0.0.1 で修正されました。

2.6 WebSphere Portal サーバーでの SAP JCo の構成

Portal Server で SAP SDO を含むポートレットをテストするためには、まず WebSphere Portal 5.1 サーバーで SAP JCo アダプターを構成する必要があります。

  1. SAP サービス・マーケットプレイスで SAP から SAP の JCo アダプター・ディレクトリーをダウンロードします。
  2. 「ソフトウェアのダウンロード」>「ダウンロード」>「SAP コネクター」>「SAP Java コネクター」をクリックします。 オペレーティング・システムに基づいて、ダウンロードする適切なファイルを選択します。 Zip ファイルの内容をローカル・ディレクトリーに解凍します。
  3. オペレーティング・システムに応じて、次のステップを実行します。注: <wps_51> は、WebSphere Portal 5.1 サーバーのインストール・ディレクトリー (例えば、C:¥WebSphere¥PortalServer51TE) を参照します。
      Windows の場合:
    1. sapjco.jar および sapjcorfc.dll を <wps_51>¥shared¥app にコピーします。
    2. librfc32.dll を c:¥windows¥system32¥ にコピーします。
    3. WebSphere Portal 5.1 サーバーを再開する必要があります。

      Linux の場合:
    1. sapjco.jar および libsapjcorfc.so を <wps_51>¥shared¥app にコピーします。
    2. ファイル librfccm.so を含むフォルダーを環境変数 LD_LIBRARY_PATH に追加します。
    3. WebSphere Portal 5.1 サーバーを再開する必要があります。

2.7 「問題」ビューにリンク切れに関する警告メッセージが表示される

「新規ポータル・プロジェクト」ウィザードを使用してポータル・プロジェクトを作成するか、またはサンプル・ギャラリーからサンプルのポータル・プロジェクトをインポートすると、「問題」ビューにリンク切れに関する警告メッセージが表示されます。

2.8 Portal Designer のマークアップ・サポート

このバージョンの Rational Developer では、Portal Designer はサポートされるマークアップとして HTML、cHTML、および WML のみを表示します。 インポートするプロジェクト内のページまたはラベル用に、サポートされるその他のマークアップを指定した場合、それらのマークアップは Rational Developer でサポートされますが、変更することはできず、「プロパティー」ビューにも表示されません。

2.9 * 社内 URL を設定できない

このバージョンの Rational Developer では、外部 URL は Portal Designer でのみ設定できます。 ポータル・サーバー上に社内 URL がある場合、それらの URL はインポートされたプロジェクトでも維持されますが、変更することはできません。 社内 URL は元のポータル・サーバーに戻してデプロイすることだけができます。

注: この問題は V6.0.0.1 で修正されました。

2.10 * Admin テーマはデフォルトとして選択できない

このリリースの Portal Designer では、Admin および AdminLeftNavigation テーマが「アウトライン」ビューに表示されます。 しかし、これらのテーマはポータル管理目的専用であり、ポータル・プロジェクトのデフォルト・テーマとしては選択できません。

注: この問題は V6.0.0.1 で修正されました。

3.0 既知の問題

3.1 (インストール) WebSphere Portal テスト環境のインストール中に障害

問題: Rational Developer のインストールで WebSphere Portal テスト環境のインストールに失敗する

解決策: インストール・ログをチェックし、問題を是正する適切な手段を実行します。

WebSphere Portal 5.0 テスト環境RD_installdir¥runtimes¥portal_v50¥log¥wpsinstalllog.txt ここで、RD_installdir は Rational Developer をインストールしたディレクトリー。

WebSphere Portal 5.1 テスト環境 WP51TE_installdir¥PortalServer¥log¥wpsinstalllog.txt ここで、WP51TE_installdir は WebSphere Portal v5.1 テスト環境をインストールしたディレクトリー。

ログ・ファイルから問題を識別できない場合は、手動で WebSphere Portal テスト環境のアンインストールを試行してください。 次に、再インストールを行います。 手動アンインストールについては、Rational Developer Installation Guide を参照してください。

3.2 (ポートレットの作成) 最新 WebSphere Portal でコンパイル・エラー

問題: Rational Developer を使用して WebSphere Portal V5.0 用のポートレットをビルドできます。 WebSphere Portal サービスをポータル・サーバーに適用すると、ポートレットのビルド中にコンパイル・エラーを受け取ります。 その場合、コンパイルに必要なファイルを手動で更新することができます。

解決策: ポートレットを正しくコンパイルするには、次のステップを実行します。

WebSphere Portal v5.0.2.x

注: WebSphere Portal テスト環境をアンインストールするには、まずこれらのファイルを元の状態に復元する必要があります。 これを行わないと、フォルダー「portal_v50_stub」が削除されないことがあり、手動による削除が必要になります。

WebSphere Portal v5.1

注: WebSphere Portal テスト環境をアンインストールするには、まずこれらのファイルを元の状態に復元する必要があります。これを行わないと、フォルダー「portal_v51_stub」が削除されないことがあり、手動による削除が必要になります。

3.3 (ポートレットの作成) Click-to-Action を使用可能にすると予期しないポートレット・アイコンが表示される

ポートレット・デプロイメント記述子エディターとプロジェクト・エクスプローラー・ビューには、ポートレット・アイコンとその名前が表示されます。 アイコンはポートレットの状態を示します。 ポートレットの状態には、標準、ソース使用可能、ターゲット使用可能、ソースとターゲットの両方使用可能があります。

問題: ポートレットを Click-to-Action ソース・ポートレットに変換したとき、変換されたポートレットのアイコンだけが変更されなければなりません。 しかし、複数のポートレットが単一のサーブレットに関連付けられている場合など、複数のポートレット・アイコンが変更されることがあります。 そのような場合、意図された Click-to-Action ポートレット・アイコン以外のポートレットのアイコンが誤って表示されます。 ポートレットを Click-to-Action ターゲット・ポートレットに変換したときも同じ状態になります。

解決策: 複数のポートレット・アイコンが変更されますが、変更されたポートレットは 1 つだけです。 変換は成功しており、ポートレット・プロジェクトは破壊されていません。

3.4 * (ポートレットの作成) 既存の IBM API ポートレット・プロジェクトにてポートレットを作成する際のサーブレット参照の誤りについてのエラー

問題: 既存の IBM API ポートレット・プロジェクトに新規ポートレットを作成する場合、「イベント処理」ページにて 「Click-to-Action 送信側ポートレット・サンプルを追加 (Add Click-to-Action sender portlet sample)」または「送信側ポートレット・サンプルの追加 (Add message sender portlet sample)」オプションを選択すると、次のエラー・メッセージが表示されます。

解決策: 次の方法を使用して、ポートレット・プロジェクトを再び開く必要があります。

  1. ポートレット・プロジェクトを右クリックして、ポップアップ・メニューから「プロジェクトを閉じる」を選択します。
  2. ポートレット・プロジェクトを右クリックして、ポップアップ・メニューから「プロジェクトを開く」を選択します。
  3. ポートレット・プロジェクトを右クリックして、ポップアップ・メニューから「妥当性検査の実行」を選択します。

注: この問題は V6.0.0.1 で修正されました。

3.5 (ポートレットのデバッグとテスト) WebSphere Portal テスト環境を開始できない

問題: WebSphere Portal テスト環境の開始が失敗する。

解決策:

3.6 (ポートレットのデバッグとテスト) テスト環境で管理ポートレットを使用してポートレットをインストールできない

問題: WebSphere Portal テスト環境サーバーで、管理ポートレットを使用したポートレットのインストールが失敗します。

解決策: WebSphere Portal テスト環境サーバーでは、管理ポートレットを使用したポートレットのインストールはサポートされていません。 WebSphere Portal テスト環境にポートレットをデプロイするには、Rational Developer で「公開」関数を使用する必要があります。 「公開」関数を使用するには、ポートレット・アプリケーション・プロジェクトを右クリックして「実行」>「サーバーで実行」を選択するか、サーバー・ビューでサーバーを右クリックして「公開」を選択します。

3.7 (ポートレットのデバッグとテスト) ポートレット・アプリケーションが Cloudscape 以外のデータベースを使用するとエラーが発生する

問題: ポートレット・アプリケーションが Cloudscape 以外のデータベースを使用するとエラーが発生することがあります。

解決策: WebSphere Portal テスト環境の WebSphere 固有のクラスパスに JDBC ドライバーを追加する必要があります。 次のステップを実行します。

  1. 「サーバー」ビューで、WebSphere Portal テスト環境サーバーをダブルクリックします。サーバー・エディターが開きます。
  2. エディターの下部で、「環境」タブをクリックします。
  3. ws.ext.dirs セクションで、JDBC ドライバーを追加します。例えば、DB2 の SQLLIB¥java12¥db2java.zip ファイルを追加します。 ここで、SQLLIB は DB2 をインストールしたディレクトリーです。
  4. Ctrl+S を押して変更を保管します。

3.8 (ポートレット・デプロイメント記述子) JSR 168 ポートレット・デプロイメント記述子エディターによる編集

問題: JSR 168 ポートレット・デプロイメント記述子では、「ポートレット・コレクション」エリアでポートレット名を編集できません。

解決策: ソース・ページでポートレット名を編集します。

3.9 (実行およびデバッグ) 内部ブラウザーが更新済みポータルまたはポートレット・プロジェクトを表示しない

問題: WebSphere Portal v5.0 を使用する一部の構成では、リモート・サーバー接続のサーバーを使用してプロジェクトの実行とデバッグを行ったとき、ポータルまたはポートレット・プロジェクトに対して行った変更がブラウザーに自動表示されません。

解決策: 次の 2 つの対処方法があります。

  1. ブラウザーを使用して明示的に WebSphere Portal をログアウトし、再びログインします。 ログイン後に変更が表示されます。 ブラウザー・ウィンドウを閉じるとまた表示されなくなることに注意してください。上の操作は更新されたポータル・プロジェクトが公開されるたびに実行する必要があります。
  2. あるいは、外部ブラウザーを使用するように Rational Developer を構成します。 それには、「ウィンドウ」メニューから「設定 ...」を選択します。 左方の「インターネット」ノードを展開し、「Web ブラウザー」を選択します。 メイン・セクションで、内部 Web ブラウザー以外のブラウザーを選択します。
    この場合、「実行」または「サーバーでデバッグ」を選択する前に、そのつど、操作の実行に先立って外部ブラウザーを閉じる必要があります。

3.10 <f:view> の代わりに <f:subview> を使用すると、Faces ポートレットが正しく機能しない

問題: ウィザード生成の Faces JSP ファイルから <f:view> タグを削除し、Faces コンポーネントをファイルに挿入すると、<f:view> タグの代わりに <f:subview>タグが挿入されます。 このタイプの JSP ファイルでは、Faces ポートレットが正しく実行されません。ブラウザーでの入力がサーバー・サイドの処理で失われます。

問題: この問題をフィックスするには、JSP ファイルで <f:subview> タグを <f:view> タグに置き換えます。

3.11 * 最大化された Faces ポートレットで Click-to-Action が機能しない

Click-to-Action タグを含む Faces ポートレットを最大化すると、ポートレットの内容が表示されません。

注: この問題は V6.0.0.1 で修正されました。

3.12 (ポートレットのマイグレーション) Portal V4.2 ポートレットの V5.0 へのマイグレーションが失敗

問題: クラスパスの長さが長いと、ポートレットの API レベルの変更が失敗します。

解決策: マイグレーションされるポートレット・プロジェクトの Java のビルド・パスを訂正する必要があります。 必要な Java のビルド・パスについては、「新規ポートレット」ウィザードにより生成される基本ポートレット・プロジェクトを参照してください。 マイグレーションするポートレット・プロジェクトの Java のビルド・パスに、欠落している必須 Jar ファイルを追加します。

3.13 * (インポート、エクスポート、およびデプロイ) 「ローカル・ホスト」をターゲットとする「インポート、エクスポート、およびデプロイ」サーバーを作成できない

問題: Portal UTE が未インストールの場合、「ローカル・ホスト」または「127.0.0.1」をターゲットとするポータル「インポート、エクスポート、およびデプロイ」サーバーを作成できません。

解決策: このようなサーバーを作成する必要がある場合は、「ローカル・ホスト」ではなくマシンの完全修飾名 (例えば、myhost.mydomain) を使用します。

注: この問題は V6.0.0.1 で修正されました。

3.14 * (ポータルのインポート) インポート操作をキャンセルすると新規ポータル・プロジェクトが使用不可になる

問題: 新規ポータル・プロジェクトのインポートを完了する前にキャンセルすると、不完全なポータル・プロジェクトが除去されず、使用不可になります。

解決策: 「ポータルのインポート」ウィザードで「上書きで削除」オプションを使用してポータル構成およびファイルを再びインポートする必要があります。

注: この問題は V6.0.0.1 で修正されました。

3.15 (ポータルのインポート) インポートされたポータル・プロジェクトの「問題」ビューに WSRP 関連エラーが表示される

問題: WebSphere Portal から Rational Developer に既存ポータル・サイトをインポートするとき、インポートされたポータル・プロジェクトについて「問題」ビューに WSRP 関連の検証エラーが表示されます。

解決策: Rational Developer にインポートする前に WebSphere Portal に APAR PQ95638 を適用します。

注: この問題は WP5.1 では修正されましたが、WP5.0 では修正されていません。

3.16 (ポータルのカスタマイズ) インポートされたポータル・プロジェクトで license.html ファイルおよび privacy.html ファイルを開くことができない

問題: エンコードの誤りのため、インポートされたポータル・プロジェクト内の license.html ファイルまたは privacy.html ファイルが Page Designer を使用して開くことができません。

解決策: ポータル・サーバーに APAR PQ93681 を適用してから、ポータル・サーバーからプロジェクトを再インポートします。

注: この問題は WP5.1 では修正されましたが、WP5.0 では修正されていません。

3.17 * (ポータル・プロジェクトの実行およびデバッグ) ポータル・プロジェクトで WebSphere Portal 5.0 テスト環境を開始できない

問題: 次の操作を行おうとしたとき、WebSphere Portal 5.0 テスト環境の開始が失敗します。

解決策: WebSphere Portal 5.0 テスト環境を再構成する必要があります。

  1. 「サーバー」ビューでサーバーを右クリックし、「プロジェクトの追加および除去」を選択します。.
  2. 「構成済みプロジェクト」から「wps」プロジェクトを除去します。
  3. ポータル・プロジェクトを右クリックし、「実行」>「サーバーで実行」を選択します。
これで、テスト環境で、ポータル・プロジェクトと、新規に関連付けられたポートレット・プロジェクトを実行できるはずです。

注: この問題は V6.0.0.1 で修正されました。

3.18 Rational Application Developer のニュースグループ (フォーラム)

「SDO ランタイムの追加」は Rational Application Developer ニュースグループ を参照します。Rational Application Developer のフォーラムは IBM の developerWorks サイト (www.ibm.com/developerworks/forums/dw_forum.jsp?forum=430&cat=24&hideBody=true) から入手できます。

メインの README ファイルに戻る