ポータル開発ガイド

ポータル開発環境の設定

この章は、ポータル開発用に Workshop for WebLogic 環境を準備するときに使用します。この章では、ポータル EAR プロジェクト ウィザード、ポータル Web プロジェクト ウィザード、Datasync プロジェクト ウィザード、プロジェクトの追加/削除ダイアログ、WebLogic Domain Configuration Wizard について説明します。また、ポータルの開発に使用する際に役立つ Workshop for WebLogic インタフェースの機能についても説明します。

各ウィザードに関連するタスクを実行する方法の段階的な例については、『WebLogic Portal 入門』を参照してください。

この章の内容は以下のとおりです。

環境設定作業のロードマップ

必要な環境設定オプションは、「従来型」ポータル、コラボレーション ポータル、または GroupSpace アプリケーションのいずれを開発するかによって異なります。表 4-1 に、それぞれの場合に実施する基本タスクを示します。

ポータル パースペクティブ

このガイドの手順や図はポータル パースペクティブで表示されるビューを使用しています。

WebLogic Domain Configuration Wizard

この節では、WebLogic Portal パースペクティブに関連する Configuration Wizard のセクションについて説明します。

ドメインは、アプリケーション サーバを含む WebLogic Server リソースの集まりです。作成したポータルをテストするには、WebLogic Portal に対応したサーバ ドメインを用意する必要があります。このカスタマイズされたドメインは、一般にポータル ドメインと呼ばれます。

Domain Configuration Wizard はさまざまな方法で起動できます。ここでは、2 つの方法の概要について説明します。

ウィザードの最初のダイアログは、図 4-1 のようになります。

表 4-2 には、通常このウィザードに入力する値と、ポータル ドメインを設定するときに役立つ説明が示されています。

ポータル EAR プロジェクト ウィザード

この節では、WebLogic Portal エンタープライズ アプリケーション アーカイブ (EAR) プロジェクト ウィザードのダイアログについて説明します。

EAR プロジェクトは、デプロイメント用アプリケーションのコンポーネント プロジェクトの集まりです。エンタープライズ アプリケーションごとに 1 つの EAR プロジェクトを作成します。EAR プロジェクトには、JAR ファイル、デプロイメント記述子、ビルド ファイル、および自動生成ファイルがあります。Workshop for WebLogic の他のプロジェクトと EAR プロジェクトの関係については、『Oracle Workshop for WebLogic ユーザガイド』 の「Web アプリケーション」を参照してください。

ポータル EAR プロジェクトは、WebLogic Portal 用にカスタマイズされた EAR プロジェクトです。EAR プロジェクトは、ワークスペース内の他のプロジェクトの兄弟として表示されますが、機能上は、他のプロジェクトを結びつける役割を果たし、Web アプリケーションのコンテンツは備えていません。

ポータル EAR プロジェクト ウィザードを開始するには、以下の手順を実行します。

[新しいポータル EAR プロジェクト - Select Project Facets] ダイアログ

図 4-2 は、[新しいポータル Web プロジェクト - Select Project Facets] ダイアログの例を示します。

表 4-3 には、[Select Project Facets] ダイアログの WebLogic Portal 関連フィールドに関する説明が記載されています。ここで選択を行うと、プロジェクトを作成する際に使用可能なファイルが WebLogic Portal で作成され、プロジェクトに適切な一連の標準 J2EE ライブラリが関連付けられます。共有 J2EE ライブラリの詳細については、「WebLogic Portal および共有 J2EE ライブラリ」を参照してください。

[プロジェクトの追加および除去] ダイアログ

この節では、[プロジェクトの追加および除去] ダイアログについて説明します。このダイアログは、ポータル ドメインに EAR プロジェクトを関連付ける場合に使用します。ドメインの作成時に EAR プロジェクトが既に存在している場合は、サーバ ドメインの作成時にこの関連付けを行うことができます。それ以外の場合には、この節の手順を使用して後から関連付けを行うことができます。

