ポートレット開発ガイド

     前  次    目次     
ここから内容

サードパーティ ポートレットの追加

この章では、WebLogic Portal パートナ企業から提供されている特殊な用途のためのポートレットについても説明します。これらのポートレットはポータルに簡単に組み込むことができます。

この章には次の節があります。

 


コラボレーション ポートレットの使用

WebLogic Portal は、ポータルにコラボレーション機能を追加するためのポートレットのセットを提供します。これらのコラボレーション ポートレットは、どの WebLogic Portal デスクトップでも使用できます。

この節では、次のトピックについて説明します。

コラボレーション ポートレットとは

WebLogic Portal は、どの WebLogic Portal デスクトップでも使用できる次のコラボレーション ポートレットを提供します。

注意 : ユーザ ポートレットは、各ユーザに基づいてデータを格納するポートレットです。共通領域のポートレットは、すべてのユーザが表示できる共通の場所にデータを格納します。カレンダー、アドレス帳、タスクのポートレットはデフォルトでユーザ ポートレットです。これは共通領域のポートレットに再コンフィグレーションする場合もあります。たとえば、すべてのユーザが同じデータを表示する企業イベント カレンダーをコンフィグレーションする場合もあります。詳細については、「共有ビューのコラボレーション ポートレットのコンフィグレーション」を参照してください。
ヒント : コラボレーション ポートレットもまた、GroupSpace コミュニティなどのコミュニティで利用できます。コミュニティの作成の詳細については、『WebLogic Portal コミュニティ ガイド』を参照してください。GroupSpace コミュニティは、Workshop for WebLogic GroupSpace テンプレートを使用して作成されるコミュニティです。WebLogic Portal GroupSpace コミュニティの詳細については、『WebLogic Portal GroupSpace ガイド』を参照してください。この章の指示は、GroupSpace が有効になっているコミュニティ以外のコラボレーション ポートレットを使用することを目的とします。

ポータルへのコラボレーション ポートレットの追加

この節では、ポータル にコラボレーション ポートレットを追加とコンフィグレーションする方法について説明します。基本的な手順は、次のとおりです。

手順 1. コラボレーション ファセットの追加

コラボレーション ポートレットが使用されるポータル EAR プロジェクトおよびポータル Web プロジェクトの両方に適切なファセットを追加する必要があります。

  1. ポータル EAR プロジェクトに関連するコラボレーション ポートレット ファセットを追加します。
    1. [ナビゲーター] ビューで、ポータル EAR プロジェクトを右クリックし、[プロパティ] を選択します。
    2. プロパティ ビューで、[Project Facets] を選択し、[Add/Remove Project Facets] をクリックします。
    3. 追加と削除のウィンドウで、[WebLogic Portal コラボレーション] を展開し、[コラボレーション ポートレットのアプリケーション ライブラリ] および [コラボレーション API] の両方を選択します。
    4. [終了] をクリックし、[OK] をクリックします。
  2. ポータル Web プロジェクトにコラボレーション ポートレット ファセットを追加します。
    1. 上記の同じサブ手順を実行し、[WebLogic Portal コラボレーション|コラボレーション ポートレット] ファセットを選択します。

次の手順に示すように、コラボレーション ポートレット ファセットを追加した後、コラボレーション ポートレットが正しくコンフィグレーションする必要があります。コンフィグレーションした後、ポータル デスクトップに追加できます。

手順 2: ドメインにコラボレーション リポジトリの追加

ドメインにコラボレーション リポジトリを追加していない場合、コラボレーション リポジトリ コンポーネントを含むためにドメインを作成または拡張する必要があります。

  1. 既存のサーバがあり、実行中の場合は、サーバを停止します。
  2. Configuration Wizard を起動します。Windows の [スタート] メニューから、[Oracle Products|WebLogic Server 10.x|Tools|Configuration Wizard] を選択します。
  3. Configuration Wizard で、[新しいドメインの作成] または [既存のドメインの拡張] を選択して [次へ] をクリックします。
  4. 手順 3 での [作成] を選択すると、[WebLogic Portal コラボレーション リポジトリ] のチェックボックスを選択して、[次へ] をクリックします。既存のドメインを拡張する場合は、ドメイン ルート ディレクトリを選択し、[次へ] をクリックします。
  5. 残りのウィザード ウィンドウを完了します。
  6. サーバを再起動します。

