この章では、Oracle WebCenter Portalに関連する問題について説明します。内容は次のとおりです。
この項では、一般的な問題および回避方法について説明します。次のトピックが含まれます:
14.1.10項「サンプルのWSRPプロデューサ・テスト・ページのスタイル・シートがOracle HTTP Serverを介して正しくロードされない」
14.1.17項「プロデューサ・テスト・ページの「サーブレットとして実行」リンクがJSFポートレットに対して動作しない」
14.1.20項「OpenSocialページレットを使用したユーザーのアクティビティ・ストリームへのアクティビティのポスト」
Oracleでは、Jive Softwareからの組込みディスカッション・サーバーをサポートしています。ディスカッション・サーバーをアプリケーションから直接コールするためのインタフェースは、WebCenter Portalに同梱されているタスク・フローを利用することによって実現します。Jive Webサービス・レイヤーのAPIに対するカスタム・デプロイは、Oracleによる再検討の対象となっているため、サポートされないことがあります。
Jive Softwareがディスカッション・サーバーの一部として配信しているベータ機能の限定セットがありますが、Oracle推奨ではなく、サポートされていません。
参照専用として、Jive Forumsのドキュメントが付属しています。WebCenter Portal製品のインストール対象外となるJive Softwareのインストールおよびアップグレードは、サポートされません。
Oracle WebCenter Portalページレット・プロデューサは、クラスタ化構成でフェイルオーバーをサポートします。ただし、処理中のデータ(未保存または保留中の変更)は保持されません。フェイルオーバー時には、管理者は管理セッションを再確立する必要があります。特定の状態を保持するためにプロキシが必要な場合は、エンド・ユーザーもセッションを再確立する必要があります。SSOが構成されている場合、資格証明が自動的に提供され、セッションが再確立されます。
使用環境がグローバル・ポリシー・アタッチメント(GPA)をサポートしている場合、Content Server接続を構成するときに「クライアント・セキュリティ・ポリシー」プロパティは空白のままにしてください。ヒント・テキストおよびオンライン・ヘルプには、値「GPA」を入力する必要があると記載されていますが、この情報は正しくありません。『Oracle Fusion Middleware for Oracle WebCenter管理者ガイド』のContent Server接続パラメータに関する表も参照してください。
JDeveloperにランタイム・タスクフローを取り込み、これらを編集し、デプロイしたアプリケーションにエクスポートし戻すことができます。ただし、JDeveloperで作成したタスクフローはポータル・リソースとして公開しないことをお薦めします。/oracle/webcenter/portalapp
フォルダ内にADFタスクフローを作成する場合、タスクフロー定義ファイルのコンテキスト・メニューに「ポータル・リソースの作成」オプションが表示されます。このオプションを使用してデザインタイム・タスクフローをポータル・リソースとして公開しないでください。通常、タスクフローには複数のファイルが含まれます。JDeveloperから新しいタスクフローをエクスポートすると、一部のファイルが正しくエクスポートされない可能性があります。この結果、デプロイメント後にタスクフローが破損する可能性があります。
SQLデータ・コントロールを使用するときに、NCHAR
データ型を使用した列が問合せに含まれる場合、エラーが発生する可能性があります。回避方法として、to_char(NCHAR_COLUMN NAME)
関数を使用できます。
SUN JDK 1.6.22を使用してWindows Native Authenticationベースのシングル・サインオンを設定すると、エラーが発生します。Sun JDKのかわりにJRockit JDKを使用するか、Oracleサポートに連絡してバグ10631797のバックポート・リクエストを取得してください。
Oracle WebCenter Source(リスト、ページ、スペースおよびピープル・コネクション・プロファイルなどのSpacesオブジェクトの検索用)は現在、SSLで保護されたWebCenter Portalエンドポイントにはアクセスできません。現在、このためのパッチを作成中です。
Oracle WebCenter Portal iPhoneアプリケーションなどのRESTクライアントの使用時にWebCenter Portal RESTサーバーの特定の機能が正しく機能するには、使用しているOracle Weblogic ServerプラグインでフラグWLForwardUriUnparsed
をON
に設定する必要があります。
Weblogic Serverの前にApacheを実行している場合、このフラグをweblogic.conf
に追加します。
Weblogic Serverの前にOracle HTTP Server (OHS)を実行している場合、このフラグをmod_wl_ohs.conf
に追加します。
次の例は、これら両方の事例で使用可能な構成を示しています。
Weblogic Serverプラグインの構成の詳細は、『Oracle Fusion Middleware Oracle WebLogic ServerにおけるWebサーバー1.1プラグインの使用』を参照してください。
例1: <location /rest>
を使用して/rest
URIに対してのみフラグを適用する(推奨)
<Location /rest> # the flag below MUST BE set to "On" WLForwardUriUnparsed On # other settings, example: WebLogicCluster or WebLogicHost & WebLogicPort # set the handler to be weblogic SetHandler weblogic-handler </Location>
例2: Oracle Weblogic Serverによって処理されるすべてのURIにフラグを適用する
<IfModule mod_weblogic.c> # the flag below MUST BE set to "On" WLForwardUriUnparsed On # other settings, example: WebLogicCluster or WebLogicHost & WebLogicPort WebLogicCluster johndoe02:8005,johndoe:8006 Debug ON WLLogFile c:/tmp/global_proxy.log WLTempDir "c:/myTemp" DebugConfigInfo On KeepAliveEnabled ON KeepAliveSecs 15 </IfModule>
実行時にリソース・マネージャを介して新しいリソースを追加するようFrameworkアプリケーションがカスタマイズされている場合、同じアプリケーションの新規デプロイメントまたは再デプロイメント後にこれらの新しいリソースがなくなります。
リソース自体がリソース・マネージャで使用できなくなっても、失われたリソースを使用する、実行時に作成された新規ページは依然として使用可能なままです。
この問題が発生するのは、Fusion Middleware ControlまたはWLSTを使用してアプリケーションの再デプロイメント時にアプリケーション・バージョンまたは再デプロイメント・バージョンが変更された場合です。また、この問題は、(たとえば、新しいリソースの作成によって)設計時にgeneric-site-resources.xml
ファイルが変更されている場合の再デプロイメントでも発生します。
この問題が発生する原因は、再デプロイメントでgeneric-site-resources.xml
ファイルが上書きされたことにあります。
この問題を回避するには、mds-transfer-config.xml
ファイルをアプリケーションに手動で追加する必要があります。
注意: 設計時に作成されたリソースは、ランタイム・アプリケーションの再デプロイメントの前にこのアプリケーションに手動で追加する必要があります。 |
次の場所からmds-transfer-config.xml
ファイルをダウンロードします。
EARファイルからMARファイル(AutoGeneratedMar.mar
など)を抽出します。
抽出したMARファイル・ディレクトリで、META-INF
という名前の新しいディレクトリを作成し、mds-transfer-config.xml
ファイルを新しいディレクトリにコピーします。
META-INF\mds-transfer-config.xml
を使用してMARファイルを更新します。次はその例です。
jar -uvf AutoGeneratedMar.mar META-INF\mds-transfer-config.xml
更新したMARファイルを使用してEARファイルを更新します。
jar -uvf YourApp.ear AutoGeneratedMar.mar
YourApp
.mar
を再デプロイします。
Oracle HTTP ServerがサンプルのWSRPポートレット・プロデューサのフロント・エンドとして使用されている場合、WSRPツールおよびリッチ・テキスト・エディタのポートレット・プロデューサのWSRPプロデューサ・テスト・ページのスタイル・シートがMozilla FirefoxまたはGoogle Chromeでは正しくロードされません。ただし、Internet Explorerでは、スタイル・シートは正しくロードされます。ポートレットの機能に影響はありません。
JSFポートレット(つまり、Oracle JSF Portlet Bridgeを使用して作成されたポートレット)のカスタマイズまたはパーソナライズ後に「OK」をクリックすると、ポートレットが応答せず、タイムアウト・メッセージが表示されます。これは、編集アクションを実行して単一操作でポートレット・モードを変更すると発生します。エンドユーザーは、「適用」を(「OK」のかわりに)クリックして編集アクションを最初に実行してから、「戻る」クリックしてポートレット・モードを「ビュー」モードに戻すことでこの問題を回避できます。ポートレット開発者は、生成された「デフォルトの編集」モード(edit_defaults.jspx
ファイル)および「編集」モード(edit.jspx
ファイル)のコードを編集し、「適用」ボタンをかわりに使用することをエンドユーザーに強制するように「OK」ボタンのコードを削除することで、発生する問題を回避できます。
カスタム翻訳のフォールバック・サポートがありません。たとえば、scope-resource-bundle_fr.xlf
というカスタム翻訳ファイルを作成し、スペースの言語設定が国固有(fr-FR)である場合、Spacesではscope-resource-bundle_fr-FR.xlf
を探すため、カスタム翻訳ファイルは使用されません。回避方法として、_fr xlf
をコピーし、国指定をカスタム翻訳ファイルの名前に含めます(たとえば、scope-resource-bundle_fr-FR.xlf
など)。
ユーザーがOAMを介してSpacesアプリケーションにアクセスすると、スペースにOAMログイン・ページで選択した言語が表示されません。Spacesアプリケーションでは、OAMと同じxlf
ファイル名規格を使用しません。
表示言語をThaiに設定すると、通知公開形式が正しくない可能性があります。これは、通知を開いて編集した後保存すると、通知自体が更新されていない場合でも発生します。
シード・ページ(「アクティビティ」ページなど)を「お気に入り」リストに追加して、「プリファレンス」を使用して優先アプリケーション言語をen-USから変更すると、お気に入りのシード・ページが見つかりません。
状況によっては、スペースのドキュメントを格納するコンテンツ・サーバーのフォルダに対する権限にSpacesアプリケーションで設定された権限が反映されないことがあります。このような場合、Spacesで適切な権限を割り当てられていても、1人以上のユーザーがそのスペースのドキュメントに対してアクションを実行できない可能性があります。
1人のユーザーにのみ影響する場合にこの状況を解決するには、スペース進行役(メンバーシップの管理権限を割り当てられたスペース・メンバー)は次のいずれかを実行できます。
スペースに対するユーザーのメンバーシップを取り消してから、そのスペースに追加して戻します: スペース管理設定の「メンバー」ページで、「メンバーの削除」をクリックしてメンバーシップを取り消した後、「ユーザーの追加」をクリックしてスペースのメンバーとして追加して戻します。
ユーザーのロールを別のロールに変更してから、必須ロールに変更して戻します: スペース管理設定の「メンバー」ページで、ユーザーを選択して「ロールの変更」をクリックします。
1人以上のユーザーに影響する場合にこの状況を解決するには、スペース進行役(メンバーシップの管理権限を割り当てられたスペース・メンバー)は次の手順を実行できます。
影響を受けるユーザーが持っているメンバーシップ・ロールを特定し、そのロールを編集します: スペース管理設定の「ロール」ページで、ロールを選択して「権限の編集」をクリックします。
ロールの権限をすべて消去し、「保存」をクリックします。
ロールを再度編集し、ロールの権限をすべて選択して「保存」をクリックします。
JSFポートレット(Oracle JSF Portlet Bridgeを使用するポートレット)は、JSR 286 Javaポートレットの作成ウィザードを使用して、ウィザードの第3ステップで「ADF-Faces JSPXの生成」実装方法を選択することで作成できます。
この方法でJSFポートレットを作成すると、ポートレットのプロデューサ・テスト・ページで「サーブレットとして実行」リンクをクリックすると、エラーが発生することがあります。ただし、ポートレット自体は正しく実行されます。
この問題を回避するには、そのポートレットが含まれるプロジェクトに「ADFページ・フロー」スコープを追加します。
コンテンツ・リポジトリ接続(Oracle WebCenter Content: Content Server)へのアクティブな接続を保持するようにWebCenter Portal: Spacesを構成して、WebCenter Portal: Spacesをバウンスすると、ドキュメント・サービスがSpacesで使用不可のように見えます。たとえば、ホーム・スペースまたはスペースで、使用可能なドキュメントがありません。問題の原因は、コンテンツ・リポジトリ接続設定にある可能性が高いです。または、WebCenter PortalデータがContent Serverに正常にシードされなかった可能性があります。
この問題を解決するには、次のようにします。
Content Serverが稼働していることを確認します。サーバーにサーバー・ポート(intradoc
)が構成されていることと、サーバーIPフィルタがWebCenter Portal: Spacesからの接続を許可していることを確認します。
Content Serverにログインします。
「管理」をクリックします。
インスタンス名の「構成」をクリックします。
「システム構成」の「サーバーの構成」リンクをクリックします。
サーバー・ポートがリストされていることと、サーバーIPフィルタがWebCenter Portal: Spacesからのアクセスを許可していることを確認します。
ドキュメント・ストアに使用されているContent Serverのコンテンツ・リポジトリ接続設定が正しいことを確認します。
WLSTまたはFusion Middleware Controlのいずれかを使用して、コンテンツ・リポジトリ接続設定を表示します。
Content Serverの接続が「アクティブな接続」または「プライマリ接続」としてマークされていることを確認します。
Content Serverの設定が正しいことを確認します。
コンテンツ管理者、ルート・フォルダおよびアプリケーション名が指定されていることを確認します。
コンテンツ管理者には、Content Serverにおける管理権限が必要です。このユーザーは、スペース・コンテンツ、セキュリティ・グループ、セキュリティ・ロール用のフォルダの作成および保守と、コンテンツ・アクセス権限の管理に使用されます。
ルート・フォルダおよびアプリケーション名は、一意であり、同じContent Serverを使用する他のWebCenter Portal: Spacesアプリケーションで使用されていない必要があります。これらの値を変更する場合は、いずれか一方のみでなく、必ず両方の値を変更します。
アプリケーション名は、Content Serverで作成され、アイテム名の長さに制限があるアイテム(ワークフローなど)の接頭辞として使用されるため、14文字未満にすることをお薦めします。
Content Serverへの接続およびContent Serverでのデータのシード中に発生したエラーがないか、WebCenter Portal: Spacesの起動時にログを確認します。
WebCenter Portal: Spacesにアクティブまたはプライマリ・コンテンツ・リポジトリ接続があり、コンテンツ管理者、ルート・フォルダおよびアプリケーション名が指定されている場合、WebCenter Portal: Spacesサーバーが起動していると、そのアプリケーションのContent Serverでデータはシードされます(まだ存在しない場合)。
手順1と手順2の両方が正しい場合、WebCenter Portal: Spacesが起動されているときに、WebCenter Portal: Spacesログにエラーがないか確認します。Content Serverでデータをシードしている場合、エラーが存在する可能性があります。
ログに有益なログ情報がない場合、ドキュメント・サーバーのロギングを有効にしてWebCenter Portal: Spacesをバウンスし、WebCenter Portal: Spacesシード・データのシードに関するログ・メッセージを確認します。
Fusion Middleware Controlを使用するか、logging.xml
ファイルを編集して、oracle.webcenter.doclib.internal.model
およびoracle.webcenter.doclib.internal.spaces
のロギングを増やします。
WebCenter Portal: Spacesを再起動します。
WebCenter Portal: Spacesデータのシードに関するメッセージがないかログを確認します。
データが正しくシードされている場合は、次のようなメッセージがTRACEレベルに記録されています。
Content Server already contains the Space container, therefore no need to seed any data
シード・データがまだ存在しない場合は、次のようなメッセージがTRACEレベルに記録されています。
Creating WebCenter Seeded Data
ドキュメント・サービスを使用してテンプレートに基づいてスペースを作成するとき、スペースの作成が次のようなエラーで失敗します。
Granting permissions for Documents failed
この問題を解決するには、WebCenter Portal: Spacesログを表示して、エラーの原因を示すログ・メッセージがあるかどうかを確認します。
エラーの原因が明確でない場合、全ロールのドキュメント権限をすべてリセットして、ロール・マッピングが正常に完了するかどうかを確認してください。失敗はすべて、WebCenter Portal: Spacesログに記録されます。
OpenSocialガジェットに基づいたページレットは、アクティビティをユーザーのアクティビティ・ストリームにポストできません。一時的な解決方法を実行するには、次のWLST/WSAdminコマンドを使用してユーザー・プロファイルの「編集」権限をOracle WebCenter Portalのページレット・プロデューサに付与します。
grantPermission(appStripe="pagelet-producer", principalClass="oracle.security.jps.internal.core.principals.JpsAuthenticatedRoleImpl", principalName="authenticated-role", permClass="oracle.webcenter.peopleconnections.profile.security.ProfilePermission", permTarget="/oracle/webcenter/peopleconnections/profile/s8bba98ff_4cbb_40b8_beee_296c916a23ed/.*", permActions="view,edit")
コマンドの実行後に、ページレット・プロデューサ・サーバーを再起動します。
OpenSocial APIをOracle WebCenter Portalのページレット・プロデューサとともに使用して所有者のプロファイル、アクティビティ、友人情報にアクセスするには、『Oracle Fusion Middleware for Oracle WebCenter管理者ガイド』で説明されているように、WebCenterDS
データソースをWC_Portlet
管理対象サーバーに対してターゲット指定する必要があります。この構成を保存すると、アクティビティおよび友人情報はフェッチできますが、プロファイル情報は戻されません。プロファイル情報にアクセスするには、WC_Portlet
管理対象サーバーを再起動します。
階層スペースでView Document
権限をPublic-User
ロールおよびAuthenticated-User
ロールに付与すると、コンテンツ・サーバーで同等の「読取り」権限が正しく設定されません。パブリック・ユーザーおよび認証済ユーザーにスペースに対するView Document
権限を持たせる場合、両方のロールに対して別個に権限を付与する必要はありません。View Document
権限をパブリック・ユーザーに付与すると、認証済ユーザーはView Document
権限を自動的に継承します。
View Document
権限をパブリック・ユーザーから取り消して、View Document
権限を認証済ユーザーに付与する場合は、Public-User
ロールから権限を取り消してAuthenticated-User
ロールに追加します。
スペース・アプリケーションで言語がロシアに設定されている場合、新しいユーザーのスペースへの追加、登録したユーザーのスペースへの招待、ユーザーのロール割当ての変更または失効を含む、スペースのユーザー・メンバーシップを管理できません。
言語がスウェーデンに設定されていると、スペース管理の下の「ロール」にはアクセスできません。
ユーザーはPublisherタスク・フローから入力され、リンクを含むアクティビティ・ストリームからのメッセージしか削除できません(つまり、ユーザーはPublisher経由で入力されず、リンクを含まないアクティビティ・ストリームからのメッセージは削除できません)。ユーザーはアクティビティ・ストリームからのリンクを含むメッセージのみを削除できます。ページ作成の通知などの、その他のアクティビティ・ストリーム・エントリは削除できません。
リリース11.1.1.6.0では、ディスカッション・サーバーがディスカッション・サーバーとSpaces間でのWebサービスの相互作用に対するメッセージ保護なしで提供されるので、ディスカッション・サーバーを追加構成なしで使用できます。しかし、Oracle WebCenter 11.1.1.4.0またはそれ以前のバージョンにパッチを適用した後で、WSセキュリティ関連エラーが発生したら、ディスカッション・サーバーのセキュリティ設定を再構成する必要があります。詳細は、『Oracle Fusion Middlewareパッチ適用ガイド』のディスカッション用のWebサービス・セキュリティの構成に関する項を参照してください。
この項では、ドキュメントの訂正箇所を示します。内容は次のとおりです。
Oracle Fusion Middleware WebCenter Portalユーザーズ・ガイドの表32-1「アクティビティ・ストリームにより追跡されるアクティビティ」で、次のアクティビティがアクティビティ・ストリームにより追跡されるとリスト行に誤って記載されています。
リストの作成
行のリストへの追加
リスト行の編集
アクティビティ・ストリームは行のリストへの追加またはリスト行の編集を追跡しません。