サーバにポータル EAR プロジェクトを関連付けるには、以下の手順を実行します。

ポータル Web プロジェクト ウィザード

ポータル Web プロジェクト ウィザードを使用して、ポータル ファイルが格納された Web プロジェクトを作成します。ポータル Web プロジェクトを作成すると、ポータルを作成するときに使用できる共有 J2EE ライブラリとファイルのセットが作成されます。

ウィザードを起動するには、以下の手順を実行します。

[新しいポータル Web プロジェクト - ポータル Web プロジェクト]

図 4-4 は、[新しいポータル Web プロジェクト] ダイアログの例を示しています。

表  4-4 には、[新しいポータル Web プロジェクト - ポータル Web プロジェクト] ダイアログの各フィールドに関する説明が記載されています。

[新しいポータル Web プロジェクト - Select Project Facets] ダイアログ

[新しいポータル Web プロジェクト - Select Project Facets] ダイアログが表示されます (図 4-5 を参照)。

表 4-5 には、ダイアログの WebLogic Portal 関連フィールドに関する説明が記載されています。

[新しいポータル Web プロジェクト - Web Module] ダイアログ

[新しいポータル Web プロジェクト - Web Module] ダイアログが表示されます (図 4-5 を参照)。

表 4-6 には、ダイアログの各フィールドに関する説明が記載されています。

[新しいポータル Web プロジェクト - WebLogic Web モジュール] ダイアログ

[新しいポータル Web プロジェクト - WebLogic Web モジュール] ダイアログが表示されます (図 4-7 を参照)。

表  4-7 には、ダイアログの説明が記載されています。

ポータル Datasync プロジェクト ウィザード

datasync プロジェクトは、パーソナライズされたアプリケーションおよびポータルの開発に使用する汎用のポータル サービス データを格納する、オプションのプロジェクトです。これらのポータル サービスには、ユーザ プロファイル、セッション プロパティ、キャンペーンなどがあります。必要に応じて、1 つの datasync プロジェクトを複数の EAR プロジェクトで共有できます。

datasync プロジェクトを作成するには、以下の手順を実行します。

表 4-8 には、ダイアログの各フィールドに関する説明が記載されています。[次へ] をクリックすると、[EAR プロジェクト] ダイアログが表示されます。

新しい Datasync プロジェクトの作成 - EAR プロジェクト

[新しい Datasync プロジェクトの作成 - EAR プロジェクト] ダイアログが表示されます (図 4-9 を参照)。

このダイアログを使用すると、適切なポータル EAR プロジェクトのチェックボックスを選択できます。

デフォルト設定を使用して Datasync プロジェクトを追加すると、図 4-10 に示す [パッケージ・エクスプローラー] ツリーのようになります。

EAR プロジェクトと Web プロジェクトおよび Datasync プロジェクトの関連付け

EAR プロジェクトと Web プロジェクト (WAR ファイル) および Datasync プロジェクトの関連付けが必要です。ウィザードを使用してWeb プロジェクトまたはdatasync プロジェクトを作成する場合は、プロジェクトを EAR と関連付けることができます。EAR と関連付けない Web または datasync プロジェクトがある場合、または関連付けを変更する場合、この節の手順を実行して関連付けることができます。

EAR プロジェクトと Web プロジェクトの関連付け

パッケージ エクスプローラー ツリーでブプロジェクトを右クリックして、Web プロジェクト (WARファイル) を EAR に関連付けることができます。次にプロパティを選択して、J2EE Module Dependencies の設定を使用して、EAR にプロジェクトを関連付ける。

Ear プロジェクトと Datasync プロジェクトの関連付け

datasync プロジェクトを作成するときに EAR に関連付けない場合、後でこの手順を実行できます。[パッケージ・エクスプローラー] ツリーの datasync プロジェクトを右クリックして [プロパティー] を選択し、ツリーの [Datasync] ノードを展開して [EAR プロジェクト] を選択すると、このプロジェクトが EAR に関連付けられます。