手順 3: コラボレーション ポートレット ユーザのロールの作成

コラボレーション ポートレットのユーザがコラボレーション データ を格納したリポジトリを使用する資格を持っている必要があります。この節では、新しいユーザ ロールの作成方法について説明します。

  1. WebLogic Portal Administration Console を起動し、ログインする。
  2. 新しいエンタープライズ アプリケーション スコープの訪問者資格を作成する。これを行うには、[ユーザ、グループ、およびロール|訪問者の資格|ロールの参照] を選択する。
  3. ロールのスコープを設定する。[ロールの参照場所] パネルで、更新をクリックして [ロール スコープの更新] ダイアログを表示する。ダイアログで エンタープライズ アプリケーション スコープを選択し、更新をクリックする。
  4. [訪問者ロール|ロールの参照|新しいロールの作成] を選択する。新しいロールの名前を入力し、保存する。

手順 4. (省略可能) リポジトリのコンフィグレーション

コラボレーション ポートレットによって生成されたデータは、コンテンツ リポジトリに保存されます。デフォルトでは、コラボレーション ポートレットはリポジトリ サブフォルダ /Communities_Repository/Collaboration にデータを格納するようにコンフィグレーションされます。

必要に応じて、コラボレーション ポートレットのデータを格納するために、いずれかの WLP コンテンツ リポジトリを使用できます。リポジトリに対するライブラリ サービスは、無効にする必要があります。コラボレーション ポートレット データはサードパーティのリポジトリ (たとえば、Documentum リポジトリ) にサポートされていません。コンテンツ リポジトリの詳細については、『コンテンツ管理ガイド』を参照してください。この節で説明するように、データが格納されるリポジトリには、サブフォルダを作成することをお勧めします。

ヒント : ベスト プラクティスは、コラボレーション データに関するカスタム リポジトリを作成することです。詳細については、『コンテンツ管理ガイド』の「追加の WLP リポジトリのコンフィグレーション」を参照してください。

コラボレーション ポートレット データが格納されるサブフォルダを作成するには、次の手順を実行します。

  1. [コンテンツ|コンテンツ管理] を選択する。リポジトリのビューで、リポジトリを選択する。
  2. [Add Folder] をクリックして、選択したリポジトリに新しいフォルダを追加する。

デフォルトの場所が望ましくない場合、選択したリポジトリ フォルダにポイントする個別のコラボレーション ポートレットをコンフィグレーションする。

手順 5. コラボレーション データ リポジトリの資格の付与

コラボレーション ポートレット データが格納されるリポジトリ フォルダに正しく資格を付与します。資格を付与されたユーザのみがコラボレーション ポートレットを使用できます。

  1. コラボレーション データを格納するために作成されたサブフォルダを選択する。
  2. サブフォルダに関する [資格] タブを選択する。
  3. [ロールの追加] をクリックして、コラボレーション ポートレットのために作成された新しいユーザ ロールを追加する。 作成、表示、更新、および削除の機能でロールに資格を付与する。

手順 6. 新しいロールへの ユーザの追加

新しいロールには、コラボレーション ポートレットを使用するすべてのユーザを追加する必要があります。ロールを選択して、[ロールにユーザを追加] をクリックします。ロールにユーザを追加するためにダイアログを使用します。

ヒント : コラボレーション ポートレットの使用権を付与するために、新しいユーザはロールに追加することを確認します。新しいユーザを作成するには、[ユーザ、グループ、およびロール|ユーザ管理] を選択します。新しいユーザを作成した後、ロールに追加します。

手順 7. コラボレーション ポートレットのコンフィグレーション

