Oracle® Fusion Middleware Oracle WebCenter Portal開発者ガイド 11g リリース1 (11.1.1.7.0) B72084-02 |
|
前 |
次 |
この章では、開発環境を設定するために実行する必要があるタスクについて説明します。
この章には次の項が含まれます:
Oracle JDeveloperは、WebCenter Portal: Frameworkアプリケーションの開発のために、統合された開発環境を提供します。Oracle JDeveloperの取得およびインストールの詳細は、次に示すOTNのOracle JDeveloperに関するページを参照してください。
http://www.oracle.com/technetwork/developer-tools/jdev/overview/index.html
Frameworkアプリケーションの開発を開始する前に、WebCenter PortalのOracle JDeveloper用拡張機能をインストールする必要があります。WebCenter Portalの拡張機能は、JDeveloper Studio EditionにWebCenter機能の完全セットを提供するJDeveloperのアドインです。
WebCenter Portalの拡張機能をインストールするには:
Oracle JDeveloperを起動します。
「デフォルトのロールの選択」ダイアログが表示される場合は、「デフォルトのロール」を選択してすべてのテクノロジを有効にし、「OK」をクリックします。
以前のバージョンから設定を移行するかどうかを尋ねるダイアログが開く場合は、「いいえ」をクリックします。
「ヘルプ」メニューから「更新のチェック」を選択します。
更新のチェック・ウィザードの「ようこそ」ページで、「次へ」をクリックします。
「ソース」ページの「更新センターの検索」で、WebCenter Portalの拡張機能を検索して選択し、「終了」をクリックします。
要求されたら、JDeveloperを再起動します。
これでJDeveloperは、WebCenter Portal: Frameworkアプリケーションおよびポートレット・プロデューサ・アプリケーションを作成するように構成されます。
Oracle WebCenter Portal: Frameworkの取得およびインストールの詳細は、次に示すOTNのOracle WebCenter Portalに関するページを参照してください。
JDeveloperで参照するユーザー・ホーム・ディレクトリの環境変数を設定することを強くお薦めします。この変数を設定することで、状況次第で発生することが確認されている、長いパス名のエラーを受け取らずに済みます。
この変数の、Windows、Linux、UNIXおよびMac OS Xオペレーティング・システムでの設定の詳細は、『Oracle Fusion Middleware Oracle JDeveloperインストレーション・ガイド』のユーザー・ホーム・ディレクトリの設定に関する項を参照してください。
Oracle WebCenter Portal: Frameworkをインストールすると、JDeveloper内の統合WebLogic Server (WLS)ドメインが再構成され、ライブラリや複数の事前構築ポートレットが追加されます。この項では、統合WLSについて(起動方法や停止方法を含めて)説明し、事前構成済のポートレット・プロデューサの一部と、それにより提供される事前構築済のポートレットについて説明します。次のサブセクションが含まれます:
統合WLSを起動するためのオプションは、Oracle JDeveloperの「実行」メニューで使用できます。
統合WLSをデバッグ・モードで起動するには、「実行」メニューで「サーバー・インスタンスのデバッグ」を選択します。
サービスをデバッグ・モードで実行すると、サービスのデバッグに役立ちます。
統合WLSを標準モードで起動するには、「実行」メニューで「サーバー・インスタンスの起動」を選択します。
統合WLSが実行中かどうかを判断したり、停止する方法はいくつかあります。
「終了」メニューには、実行中のサーバーおよびデプロイ済アプリケーション(ある場合)の一覧が表示されます。(図3-1)。サーバーを停止(またはアプリケーションをアンデプロイ)するには、このメニューから選択します。
「実行」メニューで「終了」を選択し、停止するサーバーを選択します。
ブラウザから統合WLSのコンソールにアクセスします。
http://localhost:7101/console
注意: WebLogic Serverはアクセスできない状態になることがあります(シャットダウンが正常終了する前に、ユーザーがWebLogic Serverの再起動を試みた場合など)。この場合は、Javaプロセスを手動でシャットダウンまたは停止してください。 |
統合WebLogic Server(統合WLS)は事前構成済のWebLogic Serverであり、完全なJava 2 Enterprise Edition (Java EE) 1.4準拠の環境が提供されます。これはすべてJavaで記述されており、標準Java Development Kit (JDK)のJava仮想マシン(JVM)で実行されます。WebLogic Serverは、オペレーティング・システムに用意されている標準JDKでも、Oracle JDeveloperに用意されているJDKでも実行できます。
統合WLSは、Oracle JDeveloperからアプリケーション・サーバー接続を確立することで、Frameworkアプリケーションのデプロイをローカル・コンピュータ上で事前テストするためのプラットフォームとして使用できます。統合WLSでアプリケーションを実行すると、実際にそのアプリケーションは、アプリケーション・サーバーのWebLogic Serverインスタンスにデプロイしているようにデプロイされます。統合WLSの詳細は、第69.3項「WebLogic管理対象サーバーへのFrameworkアプリケーションのデプロイ」を参照してください。
注意: 次の場所にある
JDEV_SYSTEM_DIRECTORY/DefaultDomain/bin/
デフォルトのメモリー値は、次のとおりです。 -Xmx512m -XX:PermSize=128m -XX:MaxPermSize=512m
|
WebCenter事前構成サーバーのReadmeファイルには、統合WLSの使用方法に関する有用な情報が含まれています。また、事前構成ポートレット・プロデューサへのリンクも含まれています。Oracle JDeveloperの「ヘルプ」メニューでWebCenter事前構成サーバーのReadmeを選択すると、事前構成サーバーのReadmeファイルにアクセスできます。
WebCenter事前構成済サーバーには、アプリケーション・ページに追加できる、すぐに使用可能な様々なポートレットが用意されています。デフォルト・サーバーに含まれているプロデューサをFrameworkアプリケーションに登録し、Oracle JDeveloperの「アプリケーション・リソース」パネルからそのプロデューサのポートレットを選択するのみです。
この項では、事前構成プロデューサと、これらのプロデューサで提供されるポートレットの一部について簡単に説明します。次のサブセクションが含まれます:
ポートレット・プロデューサの登録とページへのポートレットの追加の詳細は、第62章「ポートレットの消費」を参照してください。
統合WLSには、実行時に設計のOmniPortletとWeb Clippingポートレットへのアクセスを提供する、PortalToolsが含まれています。「実行時に設計」とは、ポートレットがアプリケーション・ページ上に配置されてページが実行された後で、ユーザーがポートレット・コンテンツを定義するという意味です。
OmniPortletおよびWebクリッピング・ポートレットのプロデューサにアクセスするには:
統合WLSを起動します(第3.4.1項を参照)。
「ヘルプ」メニューからWebCenter事前構成サーバーのReadmeを選択します。
Readmeファイルで、見出し「Preconfigured Portlet Producers」に移動し、「PortalTools Portlet Producers」の下の「PortalTools Welcome Page」リンクをクリックします。
これによってPortalToolsの「ようこそ」ページが開きます。
PortalToolsの「ようこそ」ページで、「Webクリッピング・プロデューサ」リンク、OmniPortletプロデューサ・リンクまたは「サンプル・ポートレット・プロデューサ」リンクのURLをコピーして、Oracle PDK-Javaポートレット・プロデューサの登録ウィザードでプロデューサURLとして使用します。
プロデューサを登録すると、そのポートレットがOracle JDeveloperの「アプリケーション・リソース」パネルで使用可能になります。「アプリケーション・リソース」パネルの「接続」ノードで、プロデューサ名を選択してそのポートレットをリスト表示し、Frameworkアプリケーション・ページにポートレットをドラッグします。(ページへのポートレットの追加の詳細は、第62.6項「ページへのポートレットの追加」を参照してください。)
PortalToolsの「ようこそ」ページに、次のプロデューサURLが表示されます。
「Webクリッピング・プロデューサ」ではWebクリッピング・ポートレットが提供されます。これは、別のWebソースからのコンテンツの動的な再利用を可能にする、ブラウザベースの宣言型ツールです。ソースが変更されると、Webクリッピング・ポートレットのコンテンツも変更されます。Webクリッピング・ポートレットでは、Webブラウザを使用して、目的のコンテンツを含むWebページにナビゲートします。ポートレットを介してアクセスするWebクリッピング・スタジオを使用して、ターゲット・ページのビジュアル・レンダリングをドリルダウンし、目的のコンテンツを選択します。Webクリッピング・ポートレットの詳細は、第64章「Webクリッピングを使用したコンテンツ・ベースのポートレットの作成」を参照してください。
注意: Webクリッピング・ポートレットは、リリース11g (11.1.1.7.0)では非推奨になっています。Oracle WebCenter Portalのページレット・プロデューサを使用してクリップ・ページレットを使用することを検討してください。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のOracle WebCenter Portalのページレット・プロデューサの管理に関する項を参照してください。 |
OmniPortletプロデューサではOmniPortletが提供されます。これは宣言型のポートレット構築ツールで、このツールを使用すると、XMLファイル、複数値を特定文字で区切ったファイル(スプレッドシートなど)、Webサービス、データベース、WebページおよびSAPデータ・ソースを含めた多様なデータ・ソースに対してポートレットを構築できます。OmniPortletユーザーは、データに対して事前に作成されたレイアウトを選択することもできます。事前に作成されたレイアウトには、表、ニュース、箇条書き、フォーム、チャートまたはHTMLが含まれます。OmniPortletの詳細は、第63章「OmniPortletを使用したポートレットの作成」を参照してください。
サンプル・ポートレット・プロデューサは、OmniPortletの機能を例証する際に有用です。サンプル・プロデューサはデモ用のため、実際のポートレット・インスタンスの作成には使用しないでください。
統合WLSには、アプリケーションで使用できるサンプルのWSRPポートレット・プロデューサとポートレットが含まれています。
注意: 次のEARファイルに、サンプル・ポートレット用のソース・コードがあります。
|
WSRPサンプル・ポートレット・プロデューサにアクセスするには:
統合WLSを起動します(第3.4.1項を参照)。
「ヘルプ」メニューからWebCenter事前構成サーバーのReadmeを選択します。
Readmeファイルで、「Preconfigured Portlet Producers」という見出しに移動し、「WSRP Portlet Producers」の下の「WSRP Tools Portlet Producer」または「Sample Portlet Producer」のリンクをクリックします。
これらのリンクでは、異なるWSRPプロデューサ・テスト・ページが開きます。一方のページにはパラメータ・フォーム・ポートレットとパラメータ表示ポートレットがあり、もう一方はサンプル・ポートレットの各種WSRPプロデューサ用のページです。
WSRP v1 WSDLまたはWSRP v2 WSDLの、いずれかのWSRPプロデューサのWeb Services Description Language (WSDL) URLをコピーします。
WSRPプロデューサの登録ウィザードで、コピーしたリンクをプロデューサURLとして使用します。
ポートレット・プロデューサ接続の登録先に応じて、そのポートレットは「アプリケーション・リソース」または「リソース・パレット」に表示されます。ここから、各種ポートレットをFrameworkアプリケーション・ページにドラッグ・アンド・ドロップできます。
統合WLSには、アプリケーションで使用できるサンプルのPDK-Javaポートレット・プロデューサとポートレットが含まれています。PDK-Javaポートレットで使用できる機能のタイプは、PDK-Javaサンプル・ポートレットを使用して確認できます。
PDK-Javaサンプル・ポートレット・プロデューサにアクセスするには:
統合WLSを起動します(第3.4.1項を参照)。
「ヘルプ」メニューからWebCenter事前構成サーバーのReadmeを選択します。
Readmeファイルで、「Preconfigured Portlet Producers」という見出しに移動し、「PDK-Java Portlet producers」の下の「PDK-Java Sample Producer」または「PDK-Java Struts Sample Producer」リンクの場所をコピーします。
Oracle PDK-Javaポートレット・プロデューサの登録ウィザードで、コピーしたリンクをプロデューサURLとして使用します。
ポートレット・プロデューサ接続の登録先に応じて、そのポートレットは「アプリケーション・リソース」または「リソース・パレット」に表示されます。ここから、各種ポートレットをFrameworkアプリケーション・ページにドラッグ・アンド・ドロップできます。
特定のOracle WebCenter Portalコンポーネントを使用するには、スキーマがサポート対象データベースにインストールされている必要があります。この項では、Oracle、SQL Server、およびDB2データベースに対するスキーマのインストールについて説明します。
WebCenterがサポートしているデータベースの詳細は、OTNのドキュメント、Oracle Fusion Middlewareのサポート対象システムの構成を参照してください。
表3-1は、WebCenterで使用するスキーマと、スキーマのインストール方法のリストです。すべてのスキーマに対して、リポジトリ作成ユーティリティ(RCU)を使用する方法をお薦めします。ただし、WebCenter Portalのスキーマには、後述するSQLスクリプトを使用したインストール・オプションがあります。
表3-1 データベース・スキーマのサマリー
スキーマ | 説明 | インストール方法 |
---|---|---|
WebCenter |
タグ、リンク、リスト、投票およびピープル・コネクションのサービスを使用するには、データベースにWebCenter Portalのスキーマがインストールされている必要があります。 |
|
ポートレット |
ポートレット・プロデューサでのカスタマイズ内容の格納用。 |
RCUのみ |
アクティビティ |
アクティビティ・グラフおよび分析製品用。 |
RCUのみ |
ディスカッション/WebCenter Portalディスカッション・クローラ |
ディスカッションおよびお知らせサービスのバックエンドとして使用します。 |
RCUのみ |
WebCenterのデータベース・スキーマは、すべてRCUを使用してインストールすることをお薦めします。詳細は、Oracle Fusion Middlewareリポジトリ作成ユーティリティ・ユーザー・ガイドのスキーマの作成に関する項を参照してください。
タグ、リンクおよびピープル・コネクションのサービスを使用するには、データベースにWebCenter Portalのスキーマがインストールされている必要があります。これは、前の手順で使用した組込みSQLワークシート・ユーティリティを使用して実行できます。
WebCenter Portalスキーマをインストールするには:
「ツール」メニューから「SQLワークシート」を選択します。
「接続の選択」ダイアログで鉛筆のアイコンをクリックして接続を編集します。
管理者(たとえばSYS
)のユーザー名とパスワードを使用するように接続を変更して(SYSDBA
ロールを使用)、「OK」をクリックします。
「OK」をクリックして「接続の選択」ダイアログを閉じます。
「ツール」メニューから「SQLワークシート」を選択します。
「SQLワークシート」パネルで次のSQL文を入力します。
@@JDEV_HOME/jdeveloper/jdev/extensions/oracle.webcenter.install/sql/oracle/wc_schema.sql
JDEV_HOME
は、マシンにJDeveloperをインストールした場所です。
「文を実行」アイコンをクリックするか、[F9]を押してスクリプトを実行します。
プロンプトから、スキーマの名前としてwebcenter
を入力し、パスワードにwelcome1
などを入力します。スキーマの名前は、必ずwebcenter
にします。
「デフォルト表領域」と「一時表領域」の入力を求められた場合は、デフォルト値のusers
およびtemp
を再入力してこれらを受け入れます。
第26.2.3項「SharePoint用Oracle WebCenterアダプタに基づいてコンテンツ・リポジトリ接続を作成する方法」で説明するように、SharePoint用Oracle WebCenter Portalアダプタを構成する前に、これをJDeveloperにインストールする必要があります。
アダプタのファイルはOracle WebCenter PortalコンパニオンDVDに収録されているofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zip
ファイルの中にあります。このZIPファイルを一時的な場所に抽出すると、TEMP_LOCATION
/WebCenter/services/content/adapters
ディレクトリ内にアダプタのファイルが見つかります。
アダプタをインストールするには:
Oracle JDeveloperを起動します(まだ起動していない場合)。
「ヘルプ」メニューから「更新のチェック」を選択します。
更新のチェック・ウィザードの「ようこそ」ページで、「次へ」をクリックします。
「ソース」ページで、「ローカル・ファイルからインストール」を選択し、TEMP_LOCATION
/WebCenter/services/content/adapters
ディレクトリからoracle.webcenter.content.jcr.sharepoint.ear
を選択します。これは、Oracle WebCenter PortalのコンパニオンDVDからofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zip
ファイルの内容を抽出した一時ディレクトリです。
「終了」をクリックします。要求されたら、JDeveloperを再起動します。