マージ済みプロジェクト ビューの使用

WebLogic Portal マージ済みプロジェクト ビューは、ポータル パースペクティブにデフォルトで組み込まれています。このビューには、プロジェクト内のファイルの組み合わせが、関連付けられている共有 J2EE ライブラリを含めて一覧で表示されます。このビューには、ポータル開発プロジェクト用の重要な参照情報が表示されます。

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

マージ済みプロジェクト ビューの開始

ポータル パースペクティブを使用していない場合は、ワークベンチでマージ済みプロジェクト ビューを開く必要があります。そのためには、[ウィンドウ｜ビューの表示｜マージ済みプロジェクト] を選択します。

マージ済みプロジェクト ビューの操作

この節では、マージ済みプロジェクト ビューの利点について説明します。

マージ済みプロジェクト ビューには、イタリック体で表示される項目があります。イタリック体の項目は、J2EE の共有ライブラリに格納されているエンティティを表します。作成したポータル ファイルなど、ファイル システムに格納されているエンティティはすべて、通常の書体で表示されます。

特定のファイルを J2EE 共有ライブラリからコピーすることができます。ファイルはこのライブラリでユーザのファイルシステムに格納されます。そのためには、マージ済みプロジェクト ビューのファイルを右クリックして、[プロジェクトにコピー] を選択します。この機能は、ファイルを共有ライブラリからプロジェクト フォルダの適切な場所にコピーします。別の機能である [ワークスペースにコピー] をクリックして、ファイルをコピーする場所を選択します。

この機能を使用してすべてのファイルをコピーできるわけではありません。たとえば、.jar や .class ファイルはコピーすることができません。通常は、プロパティ ファイル、XML ファイルおよび編集可能なファイルをコピーすることができます。また、コピー対象から一部のファイルを除外する J2EE 共有ライブラリを作成することもできます。J2EE 共有ライブラリの詳細については、『プロダクション業務ガイド』を参照してください。

共有 J2EE ライブラリ名と、そのバージョンなどを含むマージ済みプロジェクト ビューで表示したファイルの J2EE ライブラリ情報を表示することができます。このためには、ファイルを右クリックして、[プロパティー] を選択します。

サーバでのプロジェクトの実行

プロジェクト開発で作成されたプロジェクトを実行して表示するには、次のいずれかのオプションを使用します。どちらのオプションを使用するかは、プロジェクトで加えられた変更やサーバが既に起動されているかどうかによって異なります。

次に、Project Explorer ビューのコンテキスト メニューで利用できるオプションについて説明します。

サーバの停止

実行を停止するには、以下のいずれかを実行します。

時折、開発中に手動で WLP サーバを停止する必要が生じる場合があります。(たとえば、サーバのコマンド ウィンドウで〔Ctrl〕+〔C〕を押します)。このような場合、複数の WLP サーバ処理が実行されている可能性があり、手動で停止する必要があります。処理の一覧は次のトピックを含める

パースペクティブのカスタマイズ

ビューの組み合わせはオプションで個別にカスタマイズできます。そのため、いつでも容易に元に戻すことができます。

ワークベンチの現在のレイアウトをパースペクティブとして保存するには、[ウィンドウ｜パースペクティブの別名保管] を選択し、[名前] フィールドにカスタマイズしたパースペクティブの名前を入力して、[OK] をクリックします。新しいパースペクティブが、[その他] カテゴリのリストに追加されます。

[ウィンドウ｜設定] オプションを使用すると、このパースペクティブを Workshop for WebLogic のデフォルト パースペクティブとして設定することもできます。詳細については、Eclipse のドキュメントを参照してください。

Workshop for WebLogic での WebLogic Portal 環境の設定

WebLogic Portal のさまざまなエディタや機能の動作に関する環境を設定できます。以下の節では、Workshop for WebLogic で WebLogic Portal 固有の設定にアクセスする手順について説明します。

WebLogic Portal セクションの環境設定

全般的なセクションでの WebLogic Portal の環境設定