コンフィグレーションされたリポジトリを認知するようにコラボレーション ポートレットを構成します。これを行うには、指定のポートレット プリファレンスを編集します。

  1. [ポータル|ポータル管理] を選択する。
  2. [ポータル リソース|ライブラリ|ポートレット] フォルダを展開する。
  3. 使用する各コラボレーション ポートレットには、以下の手順を実行する。
    1. コンフィグレーションするためのポートレットを選択する。たとえば、[ディスカッション] をクリックして、ディスカッションのポートレットをコンフィグレーションする。
    2. [ポートレット プリファレンス] をクリックする。
    3. collaboration.personal_repository.path を編集して、その値をリポジトリ内の指定されているコラボレーション データ フォルダに設定する。たとえば、MyCollaborationRepository というリポジトリに MyCollaborationData というフォルダを作成した場合、値を /MyCollaborationRepository/MyCollaborationData に設定する。
    4. collaboration.personal_repository.name を編集して、その値をコラボレーション データのために使用するリポジトリの名前に設定する。たとえば、MyCollaborationRepository というリポジトリを使用する場合、値を MyCollaborationRepository に設定します。

手順 8. デスクトップにコラボレーション ポートレットの追加

コラボレーション ポートレットをコンフィグレーションしたら、デスクトップに追加できます。

注意 : コラボレーション ポートレットは、ユーザが認証される場合のみ機能されます。デスクトップにログイン ポートレットが必要です。認証の詳細については、『セキュリティ ガイド』を参照してください。

すべてを正しくコンフィグレーションした場合、許可されているユーザがログインした後、コラボレーション ポートレットにアクセスできます。必要に応じて、コラボレーション リポジトリにフォルダを作成します。たとえば、図 11-1 は、養蜂のディスカッション フォーラム用のリポジトリ構造の例を示します。

図 11-1 ディスカッション フォーラム用のリポジトリ構造

ディスカッション フォーラム用のリポジトリ構造

共有ビューのコラボレーション ポートレットのコンフィグレーション

この節では、ユーザ ポートレットは共通領域のポートレットとして再コンフィグレーション方法について説明します。共通領域のポートレットでは、資格を付与されたユーザがポートレット データの同じビューを共有できる場合、ユーザ ポートレットでは、ポートレット データが個々のユーザに限定されます。

ユーザと共通領域のポートレットの概要

コラボレーション ポートレットは以下の 2 つのカテゴリに分類できます。共通領域のポートレット および ユーザ ポートレット。通常、共通領域のポートレットは、すべてのユーザがポートレット データの同じビューを共有する必要があるユースケースの場合お勧めします。たとえば、企業イベントがすべてのユーザに表示されるカレンダーを作成できます。この場合、カレンダー ポートレット(デフォルトでは、ユーザ ポートレットです)は共通領域のポートレットとしてコンフィグレーションする必要があります。

共通領域のポートレットのコンフィグレーション

この節では、ユーザ ポートレットは共通領域のポートレットとして再コンフィグレーション方法について説明します。カレンダー、アドレス帳、タスク、およびメール ポートレットはデフォルトでユーザ ポートレットです。

ヒント : 通常、メールは共有されるユーザ数の代わりに特定のユーザで使用されることを想定しているので、メール ポートレットは共通領域のポートレットとして再コンフィグレーションする必要がありません。
  1. ローカル プロジェクトにコンフィグレーションするポートレットをコピーする。そのためには、次の手順を行います。
    1. Workshop for WebLogic でマージ済みプロジェクト ビューを開く。(マージ済みプロジェクト ビューを開くには、[ウィンドウ|ビューの表示|マージ済みプロジェクト] を選択する。)
    2. 各ポートレット (ポートレット/コラボレーション フォルダにある) を右クリックし、[プロジェクトにコピー] を選択する。プロジェクトへのコピー機能の詳細については、「J2EE 共有ライブラリ内のポートレット」を参照してください。
  2. コピーした各ポートレットの名前を変更する。たとえば、Tasks.portlet を Tasks-Team.portlet に変更する。
  3. テキスト エディタで、各 .portlet ファイルを開いて、定義ラベルとタイトルを変更する。次に例を示す。
  4. 前:

    <netuix:portlet definitionLabel="task" title="My Task"
        lafDependenciesUri="/portlets/collaboration/collaboration.dependencies">

    後 :

    <netuix:portlet definitionLabel="task_team" title="Team Task"
        lafDependenciesUri="/portlets/collaboration/collaboration.dependencies">

  5. テキスト エディタで、PersonalAccountListener の代わりに CmAccountListener を使用するために、AccountListenerImpl が含まれる 各ポートレットの <netuix:meta> タグを変更する。次に例を示す。
  6. 前 :

    <netuix:meta name="collaboration.portlet.AccountListenerImpl"
        content="portlets.collaboration.common.c11n.PersonalAccountListener"/>

    後 :

    <netuix:meta name="collaboration.portlet.AccountListenerImpl"
        content="portlets.collaboration.common.c11n.CmAccountListener"/>

  7. .portlet ファイルを保存する。

