サンプル ガイド

     前  次    目次     
ここから内容

動的訪問者ツールのサンプル

動的訪問者ツール (DVT) サンプル アプリケーションは特定の WLP と外部クライアント側の開発技術を使用して示しています。DVT サンプル アプリケーションの主要目的はクライアント側のポータル開発の可能性を強調表示します。

注意 : DVT サンプルは、プロダクション環境についてはサポートされていない。 DVT サンプルは、REST API、Disc API、および外部 Dojo ツールキットなどの WLP クライアント側の開発技術がポータルの双方向性を強化するには使用する方法を説明します。

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

 

DVT サンプル アプリケーションとは

動的訪問者ツール (DVT) サンプル アプリケーションは WebLogic Portal アプリケーションの動作、コンテンツ、および外観をカスタマイズするための非常にインタラクティブなツールを示しています。これらのサンプル ツールは、Disc API および REST API などの WLP 機能を使用することで、インタラクティブなユーザ インタフェース、特定のテキスト要素 (例えばタイトル) の部分編集、ブラウザの瞬時のリフレッシュなどを通じて、ユーザの知識向上に役立ちます。Disc と REST の詳細については、『クライアント側の開発者ガイド』を参照してください。

DVT の使用によって、以下ができます。

注意 : 前述のように、DVT サンプル アプリケーションはデモンストレーション用にのみ提供されています。DVT サンプルはプロダクション環境での使用を目的としていません。

 

ポータル サンプルのインストール

WLP のサンプル アプリケーションを使用する前に、ポータル サンプルの機能をインストールする必要があります。この機能は、使用可能な WLP サンプル アプリケーションおよびサンプル ドメインをインストールに追加します。デフォルトでは、ポータル サンプルはインストールされません。

Oracle WebLogic Portal インストーラ を使用してポータル サンプルをインストールします。新しいインストールまたは既存のインストールにサンプルをインストールするには、以下の手順を実行します。

  1. Oracle WebLogic Portal インストーラを実行して、カスタム インストールを実行するように選択する。
  2. [製品およびコンポーネント] ダイアログでは、[ポータル サンプル] を選択する。
  3. インストールを完了するためにウィザードを使用する。

 

あらかじめコンフィグレーションされている DVT サンプル アプリケーションの実行

WebLogic Portal は、あらかじめコンフィグレーションされているおよびすぐに実行される DVT サンプル アプリケーションを提供します。DVT サンプル アプリケーションにより、開発環境または管理環境を使用しなくても、DVT を経験することができます。この節では、DVT サンプル アプリケーションを起動する方法について説明します。

注意 : 動的訪問者ツール (DVT) 機能は、特定の WLP および外部クライアント側の開発技術を使用する WLP アプリケーションの例です。DVT サンプルは、プロダクション環境ではサポートされません。

Windows システム上であらかじめコンフィグレーションされている DVT サンプル アプリケーションを実行するには、

  1. [スタート | すべてのプログラム | Oracle Products | WebLogic Portal | Examples | Start Example Server] を選択します。
  2. サーバの起動後、[スタート | すべてのプログラム | Oracle Products | WebLogic Portal | Examples | Visit Portal Examples] を選択します。[WebLogic Portal のサンプル ドメイン] Web ページが表示されます。
  3. サンプルの Web ページで、[Go to the Dynamic Visitor Tools demo] をクリックし、ブラウザでサンプル アプリケーションを開きます。

 

デスクトップでの DVT の有効化

この節では、すべてのポータル デスクトップのため DVT を有効にする方法について説明します。この節では、次の基本手順について説明します。

  1. DVT ファセットの追加
  2. Workshop for WebLogic での動的訪問者ツールのコンフィグレーション
  3. ストリーミング デスクトップのための動的訪問者ツールの有効化
  4. DVT のテスト
ヒント : この手順に従って、Workshop for WebLogic でのチート シートも使用できます。チート シートを開くには、[ヘルプ | チート シート | Oracle WebLogic Portal | Create a Dynamic Visitor Tools Enabled Desktop] を選択します。

