データベースに接続できるように、接続プールとデータソースを作成します。

a.

Oracle Enterprise Manager Application Server Controlで、「Home」リンクをクリックします。

.

b.

OC4Jインスタンスのホームページで、「Administration」リンク を選択します。

c.

使用可能な管理タスクのリストで、「Services」→「JDBC Resources」タスクを選択して、「Go To Task」アイコンをクリックします。

d.

Connection Poolsセクション の「Create」ボタンをクリックします。

Create Connection Pool - Applicationで、デフォルト値を受け入れて「Continue」をクリックします。 このチュートリアル用の新しい接続プールを作成します。

Create Connection Poolフォームに次の情報を入力します（ここで指定しないフィールドはデフォルト値のままにします）。 このチュートリアルのタスクを実行するために、アクセスするデータベースに応じてDB Host Name、SID/Service Name、Username、およびPasswordの値を置き換えます。

上記の詳細を入力した後、「Test Connection」ボタンをクリックし ます。

Test Connectionウィンドウで、「Test」ボタンをクリックし て、サンプルのSQL文で接続をテストします。

Create Connection Poolウィンドウをアクティブ化して、接続成功のメッセージを確認します。 エラー・メッセージを取得した場合、URLおよび資格証明を参照して適切な情報が入力されていることを確認します。

「Finish」をクリックします。

ebiz_pool接続が作成されていることを示すメッセージを確認します。 Connection Poolsセクションのebiz_poolエントリも確認します。

次に、データソースを作成します。

JDBC Resourcesページで、Data Sourcesセ クションの「Create」ボタンをクリックします。

Create Data Source - Application & Typeページで、デフォルト値を受け入れて「Continue」をクリックします。 管理データソースを作成し ます。 このデータソースは、OC4J接続プーリング機能を使用します。このため、上記の手順で作成した接続プールをここで使用できます。

Create Data Source - Managed Data Sourceページで、次の表に示されているデータソースの詳細を入力します。 上記の詳細を入力した後、「Finish」をクリックしま す。

ebizDataSourceデータソースが作成されていることを確認します。 Data Sourcesセクションのエントリも確認します。

Oracle Applications Adapter接続を作成します。 この接続は、販売注文の情報をOracle E-Business Suiteに伝播するために必要です。

Oracle Application Server Controlページで、 ページ上部の「Cluster Topology」ブレッドクラム・リンクを選択します。

.

MembersセクションのView Byドロップダウン・リスト で、「Applications」を選択して、OC4Jホーム・インスタンスのすべてのアプリケーションを表示します。

.

開いたApplicationsツリーからdefaultアプリケーションのリン クをクリックします。

Modulesセクションで、AppsAdapterリソース・ア ダプタ・モジュールに対応するリンクをクリックします。

Resource Adapter: Oracle Applications Adapterページで、「Connection Factories」リンクを選択します。

Connection Factoriesの「Create」をクリックします （Shared Connection PoolsセクションのCreateボタンではなく画面上部のCreateボタンを使用します）。

Create Connection Factory: Select Interfaceページで、Connection Factory Interfaceのデフォルト値を受け入れて「Continue」 をクリックします。

Create Connection Factoryページで、JNDI Locationとしてeis/Apps/appsSampleを入力します。 Configuration Propertiesで、xADataSourceNameの値にjdbc/ebizDataSourceを 入力します。 他のすべてのフィールドのデフォルト値を受け入れます。 「Finish」をクリックします。

コネクション･ファクトリが作成されていることを示すメッセージを確認します。

Oracle SOA Suiteを再起動します。 「スタート」→「すべ てのプログラム」→「[Oracle_Home]」→「Stop SOA Suite」へ移動します。

メッセージを確認した後、「スタート」→「すべてのプログラム」→ 「[Oracle_Home]」→「Start SOA Suite」を選択します。

この手順では、事前にパッケージ化されたBPELプロセスを配置します。 このプロセスは、アダプタを通じて事前に構成されたXMLファイルから販売注文を読み取り、AppsAdapterを通じてOracle E-Business Suiteにこの注文を伝播します。

Oracle SOA Suiteを再起動します。 「スタート」→「すべ てのプログラム」→「[Oracle_Home]」→「Stop SOA Suite」へ移動します。

