WebCenter Content Content Portlet Suiteデプロイメント・ガイド

11g リリース1(11.1.1)

B69397-01(原本部品番号:E10637-02)

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 一般情報

- 1.1 新機能

- 1.2 このリリースでサポートされるサーバー

- 1.3 このリリースで提供されるポートレット

- 1.4 お薦めするアクセス設定

- 1.5 ポートレット・インタフェース言語

2 アーキテクチャとリクエストの処理

- 2.1 CPSアーキテクチャの概要

- 2.2 Model-View-Controllerフレームワーク

- 2.3 リクエストの処理

3 WSRPプロデューサとしてのCPSのデプロイ

- 3.1 プロデューサとしてのOracle WebCenter Portal

- 3.1.1 インストール要件

- 3.1.2 サポートされるWSRPコンシューマ

- 3.1.3 カスタム管理対象サーバーの作成

- 3.1.4 WebCenter Portal上でのCPSポートレットのデプロイ

- 3.2 プロデューサとしてのOracle WebLogic Portal

- 3.2.1 インストール要件

- 3.2.2 サポートされるWSRPコンシューマ

- 3.2.3 WebLogic Portal上でのCPSポートレットのデプロイ

- 3.3 プロデューサとしてのIBM WebSphere Portal

- 3.3.1 インストール要件

- 3.3.2 サポートされるWSRPコンシューマ

- 3.3.3 WebSphere Portal上でのCPSポートレットのデプロイ

- 3.4 CPS通信用のOracle WebCenter Content Serverの構成

- 3.4.1 コンテンツ・サーバー上のIPアドレスの有効化

- 3.4.2 コンテンツ・サーバーの構成ファイルの編集

4 CPSポートレットの使用

- 4.1 コンシューマとしてのOracle WebCenter Spaces

- 4.1.1 インストール要件

- 4.1.2 サポートされるWSRPプロデューサ

- 4.1.3 使用手順

- 4.2 コンシューマとしてのOracle WebCenter Interaction

- 4.2.1 インストール要件

- 4.2.2 サポートされるWSRPプロデューサ

- 4.2.3 使用手順

- 4.3 コンシューマとしてのOracle WebLogic Portal

- 4.3.1 インストール要件

- 4.3.2 サポートされるWSRPプロデューサ

- 4.3.3 使用手順

- 4.4 コンシューマとしてのIBM WebSphere Portal

- 4.4.1 インストール要件

- 4.4.2 サポートされるWSRPプロデューサ

- 4.4.3 使用手順

5 CPSポートレットの機能

- 5.1 Guest Libraryポートレット

- 5.2 Guest Searchポートレット

- 5.3 Saved Searchポートレット

- 5.4 Contributionポートレット

- 5.5 Workflow Queueポートレット

- 5.6 Libraryポートレット

- 5.7 Searchポートレット

- 5.8 Metadata Adminポートレット

- 5.9 ポートレットのカスタマイズ

A CPSソフトウェア開発キット

- A.1 ポートレット開発のヒント

- A.2 CPS SDKディレクトリ構造

- A.3 CPSポートレットの構築

- A.4 ReferencePortletsとPortletBuilderの使用方法

- A.5 ポートレット配布を構築するためのAntの使用方法

- A.6 CPSタグ・ライブラリの使用方法

- A.6.1 URIの作成

- A.6.2 エラー処理

- A.6.3 ポートレット・プリファレンス

- A.7 ディスパッチ構成の作成

- A.7.1 キーワード

- A.7.2 アクティブな検索ディスパッチ構成

- A.7.3 子ノードのタイプ

- A.7.3.1 デフォルト・アクション・ノード

- A.7.3.2 ポートレットIDノード

- A.7.3.3 ロケーション・ノード

- A.7.3.4 アクション・マッピング・ノード

- A.7.3.5 タイル定義ノード

- A.8 ポートレットAPIファサードへの参照の取得

- A.9 タイルの作成

- A.10 コントローラの作成

索引

Oracle® WebCenter Content

Content Portlet Suiteデプロイメント・ガイド

11g リリース1(11.1.1)

B69397-01(原本部品番号:E10637-02)

2011年11月

Oracle WebCenter Content Content Portlet Suiteデプロイメント・ガイド 11gリリース1 (11.1.1)

B69397-01

Copyright © 2002, 2011, Oracle and/or its affiliates.All rights reserved.

原本著者:  Will Harris

原本協力者:  Anand Vaidyanathan、Chandrasekhar Atla、Tarun Sharma、Mridhula Shetty、Naresh Sivaraman、Ron van de Crommert、Sean Cearley

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントが、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供される場合は、次のNoticeが適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、このソフトウェアまたはハードウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

はじめに

Oracle WebCenter Content Content Portlet Suite (CPS)デプロイメント・ガイドでは、CPSアーキテクチャの概要、およびCPSソフトウェア開発キット(SDK)の使用に関する情報について説明します。

対象読者

このドキュメントは、アプリケーション開発者およびプログラマを対象としています。ポートレットの概要、それらのフレームワークとアーキテクチャのプレゼンテーション、およびCPSソフトウェア開発キット(SDK)の使用に関する情報について説明します。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

詳細は、Oracle WebCenter Contentドキュメント・セットに含まれる次のドキュメントを参照してください。

- 『Oracle WebCenter Content Content Server開発者ガイド』の「Remote Intradoc Client (RIDC)」の章を参照してください。

- Oracle WebCenter Content Remote Intradoc Client (RIDC) Java APIリファレンス

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 一般情報

この章は、Content Portlet Suite (CPS)に関する一般情報を提供します。これには、サポートされるサーバーのリスト、ポートレットの説明、お薦めするアクセス設定およびポートレット・インタフェース言語に関する情報が含まれます。内容は次のとおりです。

- 第1.1項「新機能」

- 第1.2項「このリリースでサポートされるサーバー」

- 第1.3項「このリリースで提供されるポートレット」

- 第1.4項「お薦めするアクセス設定」

- 第1.5項「ポートレット・インタフェース言語」

1.1 新機能

CPS 11g リリース1 (11.1.1)には、次の新機能および拡張機能があります。

追加WSRPサポート

IBM Websphere Portal 6.1が、WSRPプロデューサとWSRPコンシューマの両方としてサポートされるようになりました。詳細は、第3.3項「プロデューサとしてのIBM WebSphere Portal」を参照してください。

CPSのアーキテクチャ

CPSはRemote Intradoc Client (RIDC) APIを使用して、Oracle WebCenter Content Serverと通信するようになりました。CPSポートレットの動作はカスタムMVCフレームワークにマッピングされ、このフレームワークがRIDC APIを使用してタスクを実行します。このアーキテクチャにより、CPSポートレットはRIDCメソッドをコールして、要求されたコンテンツ・サーバーのサービスを実行できます。詳細は、付録A「CPSソフトウェア開発キット」を参照してください。

1.2 このリリースでサポートされるサーバー

このバージョンのCPSは、Web Services for Remote Portlets (WSRP)のサポートを提供します。CPSはWSRPプロデューサとしてデプロイされ、他のWSRP対応コンシューマから使用できます。

サポートされるWSRPプロデューサおよびコンシューマ

Oracle WebCenter Portal 11gリリース1 (11.1.1.3以降) (プロデューサとして)

- Oracle WebCenter Spaces 11gリリース1 (サポートされるコンシューマ)

Oracle WebLogic Portal 10gリリース3 (プロデューサとして)

- Oracle WebCenter Interaction 10gリリース3 (サポートされるコンシューマ)

- Oracle WebLogic Portal 10gリリース3 (サポートされるコンシューマ)

IBM WebSphere Portal Version 6.1 (プロデューサとして)

- IBM WebSphere Portal Version 6.1 (サポートされるコンシューマ)

1.3 このリリースで提供されるポートレット

CPSでは、使用の簡単な一連のポートレットによって、コンテンツの作成および配信プロセスを管理できます。CPSでは、Oracle WebCenter Content Serverへのアクセスが提供されるので、ユーザーは簡単かつ効率的にコンテンツを更新、検索および表示できます。

このリリースでは、次のポートレットを使用できます。

- Oracle Guest Library: これによって、組織内での役割に基づいて、ユーザーにコンテンツが提示されます。

- Oracle Guest Search: これによってユーザーは、コンテンツ・サーバー上でキーワード検索や全文検索を実行し、返されたコンテンツに対する読取り専用アクセスを実行できます。

- Oracle Saved Search: これによってユーザーは、頻繁に使用される問合せを保存できます。

- Oracle Contribution: これによってユーザーは、コンテンツ・サーバーにコンテンツを送信できます。

- Oracle Library: これによって、組織内での役割に基づいてユーザーにコンテンツが提示され、ユーザーは返されたコンテンツに対する読取り/書込みアクセスを実行できます。

- Oracle Search: これによってユーザーは、コンテンツ・サーバーで選択されたメタデータおよびキーワード検索を実行し、返されたコンテンツに対する読取り/書込みアクセスを実行できます。

- Oracle Workflow Queue: これによってユーザーには、未処理のワークフロー・タスクが通知されます。

- Oracle Metadata Admin: これによって管理者は、カスタム・メタデータのプロパティを変更できます。

1.4 お薦めするアクセス設定

この項では、ポートレットに関する、お薦めするアクセス設定を示します。デフォルトでは、ポートレットのセキュリティにアクセスできるのはシステム管理者のみです。また、他のユーザーがポートレットにアクセスできるようにセキュリティを構成して、ユーザーに設定するアクセス要件に基づいて権限を割り当てる必要があります。ただし、認証ユーザーと匿名ユーザーに対しては、特定のセキュリティ設定をお薦めします。

認証ユーザー

認証ユーザーに対しては、次のセキュリティ設定をお薦めします。

- Oracle Guest Library: 編集

- Oracle Guest Search: 編集

- Oracle Saved Search: 編集

- Oracle Guest Library: 編集

- Oracle Contribution: 編集

- Oracle Library: 編集

- Oracle Search: 編集

- Oracle Workflow Queue: 表示

- Oracle Metadata Admin: 表示
Metadata Adminポートレットは管理ポートレットで、管理者レベルのユーザーに制限する必要があります。

匿名ユーザー

匿名ユーザーに対しては、次のセキュリティ設定をお薦めします。

- Oracle Guest Library: 表示

- Oracle Guest Search: 表示

1.5 ポートレット・インタフェース言語

ポートレット・インタフェース言語は、クライアントのロケールに設定されます。つまり、たとえば、クライアントがドイツ語バージョンのオペレーティング・システムを使用している場合は、(ポータル・サーバーを実行するJVMによってサポートされているときは)、CPSポートレットはドイツ語のインタフェースを表示します。

2 アーキテクチャとリクエストの処理

この章では、Content Portlet Suite (CPS)のアーキテクチャの概要を説明し、ポートレットのリクエスト処理のためのイベントについて大まかなシーケンスを説明します。内容は次のとおりです。

- 第2.1項「CPSアーキテクチャの概要」

- 第2.2項「Model-View-Controllerフレームワーク」

- 第2.3項「リクエストの処理」

2.1 CPSアーキテクチャの概要

CPSポートレットはRemote Intradoc Client (RIDC) APIを使用して、Oracle WebCenter Content Serverと通信します。ポートレットAPIファサードは、ポートレット・コンテナ内に共通の操作を抽象化するので、Oracleのフレームワークは、同じハンドラ・コードを使用する様々なプラットフォームで動作できます。ポートレットの動作はカスタムMVCフレームワークにマッピングされ、このフレームワークがRIDC APIを使用して必要なタスクを実行します。

ポートレットは、CHECKIN_UNIVERSALおよびGET_SEARCH_RESULTSといった標準コンテンツ・サーバー・サービスのコンシューマです。これらのサービスは、RIDC APIを使用してポートレット・コントローラからディスパッチ・ハンドラによってコールされます。詳細は、Oracle WebCenter Content Content Server開発者ガイドのRemote Intradoc Client (RIDC)に関する章を参照してください。

2.2 Model-View-Controllerフレームワーク

CPSでは、オープン・ソースのStruts and Tilesフレームワークに基づいて、Model-View-Controller設計パターンが使用されますデータのプレゼンテーションは、データを取得および整理するロジックから分離されます。model(モデル)はデータ・アクセス層をカプセル化するUCPMレイヤー、view(ビュー)はユーザー・インタフェース要素としてモデルをレンダリングするJSPページ、controller(コントローラ)はイベント(通常はユーザーのアクション)を処理してイベントに応答し、モデル上で変更を呼び出すPortletDispatchハンドラです。

図2-1 MVCフレームワーク

「図2-1 MVCフレームワーク」の説明

2.3 リクエストの処理

ポートレット・リクエスト処理のイベントの大まかなシーケンスを次に示します(Searchポートレットに基づきます)。

1. ユーザーが問合せを入力して、「検索」ボタンをクリックします。

2. アクション URLが構築されて、ポートレット・コンテナにルーティングされます。ポートレット・コンテナは、適切なポートレット(この場合はSearchポートレット)にコマンドをルーティングします。

3. Searchポートレット上でprocessActionがコールされます。

4. Searchポートレットは検索パラメータ(構築されたURLの一部)を取得してRIDCメソッドをコールし、これによってコンテンツ・サーバーのSEARCHサービスが実行されて、検索レスポンスがポートレットに返されます。

5. ポートレット・コンテナは、ページ上の各ポートレット(Searchポートレットを含む)でレンダリングをコールし、各ポートレットは受信したデータを使用して(つまりデータをリフレッシュして)、HTMLフラグメントをユーザーに表示します。

図2-2 ポートレットのリクエスト処理

「図2-2 ポートレットのリクエスト処理」の説明