DVT ファセットの追加

動的訪問者ツールのサンプル ファセットを DVT に対して有効化したい Web プロジェクトに追加する必要があります。

注意 : これらの手順を実行する前に Portal Examples をインストールする必要があります。「ポータル サンプルのインストール」を参照してください。

そのためには、次の手順を行います。

  1. [ポータル Web プロジェクト] を右クリックして、[プロパティー] を選択します。
  2. プロパティ ダイアログで、[Project Facets] を選択し、[Add/Remove Project Facets] をクリックします。
  3. 図 2-1 に示すように、[Add/Remove Facets] ダイアログでは、[WebLogic Portal のサンプル | 動的訪問者サンプル ツール] を選択します。
    4. 図 2-1 DVT ファセットの選択


    DVT ファセットの選択

ファセットの追加の詳細については、『Portal 開発者のガイド』の「既存のプロジェクトへのファセットの追加」を参照してください。

Workshop for WebLogic での動的訪問者ツールのコンフィグレーション

Workshop for WebLogic での DVT 対応ポータルをコンフィグレーションするには

  1. Workshop for WebLogic では、ポータル エディタを使用してポータル (.portal ファイル) を開きます。
  2. ポータルのプロパティ エディタが開いていることを確認してください。これを開くには、[ウィンドウ | ビューの表示 | プロパティー] を選択します。
  3. 図 2-2 に示すように、デスクトップの境界線をクリックします。
    4. 図 2-2 デスクトップの境界線の選択


    デスクトップの境界線の選択

  4. プロパティ エディタでは、以下のプロパティを設定します。(図 2-3 を参照)

    5. 非同期モードを有効化

    DVT 有効化を true。この選択の後、Disc 対応のフィールドは自動的に true に設定されます。このフラグは、WLP フレームワークによってサポートされている動的の機能を有効にします。

    シェールを DVT Header-Footer Shell。この設定は、ポータルに対する DVT サンプルを有効にします。

    図 2-3 DVT 用のプロパティの設定


    DVT 用のプロパティの設定

  5. ポータルを保存します。
  6. サーバ上でポータルを実行します。これを行うには、ポータル ファイルを右クリックして、[実行｜サーバーで実行] を選択します。コンフィグレーション ファイル例を図 2-4 に示します。
注意 : DVT を有効にすると、ログイン UI は自動的に提供されます。DVT を表示および使用するには、ユーザの認証が必要です。
図 2-4 ポータル ページの初期コンフィグレーション

ポータル ページの初期コンフィグレーション

ストリーミング デスクトップのための動的訪問者ツールの有効化

動的訪問者ツールを有効にして .portal ファイルを作成した後は、テンプレートとして.portal ファイルを使用することで、ストリーミング デスクトップを作成して、いくつかの追加のコンフィグレーションを実行するのに Portal Administration Console を使用する必要があります。その後、デスクトップを開いて動的訪問者ツールをテストできます。(ストリーミング デスクトップの詳細については、『WebLogic のポータル開発ガイド』を参照。)

  1. ブラウザで Portal Administration Console を開いてログインします。
  2. 「Workshop for WebLogic での動的訪問者ツールのコンフィグレーション」に示すように、Workshop for WebLogic では、DVT に対して有効になっている .portal ファイルに基づくデスクトップを作成します。
  3. [デスクトップの作成] ダイアログで、[DVT Header-Footer Shell] というシェルを選択します。
  4. (省略可能) ポートレットをデスクトップ ページに追加します。図 2-4 は、ログイン ポートレットおよび2 つのテスト ポートレットを含むサンプル ポータルを示します。

DVT のテスト