メッセージを確認した後、「スタート」→「すべてのプログラム」→ 「[Oracle_Home]」→「Start SOA Suite」を選択します。

Oracle SOA Suiteをインストールした[ORACLE_HOME]ディレクトリ構造のAppsAdapterサンプル・チュートリアルにアクセスします。 このタスクを実行するには、[ORACLE_HOME]\bpel\samples\tutorials\150.AppsAdapter\OrderImportConcurrentProgram\bpelフォ ルダへ移動します。

「bpel.xml」ファイルを右クリックし、「Edit」を選択 して、このxmlファイルを編集します。

bpel.xmlを編集して、ファイル・アダプタの同期読取り操作の物理ディレク トリを指定します。 以下に示すように、getOrderDetailsエントリに関連するコード・セグメントで、AppsAdapter サンプルがインストールされるフォルダ・パスにLogicalDirectoryエントリが設定されていることを確認します（このパスは、Oracle SOA Suiteをインストールしたディレクトリに応じて異なります。たとえば、Oracle SOA Suiteをインストールしたフォルダに、c:\SOASuite10131を置き換えます）。

<partnerLinkBinding name="getOrderDetails">
<property name="wsdlLocation">getOrderDetails.wsdl</property>
<property name="inputDir" type="LogicalDirectory">
c:/SOASuite10131/bpel/samples/tutorials /150.AppsAdapter/OrderImportConcurrentProgram/inputDir
</property>
<property name="retryInterval">60</property>
</partnerLinkBinding>

必要に応じてbpel.xmlファイルに変更を加えた後、BPELプロセスのコンパイルと配置を 行う必要があります。 このタスクを実行するには、「スタート」→「すべてのプログラム」→「Oracle_SOA」 →「Oracle BPEL Process Manager」→ 「Developer Prompt」へ移動します。

これによって、コマンド・プロンプト・ウィンドウが開きます。 コマンド・プロンプト・ウィンドウで、以下の手順を実行します。

コマンド・プロンプト・ウィンドウで、OrderImportDemoプロジェク トのbuild.xmlが格納されているフォルダにディレクトリを変更します。 次のスクリーンショットは、ディレクトリのパスの例を示しています。

次に、obantコマンドを実行して、BPELプロセスのコンパイルと配置を行い ます。 ビルドが成功していることを示すメッセージを確認します（次のスクリーンショットは、コンパイル/配置プロセス中に確認するメッセージの一部のみを示して います）。

order_data.xmlファイルを編集します。 [BPEL_samples]\150.AppsAdapter\OrderImportConcurrentProgram\inputDirのディレ クトリ構造からこのファイルを開きます。

「order_data.xml」ファイルを右クリックして、「Edit」 を選択します。