注意A: The アクション・リクエストはレンダリング・リクエストの開始前に終了する必要があります。

注意B: レンダリング・リクエストがトリガーされる順番は決まっていません。これらは順次または同時に実行されます。

ポートレットAPIファサード

ポータル・ベンダーは標準を様々に実装するので、各アクション・ハンドラは、様々なポータル・ベンダー間のコードの非互換性からファサードのユーザーを保護するインタフェースを提供するファサード・オブジェクトにアクセスできます。

3 WSRPプロデューサとしてのCPSのデプロイ

この章では、Oracle Content Portlet Suite (CPS)をWSRPプロデューサとしてデプロイするために必要な情報を提供します。CPSがデプロイされると、ポートレットは他のWSRP対応ポータル・サーバーから使用可能になります。内容は次のとおりです。

- 第3.1項「プロデューサとしてのOracle WebCenter Portal」

- 第3.2項「プロデューサとしてのOracle WebLogic Portal」

- 第3.3項「プロデューサとしてのIBM WebSphere Portal」

- 第3.4項「CPS通信用のOracle WebCenter Content Serverの構成」

重要:
コンテンツ・サーバー上のユーザーIDは、使用するポータル・サーバー上のユーザーIDに対応する必要があります。

3.1 プロデューサとしてのOracle WebCenter Portal

この項では、Content Portlet Suite (CPS)をOracle WebCenter Portal上でWSRPプロデューサとしてデプロイするための情報を提供します。

- 第3.1.1項「インストール要件」

- 第3.1.2項「サポートされるWSRPコンシューマ」

- 第3.1.3項「カスタム管理対象サーバーの作成」

- 第3.1.4項「WebCenter Portal上でのCPSポートレットのデプロイ」

3.1.1 インストール要件

インストールには、次のサーバーとコンポーネントが必要です。

- Oracle WebCenter Portal 11gリリース1 (11.1.1.3以降) (プロデューサとして)

- Oracle WebCenter Content Server 11gリリース1、Oracle Content Server 11gリリース1またはOracle Content Server 10gリリース3

- Oracle Content Portlet Suite (CPS)配布ファイル

3.1.2 サポートされるWSRPコンシューマ

Oracle WebCenter Portalをプロデューサとして使用する場合、次のWSRPコンシューマがサポートされます。

- Oracle WebCenter Spaces 11gリリース1。詳細は、第4.1項「コンシューマとしてのOracle WebCenter Spaces」を参照してください。

3.1.3 カスタム管理対象サーバーの作成

新しい管理対象サーバーを作成するには、Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイドのJythonスクリプトを使用したWebLogic管理対象サーバーの作成とプロビジョニングに関する項の手順に従ってください。

注意:
targetServer.propertiesを変更する際は、serverType=Portletを設定し、mgdServerNameプロパティを設定することでサーバーに名前を付けてください(例: mgdServerName=CPS_Portlet)。

ターゲット・ライブラリ

新しく作成する管理対象サーバー(CPS_Portletなど)に対して、次のライブラリをターゲットとする必要があります。Oracle WebCenter Portalの11gR1 (11.1.1.3)インストールのライブラリは、11gR1 (11.1.1.4以降)インストールのライブラリとは異なることに注意してください。

WebCenter Portalの11gR1 (11.1.1.3)インストール用の次のライブラリは次のとおりです。

- oracle-ridc-client-app-lib(10.3.2,10.3.2)

- oracle-ucm-spi-app-lib(10.3.2,10.3.2)

- p13n-app-lib-base(10.3.2,10.3.2)

- vcr-app-lib(10.3.2,10.3.2)

- oracle.webcenter.framework(11.1.1,11.1.1)

- oracle.webcenter.spaces.fwk(11.1.1,11.1.1)

WebCenter Portalの11gR1 (11.1.1.4)以降のインストール用の次のライブラリは次のとおりです。

- oracle.ucm.ridc.app-lib(11.1.1,11.1.1)

- p13n-app-lib-base(10.3.2,10.3.2)

- oracle.webcenter.framework(11.1.1,11.1.1)

- oracle.webcenter.spaces.fwk(11.1.1,11.1.1)

- oracle.webcenter.framework.core(11.1.1,11.1.1)

ライブラリをターゲットとするには、次の手順に従います。

1. WebCenter PortalインスタンスのWebLogic Server管理コンソールで、「デプロイメント」セクションを開きます。

2. oracle.webcenter.framework(11.1.1,11.1.1)など、ターゲットとするライブラリ名をクリックします。

3. 選択したライブラリの設定ページで、「ターゲット」タブを開きます。

4. 新しく作成されたサーバー(CPS_Portletなど)用のオプションを選択し、変更を保存してアクティブ化します。

5. ターゲットとする各ライブラリについてこれを繰り返します。

データ・ソースのターゲット指定

新しく作成する管理対象サーバー(CPS_Portletなど)に対して、mds-SpacesDSデータ・ソースをターゲットとしてください。

1. WebCenter PortalインスタンスのOracle WebLogic Server管理コンソールを使用します。「ドメイン構造」ウィンドウで、「サービス」→「JDBC」→「データ・ソース」を選択します。

2. 「JDBCデータ・ソースのサマリー」セクションで、「mds-SpacesDS」をクリックします。

3. mds-SpacesDSの設定ページで、「ターゲット」タブを開きます。

4. 新しく作成されたサーバー(CPS_Portletなど)用のオプションを選択し、変更を保存してアクティブ化します。

3.1.4 WebCenter Portal上でのCPSポートレットのデプロイ

この項では、CPS用のWeb Services Remote Portlets (WSRP)を使用して、WebCenter Portalをプロデューサとして構成する方法を説明します。

注意:
Oracle Content Portlet Suite 11gR1 (11.1.1.4)をOracle WebCenter Portal 11gR1 (11.1.1.4)以降で使用すると、次の例外が発生します。

java.lang.IllegalArgumentException: IdcContext.setUser() method not valid, do not use this method,

この問題を解決するために、次の2つの回避策のいずれかを実行できます。

回避策1: weblogic-application.xmlの編集

1. ライブラリoracle-ridc-client-app-lib(10.3.2,10.3.2)をデプロイし、CPS用に作成された管理対象サーバーでのみそれをターゲットとします。このライブラリがない場合は、Oracleサポートに連絡してください。

2. StellentPortlets.earファイルからweblogic-application.xmlファイルを抽出します。

3. ファイルを編集し、最初のライブラリ参照として次のエントリを追加します。

<library-ref>
<library-name>oracle-ridc-client-app-lib</library-name>
</library-ref>

4. 更新したweblogic-application.xmlファイルを使用してStellentPortlets.earファイルを更新します。

5. 管理対象サーバーにStellentPortlets.earをデプロイします。

回避策2: Oracle UCM 11gR1 (11.1.1.5)またはOracle WebCenter Content 11gR1 (11.1.1.6)のStellentPortlets.earの使用

Oracle UCM 11gR1 (11.1.1.5)およびOracle WebCenter Content 11gR1 (11.1.1.6)のStellentPortlets.earファイルには、この問題の修正が含まれています。したがって、Oracle UCM 11gR1 (11.1.1.4)にバンドルされているEARファイルのかわりに、このEARファイルを使用できます。

EARファイルのデプロイ

1. ローカル・ディレクトリにCPS配布ファイルを解凍して、CPS zipファイルを抽出します。
例:

/oracle/apps/webcenter/cps

2. WebCenter PortalインスタンスのWebLogic Server管理コンソールを起動します。

3. 「ロックして編集」をクリックします。

4. 「ドメイン構造」セクションで、「デプロイメント」をクリックします。

5. 「デプロイメントのサマリー」セクションで、「制御」タブを開き、「インストール」をクリックします。

6. 「アプリケーション・インストール・アシスタント」セクションで、「ファイルをアップロード」リンクをクリックします。

7. 「デプロイメント・アーカイブ」セクションで、「参照」ボタンをクリックします。

8. 解凍したCPS zipファイルの/portletsディレクトリを参照し、StellentPortlets.earファイルを選択します。

9. 「次へ」をクリックします。

10. CPS EARファイルがアップロードされ、使用可能なファイルのリストに表示されます。

11. CPS EARファイルに対応するオプション・ボタンを有効にします。

12. 「次へ」をクリックします。

13. 「このデプロイメントをアプリケーションとしてインストールする」オプションを選択します。

14. 「次へ」をクリックします。

15. 第3.1.3項「カスタム管理対象サーバーの作成」で作成した新しいカスタム管理対象サーバー(CPS_Portletなど)を選択します。

16. 「終了」をクリックしてアプリケーションをデプロイします。

17. WSDL URLにアクセスします。WebCenter PortalにプロデューサとしてCPS EARファイルをデプロイした後は、WebCenter Portalの11gR1 (11.1.1.3)インストールのWSDL URLは11gR1 (11.1.1.4)以降のインストールのWSDL URLとは異なることに注意してください。
WebCenter Portalの11gR1 (11.1.1.3)インストールのWSRP URLは次のとおりです。

http://Host_Name:Port/cps/portlets/wsrp1?wsdl

WebCenter Portalの11gR1 (11.1.1.4)以降のインストールのWSRP URLは次のとおりです。

http://Host_Name:Port/cps/portlets/wsrp2?WSDL

WSDLの登録

1. コマンドラインでWebLogic Scripting Tool (WLST)を起動します。次に例を示します。

WLS_HOME/as11r1wc/common/bin/wlst.sh

注意:
WebLogic Scripting Tool (WLST)は、WebLogic Serverドメインの作成、管理および監視に使用できるコマンドライン・スクリプト環境です。詳細は、Oracle Fusion Middleware Oracle WebLogic Scripting Toolを参照してください。

2. WebLogic Scripting Toolの初期化後に、connect()と入力して[Enter]キーを押します。

3. ユーザー名、パスワードおよび管理サーバーのURLを入力するように求められます。これらの値を入力して[Enter]キーを押します。

4. サーバーに接続したら、次のコマンドを実行してWSDLを登録します。

registerWSRPProducer('webcenter','Provide_Any_Name_for_WSDL_Handle', 'Your_WSDL>',timeout=500)

例:

registerWSRPProducer('webcenter','StellentWSRP','http://Host_Name:Port/cps/portlets/wsrp1?WSDL',timeout=500

コンテンツ・サーバーの参照

次のWLSTコマンドを使用して、Oracle WebCenter Content Serverの接続を作成、削除およびリセットします。

注意:
次のコマンドの実行後は、変更を有効にするために、CPSをデプロイしたカスタム管理対象サーバーとWLS_Spacesサーバーを再起動する必要があります。

- 次のWLSTコマンドを実行して、Oracle WebCenter Content Server接続を作成します。

createJCRContentServerConnection('CPS_Application_Name', 'CSConnection', socketType='socket', serverHost='Content_Server_Host', serverPort='Content_Server_Port')

次に例を示します(CPSアプリケーション名がStellentPortletsの場合)。

createJCRContentServerConnection('StellentPortlets', 'CSConnection', socketType='socket', serverHost='192.0.2.250', serverPort='4444')

CPSポートレットを有効にするには、接続名はCSConnectionにする必要があります。他の接続名は認識されません。

- 次のWLSTコマンドを実行して、Oracle WebCenter Content Server接続を削除します。

deleteConnection(appName='CPS_Application_Name', name='CSConnection')

- 次のWLSTコマンドを実行して、既存のOracle WebCenter Content Server接続をリセットします。

setJCRContentServerConnection('CPS_Application_Name', 'CSConnection', socketType='socket', serverHost='New_Content_Server_Host', serverPort='New_Content_Server_Port')

- 次のWLSTコマンドを実行して、既存のOracle WebCenter Content Server接続をリストします。

listJCRContentServerConnections(appName='CPS_Application_Name')

コンテンツ・サーバーとCPSの通信の有効化

Oracle WebCenter Content ServerインスタンスとCPSの通信を有効にする必要があります。手順の詳細は、第3.4項「CPS通信用のOracle WebCenter Content Serverの構成」を参照してください。

3.2 プロデューサとしてのOracle WebLogic Portal

この項では、Content Portlet Suite (CPS)をOracle WebLogic Portal上でWSRPプロデューサとしてデプロイする際の情報を提供します。

- 第3.2.1項「インストール要件」

- 第3.2.2項「サポートされるWSRPコンシューマ」

- 第3.2.3項「WebLogic Portal上でのCPSポートレットのデプロイ」

3.2.1 インストール要件

インストールには、次のサーバーとコンポーネントが必要です。

- Oracle WebLogic Portal 10gリリース3 (プロデューサとして)

- Oracle WebCenter Content Server 11gリリース1、Oracle Content Server 11gリリース1またはOracle Content Server 10gリリース3

- Oracle Content Portlet Suite (CPS)配布ファイル

3.2.2 サポートされるWSRPコンシューマ

Oracle WebLogic Portalをプロデューサとして使用する場合、次のWSRPコンシューマがサポートされます。

- Oracle WebCenter Interaction 10gリリース3。詳細は、第4.2項「コンシューマとしてのOracle WebCenter Interaction」を参照してください。

- Oracle WebLogic Portal 10gリリース3。詳細は、第4.3項「コンシューマとしてのOracle WebLogic Portal」を参照してください。

3.2.3 WebLogic Portal上でのCPSポートレットのデプロイ

この項では、CPS用のWeb Services Remote Portlets (WSRP)を使用して、WebLogic Portalをプロデューサとして構成する方法を説明します。

重要:
CPSポートレットをデプロイする前に、既存のWebLogicドメインを選択するか、新しいWebLogicドメインを作成してください(例: cps_domain)。このドメインは、WebLogic Server、Workshop for WebLogicおよびWebLogic Portalをサポートするように構成する必要があります。

コンテンツ・サーバーの参照

1. ローカル・ディレクトリにCPS配布ファイルを解凍して、WebLogic CPS zipファイルを抽出します。

2. /WEB-INF/configディレクトリを見つけます。

3. テキスト専用エディタでcps-initialization.propertiesファイルを開きます。使用するコンテンツ・サーバー・インスタンスのIPアドレスまたはホスト名を参照するようにホスト・プロパティ値を編集します。コンテンツ・サーバーが、デフォルト・ポートである4444以外のポートで実行されている場合は、ポート・プロパティ値を編集します。ファイル先頭の改行文字は削除しないでください。
例:

Host=192.0.2.254
Port=4448

ポータルWebプロジェクトの作成

1. Workshop for WebLogicを起動します。

2. 「ファイル」→「新規」→「プロジェクト」を選択します。

3. 「新規プロジェクト」ダイアログで、「WebLogic Portal」ノードを開きます。

4. ポータルWebプロジェクトを選択します。

5. 「次へ」をクリックします。
新規ポータルWebプロジェクト・ウィザードが表示されます。

6. 新規Oracle WebLogic Portal Webプロジェクトの作成の手順で、プロジェクト名を入力します(例: CPS)。

7. 「終了」をクリックします。

8. 関連付けられているパースペクティブを開くダイアログが表示されたら、「はい」をクリックします。

ポータルEARプロジェクトの作成

1. Workshop for WebLogicで、「ファイル」→「新規」→「プロジェクト」を選択します。

2. 「新規プロジェクト」ダイアログで、「WebLogic Portal」ノードを開きます。

3. ポータルEARプロジェクトをクリックします。

4. 「次へ」をクリックします。
新規ポータルEARプロジェクト・ウィザードが表示されます。

5. 新規Oracle WebLogic Portal EARプロジェクトの作成の手順で、プロジェクト名を入力します(例: CPS Consumer-EAR)。

6. 「次へ」をクリックします。

7. プロジェクト・ファセットの手順で、ドロップダウン・リストからWebLogic Portal EARプロジェクト・ファセットを選択します。

8. 「次へ」をクリックします。

9. EARへのJ2EEモジュールの追加の手順で、作成したポータルWebプロジェクトを選択します(例: CPS)。

10. 「終了」をクリックします。

11. 関連付けられているパースペクティブを開くダイアログが表示されたら、「はい」をクリックします。

CPSポートレットのインポート

1. プロジェクト・エクスプローラ・ビューを選択して、新しいポータルWebプロジェクトのノードを開きます(例: CPS)。

2. 「WebContent」ノードを右クリックし、「インポート」を選択します。
インポート・ウィザードが表示されます。

3. インポート・ソースを選択する手順で、「一般」ノードを開きます。

4. 「ファイルシステム」を選択します。

5. 「次へ」をクリックします。

6. ファイル・システムの手順で、コピー元ディレクトリフィールドに関連付けられた「参照」をクリックします。

7. 解凍したCPS配布ファイルの/portletsディレクトリを参照して、「OK」をクリックします。

8. ローカル・ファイル・システムからリソースをインポートする手順で、ポートレットオプションを有効にします。

9. 「終了」をクリックします。

10. Manifest.MFファイルを上書きするかどうか尋ねられたら、「はい」をクリックします。

11. ポートレット・フォルダのインポート後に、Webプロジェクトのエラーが表示される場合があります。エラー・ファイルには、プロジェクト・エクスプローラ・ビューでファイルの先頭に赤い×印が表示されます。エラーのあるファイルを選択して削除します。

EARファイルの公開

1. Workshop for WebLogicで、「サーバー」ビューを選択します。

2. 「サーバー」ビューを右クリックし、「新規」→「サーバー」をクリックします。
新規サーバー・ウィザードが表示されます。

3. 作成するサーバーのタイプを選択する手順で、デフォルト設定を受け入れて、「次へ」をクリックします。

4. WebLogicドメイン・ディレクトリを指定する手順で、「参照」をクリックします。

5. 新しいCPSドメイン・ディレクトリを参照して、「OK」をクリックします。
たとえば次のようにします(Windowsの場合)。

C:/oracle_weblogic/user_projects/domains/cps_domain

6. 「次へ」をクリックします。

7. プロジェクトを追加および削除する手順で、「使用可能なプロジェクト」セクションからCPS EARファイルを選択し、「追加」をクリックして構成されたプロジェクトにそれを追加します。

8. 「終了」をクリックします。

9. 「サーバー」ビューで、新しいサーバーを右クリックして公開を選択し、サーバーを起動してEARファイルを公開します。

10. WSDL URLを通してWSRP対応CPSポートレットが使用可能になります。
URLは次の書式になります。

http://host_server:host_port/context-root-specified-in-portal-web-project/producer?wsdl

host_server、host_portおよびcontext-root-specified-in-portal-web-projectは、適切な値で置き換えます。

コンテンツ・サーバーとCPSの通信の有効化

コンテンツ・サーバー・インスタンスとCPSの通信を有効にする必要があります。手順の詳細は、第3.4項「CPS通信用のOracle WebCenter Content Serverの構成」を参照してください。

3.3 プロデューサとしてのIBM WebSphere Portal

この項では、Content Portlet Suite (CPS)をIBM WebSphere Portal上でWSRPプロデューサとしてデプロイするための情報を提供します。

- 第3.3.1項「インストール要件」

- 第3.3.2項「サポートされるWSRPコンシューマ」

- 第3.3.3項「WebSphere Portal上でのCPSポートレットのデプロイ」

3.3.1 インストール要件

インストールには、次のサーバーとコンポーネントが必要です。

- IBM WebSphere Portal Version 6.1 (プロデューサとして)

- Oracle WebCenter Content Server 11gリリース1、Oracle Content Server 11gリリース1またはOracle Content Server 10gリリース3

- Oracle Content Portlet Suite (CPS)配布ファイル

3.3.2 サポートされるWSRPコンシューマ

IBM WebSphere Portalをプロデューサとする場合は、次のWSRPコンシューマがサポートされます。

- IBM WebSphere Portal Version 6.1。詳細は、第4.4項「コンシューマとしてのIBM WebSphere Portal」を参照してください。

3.3.3 WebSphere Portal上でのCPSポートレットのデプロイ

この項では、CPS用のWeb Services Remote Portlets (WSRP)を使用して、WebSphere Portalをプロデューサとして構成する方法を説明します。

EARファイルのデプロイ

1. ローカル・ディレクトリにCPS配布ファイルを解凍して、WebSphere CPS zipファイルを抽出します。

2. サーバーを起動してWebSphere Portalを開始します。

3. メイン・メニューで「Administration」をクリックします。

4. 「Portlet Administration」セクションで、「Web Modules」をクリックします。

5. 「Manage Web Modules」セクションで、「Install」をクリックします。

6. 解凍したWebSphere CPS zipファイルの/portletsディレクトリを参照し、StellentPortlets.earファイルを選択します。

7. 「次へ」をクリックします。

8. エンタープライズ・アプリケーション表示名とコンテキスト・ルートを指定します。

9. 「Start Application」オプションが有効(デフォルト)になっていることを確認します。

10. 「終了」をクリックします。
インストールに成功すると、「Manage Web Modules」セクションに確認のメッセージが表示されます。

コンテンツ・サーバーの参照

1. StellentPortlets WEB-INF/configディレクトリを見つけます。

WebSphere_Portal_Home\wp_profile\installedApps\Node_Name\CPS_App_Display_Name\StellentPortlets.war\WEB-INF\config

2. テキスト専用エディタでcps-initialization.propertiesファイルを開きます。コンテンツ・サーバーのインスタンスを参照するように、ホストとポートのプロパティを編集します。
例:

Host=192.0.2.254
Port=4448

3. サーバーを停止して再起動します。

CPSポートレットの検索

1. WebSphere Portalを起動し、メイン・メニューで「Administration」をクリックします。

2. 「Portlet Management」セクションで、「Portlets」をクリックします。

3. 使用可能なポートレットのリストでCPSポートレットを検索します。

リソース権限の割当て

各CPSポートレットで、次の手順を実行します。

1. 「Provide Portlet」アイコンをクリックします。

2. 「OK」をクリックします。

3. 「Assign Access to Portlet」アイコンをクリックします。
「Resource Permissions」ページが表示されます。

4. 「Roles」列で、「User」の役割の「Edit Role」アイコンをクリックします。

5. 「Add」をクリックします。

6. 「Anonymous Portal User」オプションを有効にします。

7. 「OK」をクリックします。

8. 「Add」セクションで、ポートレット名をクリックします。

9. 「Privileged User」の役割について前述の手順を繰り返します。「Edit Role」アイコン→「Add」をクリックし、「Anonymous Portal User」オプションを有効にして「OK」をクリックします。

10. それぞれのCPSポートレットについて前述の手順を完了したら、「Done」をクリックします。

プロデューサの作成

1. 「Portlet Management」セクションで、「Web Services」をクリックします。

2. 「New Producer」をクリックして、プロデューサのタイトルを指定します。CPSポートレットを使用するときに、このWebサービス・プロデューサを選択します。詳細は、第4.3項「コンシューマとしてのOracle WebLogic Portal」および第4.4.3項「使用手順」を参照してください。

3. 構成エントリが正しいことを確認します。

- 「URL to WSDL Service Definitions」フィールドを確認し、必要に応じて編集します。

- ホスト名を確認します。デフォルトのホスト名はlocalhostです。IPアドレスまたはマシン名の使用をお薦めします。

- ポート番号を確認します。デフォルトのポート番号は10040です。ポート番号は、WebSphere Portalがデプロイされているポートと一致する必要があります(これはWebブラウザのアドレス・バーに表示されます)。

4. エントリを確認したら、「Next」をクリックします。

5. 「次へ」をクリックします。
「Created the Producer successfully」という確認のメッセージが表示されます。

6. プロデューサのWSDLは次になります。

Host_Name:Port/wps/wsdl/service.wsdl

例:

http://localhost:10039/wps/wsdl/service.wsd

コンテンツ・サーバーとCPSの通信の有効化

コンテンツ・サーバー・インスタンスとCPSの通信を有効にする必要があります。手順の詳細は、第3.4項「CPS通信用のOracle WebCenter Content Serverの構成」を参照してください。

3.4 CPS通信用のOracle WebCenter Content Serverの構成

コンテンツ・サーバー・インスタンスとCPSとの通信を有効にするには、ポータル・サーバーのIPアドレスを定義して、そのIPアドレスを使用したサーバー通信ができるようにコンテンツ・サーバーの構成ファイル(config.cfg)を編集する必要があります。

この項の項目は次のとおりです。

- 第3.4.1項「コンテンツ・サーバー上のIPアドレスの有効化」

- 第3.4.2項「コンテンツ・サーバーの構成ファイルの編集」

3.4.1 コンテンツ・サーバー上のIPアドレスの有効化

アプリケーション・サーバーのIPアドレスを有効にする必要があります。これによって、コンテンツ・サーバーはアプリケーション・サーバーからの接続をリスニングできます。

1. システム・プロパティ・エディタを起動します。
「コンテンツ・サーバー」→インスタンス名→「ユーティリティ」→「システム・プロパティ」を選択します。

2. 「サーバー」タブを開きます。

3. ホスト名フィルタとIPアドレス・フィルタに、アプリケーション・サーバー固有の情報を入力します。
ワイルドカード(*)を使用できますが、IPアドレスはワイルドカードに関係なくx.x.x.xの形式をとる必要があり、垂直バーで区切る必要があります。

例:

12.34.56.*|12.34.57.*|12.35.*.*

4. 変更内容を反映するには、コンテンツ・サーバーを再起動する必要があります。

3.4.2 コンテンツ・サーバーの構成ファイルの編集

コンテンツ・サーバーの構成ファイル(config.cfg)を編集する必要があります。このファイルはMW_HOME/user_projects/domains/cs_domain_name/ucm/cs/configにあります。

IntradocServerPort構成変数を追加または編集して、CPSが使用するポート番号を含めます。このエントリは、Content Server 10gの場合はデフォルトで示されますが、Content Server 11gの場合は構成ファイルに追加する必要があります。

次の手順に従って、構成ファイルを編集してください。

1. コンテンツ・サーバーに管理者としてログインします。

2. 管理サーバーを起動します。

3. 「一般構成」をクリックします。

4. 「追加の構成変数」フィールドに、IntradocServerPortエントリとポート番号を追加または編集します。
例:

IntradocServerPort=4444

5. 「保存」をクリックします。

6. コンテンツ・サーバーを再起動します。

4 CPSポートレットの使用

この章では、Content Portlet Suite (CPS)ポートレットを使用するために必要な情報を提供します。内容は次のとおりです。

- 第4.1項「コンシューマとしてのOracle WebCenter Spaces」

- 第4.2項「コンシューマとしてのOracle WebCenter Interaction」

- 第4.3項「コンシューマとしてのOracle WebLogic Portal」

- 第4.4項「コンシューマとしてのIBM WebSphere Portal」

重要:
コンテンツ・サーバー上のユーザーIDは、使用するポータル・サーバー上のユーザーIDに対応する必要があります。

4.1 コンシューマとしてのOracle WebCenter Spaces

この項では、WebCenter SpacesでCPSポートレットを使用する際の情報を提供します。

- 第4.3.1項「インストール要件」

- 第4.3.2項「サポートされるWSRPプロデューサ」

- 第4.3.3項「使用手順」

4.1.1 インストール要件

インストールするには、次のサーバーとコンポーネントが必要です。

- Oracle WebCenter Spaces 11gリリース1 (コンシューマとして)

- Oracle WebCenter Content Server 11gリリース1、Oracle Content Server 11gリリース1またはOracle Content Server 10gリリース3

4.1.2 サポートされるWSRPプロデューサ

WebCenter Spacesをコンシューマとする場合は、次のWSRPプロデューサがサポートされます。

- Oracle WebCenter Portal 11gリリース1。詳細は、第3.1項「プロデューサとしてのOracle WebCenter Portal」を参照してください。

4.1.3 使用手順

この項では、Oracle WebCenter SpacesでCPSポートレットを使用する方法を説明します。

1. 次でWebCenter Spacesにログインします。

http://Host_Name:Port/webcenter/spaces/

2. 新しいページを作成します。「ページ・アクション」→「ページの編集」を選択し、「コンテンツの追加」をクリックします。

3. 新しいダイアログが表示されます。「ポートレット」をクリックし、登録したWSRPプロデューサを選択します。

4. 含めるポートレットを選択します。

4.2 コンシューマとしてのOracle WebCenter Interaction

この項では、Oracle WebCenter Interaction 10gリリース3でCPSポートレットを使用する際の情報を提供します。

- 第4.2.1項「インストール要件」

- 第4.2.2項「サポートされるWSRPプロデューサ」

- 第4.2.3項「使用手順」

4.2.1 インストール要件

インストールするには、次のサーバーとコンポーネントが必要です。

- Oracle WebCenter Interaction 10gリリース3 (コンシューマとして)

- WSRPコンシューマ・コンポーネント
WebCenter Interaction WSRPコンシューマ・コンポーネントをインストールして、WebCenter InteractionをWSRPコンシューマとして構成する必要があります。このコンポーネントのインストールの詳細は、WebCenter Interactionのインストレーション・ガイドを参照してください。

- JSR 168 Container
このコンポーネントのインストールの詳細は、WebCenter Interactionのインストレーション・ガイドを参照してください。

- Oracle WebCenter Content Server 11gリリース1、Oracle Content Server 11gリリース1またはOracle Content Server 10gリリース3

4.2.2 サポートされるWSRPプロデューサ

Oracle WebCenter Interactionがコンシューマの場合は、次のWSRPプロデューサがサポートされます。

- Oracle WebLogic Portal 10gリリース3。詳細は、第3.2項「プロデューサとしてのOracle WebLogic Portal」を参照してください。

4.2.3 使用手順

この項では、Oracle WebCenter InteractionでCPSポートレットを使用する方法を説明します。

1. WebCenter Interactionを起動し、管理者としてポータルにログインします。

2. 「管理」をクリックします。

3. リモート・ポートレットの格納先にするフォルダをクリックします。

4. 「オブジェクトの作成」ドロップダウン・リストで、「ポートレット」を選択します。

5. 「テンプレートまたはWebサービスの選択」ダイアログで、WSRPコンシューマ・オプションを有効にします。
このオプションを表示するには、WSRPコンシューマ・コンポーネントをインストールする必要があります。 詳細は、第4.2.1項「インストール要件」を参照してください。

6. 「OK」をクリックします。

7. 「ポートレットの作成」ダイアログで、ポートレットのタイトル・バーを非表示にするオプションを有効にします。

8. 「このポートレットの構成」セクションで、「編集」をクリックします。

9. WSRP対応CPSプロデューサのWSDLリンクを入力します。

10. サービスWSDLのインポートをクリックします。

11. 「次へ」をクリックします。

12. CPSリモート・ポートレットを選択して「終了」をクリックします。

13. 「ポートレットの作成」ダイアログで、「終了」をクリックします。

14. 「オブジェクトの保存」ダイアログで、名前と説明を入力し、希望のフォルダにポートレット・オブジェクトを保存します。

15. 前述の手順を繰り返して、他のCPSリモート・ポートレットを追加します。

4.3 コンシューマとしてのOracle WebLogic Portal

この項では、Oracle WebLogic Portal 10gリリース3でCPSポートレットを使用する際の情報を提供します。

- 第4.3.1項「インストール要件」

- 第4.3.2項「サポートされるWSRPプロデューサ」

- 第4.3.3項「使用手順」

4.3.1 インストール要件

インストールするには、次のサーバーとコンポーネントが必要です。

- Oracle WebLogic Portal 10gリリース3 (コンシューマとして)

- Oracle WebCenter Content Server 11gリリース1、Oracle Content Server 11gリリース1またはOracle Content Server 10gリリース3

4.3.2 サポートされるWSRPプロデューサ

WebLogic Portalをコンシューマとする場合は、次のWSRPプロデューサがサポートされます。

- Oracle WebLogic Portal 10gリリース3。詳細は、第3.2項「プロデューサとしてのOracle WebLogic Portal」を参照してください。

4.3.3 使用手順

この項では、WebLogic Portal上でCPSポートレットを使用する方法を説明します。

ポータルWebプロジェクトの作成

1. Workshop for WebLogicを起動します。

2. 「ファイル」→「新規」→「プロジェクト」を選択します。

3. 「新規プロジェクト」ダイアログで、「WebLogic Portal」ノードを開きます。

4. ポータルWebプロジェクトを選択します。

5. 「次へ」をクリックします。
新規ポータルWebプロジェクト・ウィザードが表示されます。

6. 新規Oracle WebLogic Portal Webプロジェクトの作成の手順で、プロジェクト名を入力します(例: CPSコンシューマ)。

7. 「終了」をクリックします。

8. 関連付けられているパースペクティブを開くダイアログが表示されたら、「はい」をクリックします。

ポータルEARプロジェクトの作成

1. Workshop for WebLogicで、「ファイル」→「新規」→「プロジェクト」を選択します。

2. 「新規プロジェクト」ダイアログで、「WebLogic Portal」ノードを開きます。

3. ポータルEARプロジェクトをクリックします。

4. 「次へ」をクリックします。
新規ポータルEARプロジェクト・ウィザードが表示されます。

5. 新規Oracle WebLogic Portal EARプロジェクトの作成の手順で、プロジェクト名を入力します(例: CPS Consumer-EAR)。

6. 「次へ」をクリックします。

7. プロジェクト・ファセットの手順で、ドロップダウン・リストからWebLogic Portal EARプロジェクト・ファセットを選択します。

8. 「次へ」をクリックします。

9. EARへのJ2EEモジュールの追加の手順で、作成したポータルWebプロジェクトを選択します(例: CPSコンシューマ)。

10. 「終了」をクリックします。

11. 関連付けられているパースペクティブを開くダイアログが表示されたら、「はい」をクリックします。

CPSリモート・ポートレットをインポートします。

1. プロジェクト・エクスプローラ・ビューを選択して、新しいポータルWebプロジェクトのノードを開きます(例: CPSコンシューマ)。

2. 「WebContent」ノードを右クリックし、「新規」→「ポートレット」を選択します。

3. ポートレットの格納先ディレクトリを選択し、ポートレットの名前を入力します。

4. 「次へ」をクリックします。
ポートレット・ウィザードが表示されます。

5. ポートレットのタイプを選択する手順で、リモート・ポートレットオプションを有効にします。

6. 「次へ」をクリックします。

7. プロデューサの手順で、プロデューサを検索オプションを有効にします。

8. WSRP対応CPSプロデューサのWSDLリンクを入力します。

9. 取得をクリックします。

10. 登録をクリックして、プロデューサを登録します。

11. 登録用のダイアログで、プロデューサのハンドル名を入力し、ローカル・レジストリに登録プロパティを格納オプションを有効にします。

12. 「OK」をクリックします。

13. 「次へ」をクリックします。

14. 使用可能なポートレットのリストからCPSリモート・ポートレットを選択し、「次へ」をクリックします。

15. プロキシ・ポートレットの詳細を入力し、「作成」をクリックします。新しいリモート(プロキシ)ポートレットが作成されます。

16. 「ファイル」メニューから「すべて保存」を選択して、リモート・ポートレットを保存します。

17. 前述の手順を繰り返して、他のCPSリモート・ポートレットを追加します。ローカル・レジストリに登録プロパティを格納するオプションを有効にした場合は、「プロデューサ」をクリックし、「登録済プロデューサ」ドロップダウン・リストからこれを選択することで、WSDLリンク(手順8)を追加できます。

次の追加手順に従って、既存のポータル・インスタンスにCPSポートレットをデプロイします。

1. ポータルEARプロジェクトを選択し、「実行」→Portal管理コンソールを開くを選択してPortal管理コンソールを開きます。

2. 管理資格証明を使用してログインします。

3. 左側のナビゲーション・ペインで、「ポータル管理」をクリックします。

4. リソース・ツリー内で「ポータル」を選択します。

5. CPSリモート・ポートレットを選択し、既存のポータルにそれらを追加します。

4.4 コンシューマとしてのIBM WebSphere Portal

この項では、IBM WebSphere Portal上でCPSポートレットを使用する際の情報を提供します。

- 第4.3.1項「インストール要件」

- 第4.3.2項「サポートされるWSRPプロデューサ」

- 第4.3.3項「使用手順」

4.4.1 インストール要件

インストールするには、次のサーバーとコンポーネントが必要です。

- IBM WebSphere Portal Version 6.1 (コンシューマとして)

- Oracle WebCenter Content Server 11gリリース1、Oracle Content Server 11gリリース1またはOracle Content Server 10gリリース3

4.4.2 サポートされるWSRPプロデューサ

WebSphere Portalをコンシューマとする場合は、次のWSRPプロデューサがサポートされます。

- IBM WebSphere Portal Version 6.1。詳細は、第3.3項「プロデューサとしてのIBM WebSphere Portal」を参照してください。

4.4.3 使用手順

この項では、WebSphere Portal上でCPSポートレットを使用する方法を説明します。

CPSポートレットの使用

1. WebSphere Portalを起動し、メイン・メニューで「Administration」をクリックします。

2. 「Portlet Management」セクションで、「Web Modules」をクリックします。

3. 「Consume」をクリックします。

4. Webサービス・プロデューサのリストから、CPSポートレットを提供するために作成されたプロデューサを選択します。
詳細は、第3.3項「プロデューサとしてのIBM WebSphere Portal」と第3.3.3項「プロデューサの作成」を参照してください。

5. ポータルで使用するCPSポートレットを選択します。すべてのポートレットを使用する場合は、すべてを選択します。

6. 「OK」をクリックします。

CPSリモート・ポートレットの検索

1. 「Portlet Management」セクションで、「Portlets」をクリックします。

2. 使用可能なポートレットのリストで、CPSリモート・ポートレットを検索します。
リモート・ポートレットは、Webサービス・プロデューサのタイトルがそのポートレットの「リモート・ポートレット」列の下に示されていることで、ローカル・ポートレットと区別できます。

リソース権限の割当て

各CPSリモート・ポートレットで、次の手順を実行します。

1. 「Assign Access to Portlet」アイコンをクリックします。
「Resource Permissions」ページが表示されます。

2. 「Roles」列で、「User」の役割の「Edit Role」アイコンをクリックします。

3. 「Add」をクリックします。

4. 「Anonymous Portal User」オプションを有効にします。

5. 「OK」をクリックします。

6. 「Add」セクションで、ポートレット名をクリックします。

7. 「Privileged User」の役割について前述の手順を繰り返します。「Edit Role」アイコン→「Add」をクリックし、「Anonymous Portal User」オプションを有効にして「OK」をクリックします。

8. それぞれのCPSリモート・ポートレットについて前述の手順を完了したら、「Done」をクリックします。

ページへのポートレットの追加

1. 「Portal User Interface」セクションで、「Manage Pages」をクリックします。

2. 「Title」列で「Content Root」→「Home」をクリックします。

3. 「New Page」をクリックします。
「Page Properties」ページが表示されます。

4. タイトルと一意の名前を指定します。

5. 「OK」をクリックします。

6. ページ左上の「Home」リンクをクリックし、新しく作成したページのタブをクリックします。

7. タイトルの上にカーソルを置き、表示されたアイコンをクリックして、「Edit Page Layout」を選択します。

8. 「Add Portlets」をクリックします。

9. 使用可能なポートレットのリストから各CPSリモート・ポートレットを選択し、「OK」をクリックします。

10. それぞれのCPSリモート・ポートレットについて前述の手順を完了したら、「Done」をクリックします。

注意:
ユーザーがInternet Explorer 8を使用している場合は、互換モードでポートレット・ページを表示することをお薦めします。これを行わない場合、ポートレット・アイコンのメニュー・オプションが正しくレンダリングされず、使用できません。

5 CPSポートレットの機能

この章では、CPSポートレットに関する情報を提供します。これには、CPSポートレットの使用方法に関する短いチュートリアルと、LibraryおよびGuest Libraryポートレットのカスタマイズ方法に関する手順が含まれます。内容は次のとおりです。

- 第5.1項「Guest Libraryポートレット」

- 第5.2項「Guest Searchポートレット」

- 第5.3項「Saved Searchポートレット」

- 第5.4項「Contributionポートレット」

- 第5.5項「Workflow Queueポートレット」

- 第5.6項「Libraryポートレット」

- 第5.7項「Searchポートレット」

- 第5.8項「Metadata Adminポートレット」

- 第5.9項「ポートレットのカスタマイズ」

この項では、例示の目的でのみポートレットの画像が示されています。ポータル・サーバー・インスタンスの実際の外観(アイコン、色など)は、異なる場合があります。

注意:
ポートレットがWebSphere上にあり、ユーザーがInternet Explorer 8を使用している場合は、互換モードでポートレット・ページを表示することをお薦めします。これを行わない場合、ポートレット・アイコンのメニュー・オプションが正しくレンダリングされず、使用できません。

5.1 Guest Libraryポートレット

Guest Libraryポートレットによって、ポータル・ユーザーは、ポートレット管理者が事前に定義した基準に一致するコンテンツを表示できます。定義済の検索の結果は、リスト形式でユーザーに配信されます。ユーザーはリストからハイパーリンク・アイテムを選択することで、コンテンツを表示できます。また、ユーザーは、コンテンツ・アイテムの情報ページも表示できます。ユーザーに表示されるコンテンツは、ポータル管理者が定義します。

図5-1 Guest Libraryポートレット

「図5-1 Guest Libraryポートレット」の説明

Guest Libraryポートレットの使用方法

1. パーソナライズをクリックします。
ユーザーはパーソナライズによって、表示される検索結果を変更できます。

- ページごとの結果: ページ当たりに表示する結果の数を入力します。デフォルトは20です。

- ソート: ソートの基準とするフィールドを選択します。オプションは「日付」または「タイトル」です。

- ソート順序: ソート順序を選択します。オプションは「昇順」または「降順」です。

2. 必要に応じて設定を変更し、編集が完了したら「保存」をクリックします。

3. 検索問合せ(例: 新着)を選択します。
結果がリスト形式で表示されます。

4. 「戻る」をクリックします。

5.2 Guest Searchポートレット

Guest Searchポートレットによって、ポータル・ユーザーは、コンテンツ・サーバーでビジネス・コンテンツを検索できます。ユーザーは、件名またはキーワード、あるいはその両方で検索できます。検索結果は、リスト形式でユーザーに配信されます。ユーザーはリストからハイパーリンク・アイテムを選択することで、コンテンツを表示できます。

図5-2 Guest Searchポートレット

「図5-2 Guest Searchポートレット」の説明

Guest Searchポートレットの使用方法

1. パーソナライズをクリックします。
ユーザーはパーソナライズによって、表示される検索結果を変更できます。

- ページごとの結果: ページ当たりに表示する結果の数を入力します。デフォルトは20です。

- ソート: ソートの基準とするフィールドを選択します。オプションは「日付」または「タイトル」です。

- ソート順序: ソート順序を選択します。オプションは「昇順」または「降順」です。

2. 必要に応じて設定を変更し、編集が完了したら「保存」をクリックします。

3. 件名またはキーワードを入力して、「検索」をクリックします。
取得するアイテムについて指定の件名またはキーワードを含むコンテンツが、コンテンツ・サーバーにチェックインされている必要があります。

4. 検索結果の画面で、「保存」をクリックします。
検索問合せの保存画面が表示されます。この機能により、Saved Searchポートレットの保存済検索リストに検索が保存されます。

5. 検索の実行に使用したキーワードは「キーワード」フィールドに表示されます。検索を保存するには、問合せのタイトル(コンテンツ・アイテムのタイトル)を入力して、「新規問合せの追加」をクリックします。

6. 「戻る」をクリックして、検索結果のページに戻ります。

5.3 Saved Searchポートレット

Saved Searchポートレットにより、ポータル・ユーザーは、以前保存された検索を表示できます。保存済検索は、リスト形式でユーザーに配信されます。ユーザーは、リストからハイパーリンク・アイテムを選択することで、保存済検索のコンテンツを表示できます。保存済検索は、Searchポートレットを使用して検索を実行してその検索を保存するか、またはSaved Searchポートレット上で検索パラメータを直接定義することで、リストに保存できます。

図5-3 Saved Searchポートレット

「図5-3 Saved Searchポートレット」の説明

Saved Searchポートレットの使用方法

検索は、Searchポートレットを使用して検索を実行してその検索を保存するか、またはSaved Searchポートレット上で検索パラメータを直接定義することで、保存済検索リストに保存できます。

1. パーソナライズをクリックします。
検索基準ページが表示されます。このページで、標準検索パラメータを編集し、保存済検索リストのアイテムを表示または削除し、新規問合せを作成できます。

2. 新しい問合せに関する次の情報を入力します。

- 問合せのタイトル(例: Sales Images)。

- 問合せの説明(例: Sales Department Images)。

- 問合せテキスト(例: dDocTitle <substring> `salesimage`)。

問合せ文字列を入力するかわりに、Searchポートレットを使用して標準検索を実行し、「保存」→「新規問合せの追加」をクリックできます。

3. 「新規問合せの追加」をクリックします。

図5-4 Saved Searchポートレット - 保存された問合せ

「図5-4 Saved Searchポートレット - 保存された問合せ」の説明

4. 保存済検索のタイトルをクリックします。
保存済検索結果がリスト形式で表示されます。

5. 「戻る」をクリックします。

5.4 Contributionポートレット

Contributionポートレットによって、ポータル・ユーザーは、管理および公開用にネイティブのビジネス・コンテンツを送信できます。 コンテンツの送信によって、自動索引付け、ワークフロー・ルーティング、サブスクリプション・サービスおよびセキュリティをトリガーできます。さらに、コンテンツ・サーバーのアドオン・モジュールにより、様々な形式で公開できます。

図5-5 Contributionポートレット

「図5-5 Contributionポートレット」の説明

Contributionポートレットの使用方法

1. Contributionポートレットで、必要なメタデータと希望するオプションのメタデータを入力します。
Contributionポートレットにより、ユーザーは、公開とリビジョン管理のためにネイティブ・アプリケーションで作成されたビジネス・コンテンツを送信できます。メタデータ・フィールドはコンテンツ・サーバー管理者が定義します。

2. 「プライマリ・ファイル」フィールドで、コンテンツの完全パスを入力するか、「参照」をクリックしてチェックインするコンテンツを選択します。

3. 「チェックイン」をクリックして、コンテンツを送信します。

注意:
contributionポートレットでは、Oracle WebCenter Content: RecordsまたはOracle Universal Records Management (Oracle URM)のコンポーネントがコンテンツ・サーバーで有効化されると、次の既知の問題が発生します。

- CPS contributionポートレットのレンダリングに長時間かかります。コンシューマ上でのWSRPリクエストのタイムアウトが十分長い時間に設定されていることを確認してください。

- CPS contributionポートレットによって、「フォルダID」および「カテゴリID」という2つの追加フィールドが表示されます。これらのフィールドは、コンテンツ・サーバーのチェックイン・ページには表示されません。

- 「カテゴリまたはフォルダ」フィールドは、アイテムをコンテンツ・サーバーにチェックインするための必須フィールドです。しかし、contributionポートレットでは、このフィールドが必須フィールドとして強調表示されません。このフィールドに値を入力しないでcontributionポートレットからドキュメントをチェックインしようとすると、チェックインは失敗します。

5.5 Workflow Queueポートレット

Workflow Queueポートレットによって、ポータル・ユーザーは、ユーザーのレビュー待ちのコンテンツに迅速にアクセスできます。ユーザーはこのポートレットによって、ビジネス・コンテンツのレビューおよび承認のためのワークフロー・インボックスに直接アクセスできます。このポートレットが機能を提供するようにワークフローを定義する必要があります。このポートレットでは、コンテンツ・アイテムのタイトル、ワークフロー・ステップ情報、実行された最後のアクションおよび許可されているアクションがリストされて、コンテンツ・アイテム情報へのリンクが提供されます。

図5-6 Workflow Queueポートレット

「図5-6 Workflow Queueポートレット」の説明

このポートレットが機能を提供するようにワークフローを定義する必要があります。ワークフローの定義手順は、Oracle WebCenter Content Application Content Server管理者ガイドのワークフローに関する章を参照してください。

この例は、次のプロパティが指定された基準ワークフローを想定しています。

- 名前: WorkflowTest

- セキュリティ・グループ: パブリック

- 条件定義を設定する: 有効

- フィールド: タイプ

- 演算子: 次に一致する

- 値: ADSALES

また、次のプロパティのワークフロー・ステップが想定されています。

- 名前: StepOne

- タイプ: レビューア

- ユーザー: User1

Workflow Queueポートレットの使用方法

1. Workflow Queueポートレットを見つけます。

2. ワークフローの作成後、ワークフロー・レビューア(例: user1)としてログインし、指定の基準に一致するコンテンツ・アイテムをチェックインします。

3. ワークフロー・アイテムをレビューします。
Workflow Queueポートレットでは、次の機能が提供されます。

- タイトル: コンテンツ・アイテムがリストされます。クリックすると、ファイルをダウンロードできます。

- ワークフロー情報: アクティブなステップがリストされます。クリックすると、ワークフロー・ステップ情報を表示できます。

- 最終アクション: ワークフローでユーザーが実行した最後のアクションがリストされます。

- アクション: レビューアとして定義されたユーザーは、コンテンツを承認または却下できます。レビューア/コントリビュータとして定義されたユーザーは、コンテンツを承認、却下またはコントリビュートできます。

- 情報: コンテンツ・アイテム情報が表示されます。

図5-7 Workflow Queueポートレット - 定義されたワークフロー

「図5-7 Workflow Queueポートレット - 定義されたワークフロー」の説明

4. 「ワークフロー情報」のステップ名をクリックして、ワークフロー・ステップ情報を表示します。

5. 「戻る」をクリックします。

6. 「承認」または「却下」をクリックします。
承認基準がどのように定義されているかに応じて、「承認」をクリックすると、コンテンツ・アイテムが次のワークフロー・ステップに送信される場合があります。ただし、各ワークフローは、複数のレビューと通知のステップで構成でき、各ステップには、コンテンツを承認または却下する複数のレビューアを割り当てることができます。したがって、ワークフロー・ステップがワークフローの次のステップに進むには、多数のレビューアの承認を必要とする可能性があります。

「却下」をクリックすると、そのコンテンツ・アイテムは、直前の、リビジョンのレビュー/編集手順またはリビジョンのレビュー/新規作成手順に戻ります。該当するステップがない場合、コンテンツは最初の作成者に戻ります。

詳細は、Oracle WebCenter Content Application Content Server管理者ガイドのワークフローに関する章を参照してください。

5.6 Libraryポートレット

Libraryポートレットによって、ポータル・ユーザーは、コンテンツ・サーバーで選択されたメタデータおよびキーワード検索を実行し、返されたコンテンツに対する読取り/書込みアクセスを実行できます。また、ユーザーはこのポートレットを使用して、Saved Searchポートレットで表示する問合せを保存できます。

図5-8 Libraryポートレット

「図5-8 Libraryポートレット」の説明

Libraryポートレットの使用方法

1. パーソナライズをクリックします。
ユーザーはパーソナライズによって、表示される検索結果を変更できます。

- ページごとの結果: ページ当たりに表示する結果の数を入力します。デフォルトは20です。

- ソート: ソートの基準とするフィールドを選択します。オプションは「日付」または「タイトル」です。

- ソート順序: ソート順序を選択します。オプションは「昇順」または「降順」です。

2. 必要に応じて設定を変更し、編集が完了したら「保存」をクリックします。

3. 検索問合せ(例: 新着)を選択します。
検索結果が表示されます。

4. 「情報」アイコンをクリックします。

5. 「コンテンツ情報」ページで、リストから次のオプションを選択できます。

- コンテンツ情報

- チェックアウト

- 類似をチェックイン

- 電子メールでリンクを送信

6. 「戻る」をクリックします。

5.7 Searchポートレット

Searchポートレットによって、ポータル・ユーザーは、ユーザー定義の問合せ基準に一致するコンテンツを表示して、返されたコンテンツに対する読取り/書込みアクセスを実行できます。また、ユーザーはこのポートレットを使用して、Saved Searchポートレットで表示する問合せを保存できます。

図5-9 Searchポートレット

「図5-9 Searchポートレット」の説明

検索ポートレットの使用

1. 検索問合せ(例: Sample)を入力して「送信」をクリックします。
検索問合せの結果が表示されます。

2. 「情報」アイコンをクリックします。

3. 「コンテンツ情報」ページで、リストから次のオプションを選択できます。

- コンテンツ情報

- チェックアウト

- 類似をチェックイン

- 電子メールでリンクを送信

4. 「戻る」をクリックします。

5.8 Metadata Adminポートレット

Metadata Adminポートレットによって、管理者は、カスタム・メタデータのプロパティを変更できます。

図5-10 Metadata Adminポートレット

「図5-10 Metadata Adminポートレット」の説明

Metadata Adminポートレットの使用方法

1. 「情報フィールド」をクリックします。
「情報フィールド」リストが表示されます。情報フィールドは、コンテンツ・サーバー管理者が定義します。

図5-11 Metadata Adminポートレット - 情報フィールド

「図5-11 Metadata Adminポートレット - 情報フィールド」の説明

2. 情報フィールド(例: コメント)をクリックします。
「フィールドの編集」ページが表示されます。

3. 必要な変更を加え、「適用」または「取消」をクリックします。

5.9 ポートレットのカスタマイズ

この項では、ポートレットのカスタマイズに関する情報を提供します。これには、管理者が事前に定義した問合せを表示するLibraryポートレットとGuest Libraryポートレットのカスタマイズに関する情報が含まれます。

これらの手順は管理者が実行し、ユーザーは構成できません。

管理者はportlet.xmlファイルを編集することで、ポートレットでユーザーに表示されるビジネス・コンテンツを定義できます。問合せ文字列を使用して、検索に関するパラメータを定義します。検索問合せの定義には、任意のメタデータ・フィールドを使用できます。

1. CPS配布ファイルを解凍するか、ポータル・サーバー・インスタンス上でデプロイされたポートレットEARファイルを見つけます。

2. WARファイルを解凍します(例: cps-oracle-war-version.war)。

3. WEB-INFディレクトリで、portlet.xmlファイルをテキスト専用エディタで開きます。

4. LibraryポートレットとGuest Libraryポートレットの<portlet>エントリを見つけます。

<portlet>
<description>Oracle Library Portlet</description>
<portlet-name>stellentLibrary</portlet-name>

<portlet>
<description>Oracle Guest Library Portlet</description>
<portlet-name>stellentGuestLibrary</portlet-name>

5. LibraryポートレットまたはGuest Libraryポートレットについて、問合せの定義を提供する<preference>エントリを見つけます。ポートレットをカスタマイズするには、<value>エントリを編集する必要があります。

<preference>
<name>query1.title</name>
<value>What&apos;s New</value>
</preference>
<preference>
<name>query1.description</name>
<value>Content from the past 30 days</value>
</preference>
<preference>
<name>query1.query</name>
<value>dInDate &gt; `&lt;$dateCurrent(-30)$&gt;`</value>
</preference>

6. タイトルおよび説明エントリを編集します。タイトルはユーザーに表示される検索タイトルで、説明はユーザーに表示される検索に関する短い説明です。
例: Important NoticesとImportant messages from the company president.

<name>query3.title</name>
<value>Important Notices</value>

<name>query3.description</name>
<value>Important messages from the company president.</value>

7. 標準XML表記法を使用して問合せ文字列で定義された問合せエントリを編集します。問合せ文字列をコーディングするには、定義済のメタデータ・パラメータ、問合せ文字列修飾子および適切なメタデータ値を使用してください。
たとえば、作成者のpresidentによってチェックインされたコンテンツ・アイテム(dDocAuthorがpresidentに一致)を返す問合せ文字列を定義します。

<name>query3.query</name>
<value>dDocAuthor &lt;matches&gt; &apos;president&apos;</value>

任意の定義済メタデータ・パラメータを使用して、コマンドを作成できます。次に例を示します。

- dInDate: コンテンツ・アイテムのリリース日(つまり、コンテンツ・アイテムがWebにリリースされた日付)。

- dDocAuthor: コンテンツ・アイテムの作成者(例: user1またはsysadmin)。

- dDocType: コンテンツ・アイテムのタイプ(例: ADACCTまたはFILES)。

フィールド・タイトルではなく、メタデータ・パラメータを使用してください(例: Authorではなく、dDocAuthorを使用)。

次の問合せ文字列修飾子を使用できます。

- contains

- starts

- ends

- matches

- substring

8. 編集が完了したら、portlets.xmlファイルを保存します。

9. WARファイルを再度圧縮します。

10. 編集したポートレットの更新されたバージョンをデプロイします。

A CPSソフトウェア開発キット

この項の項目は次のとおりです。

- 第A.1項「ポートレット開発のヒント」

- 第A.2項「CPS SDKディレクトリ構造」

- 第A.3項「CPSポートレットの構築」

- 第A.4項「ReferencePortletsとPortletBuilderの使用方法」

- 第A.5項「ポートレット配布を構築するためのAntの使用方法」

- 第A.6項「CPSタグ・ライブラリの使用方法」

- 第A.7項「ディスパッチ構成の作成」

- 第A.8項「ポートレットAPIファサードへの参照の取得」

- 第A.9項「タイルの作成」

- 第A.10項「コントローラの作成」

A.1 ポートレット開発のヒント

CPSでは、可能な場合は常にWeb標準に準拠して、Model-View-Controller設計パターンが使用されています。こうしたベスト・プラクティスに従うことで、ポータブルで保守可能なポートレットが実現します。ポートレット開発者がポートレットを設計および開発する際は、こうしたコーディング・ガイドラインに従う必要があります。

これはポートレット開発の入門書ではありません。なぜなら、ポートレット・プログラミングの基礎には触れていないからです。むしろ、これらのガイドラインは、高品質で一貫したポートレットの実装を促進するために、設計およびコード・レビュー時のチェックリストとして使用してください。

ポートレットを開発する際は、次の実用的な推奨事項に従ってください。

- 可能な場合は常にtaglibsを使用してください。JSPタグ・ライブラリ内にJavaコードをカプセル化することで、共通の関数の再利用とJSPページの更新がより簡単になります。

- ポートレットとサーブレットに同じ名前を付けないでください。一部のポータル・サーバーではポートレット名を使用してWebアプリケーション内のポートレットが識別されるので、同じ名前のサーブレットが検出されるとエラーが発生する可能性があります。

- headまたはbodyタグは使用しないでください。ポートレットJSPページは、より大きなページのコンテンツに役立ちます。HTMLフラグメントはポータルの表セル<td></td>に追加されるので、<html>、<head>または<body>タグは含めないでください。

- クライアント側JavaScriptは使用しないでください。ブラウザ上で実行されたJavaScriptを使用すると、ポートレットがブラウザに依存し、ブラウザ間の追加テストが必要になります。

- Model-View-Controller設計パターンに従ってください。CPSでは、オープン・ソースのStruts and Tilesフレームワークに基づいて、Model-View-Controller設計パターンが使用されますしたがって、データのプレゼンテーションは、データを取得および整理するロジックとは切り離す必要があります。

- JavaServer Pages Standard Tag Library (JSTL)を使用してください。JSTLでは、条件、反復、フォーマットなどに一般的に必要とされる多くのタグが定義されています。JSPページのコードにc:接頭辞がある場合は、これらのタグ・ライブラリが使用されています。これらのタグ・ライブラリの詳細は、次を参照してください。
http://jakarta.apache.org/taglibs/

A.2 CPS SDKディレクトリ構造

CPS SDKは、CPS配布パッケージの/sdkディレクトリに格納されています。これは次のサブディレクトリから構成されています。

- ReferencePortlets: CPSポートレットのソース・コードが格納されています。これには、Javaコード、JSPページおよびカスタマイズされたポートレットを作成するためのAnt build.xmlファイルが含まれます。これにより、ポートレットをカスタマイズする必要があるユーザーは、ポートレットJSPページおよびModel-View-Controllerフレームワークのソース・コードにアクセスできます。

- PortletBuilder: これによって、Model-View-Controllerフレームワークを使用して新しいポートレットを作成するための構造が提供されます。これには、ターゲット・プラットフォームのカスタム・ポートレットの作成に使用できるAnt build.xmlファイルが含まれます。

- lib: JARファイルにバンドルされているCPS SDKタグ・ライブラリが含まれます。

- sample: PortletBuilderディレクトリを使用してカスタム・ポートレットを作成する方法を例示するサンプル開発ポートレットが含まれます。

カスタマイズされたポートレットを構築するには、Javaベースのビルド・ツールであるApache Antをインストールする必要があります。このツールは、次から入手できます。

http://ant.apache.org

A.3 CPSポートレットの構築

CPS SDKを使用して構築したすべてのポートレットには、ディスパッチ構成ファイル、一連のJavaServer Pagesおよび一連のアクション・ハンドラが含まれます。特定ポートレットのリンクをユーザーがクリックすると、関連付けられたアクション・ハンドラが実行されて、アクションの結果がリクエストに配置されます。その後、アクション実行後の宛先として構成されたタイルが取り出されて、関連付けられたJSPページが挿入されます。その後、JSPページが、アクションの結果のデータをモデル化します。詳細は、第A.7項「ディスパッチ構成の作成」を参照してください。

A.4 ReferencePortletsとPortletBuilderの使用方法

CPS SDKには、ReferencePortletsディレクトリとPortletBuilderディレクトリが含まれています。ReferencePortletsディレクトリにはソース・コードが、PortletBuilderディレクトリにはポートレット構築ファイルが含まれます。これらのディレクトリは、同様の構築環境とAntスクリプトを共有します。

このディレクトリ構造は、ポートレット配布を構築するために提供されているAntファイルによって使用されます。PortletBuilder Antスクリプトでは、ポータル・コンテナ用に必要なポートレット・ファイルをパッケージ化する方法の例として、単一のポートレットが構築されます。多数のポートレットを構築する開発者は、それに合せてスクリプトを変更してください。

ディレクトリ構造

定義

lib/compile/$portalvendor

ポートレットの構築に必要なライブラリが含まれます。

lib/deploy/$portalvendor

ポートレットのデプロイに必要なライブラリが含まれます。

resources/$portalvendor

ポートレットのパッケージ化に必要なグローバル・ファイルとポータル・ベンダー固有のファイルが含まれます。

src

新しいポートレットのソース・ファイル。

build/$appserver

クラスおよび他の構築関連ファイルの保持用に構築時に生成されたディレクトリ。

build/$appserver

構築後に生成されるディレクトリは、構築されたポートレットの保持用です。

dist/$appserver

ポートレットの構築に必要なライブラリが含まれます。

A.5 ポートレット配布を構築するためのAntの使用方法

PortletBuilderおよびReferencePortletsルート・ディレクトリの両方には、ポートレットのコンパイルとパッケージ化を実行するAntファイルが含まれています。このルート・ディレクトリは$workingdirectoryと呼ばれます。配布プロセスは、次のコマンドによって呼び出されます。

cd $workingdirectory
ant dist

この配布を適切に動作させるために、$workingdirectoryディレクトリのbuild.propertiesファイルで次の2つの環境変数を設定する必要があります。

プロパティ名

定義

portal.vendor

現在の配布のターゲットであるポータル・ベンダーの名前。

portlet.name

ユーザーが現在の構築用に使用する名前。この名前はポートレットのディスクリプタ・ファイルの生成に使用されます。

新しく構築されたポートレットは$workingdirectory/dist/$portal.vendorディレクトリに格納このプロセスを正しく動作させるには、Apache Antをインストールする必要があります。このツールは、次から入手できます。

http://ant.apache.org

A.6 CPSタグ・ライブラリの使用方法

CPSタグ・ライブラリには、カスタマイズされたポートレットの構築時に役立つタグがいくつか含まれています。CPSタグ・ライブラリは/libディレクトリにあり、JARファイルにバンドルされています。

この項の項目は次のとおりです。

- 第A.6.1項「URIの作成」

- 第A.6.2項「エラー処理」

- 第A.6.3項「ポートレット・プリファレンス」

A.6.1 URIの作成

PortletAPIFacadeを通してURLを作成します。modeパラメータはオプションで、これを使用すると、作成されたURLにより、ポートレット・モードがユーザー指定の値に切り替えられます。このタグは、しばしば、次の2つのネストされたタグとともに使用されます。

<SCS:CreateURI mode=("edit" | "help" | "view"">

実行するアクションを指定して、作成されたURLを変更します。このアクション名はPortletDispatch.xmlファイルで定義されます(ポートレット・ディスパッチのフレームワークに関する説明を参照してください)。

<SCS:URIAction name="$actionName">

生成されたURLに名前と値のペアを追加します。

<SCS:URIParameter name="$paramName" value="$paramValue">

コード・サンプル

<a href="
<scsportlet:createURI>
<scsportlet:URIAction value="checkOut"/>
<scsportlet:URIParameter name="documentID" value='<%=id%>' />
</scsportlet:createURI>">
Check Out File
</a>

A.6.2 エラー処理

エラーがあるかどうかが判断されます。エラーが見つかった場合は、タグの本体が評価され、エラー・オブジェクト変数が設定されます。

<SCS:Error id="$errorObject">

コード・サンプル

<scsportlet:error id="error">
<div class="portlet-msg-error">
<%=error.getMessage ("%></div>
</scsportlet:error>

A.6.3 ポートレット・プリファレンス

指定のポートレット・プリファレンスが取得され、指定の変数名に結果が格納されます。

<SCS:getPreference preference="$prefName" result="$resultVar">

コード・サンプル

<scsportlet:getPreference preference="maxResults" result="maxResultsVar" />

A.7 ディスパッチ構成の作成

ディスパッチ構成ファイルによって、各アクション・ハンドラ、各タイルおよびポートレット自体の情報が定義されます。デフォルトの命名規則はstellent<portletname>dispatchです(例: stellentactivesearchdispatch.xml)。

CPSポートレットのエントリ・ポイントは、SCSPortletクラスです(コンテナによってこの実装が異なる場合があります)。このクラスにより、GenericPortletクラスが拡張されます。初期化時に、このクラスによって/WEB-INF/configディレクトリ内で構成ファイルが検索されます。

この項の項目は次のとおりです。

- 第A.7.1項「キーワード」

- 第A.7.2項「アクティブな検索ディスパッチ構成」

- 第A.7.3項「子ノードのタイプ」

A.7.1 キーワード

次の特別なキーワードをビュー・ターゲットとして使用できます。

- default: デフォルト・アクション・ノードの定義に従って、ポートレットのデフォルト・ページがレンダリングされます。ユーザーが編集モードの場合は、デフォルトの編集モード・ページが表示されます。

- previous: スタックの前のページがレンダリングされます。

- login: この名前のアクション・ノードを指定すると、新規ログインの検出時にフレームワークによってアクション・ハンドラが実行されます。

- error: リクエストでスロー可能なエラーが発生したと想定されて、CPSによってデフォルトのエラー・ページが表示されます。このエラー・ページは、errorキーワードを使用して新規アクション定義を作成することでオーバーライドできます。

A.7.2 アクティブな検索ディスパッチ構成

アクティブな検索ディスパッチ構成のコーディング例を次に示します。

<portletdispatch-config>
<!--
Default action parameters, name for the default action, cacheResult is a
boolean that specifies whether the default behavior is to cache the action
result on the session. If the value is set to false, the action will be
performed each time the portlet is rendered, the result data is discarded
each time.

The cacheResult value here can be overriden by the action definition itself,
it the action does not specify, the default value is used.
-->

<default-action view="showHome" edit="showEdit" cacheResult="true"/>

<!--
Portlet-id is used to ensure that unique HTML form, javascript names are
used, this value will be available on the request object as
ISCSAction.PORTLET_ID
-->

<portlet-id value="active_search_portlet"/>

<!--
Definitions for all the action types available to this portlet
-->

<action-mappings>
<forward name="showHome" authRequired="true" path="active.search.main.page"/>
<forward name="showEdit" authRequired="true" path="active.search.edit.page"/>
<location path="/WEB-INF/actions/active_search_actions.xml"/>
<location path="/WEB-INF/actions/active_document_actions.xml"/>
</action-mappings>

<!--
Definitions for UI components available to this portlet
-->

<tiles-definitions>
<definition name=".mainLayout" path="/stellent/ui/layouts/mainlayout.jsp">
<put name="header" value="/stellent/ui/fragment/header.jsp"/>
<put name="footer" value="/stellent/ui/fragment/footer.jsp"/>
<put name="content" value="/stellent/ui/layouts/defaultContent.jsp"/>
</definition>
<location path="/WEB-INF/tiles/active_search_tiles.xml"/>
<location path="/WEB-INF/tiles/active_document_tiles.xml"/>
</tiles-definitions>
</portletdispatch-config>

A.7.3 子ノードのタイプ

最上位ノードの<portletdispatch-config>には、デフォルト・アクション、ポートレットID、ロケーション、アクション・マッピングおよびタイル定義ノードというタイプの子ノードを含めることができます。

この項の項目は次のとおりです。

- 第A.7.3.1項「デフォルト・アクション・ノード」

- 第A.7.3.2項「ポートレットIDノード」

- 第A.7.3.3項「ロケーション・ノード」

- 第A.7.3.4項「アクション・マッピング・ノード」

- 第A.7.3.5項「タイル定義ノード」

A.7.3.1 デフォルト・アクション・ノード

<default-action>ノードを使用して、ポートレットまたは編集モードへの初回アクセス時に実行するアクションまたは表示するタイルを指定します。これはまた、defaultキーワードが別のアクションのターゲットである場合に実行されるアクションになります。

view/edit属性: 表示/編集のデフォルトを指定します。この値は、定義済アクションとデフォルト編集アクションの名前になります。たとえば、定義済アクションのshowHomeとデフォルト編集アクションのshowEditになります。

cacheResult属性: アクションの結果をセッション上にキャッシュするか、render ()メソッドのコールごとに再実行するかを示します。ユーザーが他のポートレット上でアクションを実行すると、これによって自らの再描画をポートレットに指示するレンダリング・コールが生成されます。cacheResultがtrueに設定されている場合は、この再描画ではアクションが再実行されるかわりにキャッシュされた結果が使用されます。アクティブなSearchポートレットの場合、これはデフォルトでtrueに設定されています。個々のアクションによってポートレットのデフォルトをオーバーライドでき、この値はアクション定義で指定されていない場合のみ使用されます。

A.7.3.2 ポートレットIDノード

<portlet-id>ノードを使用して、ポートレットの一意の名前を指定します。ここで指定した文字列値は、パラメータ名ISCSAction.PORTLET_IDを使用したリクエストで使用できます。このIDは主に、フォームやJavaScript関数などのHTML要素が同じページ上の他のポートレットと競合しないように、これらを一意に識別するために使用されます。

A.7.3.3 ロケーション・ノード

<location>ノードを使用して、定義をロードする別のディスパッチ構成ファイルを指定します。これにはパス属性を指定し、これによってロードする構成ファイルの検索場所が示されます。

このノードは、アクション・マッピング・ノードまたはタイル定義ノードの子になることが可能です。名前が競合する場合は、現在の構成XMLのアクション・マッピング定義が、ロードされたアクション定義より優先されます。

A.7.3.4 アクション・マッピング・ノード

<action-mappings>ノードは、通常はアクション・ノードによって定義されるアクション定義のコンテナです。2つの例外はフォワード・ノードとロケーション・ノードです。

アクション・ノード

<action>ノードによって、必要なアクションの実行に使用されるいくつかの属性を指定します。アクション定義の例を次に示します。

<!--
Shows the form to add new saved search.
-->

<action
name="active.search.showAddSavedSearch"
class="com.stellent.portlet.components.search.active.handlers.
ShowAddSavedSearchHandler"
bean="com.stellent.portlet.components.search.active.forms.
AddSavedSearchForm"
authRequired="true"
addToStack="false">
<forward name="success" path="active.search.savedsearch.add.page"/>
</action>

属性は次のとおりです。

- name: アクションの名前。これは、JSPページ内でこのアクションを実行するときに使用されます。

- class: ISCSActionHandlerインタフェースを実装するクラスの完全修飾クラス名。このクラスに、アクション・ハンドラ・コードを追加します。アクションの定義には、name属性とclass属性の両方が必要です。

- bean: ISCSActionFormインタフェースを実装するクラスの完全修飾クラス名。handleActionメソッドがコールされると、これはアクション・ハンドラに渡されます。このbeanは、HTMLフォーム・ポストを通じて、または特殊なCPSポートレット・タグを使用した明示的定義によって、移入できます。これはオプション属性で、アクションに入力パラメータがまったく必要とされない場合は、この属性は省略できます。その場合は、handleActionに渡されるISCSActionFormはnullになります。

- authRequired: 認証されていないポータル・ユーザーがアクションの実行を試みたときに、フレームワークによってアクションを実行するかどうかを制御します。これはオプション・パラメータで、デフォルトはfalseです。これがtrueに設定されている場合に、認証されていないポータル・ユーザーがアクションを実行しようとすると、特殊なシステムJSPページが表示され、ポートレットを使用する前にログインするようにユーザーに指示します。

- addToStack: 再描画のためにrenderがコールされた場合、ポートレット・フレームワークによってこのアクションを再度実行するか、結果をキャッシュするかを定義します。デフォルトはtrueで、ポートレットでは再描画時に最新の状態が表示されます。しかし、一部のアクションは一度しか実行できません。そのため、フレームワークで結果を保存しないか、または結果を最終アクションとして記憶するかを定義できます。

<action>ノードはまた、任意の数のフォワード・アクションのコンテナになります。フォワード・アクションによって、アクション完了時にポートレットで表示されるタイルまたはJSPページを指定します。一意の名前を持つ異なるforwardsを必要な数だけこのリストに指定できます。アクション・ハンドラ・コード自体で、アクション完了時に使用するforwardを指定します。アクション完了時にフォワードするビュー名がハンドラによって明示的に示されていない場合、デフォルトはsuccess forwardになります。

これらのフレームワーク・プロパティに加え、任意の数のカスタム属性をアクション定義に指定できます。これらの属性は、ISCSActionHandler getAttributes()メソッドによってアクション・ハンドラで使用できます。たとえば、Contributionポートレットでは、カスタム・プロパティのasyncが追加されます。このカスタム・プロパティは、コントリビューションでJava Messaging Service (JMS)を利用して、ドキュメント・コントリビューションを非同期で実行するかどうかを示します。

フォワード・ノード

<forward>ノードは、特殊なタイプのアクションで、実際にコードは実行しませんが、指定のタイル定義または明示的JSPページ・ロケーションに自動的に表示をフォワードします。パス属性には、これらの値のいずれも指定できます。

A.7.3.5 タイル定義ノード

Tiles and Struts設計パターンでは、最終ビューの作成に使用されるメインJSPページ、コンテンツの様々な領域およびオプションのコントローラ・クラスを指定することで、特定ビューのレンダリング方法をフレームワークに指示します。

例:

<definition name=".mainLayout" path="/stellent/ui/layouts/mainlayout.jsp">
<put name="header" value="/stellent/ui/fragment/header.jsp"/>
<put name="footer" value="/stellent/ui/fragment/footer.jsp"/>
<put name="content" value="/stellent/ui/layouts/defaultContent.jsp"/>
</definition>

これによって、名前.mainLayoutのタイルを定義し、JSPページ/stellent/ui/layouts/mainlayout.jspを、このビューをレンダリングするときに使用するメインJSPページに指定しています。メインJSPページが使用可能なコンテンツの領域を指定するプット・ノードに注意してください。この例では、ヘッダー、フッターおよびコンテンツ領域の3つの領域を使用できます。これらの各プット・ノードによって、領域の名前と領域のレンダリングに使用する対応するJSPページが指定されます。

また、次の定義のように、タイル定義のコントローラを指定し、継承を指定できます。

<definition name="active.search.edit.page" extends=".mainLayout"
controllerClass="com.stellent.portlet.components.search.active.
controllers.EditController">

<put name="content" value="/stellent/ui/layouts/search/active/
active_search_edit.jsp"/>
</definition>

このタイルは、以前に定義した.mainLayoutタイルを拡張するもので、その構成が継承されます。ここでは、controllerClassをこのタイルに追加しています。controllerClassは、ISCSControllerインタフェースを実装して処理が必要な状況でタイルがレンダリングされる前にJavaコードを実行するフックを提供するオブジェクトです。このタイル定義によってcontent領域がオーバーライドされ、この領域のレンダリングに使用されているJSPページが変更されることに注意してください。

A.8 ポートレットAPIファサードへの参照の取得

次のように、JSPページを通してアクション定義が呼び出されます。

<form name="subAuthSearch" method="POST" onSubmit="prepareAuthScsSearch()"
action='<scsportlet:createURI><scsportlet:URIAction
value="active.search.doSearch"/>
</scsportlet:createURI>'>

この例では、フォームが送信されたときに、CPSタグcreateURIによってactive.search.doSearchアクションが呼び出されます。アクションactive.search.doSearchは、構成ファイルで作成されたアクション定義にマッピングします。詳細は、第A.7.3.4項「アクション・マッピング・ノード」を参照してください。

アクション定義はクラス名を指定します。クラス名は、 ISCSActionHandlerインタフェースを実装するオブジェクトになります。このインタフェースでは、オブジェクトを行使するためにフレームワークによって使用される様々なメソッドを実装できます。ただし、抽象ベース・クラスのSCSActionHandlerを拡張すると、開発者は1つのメソッドのみを実装すれば済みます。

/**
* Handle an action from the portlet
* @param portletRequest
* @throws com.stellent.portlet.dispatcher.PortletDispatcherException
*/
public ISCSActionResult handleAction (ISCSActionForm form,
Object portletRequest)
throws PortletDispatcherException, IdcClientException, RemoteException;

このメソッドは、ポートレット・フレームワークを通してアクションが呼び出されるたびにコールされます。メソッドは、このアクションが使用できるパラメータを表すbeanである、ISCSActionFormで渡されます。

このクラスは、アクション・ノードで指定されたタイプになります。

handleActionメソッド内では、アクション・ハンドラは、getIdcClient()メソッドを通して、初期化済のIdcClientオブジェクトを使用できます。同様に、getAttributes()メソッドを通して、アクション・ノードで指定された他のすべての属性を使用できます。また、getID()メソッドを通して、このハンドラの一意のIDにアクセスできます。これを使用すると、競合なしでセッションの情報を格納できます。

戻りタイプはアクション結果オブジェクトです。通常、これは単純に、JSPページ内でのアクセスのリクエストに格納される結果パラメータのコンテナです。ただし、戻り時に使用されるビューなど、この結果に対して他のパラメータを指定できます。ベース・クラスSCSActionResultを使用する場合、デフォルトはsuccessになります。

サンプル・アクション・ハンドラ

アクション定義で、アクション active.document.checkOut、アクションを実行するISCSActionHandlerクラス、ハンドラに渡されるパラメータを表すbeanであるISCSActionFormおよびアクション完了時に表示される結果のタイルを指定します。

<!--
Attempts to check out the specified document.
-->

<action
name="active.document.checkOut"
class="com.stellent.portlet.components.document.
active.handlers.CheckOutHandler"
bean="com.stellent.portlet.components.document.
active.forms.CheckOutForm"
authRequired="true" >

<forward name="success" path="active.document.checkout.page"/>
</action>

SCSActionFormコードは、checkoutハンドラがそのアクションを完了するために必要とするパラメータを示します。次の例では、チェックアウトするドキュメントのドキュメントIDのみがcheckoutで必要とされます。

public class CheckOutForm extends SCSActionForm {
private String m_documentID;

public String getDocumentID () {
return m_documentID;
}

public void setDocumentID (String documentID) {
m_documentID = documentID;
}
}

SCSActionHandlerコードでは、渡されたフォームがCheckOutFormのインスタンスであるかどうかが最初にチェックされます。そうでない場合は、エラーが発生します。それ以外の場合は、コンテンツ・サーバーのCHECKOUTサービスをコールすることで、RIDC APIを通してファイルがチェックアウトされます。結果のレスポンス・オブジェクトは、result.setVariable(name,object)をコールすることでリクエストに置かれます。これらのオブジェクトは、ビューをレンダリングするJSPページで使用可能になります。

public class CheckOutHandler extends SCSActionHandler {
/**
* Checks out the specified content.
*
* @param portletRequest
* @throws com.stellent.portlet.dispatcher.PortletDispatcherException
*/
public ISCSActionResult handleAction (ISCSActionForm form, Object portletRequest)
throws PortletDispatcherException, IdcClientException, RemoteException {
ISCSActionResult result = new
SCSActionResult ();

// Checking of Form Instance.
if (form instanceof CheckOutForm) {
CheckOutForm cof = (CheckOutForm)form;

//The IdcClient Object and the Context.
IdcClient client = getIdcClient();
IdcContext ctx = SCSSession.getSCSContext(portletRequest);

// Content Server Service executed using RIDC API for Checking Out a document.
DataBinder chkoutBinder = client.createBinder ();
chkoutBinder.putLocal ("IdcService", "CHECKOUT");
chkoutBinder.putLocal ("dID", cof.getDocumentID ());
ServiceResponse response = client.sendRequest (ctx, chkoutBinder);
DataBinder checkoutBinder = response.getResponseAsBinder ();

// Service Executed for getting Document Information.
DataBinder docBinder = client.createBinder ();
docBinder.putLocal ("IdcService", "DOC_INFO");
docBinder.putLocal ("dID", cof.getDocumentID ());
ServiceResponse docresponse = client.sendRequest (ctx, docBinder);
DataBinder docDataBinder = docresponse.getResponseAsBinder ();
DataResultSet docData = docDataBinder.getResultSet ("DOC_INFO");
List docDataRows = docData.getRows ();
DataObject dobj = (DataObject)docDataRows.get(0);

//Result put on the request and sent to the JSP Page.
result.setVariable ("checkoutResponse", checkoutBinder);
result.setVariable ("infoResponse", dobj);
} else {
throw new PortletDispatcherException ("Unexpected form type,
expected 'CheckOutForm', got " + form);
}
return result;
}

A.9 タイルの作成

タイルは、定義、オプションのコントローラ・クラスおよびポートレット・ビューを作成する一群のJSPクラスから構成されます。定義セクションには、メイン・レイアウトのJSPページを識別するXMLコードが含まれます。

次の例では、3つのJSPページを参照する3つの異なる領域が指定されています。

<%@ include file="/stellent/ui/fragment/jspimport.inc" %>
<scsportlet:insert name="header"/>
<scsportlet:insert name="content"/>
<scsportlet:insert name="footer"/>

先頭のincludeには、一般に定義されるimportとtaglib定義が含まれます。これはポートレット用のファイルの例です。

<%@ page import="com.stellent.portlet.api.IPortletAPIFacade" %>
<%@ page import="com.stellent.portlet.api.PortletAPI" %>
<%@ include file="/stellent/ui/fragment/page.inc" %>
<%@ taglib uri="/WEB-INF/tlds/i18n.tld" prefix="i18n" %>
<%@ taglib uri="/WEB-INF/tlds/scsportlet.tld" prefix="scsportlet" %>
<%@ taglib uri="/WEB-INF/tlds/c.tld" prefix="c" %>
<%@ taglib uri="/WEB-INF/tlds/scs-databinder.tld" prefix="db" %>

<%
//the api facade class
IPortletAPIFacade apiFacade = PortletAPI.getInstance ().getPortletAPIFacade ();
%>

JSPページでは、最初にヘッダー、次にコンテンツ、最後にフッターを配置するようにビューに指示するために、3つの行でinsertタグが使用されています。それぞれの領域について、定義を検索してinsertタグによって指定されたJSPページを含めるように、insertタグはフレームワークに指示しています。

A.10 コントローラの作成

コントローラは、タイル自体がレンダリングされる前にタイル作成者がJavaコードを実行できるようにするフックです。コントローラを作成するには、ISCSControllerクラスを実装する必要があります。このクラスでは、ポートレット・フレームワークがその存続期間を制御するために使用するいくつかのメソッドが必要とされます。

ほとんどの場合、抽象ベース・クラスのSCSControllerによって、必要なすべての操作が実行されます。ただし、次は例外となります。

/**
* Method is called before a Tile is rendered.
*
* @param portletRequest The portlet request that generated the Tile render.
* @param portletResponse The portlet response associated with Tile render
* @throws ServletException If a portlet container error occurs.
* @throws IOException If a portlet container error occurs.
* @throws IdcClientException If a RIDC framework error occurs.
* @throws RemoteException If a RIDC communication error occurs.
*/

public void perform (Object portletRequest,
Object portletResponse)
throws ServletException, IOException, IdcClientException, RemoteException;

このメソッドはタイルがレンダリングされる直前にコールされ、リクエスト上に配置するすべてのオブジェクトは、結果のJSPページで使用可能になります。

索引

A  B  C  D  E  F  G  H  I  J  L  M  O  P  Q  R  S  T  V  W  X

A

抽象ベース・クラス, A.8

アクセス要件, 1.4

アクション定義, A.7.3.1

アクション定義, A.7.3.4

アクション・ハンドラ, A.3, A.7.1

アクション・マッピング・ノード, A.7.3.3

アクション・ノード

addToStack属性, A.7.3.4

authRequired属性, A.7.3.4

bean属性, A.7.3.4

class属性, A.7.3.4

name属性, A.7.3.4

アクション・ノード, A.7.1, A.7.3.4 アクション・リクエスト, 2.3 アクションURL, 2.3 アクション・マッピング・ノード, A.7.3.4 active.document.checkOut, A.8 active.search.doSearchアクション, A.8 匿名ユーザー, 1.4 Ant build.xmlファイル, A.2 Antファイル, A.5 Apache Ant, A.2 認証ユーザー, 1.4

B

bodyタグ, A.1

カスタマイズされたポートレットの構築, A.6

build.propertiesファイル, A.5

C

cacheResult, A.7.3.1

チェックアウト・ハンドラ, A.8

子ノード, A.7.3

クライアント側JavaScript, A.1

CPS用のコンテンツ・サーバーの構成, 3.3, 3.4

CPSポートレットの使用, 4

Contributionポートレット, 1.3, 5.4

コントローラ, A.10

コントローラ(MVC), 2.2

コントローラ・クラス, A.9

controllerClass, A.7.3.5

CPS通信, 3.4

CPSポートレット・タグ・ライブラリ, A.6

CPSポートレット, 2.1

WebCenter Interaction上のCPSポートレット, 4.2

WebCenter Portal上のCPSポートレット, 3.1.4

WebLogic Portal上のCPSポートレット, 3.2.3

WebLogic Portal上のCPSポートレット, 4.3, 4.4

WebSphere Portal上のCPSポートレット, 3.3.3

CPS SDKタグ・ライブラリ, A.2

createURI, A.8

カスタム属性, A.7.3.4

カスタム管理対象サーバー, 3.1.3

カスタマイズされたポートレット, A.6

ポートレットのカスタマイズ, 5.9

D

デフォルト・アクション・ノード

cacheResult属性, A.7.3.1

表示/編集属性, A.7.3.1

defaultキーワード, A.7.3.1 デフォルト・アクション・ノード, A.7.1, A.7.3.1 WSRPプロデューサとしてのCPSのデプロイ, 3 WebCenter Portal上でのCPSポートレットのデプロイ, 3.1.4 WebLogic Portal上でのCPSポートレットのデプロイ, 3.2.3 WebSphere Portal上でのCPSポートレットのデプロイ, 3.3.3 ディスパッチ構成ファイル, A.3, A.7, A.7.3.3

子ノード, A.7.3

アクティブな検索のコーディング, A.7.2

defaultキーワード, A.7.1

errorキーワード, A.7.1

loginキーワード, A.7.1

previousキーワード, A.7.1

最上位ノード, A.7.3

dispatch.xml, A.7

E

ホストとポートのプロパティの編集, 3.1.4

編集モード, A.7.1

編集モード・ページ, A.7.1

コンテンツ・サーバーの構成ファイルの編集, 3.4.2

コンテンツ・サーバー上のIPアドレスの有効化, 3.4.1

コンテンツ・サーバー上のIPアドレスの有効化, 3.4.1

Javaコードのカプセル化, A.1

環境変数, A.5

portal.vendor, A.5

portlet.name, A.5

エラー処理, A.6.2 errorキーワード, A.7.1 エラー・オブジェクト変数, A.6.2 エラー・ページ, A.7.1

F

ファサード・オブジェクト, 2.3

フォワード・ノード, A.7.3.4

forwardノード, A.7.3.4

G

GenericPortletクラス, A.7

getAttributesメソッド, A.7.3.4

getIDメソッド, A.8

Guest Libraryポートレット, 1.3, 5.1

Guest Searchポートレット, 1.3, 5.2

H

handleActionメソッド, A.7.3.4

headタグ, A.1

HTMLフラグメント, A.1

htmlタグ, A.1

I

コンシューマとしてのIBM WebSphere Portal, 4.4

プロデューサとしてのIBM WebSphere Portal, 3.3

IBM WebSphere Portal Version 6.1, 1.2

サービスWSDLのインポート, 4.2.3

insertタグ, A.9

IPアドレス、有効化, 3.4.1

ISCSActionForm, A.8, A.8

ISCSActionFormインタフェース, A.7.3.4

ISCSActionHandler, A.7.3.4, A.8

ISCSActionHandlerインタフェース, A.7.3.4, A.8

ISCSAction.PORTLET_ID, A.7.3.2

ISCSControllerクラス, A.10

ISCSControllerインタフェース, A.7.3.5

J

Java Messaging Service (JMS), A.7.3.4

JavaScript, A.1

JavaServer Pages標準タグ・ライブラリ, A.1

JSPクラス, A.9

JSPタグ・ライブラリ, A.1

JSPタグ・ライブラリ, A.1

JSTL, A.1

L

ターゲットとするライブラリ, 3.1.3

Libraryポートレット, 1.3, 5.6

ロケーション・ノード, A.7.3.4

locationノード, A.7.3.3

M

Manifest.MFファイル, 3.2.3

mds-SpacesDS, 3.1.3

Metadata Adminポートレット, 1.3, 5.8

メタデータ・パラメータ, 5.9

メタデータ値, 5.9

モード・パラメータ, A.6.1

モデル(MVC), 2.2

Model-View-Controller, 2.2

Model-View-Controllerデザイン・パターン, A.1

Model-View-Controllerフレームワーク, 2.2, A.2

MVC

コントローラ, 2.2

モデル, 2.2

ビュー, 2.2

O

Oracle Application Server, 3.1, 3.3

Oracle Contributionポートレット, 1.3

Oracle Guest Libraryポートレット, 1.3

Oracle Guest Searchポートレット, 1.3

Oracle Libraryポートレット, 1.3

Oracle Metadata Adminポートレット, 1.3

Oracle Saved Searchポートレット, 1.3

Oracle Searchポートレット, 1.3

Oracle WebCenter Interaction, 4.2

コンシューマとしてのOracle WebCenter Interaction, 4.2

Oracle WebCenter Portal, 3.1, 3.3

プロデューサとしてのOracle WebCenter Portal, 3.1

コンシューマとしてのOracle WebCenter Spaces, 4.1

Oracle WebLogic Portal, 4.3

コンシューマとしてのOracle WebLogic Portal, 4.3

プロデューサとしてのOracle WebLogic Portal, 3.2

Oracle Workflow Queueポートレット, 1.3

P

権限, 1.4

ポータルEARプロジェクト, 3.2.3, 4.3.3

ポータルWebプロジェクト, 3.2.3, 4.3.3

portal.vendor, A.5, A.5

ポートレットJSPページ, A.1

ポートレット名, A.1

ポートレット・プリファレンス, A.6.3

ポートレットのリクエスト処理, 2.3

ポートレットSDK, A.2

ポートレットのセキュリティ, 1.4

PORTLET_ID, A.7.3.2

PortletAPIFacade, A.6.1

PortletBuilder, A.2, A.5

PortletDispatch, 2.2

portletdispatch-config, A.7.3

PortletDispatch.xml, A.6.1

ポートレットIDノード, A.7.3.2

portlet.nam, A.5

portlet.name, A.5

ポートレット

Contribution, 1.3

ディスパッチ構成ファイル, A.3

Guest Library, 1.3

Guest Search, 1.3

Library, 1.3

Metadata Admin, 1.3

Saved Search, 1.3

Search, 1.3

コンパイルおよびパッケージ化のためのAntの使用方法, A.5

ワークフロー・キュー, 1.3

portlet.xmlファイル, 5.9 定義済メタデータ・パラメータ, 5.9 processAction, 2.3 プット・ノード, A.7.3.5

Q

問合せ定義, 5.9

問合せエントリ, 5.9

問合せ文字列, 5.9

問合せ文字列修飾子, 5.9

R

お薦めするアクセス設定, 1.4

ReferencePortlets, A.2, A.5

登録プロパティ, 4.3.3

renderのコール, A.7.3.1

renderメソッド, A.7.3.1

レンダリング・リクエスト, 2.3

リクエスト処理, 2.3

S

Saved Searchポートレット, 1.3, 5.3

SCSActionFormコード, A.8

SCSActionHandler, A.8

SCSActionResult, A.8

SCSControllerクラス, A.10

SCSPortletクラス, A.7

SDKディレクトリ構造, A.2

SDKタグ・ライブラリ, A.2

Searchポートレット, 1.3, 5.7

セキュリティ設定, 1.4

showEdit, A.7.3.1

showHome, A.7.3.1

Struts, 2.2, A.1

Struts and Tilesフレームワーク, 2.2, A.1

ポートレットのタイトル・バーを非表示にする, 4.2.3

T

表セル, A.1

タグ

body, A.1

head, A.1

html, A.1

タグ・ライブラリ, A.2 ターゲット・ライブラリ, 3.1.3 タイル定義ノード, A.7.3.3 Tiles, 2.2, A.1

V

ビュー(MVC), 2.2

W

Web Services for Remote Portlets (WSRP), 1.2

WebCenter Interaction, 4.2

コンシューマとしてのWebCenter Interaction, 4.2

プロデューサとしてのWebCenter Portal, 3.1

WebCenterの構成済OC4J, 3.1.1, 3.1.2

コンシューマとしてのWebCenter Spaces, 4.1

WEB-INFディレクトリ, 5.9

WebLogic Portal, 4.3

コンシューマとしてのWebLogic Portal, 4.3

プロデューサとしてのWebLogic Portal, 3.2

WebLogic Portal EARプロジェクト・ファセット, 3.2.3, 4.3.3

コンシューマとしてのWebSphere Portal, 4.4

プロデューサとしてのWebSphere Portal, 3.3

Workflow Queueポートレット, 1.3, 5.5

WSRP対応ポータル・サーバー, 3

WSRPプロデューサ, 3, 3.1, 3.2, 3.3

X

XMLコード, A.9

XML表記法, 5.9

Copyright © 2002, 2011, Oracle and/or its affiliates. All rights reserved.