D トラブルシューティング

この付録では、WebCenter Portalアセットに関するトラブルシューティング情報を示します。

この付録の内容は次のとおりです。

D.1 WebCenter Portal共有ライブラリのデプロイメントのトラブルシューティング

デプロイメントが正常に行われたにもかかわらず、デプロイメント後に変更が反映されない。

WebCenter Portalは、常に最新バージョンの共有ライブラリを使用します。MANIFEST.MF内の実装バージョンが、WebLogic Server管理コンソールに表示される実装バージョンに一致することを確認します。

たとえば、PortalSharedLibrary/Application Sources/META-INF/MANIFEST.MFの値が、管理コンソールの「デプロイメント」→「extend.spaces.webapp」→「概要」に表示される値と同じであることを確認します。
「DeployerException: Task 9 failed」が表示されます。
```
weblogic.Deployer$DeployerException: weblogic.deploy.api.tools.deployer.DeployerException: Task 9 failed:
[Deployer:149117]deploy library com.mycompanyname.shared.lib [LibSpecVersion=11.1.1.2,LibImplVersion=11.1.1.2.5] on AdminServer,WC_Portal.
```
このエラーは、新しいデプロイメントと既存のデプロイメントの実装バージョンが同一の場合に発生します。管理コンソールを使用して現在の実装バージョンを確認し、必要に応じてバージョンを変更して共有ライブラリを再デプロイします。
「java.lang.IllegalArgumentException」が表示される。

WebCenter Portalがデプロイされている管理対象サーバーを再起動します。

D.2 ポートレット作成のトラブルシューティング

この項には次のトピックが含まれます:

ポートレットの作成ウィザードにアクセスできない
ポートレットに必要なポートレット機能が追加できない

D.2.1 ポートレットの作成ウィザードにアクセスできない

「新規ギャラリ」に、「規格に基づいたJavaポートレット(JSR 286)」オプションがありません。

問題

「新規ギャラリ」に、「規格に基づいたJavaポートレット(JSR 286)」オプションがありません。

原因

ポートレットを作成しようとしているアプリケーションが、WebCenter Portalの「ポータル・フレームワーク」テンプレートを使用して作成されているため、ポートレット作成用にスコープ設定されていません。

解決策

次の手順を実行します。

ポートレット・プロデューサ・アプリケーションまたはポートレット作成用にスコープ設定されているアプリケーション(WebCenter Portalの「ポータル・フレームワーク」テンプレートを使用して構築されているアプリケーション以外のアプリケーション)でポートレットを作成します。
「新規ギャラリ」で、「すべてのテクノロジ」タブをクリックすると、アプリケーションのテクノロジ・スコープに関係なく、使用できるすべてのオプションがリストされます。

D.2.2 ポートレットに必要なポートレット機能が追加できない

JSR 286 Javaポートレットの作成ウィザードで、特定の機能(たとえば、ポートレット・イベントやパブリック・レンダラ・パラメータなど)をポータルに追加するオプションがありません。

問題

原因

このウィザードには、特定の機能をポートレットに追加するオプションはありません。

解決策

JSR 286 Javaポートレットの作成ウィザードを使用してポートレットを作成した後で、概要エディタを使用してportlet.xmlファイルを編集することで、高度な機能を追加してください。詳細は、「JSR 286 Javaポートレットの開発」を参照してください。

D.3 ページレットのトラブルシューティング

リソースとページレットをトラブルシューティングする際には、次の一般的な構成エラーに注意してください。ページレット・プロデューサ設定の構成の詳細は、第23.2項「ページレット・プロデューサ設定の構成」を参照してください。

SSLを使用する場合、ページレット・プロデューサ設定の「変換」ページで、HTTP (セキュアでない)およびHTTPS (セキュア)ポートが適切に構成されていることを確認してください。
HTTPプロキシを必要とするネットワーク上の外部サイトをプロキシする場合、ページレット・プロデューサ設定の「プロキシ」ページで、プロキシURLを構成する必要があります。
デフォルトで作成されるlogin_resourceおよびpagelet_apiリソースが存在し、適切に構成されていることを確認してください。
KDブラウザや他のCSPページレットをプロキシする場合、ページレット・プロデューサ設定の「CSP」ページで、イメージ・サービスのURLが絶対URLであることと、CSP SOAP APIのURLが正しく設定されていることを確認してください。
Sun Java仮想マシン(JVM)の制限により、ページレットでは、基になる証明書によってMD2署名アルゴリズムが使用される場合、HTTPSコンテンツを使用できません。

その他のトラブルシューティング情報を確認するには、ロギングを使用します。ページレット・プロデューサは、標準のOracle Diagnostic Loggingファシリティにメッセージのログを記録します。Oracle WebLogic Serverの場合、その場所はuser-projects/domains/<domain>/servers/ <server>/logs/<server>-diagnostic.logです。ロギングの構成の詳細は、第14.2.2項「ロギング設定の構成方法」を参照してください。ページレットのデバッグの詳細は、『Oracle Fusion Middleware Oracle JDeveloperによるWebCenter Portalアセットとカスタム・コンポーネントの開発』の「Oracle WebCenter Portalのページレット・プロデューサを使用したページレットの作成」の章を参照してください。

D.4 OmniPortletのトラブルシューティング

この項では、OmniPortletの使用中に発生する可能性がある問題のトラブルシューティングに役立つ情報を提供します。

注意:

OmniPortletプロデューサはWebCenter Portalと異なる層に存在し、実行されるため、セッション情報にはアクセスできないので、OmniPortletがアクセスできるように、XMLファイルをPUBLICとして公開する必要があります。

「定義」リンクを使用してOmniPortletを定義できない

実行時にOmniPortletを定義することはできません。

問題

OmniPortletは、trueのRenderPortletInIFrame値のみをサポートします。これはOmniPortletをIFRAME内でレンダリングする必要があることを意味します。したがって、OmniPortletプロパティRenderPortletInIFrameをtrueに設定する必要があります。「プロパティ・インスペクタ」で、RenderPortletInIFrameプロパティは、「表示オプション」の下にあります。

現時点では、RenderPortletInIFrameプロパティの値はfalseです。そのため、実行時に「定義」リンクをクリックしても、「タイプ」タブは表示されず、OmniPortletの定義を進めることができません。

解決策

OmniPortletを定義するために、「アクション」リストから「カスタマイズ」を選択するか、Oracle JDeveloperの「構造」ウィンドウで「OmniPortlet」を選択して、プロパティ・インスペクタでRenderPortletInIFrameをtrueに設定します。