3回表示される"order_id_01"をすべて検索して、デフォルト以外の値 に置き換えます。 たとえば、123456を設定します。 (注：Oracle E-Business Suite内にこの注文IDの注文がすでに存在することがあるので、この手順を実行する必要があります。） ファイルを保存します。

Oracle BPEL Consoleへ移動し、ダミーの文字列を入力してプロセスを開始します。 ブラウザ・ウィンドウで、Oracle BPEL Consoleを起動するためにhttp://<host>:<port>/BPELConsole（デフォルトのポート は8888）
の形式でURLを設定します。 ページが開けないことを示すエラーを受け取った場合、「スタート」→「すべてのプログラム」 →「Oracle_SOA」→「Oracle BPEL Process Manager」→「BPEL Control」へ移動して、コンソール・ページを起動します。

デフォルトのログイン・ユーザーIDはbpeladminで、デフォルトのパス ワードはwelcome1です。

DashboardまたはBPEL ProcessesタブのDeployed BPEL Processesリストから「OrderImportDemo」リンクを選択します。

Initiateセクションで、テスト・インスタンスを開始する値としてdummyを 設定し、「Post XML Message」ボタンをクリックします。

テスト・インスタンスが開始されてインスタンスが非同期に処理されることを示すメッセージを確認 します。 「Visual Flow」ダイアグラムをクリックして表示します。

結果のビジュアル・フロー・ダイアグラムは、オープン・インタフェースおよび同時プログラム・ サービスの起動に成功したことを示しています。

Auditタブへ移動して「View Raw XML」リンクをクリックすると、 特定のインスタンス用に生成されるXMLファイルを表示できます。

結果のXMLファイルの断片が以下に表示されています。 前の手順で設定した注文IDの123456を確認します。

Navigatorセクションで使用できる権限のリストを下方向にスクロールして、「Order Management Super User, Vision Operations (USA)」権限をクリックします。次に、結果ペインから スクリーンショットの2つ目のフレームでハイライトされている「Sales Order」を選択します。 注：画面の一部が表示されない次のスクリーンショットよりも多くの値を表示する場合があります。

上記の手順によって、Oracle Applications 11iブラウザ・ ウィンドウが開きます。このウィンドウとOrder Management Super User, Vision Operations (USA) NavigatorフォームおよびSales Orders - [New]フォームを含むOracle Applications - Visionウィンドウを閉じないように求めるメッセージが表示されます。

Order ReturnsのSales Orderフォームがアクティブになっていることを確認します。

Sales Orderフォームで、[F11]を押して注文の検索を有効にします。 Customer POフィールドで、order_id_01（orders xmlファイルの注文ID）と入力して、[Ctrl]を押しながら[F11]を押します。

注文IDが'order_id_01'の新しく作成した注文の詳細を確認できます。

「Line items」タブを押します。 上記の手順5iのイニシエータでBPELプロセスがテストされた際に、生成された実際のXMLデータと、注文の数量および項目タイプが同一であるかどうか を確認します。

Oracle Jdeveloperを起動し、appsスキーマを使用してOracle E-Business Suiteへの接続を作成します。

Oracle JDeveloperで、「Connections」タブを選択し ます（表示されていない場合、「View」→「Connection Navigator」を選択します）。 「Database」 を右クリックし、「New Database Connection」を選択して、データベース・ウィザードを開きます。

データベース接続の適切な値を入力します。 このチュートリアルでは、接続名にebiz、 ユーザー名とパスワードにappsを使用します。 次のスクリーンショットは、データベース接続作成プロセスを示しています。

.

接続のテスト時にエラーを受け取った場合、データベースのホスト名、ポート、およびSIDが正し いことを確認します。 接続が正しく作成されている場合、以下のスクリーンショットに示されているようにデータベース接続ナビゲータのebizのエントリを確認します。

1.

Oracle JDeveloper BPEL Designerを開きます。 Applications Navigatorタブをアクティブにします。 「Applications」 ノードを右クリックして、「New Applications」を選択します。 .

アプリケーション名にBPEL_eBuzを設 定します。 「OK」をクリックします。

プロジェクト・ファイルはまだ作成しないでください。 「Cancel」 をクリックします。

BPELプロセス・プロジェクトを作成します。 このタスクを実行するには、以下の手順を実行します。

アプリケーション・ナビゲータの「BPEL_eBuz」ノードを右クリックして、 「New」を選択します。

New Galleryダイアログ・ボックス で、CategoriesのGeneralから「Projects」を選択して、Itemsセクションから「BPEL Process Project」を選択します。 「OK」をクリックします。

BPEL Process Projectダイアログ・ボックスが表示されます。
BPEL Process Nameフィールドで、記述名を入力します。 たとえば、OrderImportDemoを 入力します。

OrderImportDemoというBPELプロセス・プロジェクトが Applicationsセクションに作成されていることを確認し、OrderImportDemo.bpelビジュアル・プロセス・フ ロー・ダイアグラムを表示します。

Create Partner Linkウィンドウで、WSDL Settingsセクションの「Define adapter services」アイコンをクリックします。

Adapter Configuration WizardのWelcome画面 で「Next」をクリックします。 構成するアダプタとして「Oracle Applications」を選択します。 「Next」 をクリックします。

ステップ2で、サービスにDeleteOrderという名前を付け、 DescriptionにDeletes an existing order from E-Business Suiteと入力して、 「Next」をクリックします。

ステップ3で、このチュートリアルで前に作成したアプリケーションのデータベース接続を選択し て、「Next」をクリックします。

Oracle Applications Module Browserウィンドウで、次のようにDelete Orderエントリへ移動します。
「Product Families」→「Order Management Suite (OM_PF)」→「Order Management (ONT)」→「Sales Order (ONT_SALES_ORDER)」→「PLSQL」→「Process Order API (OE_ORDER_PUB)」→「DELETE ORDER (DELETE_ORDER)」

「OK」をクリックします。

Adapter Configurationウィザードのステップ4で、「DELETE ORDER API」を選択して、「Next」をクリックします。

このステップで、DeleteOrderと呼ばれるOracle Application Adapter Serviceの定義を完了します。 「Finish」をクリックして、プロセスを完了します。

前の手順で作成したアダプタに基づくWSDL Settings情報が移入されたCreate Partner Linkウィンドウに戻ります。 「OK」をクリックします。

Oracle JDeveloper BPEL Designerに戻り、サービスとしてDeleteOrderが使用できることを確認します。

すべての作業を保存します。

コンポーネント・パレットのドロップダウン・リストから「Process Activities」を選択し、「Invoke」アクティビティを選択します。

OrderImportDemo.bpelビジュアル・プロセス・フロー・ダイアグラムの receiveInputアクティビティの次に、「Invoke」アクティビティをドラッグします。

InvokeアクティビティのコネクタをOracle E-Business SuiteのDeleteOrderパー トナリンクにドラッグします（右矢印ボタンをDeleteOrderアイコンにドラッグします）。

Edit Invokeダイアログ・ボックスで、アクティビティ の名前にCallDeleteOrderと入力します。 「Automatically Create Input Variables」ボタンをクリックして、入力変数を選択します。同様に、出力変数も選択します。

Input VariableおよびOutput Variableフィー ルドに値が移入されていることを確認します。 「OK」をクリックします。

コンポーネント・パレットから「Assign」アクティビティをド ラッグして、フローのCallDeleteOrderアクティビティの前にドロップします。

CallDeleteOrder起動アクティビティの入力値を設定するため、「Assign_1」 アクティビティをダブルクリックして、次のように値を設定します。 Generalタブで、名前にAssignDeleteOrderを 設定します。 Copy Operationタブで、Createオプション・ドロップダウン・リストから「Copy Operation」を選択します。

Create Copy Operationウィンドウで、以下の手順を実行しま す。

FromセクションのVariablesノードで、「Variables」 →「Process」→「Variables」→「inputVariable」→「payload」 →「client:OrderImportDemoProcessRequest」→「client:input」を開きま す。

ToセクションのVariablesノードで、「Variables」 →「Process」→「Variables」→「CallDeleteOrder_DeleteOrder_InputVariable」 →「InputParameters」→「ns2:InputParameters」→「ns2:P_HEADER_ID」 を開きます。

「OK」をクリックします。

「OK」をクリックします。

BPEL Process DeployerウィンドウのIntegration Server Connectionで、「New」をクリックして、新しい統合サーバー接続を作成します。

ステップ1で、Connection NameにSOAを設定しま す。 「Next」をクリックします。

ステップ2で、「Configure a new application server icon」をクリックして、新しいアプリケーション・サーバー接続を作成します。

Create Application Server Connectionウィ ザード・ウィンドウで、Connection NameにApplicationServerConnectionを設定し、 Connection Typeに「Oracle Application Server 10g 10.1.3」を選択します。 「Next」 をクリックします。

Oracle SOA Suiteのインストールに適切なユーザー名とパスワードを設定します。 「Next」をクリックします。

ホスト名とポートが正しいことを確認し、「Next」をクリックします。

接続をテストして、「Finish」をクリックします。 ステータスがSuccessであることを確認します。 そうでない場合は、接続の詳細を確認して、接続を再度テストします。

このステップで、アプリケーション・サーバー・インスタンスの接続の作成が完了しました。

ステップ2のCreate Integration Server Connectionウィ ンドウに戻ります。 「Next」をクリックします。

ステップ3で、「Test Connection」をクリックして、接続が成功し ていることを確認します。 「Finish」をクリックします。

BPEL Process Deployerウィンドウに戻ります。 「OK」を クリックします。

Deployment Propertiesウィンドウで、「OK」をクリックし ます。 何度もこのアプリケーションの配置を試行した場合、バージョンが異なります。

Apache Ant - Logウィンドウを表示して、配置が成功していることを確認します。 Oracle JDeveloperのすべてのファイルを保存します。

ブラウザ・ウィンドウを開き、BPEL Console（http://< hostname>:8888/BPELConsoleまたは「スタート」→「すべてのプログラム」→「Oracle SOA Suite」→「Oracle BPEL Process Manager」→「BPEL Control」） を表示して、BPELサーバーに配置したBPELプロセスとしてOrderImportDemoプロセスが使用できるかどうかを確認しま す。 「OK」をクリックします。

既存の注文の問合せを行います。 「Cust Name」をクリックして、[F11]を押します。 フィールドが青色の場合、Cust NameフィールドにBusiness Worldと入力し、[Ctrl]を押しながら[F11]を押します。 顧客のBusiness Worldに対応する情報がフォームに移入されます。 この顧客のエントリに対応する品目も確認します。 品目が表示されない場合、キーボードの上矢印キーと下矢印キーを使用して、少なくとも1つの品目が含まれた注文を選択します。

上記のスクリーンショットは、システムの注文IDが57686の注文を示しています。 異なる注文が検索される場合があります。

上記の手順で選択した注文に対応するheader_idを検索します。 Oracle Order Managementは内部の値で動作するので、header_idが必要です。 通常、注文番号は外部システムによって提供されます。同じ注文番号で異なる企業2社の2つの販売注文が存在する場合があります。

Oracle JDeveloperで、「Tools」→「SQL Worksheet」へ移動します。 Select Connectionウィンドウからデータベース接続として「ebiz」 を選択します。 これは、このチュートリアルの前の手順で作成したデータベース接続です。

ebizウィンドウで次のSQL文を入力し、Execute SQL Statementボタン「」 をクリックして、コマンドを実行します。

SELECT * FROM oe_order_headers_all
WHERE order_number=57686

注文番号57686のheader_idが104550であることを確認します。

新しいインターネット・ブラウザを開き、アドレス・バーに次 のURLを入力して、Oracle BPEL Consoleにログインします。

http://localhost:8888/BPELConsole

まだログインし ていない場合、ユーザー名にoc4jadmin、パスワードにwelcome1（またはOracle SOA Suiteのインストール時に入力したパスワード）を設定して、Oracle BPEL Controlにログインします。

「OrderImportDemo」リンクをクリックします。Initiateタ ブで、入力パラメータ・フィールドに前の手順で確認した注文IDを設定します。「Post XML Message」をクリックします。

インスタンスが非同期で正常に処理されたことを示すメッセージを確認します。 「Visual Flow」ダイアグラムをクリックして、BPELプロセス・ダイアグラムのビジュアル・フローを表示します。

販売注文のアクションを実際に実行するAPIからの結果を確認します。 「CallDeleteOrder」 アクティビティをクリックして、テスト・インスタンスで設定された注文IDの注文を削除します。

Activity Audit Trailウィンドウで、削除アクションのステータスを示すハイライトされたメッセージを確認します。

このチュートリアルの例では、メッセージ・データにOE_PC_DELETE_VIOLATION、 メッセージの理由にOrder has been bookedが表示されています。 このメッセージは注文表に削除違反制約が定義されており、この注文を削除できないことが示されています。 指定した注文がすでに予約されていて削除できないので、上記の制約が発生します。

<X_RETURN_STATUS> E <X_RETURN_STATUS>

<X_MSG_COUNT>1<X_MSG_COUNT>

<X_MSG_DATA> ONT$#0; OE_PC_DELETE_VIOLATION ....

結論：上記の内容は、注文管理システムからの有効なエラー・ メッセージです。 注文が予約されている場合、削除できません。 別の注文を削除してください。

ただし、指定した注文IDの注文がまだ予約されていない場合 は販売注文に関連する表から削除できるので、削除されたことを示すメッセージが表示されます。 次のスクリーンショットのように、削除成功のメッセージが表示されます。

<X_RETURN_STATUS> S <X_RETURN_STATUS>

<X_MSG_COUNT> 0 <X_MSG_COUNT>

<X_MSG_DATA xsi:nil= TRUE ...

削除に成功したことを示す上記のメッセージを取得した場合、 Oracle Applicationsに戻り、削除した品目の注文番号を検索します。

このプロセスによって、BPELフロー内のサービスとしてPL/SQL APIを起動するE-Businessアダプタの機能が証明されます。