Siebel Web Engine(SWE)を使用したOracle WebCenterアプリケーションでのデータ表示

このチュートリアルで は、Oracle WebCenterアプリケーションを使用して、Siebelデータを動的に問い合わせて、Siebel Web Engine(SWE)からのXML出力を解析する方法について説明します。

約20分

トピック

このチュートリアルでは、以下のトピックについて説明します。

このアイコンの上にカーソルを置くと、すべてのスクリーンショットがロードし、表示されます。 (警告:すべてのスクリーンショットが同時にロードされるため、ご使用のインターネット接続によってはレスポンス・タイムが遅くなる場合があります。)

注:各手順に関連したスクリーンショットのみ を表示する場合は、それぞれの手順にある各アイコンの上にカーソルを置いてください。

概要

このチュートリアルでは、Oracle JDeveloper StudioにアップロードするOracle WebCenterのビルトイン・アプリケーション上で、Siebelデータを実行し検索する方法について説明します。 これにより、SiebelとWebCenterの統合ニーズの基盤としてアプリケーションを利用できるようになります。 このチュートリアルでは、Oracle WebCenterアプリケーションの構築方法は言及しないことに注意してください。 詳しくは、関連情報のセクションを参照してください。

Oracle WebCenterは、統合されたコンテキスト認識型のユーザー・エクスペリエンスを提供する統合テクノロジ・セットです。構造化コンテンツと非構造化コ ンテンツ、ビジネス・インテリジェンス、ビジネス・プロセス、コミュニケーション、コラボレーションなどのサービスを統合します。 また、Oracle Fusion Middleware製品群の1つであり、オープンな標準ベースのアーキテクチャに基づいています。 Oracle WebCenterのおもな特徴は、Webベースのポータルとエンタープライズ・アプリケーションの境界を取り払い、作業環境を一変させる、次世代のコン テキストを中心とした複合アプリケーションの迅速な構築を可能にすることです。 Oracle WebCenter Frameworkは、Oracle JDeveloperに統合されており、ポートレット、コンテンツ、およびカスタマイズ可能なコンポーネントをアプリケーションに組み込むことができま す。

Siebel Web Engine(SWE)は、Siebelのユーザー・インタフェースのレンダリングを行います。 Siebel Web Templatesは、アプリケーションのリポジトリ定義に従ってSiebelオブジェクトをレンダリングする際に、Siebel Web EngineへHTMLレイアウト情報(マークアップ情報)を提供します。 SWEが返すマークアップは、XML認識型アプリケーションでレンダリングする場合はXMLに、ワイヤレス・デバイスでレンダリングする場合はWML(ワ イヤレス・マークアップ言語)に、それぞれ変換できます。 この例では、SWEにXMLとしてSiebelビューを返し、データ要素を解析して、Oracle WebCenterアプリケーションに結果を表示します。

SWEおよびWeb Templatesの詳細は、Siebel Bookshelf Guidesの『Siebel Portal Framework Guide』(特に外部のWebアプ リケーションへのコンテンツ配信に関する項)と『Configuring Siebel Business Applications Guide』を参照してください。

トピック・リストに戻る

シナリオ

まず、Siebel Call Centerにログインし、さまざまなビューを表示して、SWEが生成するXMLデータセットの構造を確認してください。 確認ができたら、Siebel向けにOracle WebCenterのビルトイン・アプリケーションを設定し、アプリケーションを実行します。 実行中のアプリケーションは、以下の図のとおりです。

終了したアプリケーション

Execute」をクリックすると、アプリケーションは 動的にSiebelデータを問い合わせて、Siebel Web Engineが返すXML出力を解析します。 返されたデータセットは、Order Detail表に表示されます。

 

トピック・リストに戻る

前提条件

このチュートリアルを始める前に次のことを確認してください。

1.

Oracle JDeveloper Studio Edition(10.1.3.3)にアクセスできるか、またはインストール済みであること。