コラボレーション ポートレットの使用

コラボレーション ポートレットの使用方法の詳細については、『WebLogic Portal GroupSpace ガイド』の「GroupSpace ポートレットの使用」章を参照してください。この節でこれまでにリストされたすべてのコラボレーション ポートレットは、この章で説明されています。

コラボレーション ポートレット ソース コードの使用

コラボレーション ポートレット用のソース コードは、この節で説明したように、WebLogic Portal 開発者が利用できます。

プロジェクトへのソース コードのコピー

ソース コードを使用するには、まずそれを J2EE 共有ライブラリからワークスペースにコピーする必要があります。

コラボレーション ポートレット用のソース コードは、J2EE 共有ライブラリ wlp-collab-portlets-web-lib にあります。このソース コードを使用するには、それを共有ライブラリからプロジェクト ワークスペースにコピーする必要があります。プロジェクトへのコピー機能の詳細については、「J2EE 共有ライブラリ内のポートレット」を参照してください。

コラボレーション ポートレット用の Java ソース コードは、WEB-INF/src/portlets にコピーされます。コラボレーション ポートレット コード用の Javadoc は、WEB-INF/src/javadoc.zip にコピーされます。

ソース コード免責事項

コラボレーション ポートレット用ソース コードを変更する場合、以下の免責事項に注意してください。

 


サードパーティのポートレット

ポータルに簡単に組み込むことができる特殊用途のポートレットが WebLogic Portal パートナ企業から提供されています。その企業は、Autonomy、Documentum、MobileAware などです。

以下の節で、サードパーティ ポートレットの詳細について説明します。

Autonomy ポートレット

WebLogic Portal には、Autonomy 製の検索機能のライセンスが付属しています。これらの機能を使用して、ポータルにエンタープライズクラスの検索を統合することができます。一般的な使用例として、コンテンツ管理システム、リレーショナル データベース、および外部 Web サイトとの統合があります。WebLogic Portal に付属する一部のポートレットを使用した検索では、これらの情報源を公開することができます。また、開発者は、ポータルに検索を統合するために新しいポートレットとビジネス ロジックを作成するとき、Autonomy API を使用することもできます。

WebLogic Portal 9.2 では、製の検索 API は非推奨になりました。検索機能を実装する場合は、Autonomy API を使用することをお勧めします。

Autonomy の詳細については、「検索の統合」を参照してください。

Documentum ポートレット

EMC Documentum は Oracle との提携のもと、EMC Documentum Content Services for Oracle Weblogic Portal を提供しています。この製品は、Oracle WebLogic Portal インフラストラクチャを通じて公開される Documentum 機能パッケージであり、この製品を使用すると、ユーザは、Web ページ、ドキュメント、音声や動画などのリッチ メディアを含む、あらゆるタイプのエンタープライズ コンテンツにアクセスして操作することができます。

ポートレット開発の立場から見たこの製品の重要な特徴は、Documentum ポートレットが組み込まれていることです。Documentum ポートレットはアプリケーション コンポーネントであり、標準的かつ強力なコンテンツ管理機能をポータル インタフェース経由でユーザに公開します。

Documentum ポートレットは、以下の 4 つの重要なアプリケーションを公開します。

WebLogic Portal の Documentum ポーレットの詳細については、「Documentum の Web サイト」を参照してください。

MobileAware ポートレット

Oracle Communication and Mobility Server では、マルチチャネル モバイル サービスを非常に短い期間で提供するために、Oracle WebLogic デプロイメントを拡張した標準ベースの非独占的環境を提供しています。企業は、従業員や顧客のために基幹システムの有効性を拡大でき、携帯電話会社は、データ中心の新しいサービスを迅速にデプロイできます。再トレーニングやツールの変更は不要です。

Oracle Communication and Mobility Server と WebLogic Portal での使用方法については、e-docs Web サイトの製品のドキュメントを参照してください。


  ページの先頭       前  次