DVT をテストするには、次の手順に従います。

  1. ブラウザにデスクトップを表示するには、Administration Console では [デスクトップの表示] を選択します。
  2. ユーザ名とパスワードを入力してから[ログイン] をクリックして、デスクトップにログインします。図 2-5 に示すように、デスクトップが更新され、[DVT カスタマイズ] メニューが表示されます。
    3. 図 2-5 DVT 対応のデスクトップ


    DVT 対応のデスクトップ

  3. 図 2-6 に示すように、[カスタマイズ] メニューをクリックして、[DVT カスタマイズ ドロップダウン] ダイアログを表示します。
    4. 図 2-6 [DVT カスタマイズ ドロップダウン] ダイアログ


    [DVT カスタマイズ ドロップダウン] ダイアログ

デフォルトでは、[DVT カスタマイズ ドロップダウン] ダイアログは次の機能を提供します。

ヒント : これらの機能は、Administration Console を使用している管理者が使用できる機能のサブセットです。ただし、ユーザが DVT でデスクトップを変更した場合、そのユーザのみに対して、これらの特定の変更が保存され、永続化されます。

DVTのカスタマイズ

注意 : DVT サンプルと開発者追加のどちらもサポートされていません。

必要に応じて、DVT JavaScript のソース ファイルを変更して、DVT サンプルをカスタマイズすることができます。ソース ファイルは J2EE 共有ライブラリに保存されています。Workshop for WebLogic のマージ済みプロジェクト ビューにこのライブラリの内容を表示することができます。DVT ソースは、ポータル Web アプリケーション内の samples/dvt フォルダにあります。ファイルを編集するには、それを共有ライブラリから抽出する必要があります。マージ済みプロジェクト ビューで、変更対象のイタリック表示のファイルをクリックします。右クリックして、[ロジェクトにコピー] を選択します。これにより、Web プロジェクト内にファイルのコピーが作成され、このコピーはライブラリ モジュールにあるデフォルト バージョンをオーバーライドします。

 

Workshop for WebLogic の外での DVT サンプルのデプロイ

注意 : この節では、コンフィグレーション ファイルを編集および EAR を再デプロイする基本シナリオについて説明します。詳細再デプロイメント オプションについては、WebLogic Server ドキュメントの「weblogic.deployer を使用してアプリケーションおよびモジュールのデプロイ」を参照してください。

DVT サンプル アプリケーションを含むポータル Web アプリケーションが Workshop for WebLogicの外部であるドメインにデプロイされると、この節で説明されているように、ドメインの config.xml ファイルを手動で編集する必要があります。

たとえば、EAR ファイルを作成するおよび DVT サンプル ファセットを含む EAR ポータル Web アプリケーションに追加するために Workshop for WebLogic を使用します。その後、Workshop for WebLogic から EAR ファイルをエクスポートして新しいポータル ドメインに EAR をデプロイする場合、デプロイメント エラーが発生します。次の手順を実行しなければ、アプリケーションをデプロイできません。

  1. サーバを停止します。
  2. DOMAIN_HOME/config/config.xml ファイルを開きます。
  3. コード リスト 2-1 に示すように、ライブラリ要素をファイルに追加します。<WLPORTAL_HOME> 用の正しいパスで置き換えることを確認します。
  4. ファイルを保存します。
  5. サーバを再起動します。
  6. EAR を再デプロイします。
    7. コード リスト 2-1 config.xml に追加する要素 
    <library>
        <name>wlp-sample-lookandfeel-web-lib#10.3.0@10.3.0</name>
        <target>AdminServer</target>
        <module-type>war</module-type>
        <source-path>
         WLPORTAL_HOME\samples\lib\j2ee-modules\wlp-sample-lookandfeel-web-lib.war
        </source-path>
        <security-dd-model>DDOnly</security-dd-model>
    </library>
    <library>
        <name>wlp-sample-dvt-web-lib#10.3.0@10.3.0</name>
        <target>AdminServer</target>
        <module-type>war</module-type>
        <source-path>
          WLPORTAL_HOME\samples\lib\j2ee-modules\wlp-sample-dvt-web-lib.war
        </source-path>
        <security-dd-model>DDOnly</security-dd-model>
    </library>

  ページの先頭       前  次