このリリースには、Oracle WebCenterアプリケーションの構築に必要なすべての機能が含まれています。 Oracle JDeveloper Studio Editionは、Oracle Technology Network(http://www.oracle.com/technology/global/jp/software/products/jdev/htdocs/soft10134.html) からダウンロードできます。

2.

オラクルのSiebel eBusiness Applicationにアクセスできるか、またはインストール済みであること。 このOracle By Example(OBE)では、Call Centerと連携してSiebel eBusiness Applications 7.8を使用します。

 

3.

sweOBE.zipを ダウンロードし、c:\myworkディレクトリにコンテンツを解凍していること。このディレクトリは、以下の図にあ るとおり、ローカル・マシンに作成する必要があります。

注:これとは異なる最上 位ディレクトリを使用している場合は、アプリケーション・コードに簡単な修正を加える必要があります。

 

4.

Windows Internet Explorer(IE)7.0以上でアクセスすること。 ブラウザがSiebel Call Centerと互換性を持つ必要があります。

 

トピック・リス トに戻る

Siebel Call CenterのビューおよびXMLの確認

このトピックでは、Siebel Call Centerにログインして、さまざまなビューを表示し、次にSWEが生成するXMLデータセットの構造を確認します。

1.

Internet Explorerを開き、Siebel Call CenterのURLを入力します。

URLの構成は、http:// < hostname>/callcenter_<language>/start.sweです。 たとえば、http://myhost.oracle.com/callcenter_enu/start.sweに なります。

ブラウザは、IE 7など、Siebelで認定されているものを使用してください。

 

2.

有効なユーザーIDとパスワードを入力します。 ここでは、ユーザーIDとパスワードの両方にSADMINを使用します。 矢印をクリックしてログインします。

 

3.

ホームページで、「Accounts」タブをクリックしま す。

 

4.

アプリケーションで使用するビューを探すには、以下の手順に従います。

a.

My Accounts」 をクリックして、Accounts Listへ移動します。

 

b.

いずれかのアカウントをクリックします。

 

c.

Contactsの横にある矢印をクリックし、ポップリストを開きます。

 

d.

ポップリストでOrdersを探します。

これが、ページのベースとなるビューです。

 

5.

このビューのXMLを表示します。 XMLへアクセスするには、ブラウザのURLに以下のコードを付け加えます。 &SWECmd=GotoView&SWEView=Account+Detail+Orders+View&SWESetMarkup=XML&SWEDataOnly=TRUE&SWERowId0=6SIA-2ZIAL&SWEApplet0=SIS+Account+Entry+Applet

SWESetMarkup=XMLが設定されたことを確認します。 さらに、SWEがデータのみを返し、非データ制御などのユーザー・インタフェース情報(アンカーやナビゲーション制御など)を返さないよう、 SWEDataOnly=Trueを設定します。

注:スクリーンショットでは、読みやすいようにいくつかの ノードを閉じています。

 

6.

2つ目の<APPLET>要素にある<RS_DATA>要 素までスクロールし、データで公開されているフィールドを表示します。 XMLで返す際に使用されるフィールド名(Priority Status、Order Numberなど)があることを確認します。

いくつかのフィールド(Order Typeなど)には、値のセットが含まれる選択リストがあります。 これらの選択リストは、XMLの解析をより困難にします。

 

7.

Siebel Call Centerに戻ります(ブラウザの戻るボタンをクリックします)。 メイン・メニューから「Help」→「About View」を選択します。

 

8.

About Viewウィンドウには、この画面の詳細が表示されます。 ビューの名前(Account Detail - Orders View)とアプレット名を確認します。

指定されたアプレット[1](この例では、SIS Account Entry Applet)は、ビューのマスター・セクションを常に制御します。 次のセクションでは、ビュー名とアプレット名を使用します。

 

10.

OK」をクリックして、About Viewウィンドウを閉じます。

トピック・リス トに戻る

アプリケーションの設 定

このトピックでは、Oracle JDeveloper Studioに設定済みのOracle WebCenterアプリケーションをアップロードし、アプリケーションで使用する2つのプロパティ・ファイルを確認します。 Siebel環境に一致するよう、ファイルの1つを設定します。

1. Oracle JDeveloperを起動します。 解凍先のルート・ディレクトリ(<jdev_home>)にあるOracle JDeveloperの実行可能ファイル(「jdeveloper.exe」)をダブルクリックします。

Migrate User Settingsダイアログ・ボックスが開いたら、「NO」 をクリックします。

Tip of the Dayウィンドウを閉じます。

 

2.

アプリケーション・ナビゲータで「Applications」 (左上)を右クリックし、「Add to Applications」を選択します。


3.

Select application(s) to addダイアログ・ボックスで、c:\mywork\sweOBEへ 移動します。

 

4.

sweOBE.jws」を選択して、「Open」 をクリックします。 jws拡張子は、ファイルがOracle JDeveloperワークスペース(アプリケーション)のファイルであることを示しています。

 

5.

ナビゲータで「sweOBE」アプリケーションを開き、「ViewController」 →「Web Content」の順に開きます。

 

6.

ViewPage1.jsp」をダブルクリックして、 Visual Editorを開きます。

このページは、マスター形式の詳細を表示します。 上部フィールドに顧客レコードを入力したら、「Execute」をクリックします。 下部のブロックに、Siebelから出力されたデータが入力されます。

ページを実行する前に、設定ファイルを修正する必要があります。

 

7.

Windows Explorerを開き、SWEgeneral.propertiesを 検索します。

 

8.

WordPadでSWEgeneral.propertiesを 開きます。

 

9.

SiebelがあるWebサーバーのホスト名を入力します。 必要に応じて、SiebelAccountプロパティも修正します。

注:サンプル・アプリケーションのコードは、ログインする際 のユーザー名およびパスワードとしてSiebelAccount値を使用します。

ファイルを保存します。

 

10.

WordPadでorders.propertiesを開き ます。 ViewプロパティおよびAppletNameプロパティが事前に設定されていることに注意してください。 また、レコードIDを指定しない場合でも、自動的に顧客注文を問い合わせられるよう、デフォルトのレコードが定義されます。

フィールド名を見てください。 ファイルは、選択リストのフィールドも示すことに注意してください。 これは、XMLを解析する際に重要となります。

変更を加えずにファイルを閉じます。

 

 

トピック・リス トに戻る

ア プリケーションの実行

1.

Oracle JDeveloperで、ViewPage1.jspxページを実行します。 実行するには、ナビゲータで「ViewPage1.jspx」を右クリックし、コンテキスト・メニューから「Run」 を選択します。

 

2.

orders.propertiesで指定されたデフォルト・レコードを使用して、問合せが自動 で実行されたことを確認します。


3.

Siebel Call Centerに戻り、別の顧客レコード番号を探します。 任意のレコードを探すため、下までスクロールします。 メイン・メニューから「Help」→「About Record」を選択し、レコードID("row#")を探します。

 

4.

レコードIDをクリップボードにコピーします。

 

5.

実行中のページにあるRecord IDフィールドにIDを貼り付けて、「Execute」 をクリックします。 顧客の注文がOrder Detailブロックにリストされます。

 

トピック・リス トに戻る

ア プリケーションの確認

Oracle JDeveloperを詳しく見ながら、アプリケーションの構造とコードについて学習します。

1.

ナビゲータで「Application Sources」を 開き、「model.swetoadf」を開きます。

注:アプリケーションは、2つのプロジェクトを使用します。 Modelプロジェクトは、Order Detail表をベースとするデータ制御を構築する際に使用され、ViewControllerプロジェクトはユーザー・インタフェースを定義する際に使 用されます。 データ制御をユーザー・インタフェースから切り離すことは、常に効果的です。 Portletsプロジェクトは使用されません。

 

2.

sweData.java」をダブルクリックして Visual Editorを開き、コードの内容を確認します。

public static List<viewRecord> getView(String pZoneName,String pRecordID)
メソッドは、任意のレコードから列を収集する際に呼び出されます。pZoneName
orders.propertiesファイルを選択するために"orders"にハード・コードされており、レコードの属性が定義されています。


3.

SWEgeneral.propertiesファイルから、 Siebel Call Centerのアクセス・パラメータであるホスト名とアカウント名を取得します(これらは、この例でパスワードとしても使用されています)。

orders.propertiesファイルから、レコード の属性を取得します。 これらには、モジュールとアプレットの名前、デフォルト・レコード、任意のフィールド名、およびフィールド・タイプ(選択リストまたはスカラー値)が含ま れます。


4.

リクエストURLオブジェクトは、これらのパラメータから構築されます。 メソッド・コールでレコードが指定されていない場合、デフォルト・レコードが使用されます。

まず、URLがログインを実行し(SWECmd=ExecuteLogin ...)、適切なビュー、アプレット、XML形式のレコードから、データをリクエスト(SWECmd=GotoView ...)します。


5.

次に、DOM(ドキュメント・オブジェクト・モデル)パーサーが作成されます。これは、新しく構 築したURL(つまり、構築されたURLがリクエストされた際にSiebelから返されるもの)を解析します。

コードではオラクルのDOMパーサーを使用するため、最終ドキュメントはoracle.xml.parser.v2.XMLDocumentに 変換されることがあります。 このドキュメント・クラスのメリットは、標準に準拠しないselectNodes(<XPATH String>)メソッドを実装することです。これにより、XPATH式と一致するすべてのレコードのリストを返すことができます。


6.

構築したXPATH式は、指定されたAPPLETタグ(この場合、APPLET[2])の RSS_DATA要素から、APPLICATION/SCREEN/VIEW/APPLET[2]/LIST/RS_DATA/ROWの とおり、すべての列を選択します。 一致するノード("ROW")が、取得されます。

次に、orders.propertiesファイル(行1~5)で指定されたフィールドの値を取 得し、すべての列が処理されます。

最後に、すべての値は新しいviewRecordオブジェクトとしてパッキングされ、結果リスト に追加されます。

7.

valueOfFieldメソッド は、リクエストされたフィールドの値を現在の列から取得します。

いくつかのフィールドは、選択リストから値を取得します。 選択リストは、最初の列に対してのみ提供されます。

メソッドは、現在のROWノードからXPATH式の構築を開始します。 最初の列が処理され、フィールドが選択リストである場合、名前のついたフィールドのPICK_LISTのVALUE属性が使用されます。

../FIELD[@NAME='" + fieldName + "']/PICK_LIST / @VALUE)

フィールドが選択リストではない場合、値はフィールドの値になります。

./FIELD[@NAME='" + fieldName + "']

メソッドは、XPATH式で選択されたノードの値を返します。


8.

ナビゲータの「viewRecord.java」をダブルク リックして、ファイルを開きます。

これは簡単なJavaクラスで、5つのフィールドの値として5つの文字列のレコードを保持しま す。


9.

model.siebel」を開いて「orders.java」 をダブルクリックし、Visual Editorを開きます。

orders.javaは、sweDataクラスのgetViewメソッ ドを呼び出します。

アプリケーションを構築する際、このJavaクラスを使用してデータ制御を作成しました。作成方 法は、以下に示すとおり、ファイルを右クリックしてコンテキスト・メニューの「Create Data Control」を選択します。

作成されたXMLファイルには、データ制御について記述されています。

 

10.

アプリケーション・モデルを確認したところで、ViewPage1.jspxを クリックして再度ユーザー・インタフェースへ戻ります。 データ・コントロール・パレットにあるordersDataControlを 確認します。

このデータ制御は、ViewPage1.jspxを構築する際に2回使用しています。

完成したViewPage1.jspxは、以下のとおりです。


トピック・リス トに戻る

 

このレッスンでは、Oracle WebCenterアプリケーションを使用し、Siebelデータを動的に問い合わせて、Siebel Web Engine(SWE)からのXML出力を解析する方法について学習しました。

トピック・リス トに戻る

Oracle WebCenterの詳細は、下記のWebサイトを参照してください。

トピック・リス トに戻る

このアイコンの上にカーソルを置くと、すべてのスクリーンショットが 非表示になります。

 

 

 


Oracle Corporation発行の「Using the Siebel Web Engine (SWE) to View Data in a WebCenter Application」の翻訳版です。

この文書はあくまで参考資料であり、掲載されている情報は予告なしに変更されるこ とがあります。 万 一、誤 植などにお気づきの場合は、オラクル社までお知らせください。 オラクル 社は本書の内容に関していかなる保証もしません。 また、本 書の内容に関連したいかなる損害についても責任を負いかねます。

Oracle はオラクル社の登録商標です。
その他の会社名および製品名は、 あくまで その製品および会社を識別する目的にのみ使用されており、 それぞれ の所有者の商標または登録商標です。