Oracle Fusion Middleware Oracle E-Business Suite Adapterユーザーズ・ガイド 12c (12.2.1.2.0) 部品番号E82667-01 | ![]() 目次 | ![]() 前 | ![]() 次 |
この章の構成は、次のとおりです。
コンカレント・プログラムは、実行ファイルのインスタンスです。コンカレント・プログラムでは、コンカレント・プログラム実行可能ファイルを使用して適切な実行ファイルが検出されます。複数のコンカレント・プログラムが同じ実行ファイルを使用し、それぞれパラメータのデフォルト値が異なる特定のタスクを実行できます。コンカレント・マネージャはバックグラウンドで実行され、コンカレント・プログラムが実行されるのを待機します。コンカレント・プログラムが実行されると、ただちにコンカレント・マネージャによって実行キューに入れられます。コンカレント・マネージャはコンカレント・プログラムのコンカレント実行も管理します。
オープン・インタフェース表に関連付けられているコンカレント・プログラムは、インタフェース表から実表にデータを移動します。他のコンカレント・プログラムは、Oracle E-Business Suiteのビジネス・ロジック・レベルおよびアプリケーション・レベルの処理を実行します。
コンカレント・プログラムへのアクセス
コンカレント・プログラムにアクセスするには、Oracle E-Business Suiteモジュール・ブラウザを使用して製品ファミリを表示するか、検索機能を使用して希望するコンカレント・プログラムを見つけます。
カスタムのコンカレント・プログラムは、Oracle E-Business Suiteモジュール・ブラウザで「その他インタフェース」→「カスタム・オブジェクト」→「コンカレント・プログラム」ノードの下に表示されます。
カスタムのコンカレント・プログラムの表示と選択
別の方法としては、検索を実行して希望するカスタムのコンカレント・プログラムを見つけることもできます。
カスタムのコンカレント・プログラムの検索
この項では、コンカレント・プログラムを使用するようにOracle E-Business Suite Adapterを構成する方法について説明します。
BPELプロセスを使用したSOAコンポジット・アプリケーションのシナリオ
オープン・インタフェース: オーダー・インポート・コンカレント・プログラム(OEOIMP)を例として説明します。このコンカレント・プログラムを使用すると、オーダー・インポート処理を実行して、Order Managementのオープン・インタフェース表からオーダー詳細を取得し、受注を作成できます。
オーダー作成のリクエストを受信すると、オーダー詳細がオープン・インタフェース表(OE_HEADER_IFACE_ALLとOE_LINES_IFACE_ALL)に渡されて挿入されます。挿入が完了すると、コンカレント・プログラムが起動され、オーダー・データをオープン・インタフェース表からOrder Managementの実表にインポートします。
BPELプロセスを使用したSOAコンポジット・アプリケーションがデプロイ後に正常に実行されると、オーダーがOracle E-Business Suiteに作成されます。購買オーダーIDはペイロードの入力値と同じである必要があります。
アプリケーション・コンテキストのヘッダー変数の移入
Oracle E-Business Suiteのコンテキスト情報を提供するには、BPEL PMに特定の変数を移入する必要があります。十分な権限を持つOracle E-Business Suiteユーザーがプログラムを実行するには、トランザクションのコンテキスト情報が必要です。
コンテキストはヘッダー・プロパティ(「ユーザー名」、「職責」、「職責アプリケーション」、「セキュリティ・グループ」および「NLS言語」を含む)に渡される値を考慮して設定されます。新しいヘッダー・プロパティ「職責アプリケーション」、「セキュリティ・グループ」および「NLS言語」の値が渡されない場合、コンテキスト情報は「ユーザー名」と「職責」に基づいて判断されます。
デフォルトの「ユーザー名」はSYSADMIN、デフォルトの「職責」はSYSTEM ADMINISTRATOR、デフォルトの「セキュリティ・グループ・キー」は「標準」、およびデフォルトの「NLS言語」はUSです。
生成WSDLに指定されているデフォルト値は変更できます。これは、コンテキスト情報を静的に変更する方法です。これらの値は、デプロイ済のビジネス・プロセスのすべての起動に適用されます。ただし、ビジネス・プロセスの起動ごとに異なるコンテキスト情報を提供する必要がある場合は、ヘッダー値に動的に値を移入できます。コンテキスト情報はinvokeアクティビティを構成することにより指定できます。
アプリケーション・コンテキストの詳細は、「正規化されたメッセージ・プロパティのサポート」を参照してください。
BPELプロセスを使用したSOAコンポジット・アプリケーションの作成フロー
この章では、プロセス・シナリオに基づき、次の設計時タスクについて説明します。
BPELプロジェクトを使用した新しいSOAコンポジット・アプリケーションを作成する手順は、次のとおりです。
JDeveloper BPEL Designerを開きます。
「アプリケーション・ナビゲータ」で「新規アプリケーション」をクリックします。
「新規ギャラリ」ページが表示されます。項目リストで「SOAアプリケーション」を選択します。
「新規ギャラリ」ページ
「OK」をクリックします。
「SOAアプリケーションの作成 - アプリケーションの名前付け」ページが表示されます。
「SOAアプリケーションの作成 - アプリケーションの名前付け」ページ
「アプリケーション名」フィールドにアプリケーションに適した名前を入力します。
「次」をクリックします。「SOAアプリケーションの作成 - プロジェクトの名前付け」ページが表示されます。
「プロジェクト名」フィールドに適切なプロジェクト名を入力します。例: OrderImportConcurrentProgram。
「プロジェクトの機能」セクションに「SOAスイート」が表示されます。
「SOAアプリケーションの作成 - プロジェクトの名前付け」ページ
「次」をクリックします。「SOAアプリケーションの作成 - SOA設定の構成」ページが表示されます。
「SOAアプリケーションの作成 - SOA設定の構成」ページ
「開始」フィールドでは、デフォルトで選択されている「標準コンポジット」をそのままにします。
「標準コンポジット」リストからBPELプロセスを使用するコンポジットを選択し、「終了」をクリックします。新しいアプリケーションとSOAプロジェクトが作成されました。これにより、SOAコンポジットが自動的に作成されます。
「BPELプロセスの作成」ページが表示されます。
デフォルトで選択されている「BPEL 2.0仕様」をそのままにします。BPEL 2.0仕様をサポートするBPELプロジェクトが作成されます。
「名前」フィールドに適切なBPELプロセス名を入力します。例: OrderImportConcurrentProgram。
「テンプレート」フィールドで「非同期BPELプロセス」を選択します。「OK」をクリックします。
receiveアクティビティとreplyアクティビティを持つ非同期BPELプロセスが作成されます。指定した名前を使用したbpelおよびwsdlファイル(例: OrderImportConcurrentProgram.bpelとOrderImportConcurrentProgram.wsdl)を含む必要なソース・ファイルとOrderImportConcurrentProgram (composite.xml)も生成されます。
SOAフォルダにナビゲートしてOrderImportConcurrentProgram (composite.xml)をクリックすると、コンポジット・ダイアグラムが表示されます。
Oracle JDeveloperのコンポジット・ダイアグラム
「OrderImportConcurrentProgram」コンポーネントをダブルクリックするとBPELプロセスが開きます。
次のタスクは、BPELプロセスにパートナ・リンクを追加することです。パートナ・リンクは、パートナ・サービスと相互動作するBPELプロセスのリンク名、タイプおよびロールを定義するものです。
前に説明したBPELプロセス・シナリオに基づいて、次の2つのパートナ・リンクを構成する必要があります。
最初のパートナ・リンクInsertOrderを追加して、選択したオープン・インタフェース表にオーダー詳細を挿入します
2番目のパートナ・リンクImportOrderCPを追加して、購買オーダー・データをオープン・インタフェース表からOrder Managementの実表にインポートします
最初のパートナ・リンクを追加する手順は、次のとおりです。
「コンポーネント・パレット」で「BPELサービス」をクリックします。
Oracle E-Business Suite」(旧称Oracle Applications)を「BPELサービス」リストからプロセス・ダイアグラムの右側の「パートナ・リンク」スイムレーンにドラッグ・アンド・ドロップします。「Oracle E-Business Suite Reference」ページが表示されます。
「名前」フィールドにサービス名を入力します。例: InsertOrder。
「次」をクリックします。サービス接続ページが表示されます。
データベース・サービス接続の指定
データベース接続については次のいずれかのオプションを実行できます。
注意: Oracle E-Business Suiteが実行されているデータベースに接続する必要があります。
新しいデータベース接続を作成するには、「新規データベース接続を作成します」アイコンをクリックします。
新しいデータベース接続を定義する方法は、「新規データベース接続の作成」を参照してください。
以前に構成した既存のデータベース接続は、「接続」ドロップダウン・リストから選択できます。
「サービス接続」ページが開いて、選択した接続情報が表示されます。データベース接続に対応するJNDI(Java Naming and Directory Interface)名が、「データベース・サーバーのJNDI名」フィールドに自動的に表示されます。JNDI名を指定することもできます。
注意: JNDI名を指定する場合、データベースにアクセスするには、Oracle E-Business Suite Adapterのデプロイメント・ディスクリプタにより、このJNDI名をアダプタで必要な構成プロパティに関連付ける必要があります。
JNDI名は、サービスがBPELサーバーにデプロイされるときに使用される接続のプレースホルダとなります。これによって、開発用とその後の本番用とで異なるデータベースを使用できます。
注意: JNDIの概念の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタの理解』を参照してください。
「サービス接続」ダイアログ・ボックスで「次へ」をクリックします。Oracle E-Business Suiteで使用可能なコンカレント・プログラムのリストを参照することにより、コンカレント・プログラムを追加できます。
Oracle E-Business Suiteリリース12に接続している場合は、IREPファイルがありませんというダイアログ・ボックスが表示されます。これは、ワークスペース内で接続中のデータベースに対応するOracle Integration Repositoryデータ・ファイルが見つからないことを示します。データファイルがないと、Integration Repositoryツリーの参照や検索がかなり低速になります。データファイルを抽出し、Integration Repositoryデータファイルのローカル・コピーを作成するように選択できます。正常に作成されたローカル・コピーは、次回にアダプタにより自動的に使用され、ローカルIntegration Repositoryからデータが取得されます。
次のいずれかのオプションを選択できます。
Integration Repositoryデータファイルを抽出するには、「はい」をクリックします。
システムによりIntegration Repositoryデータファイルのローカル・コピーが正常に作成されると、データベースへの次回接続時には、「操作」ダイアログ・ボックスに「IRepデータファイル」フィールドが表示されます。これは、ファイル名の一部に作成日時を含んだローカル・コピーが存在することを示します。
ローカルIntegration Repositoryデータファイルの使用
接続中の本番データベースからIntegration Repositoryデータファイルを問い合せてIntegration Repositoryツリーを表示するには、「いいえ」をクリックします。
この例では、「いいえ」をクリックします。「操作」ページで「次へ」をクリックして、Oracle E-Business Suiteモジュール・ブラウザを開きます。
Oracle E-Business Suiteモジュール・ブラウザには、Oracle E-Business Suiteで使用可能な各種の製品ファミリが表示されます。ツリー・ノードを展開して、目的のインタフェースを探します。コンカレント・プログラムはオープン・インタフェース・カテゴリの下にあります。
「Order Management Suite (OM_PF)」→「Order Management (ONT)」→「受注 (ONT_SALES_ORDER)」→「OpenInterfaces」→「Order Management受注オープン・インタフェース (OEOIMP)」→「表」にナビゲートして、「OE_HEADERS_IFACE_ALL」を選択します。
モジュール・ブラウザからのコンカレント・プログラムの選択
注意: 選択したインタフェース表で、事前構成済みのフレックスフィールド・マッピングが使用できる場合、ポップアップ・ウィンドウが表示され、このような事前構成済みマッピングを使用するかどうかを指定できます。「はい」をクリックすると、「フレックスフィールドの構成」領域にフレックスフィールドの定義の一部として、これらのマッピングが表示されます。これらは必要に応じて、後で変更できます。
これらのマッピングを使用しない場合は「いいえ」をクリックして、ポップアップ・ウィンドウを閉じます。
選択したオープン・インタフェース表でのフレックスフィールド・マッピング・データの構成
ただし、この例では、パートナ・リンク作成の一環として、オープン・インタフェース表が選択されています。Oracle E-Business Suite Adapterはオープン・インタフェース表にフレックスフィールド・サポートを提供します。モジュール・ブラウザで表を選択したら、Oracle E-Business Suiteで定義されたフレックスフィールドを持つ表のフレックスフィールド・マッピングを構成することも、または、それ以上フレックスフィールド・マッピングを構成せずに現在のデータを使用することもできます。
Oracle E-Business Suiteモジュール・ブラウザで次のタスクの1つを実行します。
それ以上構成せずに既存のデータを使用するには、 「OK」をクリックして続行します。
既存のフレックスフィールド・マッピングを使用するか、必要があれば、フレックスフィールド・ウィザードを使用して新しいマッピングを作成し、フレックスフィールド・マッピング・データを構成します。
オープン・インタフェース表でのフレックスフィールドのサポートと、既存のマッピング構成を変更する方法について、詳細は次を参照してください。
この例では、「OK」をクリックします。「アプリケーション・インタフェース」ページが開き、選択したオープン・インタフェース表が表示されます。
「アダプタ構成ウィザード」 - 「アプリケーション・インタフェース」ページ
「オブジェクト取得」をクリックして、モジュール・ブラウザをもう一度開き、同じナビゲータ・パス「Order Management Suite (OM_PF)」→「Order Management (ONT)」→「受注 (ONT_SALES_ORDER)」→「OpenInterfaces」→「Order Management受注オープン・インタフェース (OEOIMP)」→「表」を使用して、別のオープン・インタフェース表OE_LINES_IFACE_ALLを選択します。
「OK」をクリックします。「アプリケーション・インタフェース」ページが開き、選択した2つの表が表示されます。
「アダプタ構成ウィザード」 - 「アプリケーション・インタフェース」ページ
「OK」をクリックします。
「次」をクリックします。「操作タイプ」ページが表示されます。
「アダプタ構成ウィザード」 - 「操作タイプ」ページ
「表に対して操作を実行」ラジオ・ボタンを選択し、「挿入」チェック・ボックスを選択します。「選択」チェック・ボックスが選択解除されていることを確認します。
「次」をクリックします。「表の選択」ページが表示されます。
「アダプタ構成ウィザード」 - 「表の選択」ページ
このサービスの問合せのルート・データベース表としてOE_HEADERS_IFACE_ALLを選択します。
「次」をクリックします。「主キーの定義」ページが表示されます。
「アダプタ構成ウィザード」 - OE_HEADERS_IFACE_ALLの「主キーの定義」ページ
OE_HEADERS_IFACE_ALL表に対して次の主キーを選択します。
ORDER_SOURCE_ID
ORIG_SYS_DOCUMENT_REF
「次」をクリックします。
OE_LINES_IFACE_ALL表に対して同じ主キーを選択します。
「次」をクリックします。「リレーションシップ」ページが表示されます。「作成」をクリックして、「リレーションシップの作成」ダイアログを開きます。
リレーションシップの定義
次の情報を入力して、ヘッダーと詳細表間のリレーションシップを定義します。
親表としてOE_HEADERS_IFACE_ALL、および子表としてOE_LINES_IFACE_ALLを選択します。
マッピング・タイプ「OE_HEADERS_IFACE_ALLとOE_LINES_IFACE_ALLのリレーションシップは1対多」を選択します。
注意: 表どうしの外部キー制約がすでにデータベースに存在する場合、表のインポート中に2つのリレーションシップが自動的に作成されます。1つは、ソース表(外部キー制約が含まれる表)からターゲット表への1対多リレーションシップです。もう1つのリレーションシップは、ターゲット表からソース表への1対1バック・ポインタです。
「私有」チェック・ボックスを選択します。
主キー・フィールドに外部キー・フィールドを関連付けます。
OE_HEADERS_IFACE_ALL.ORDER_SOURCE_ID: ORDER_SOURCE_ID
OE_HEADERS_IFACE_ALL.ORIG_SYS_DOCUMENT_REF: ORIG_SYS_DOCUMENT_REF
「リレーションシップ名」フィールドは、デフォルトでは自動的に移入されます。必要に応じて、作成しているリレーションシップに新しい名前を指定できます。
「OK」をクリックします。「リレーションシップ」ページに、新しく作成されたリレーションシップ情報が表示されます。
「アダプタ構成ウィザード」 - 「リレーションシップ」ページ
「次」をクリックします。「属性のフィルタ処理」ページが表示されます。デフォルトで選択されている内容を変更せずにそのままにします。
「アダプタ構成ウィザード」 - 「属性のフィルタ処理」ページ
「次」をクリックします。「詳細オプション」ページが表示されます。
「次」をクリックします。
「終了」をクリックします。選択したインタフェースに対応するWSDLファイルが生成されます。このWSDLファイルをパートナ・リンクに使用できます。
2番目のパートナ・リンクを追加する手順は、次のとおりです。
「コンポーネント・パレット」で「BPELサービス」をクリックします。
Oracle E-Business Suite」(旧称Oracle Applications)を「BPELサービス」リストからプロセス・ダイアグラムの右側の「パートナ・リンク」スイムレーンにドラッグ・アンド・ドロップします。「Oracle E-Business Suite Reference」ページが表示されます。
「名前」フィールドにサービス名を入力します。例: ImportOrderCP。
「次」をクリックします。「サービス接続」ダイアログが表示されます。
データベース接続については次のいずれかのオプションを実行できます。
注意: Oracle E-Business Suiteが実行されているデータベースに接続する必要があります。
新しいデータベース接続を作成するには、「新規データベース接続を作成します」アイコンをクリックします。
新しいデータベース接続を定義する方法は、「新規データベース接続の作成」を参照してください。
以前に構成した既存のデータベース接続は、「接続」ドロップダウン・リストから選択できます。
「サービス接続」ページが開いて、選択した接続情報が表示されます。データベース接続に対応するJNDI(Java Naming and Directory Interface)名が、「データベース・サーバーのJNDI名」フィールドに自動的に表示されます。JNDI名を指定することもできます。
注意: JNDI名を指定する場合、データベースにアクセスするには、Oracle E-Business Suite Adapterのデプロイメント・ディスクリプタにより、このJNDI名をアダプタで必要な構成プロパティに関連付ける必要があります。
JNDI名は、サービスがBPELサーバーにデプロイされるときに使用される接続のプレースホルダとなります。これによって、開発用とその後の本番用とで異なるデータベースを使用できます。
注意: JNDIの概念の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタの理解』を参照してください。
新規のサービス接続の作成を完了した後、Oracle E-Business Suiteで使用可能なリストを参照してコンカレント・プログラムを追加できます。
「次」をクリックします。
Oracle E-Business Suiteリリース12に接続している場合は、IREPファイルがありませんというダイアログが表示されます。これは、ワークスペース内でOracle E-Business Suite Adapterに接続中のデータベースに対応するOracle Integration Repositoryデータファイルが見つからないことを示します。データファイルがないと、Integration Repositoryツリーの参照や検索がかなり低速になります。データファイルを抽出し、Integration Repositoryデータファイルのローカル・コピーを作成するように選択できます。正常に作成されたローカル・コピーは、次回にアダプタにより自動的に使用され、ローカルIntegration Repositoryからデータが取得されます。
次のいずれかのオプションを選択できます。
Integration Repositoryデータファイルを抽出するには、「はい」をクリックします。
システムによりIntegration Repositoryデータファイルのローカル・コピーが正常に作成されると、データベースへの次回接続時には、「操作」ダイアログに「IRepデータ・ファイル」フィールドが表示されます。これは、ファイル名の一部に作成日時を含んだローカル・コピーが存在することを示します。
ローカルIntegration Repositoryデータファイルの使用
接続中の本番データベースからIntegration Repositoryデータファイルを問い合せてIntegration Repositoryツリーを表示するには、「いいえ」をクリックします。
この例では、「操作」ページで「次へ」をクリックして、Oracle E-Business Suiteモジュール・ブラウザを開きます。
Oracle E-Business Suiteモジュール・ブラウザは、Oracle Integration Repositoryからのインタフェース・データを、Oracle E-Business Suite Adapterでサポートされるその他のインタフェースに関する情報と組み合せて、ツリー階層を作成します。
「Order Management Suite (OM_PF)」→「Order Management (ONT)」→「受注 (ONT_SALES_ORDER)」→「OpenInterfaces」→「Order Management受注オープン・インタフェース」→「ConcurrentPrograms」にナビゲートして、コンカレント・プログラム「OEOIMP (OEOIMP)」を選択します。
モジュール・ブラウザからのコンカレント・プログラムの選択
「OK」をクリックします。「アプリケーション・インタフェース」ページが表示されます。
「アダプタ構成ウィザード」 - 「アプリケーション・インタフェース」ページ
「次へ」をクリックし、「終了」をクリックして、プロセスを完了します。必要なWSDL設定を使用してパートナ・リンクが作成されます。XMLスキーマに対応するWSDLファイルも生成されます。このWSDLファイルをパートナ・リンクに使用できます。
入力ファイルからペイロードを同期読取りしてオーダー詳細とコンカレント・プログラムの詳細を取得することによって、BPELプロセスを構成するには、この手順を使用します。
次の2つのパートナ・リンクを構成します。
同期Read操作を使用して入力ファイルからオーダー詳細を取得します。
同期Read操作を使用して入力ファイルからコンカレント・プログラムの詳細を取得します。
最初のファイル・アダプタ用パートナ・リンクを追加して、オーダー詳細を読み取る手順は、次のとおりです。
Oracle JDeveloper BPEL Designerの「コンポーネント・パレット」で、「BPELサービス」をクリックします。
「ファイル・アダプタ」を「BPELサービス」リストから、右側の「パートナ・リンク」スイムレーンの最初のパートナ・リンクInsertOrderの前にドラッグ・アンド・ドロップします。ファイル・アダプタ参照ページが表示されます。
ファイル参照名の指定
ファイル・アダプタ・サービスの名前(getOrderDetailsなど)を入力します。
「次」をクリックします。「アダプタ・インタフェース」ページが表示されます。
アダプタ・インタフェースの指定
「操作およびスキーマから定義(後で指定)」ラジオ・ボタンを選択し、「次へ」をクリックします。
ファイル・サーバーの接続ページが表示されます。「ファイル・サーバーのJNDI名」フィールドのデフォルト値は変更せず、そのままにします。
「次へ」をクリックします。
「操作」ページで、操作タイプを指定します。たとえば、「同期Read File」ラジオ・ボタンを選択します。この操作タイプは、「操作名」フィールドに自動的に移入されます。
操作の指定
「次へ」をクリックして、「ファイル・ディレクトリ」ページにアクセスします。
「論理名」ラジオ・ボタンを選択して、受信ファイルのディレクトリ(inputDirなど)を指定します。
「正常な取得後にファイルを削除」チェック・ボックスが選択されていないことを確認します。
入力ファイルの構成
「次へ」をクリックして、「ファイル名」ページを開きます。
同期Read File操作のファイル名を入力します。たとえば、order_data.xmlと入力します。「次」をクリックします。「メッセージ」ページが表示されます。
「URL」フィールドの横の「スキーマ・ファイルを参照」アイコンを選択して、「タイプ・チューザ」を開きます。
「タイプ・エクスプローラ」をクリックして、「プロジェクトのスキーマ・ファイル」→「InsertOrder_table.xsd」→「OeHeadersIfaceAllCollection」を選択します。「OK」をクリックします。
選択したスキーマ情報は、「URL」フィールドと「スキーマ要素」フィールドに自動的に移入されます。
メッセージ・スキーマの指定
「次へ」をクリックし、「終了」をクリックします。これで構成が完成し、必要なWSDL設定を使ったファイル・アダプタ・サービスでのパートナ・リンクが作成されます。パートナ・リンクに対応するWSDLファイルも生成されます。メインの「パートナ・リンクの作成」ダイアログ・ボックスが表示され、新規WSDLファイルgetOrderDetails.wsdlが指定されています。
BPELプロセス・ダイアグラムにgetOrderDetailsパートナ・リンクが表示されます。
2番目のファイル・アダプタ用パートナ・リンクを追加して、コンカレント・プログラムの詳細を読み取る手順は、次のとおりです。
Oracle JDeveloper BPEL Designerの「コンポーネント・パレット」で、「BPELサービス」をクリックします。
「ファイル・アダプタ」を「BPELサービス」リストから、右側の「パートナ・リンク」スイムレーンの最初のファイル・アダプタ用パートナ・リンクgetOrderDetailsの後ろにドラッグ・アンド・ドロップします。ファイル・アダプタ参照ページが表示されます。
ファイル・アダプタ参照名の指定
ファイル・アダプタ・サービスの名前(getCPDetailsなど)を入力します。
「次」をクリックします。「アダプタ・インタフェース」ページが表示されます。
アダプタ・インタフェースの指定
「操作およびスキーマから定義(後で指定)」ラジオ・ボタンを選択し、「次へ」をクリックします。
ファイル・サーバーの接続ページが表示されます。「ファイル・サーバーのJNDI名」フィールドのデフォルト値は変更せず、そのままにします。
「次へ」をクリックします。
「操作」ページで、操作タイプを指定します。たとえば、「同期Read File」ラジオ・ボタンを選択します。この操作タイプは、「操作名」フィールドに自動的に移入されます。
操作の指定
「次へ」をクリックして、「ファイル・ディレクトリ」ページにアクセスします。
「論理名」ラジオ・ボタンを選択して、受信ファイルのディレクトリ(inputDirなど)を指定します。
「正常な取得後にファイルを削除」チェック・ボックスが選択されていないことを確認します。
入力ファイルの構成
「次へ」をクリックして、「ファイル名」ページを開きます。
同期Read File操作のファイル名を入力します。たとえば、cp_data.xmlと入力します。「次へ」をクリックして、「メッセージ」ページを開きます。
「URL」フィールドの横の「スキーマ・ファイルを参照」アイコンを選択して、「タイプ・チューザ」を開きます。
「タイプ・エクスプローラ」をクリックして、「プロジェクトのスキーマ・ファイル」→「ImportOrderCP_sp.xsd」→「InputParameters」を選択します。「OK」をクリックします。
選択したスキーマ情報は、「URL」フィールドと「スキーマ要素」フィールドに自動的に移入されます。
「次へ」をクリックし、「終了」をクリックします。これで構成が完成し、必要なWSDL設定を使ったファイル・アダプタ・サービスでのパートナ・リンクが作成されます。パートナ・リンクに対応するWSDLファイルも生成されます。メインの「パートナ・リンクの作成」ダイアログ・ボックスが表示され、新規WSDLファイルgetCPDetails.wsdlが指定されています。
BPELプロセス・ダイアグラムにgetCPDetailsパートナ・リンクが表示されます。「パートナ・リンク」サービス・アイコンをダブルクリックします。パートナリンクの編集 ダイアログが開き、詳細が表示されます。
パートナ・リンクを追加および構成した後、次の4つのinvokeアクティビティを構成する必要があります。
同期Read操作を使用してgetOrderDetailsパートナ・リンクを起動することによって、オーダー詳細を取得し、入力ファイルからオーダーを読み取ります。
同期Read操作を使用してgetCPDetailsパートナ・リンクを起動することにより、コンカレント・プログラムの詳細を取得して、入力ファイルからコンカレント・プログラム情報を読み取ります。
InsertOrderパートナ・リンクを起動することにより、オーダー・データをオープン・インタフェース表に挿入します。
ImportOrderCPコンカレント・プログラムのパートナ・リンクを起動することにより、オーダー・データをオープン・インタフェース表からOracle E-Business Suiteにインポートします。
パートナ・リンクに対する最初のinvokeアクティビティを追加して、オーダー詳細を取得する手順は、次のとおりです。
Oracle JDeveloper BPEL Designerの「コンポーネント・パレット」で、「BPELコンストラクト」を展開します。1番目の「Invoke」アクティビティを、「Web Service」セクションから、プロセス・ダイアグラムの中央スイムレーンの「receiveInput」アクティビティと「callbackClient」アクティビティの間にドラッグ・アンド・ドロップします。
invokeアクティビティの追加
invokeアクティビティをgetOrderDetailsサービスにリンクします。「Invokeの編集」ダイアログが表示されます。
Invokeアクティビティの名前を入力します。「入力」タブで「入力変数」ラジオ・ボタンが選択されていることを確認します。「入力変数」フィールドの横にある「作成」アイコンをクリックして、新しい変数を作成します。「変数の作成」ダイアログ・ボックスが表示されます。
「グローバル変数」を選択し、変数の名前を入力します。デフォルト名を受け入れることもできます。「OK」をクリックします。
「出力」タブで「出力変数」ラジオ・ボタンが選択されていることを確認します。「出力変数」フィールドの横にある「作成」アイコンをクリックして、新しい変数を作成します。「変数の作成」ダイアログ・ボックスが表示されます。
「グローバル変数」を選択し、変数の名前を入力します。デフォルト名を受け入れることもできます。「OK」をクリックして、「Invokeの編集」ダイアログ・ボックスに戻ります。
Invokeアクティビティの詳細の表示
「適用」をクリックして、「OK」をクリックし、invokeアクティビティの構成を完了します。
プロセス・ダイアグラムにinvokeアクティビティが表示されます。
パートナ・リンクに対する2番目のinvokeアクティビティを追加して、コンカレント・プログラムの詳細を取得する手順は、次のとおりです。
JDeveloper BPEL Designerの「コンポーネント・パレット」で、「BPELコンストラクト」を展開します。2番目の「Invoke」アクティビティを、「Web Service」セクションから、プロセス・ダイアグラムの中央スイムレーンの1番目の「Invoke」アクティビティの直後にドラッグ・アンド・ドロップします。
invokeアクティビティをgetCPDetailsサービスにリンクします。「Invokeの編集」ダイアログが表示されます。
最初のinvokeアクティビティの手順で説明したステップ3から6を繰り返します。
入力変数と出力変数は、「Invokeの編集」ダイアログ・ボックスで移入します。
Invokeアクティビティの詳細の表示
パートナ・リンクに対する3番目のinvokeアクティビティを追加して、オープン・インタフェース表にオーダー・データを挿入する手順は、次のとおりです。
JDeveloper BPEL Designerの「コンポーネント・パレット」で、「BPELコンストラクト」を展開します。3番目の「Invoke」アクティビティを、「Web Service」セクションから、プロセス・ダイアグラムの中央スイムレーンの2番目の「Invoke」アクティビティと「callbackClient」アクティビティの間にドラッグ・アンド・ドロップします。
invokeアクティビティをInsertOrderサービスにリンクします。「Invokeの編集」ダイアログ・ボックスが表示されます。
最初のinvokeアクティビティの手順で説明したステップ3から4を繰り返します。「Invokeの編集」ダイアログ・ボックスの「OK」をクリックして、2番目のinvokeアクティビティの構成を終了します。
Invokeアクティビティの詳細の表示
パートナ・リンクに対する4番目のinvokeアクティビティを追加し、Oracle E-Business Suiteでオーダー情報をインポートする手順は、次のとおりです。
JDeveloper BPEL Designerの「コンポーネント・パレット」で、「BPELコンストラクト」を展開します。4番目の「Invoke」アクティビティを、「Web Service」セクションから、プロセス・ダイアグラムの中央スイムレーンの3番目の「Invoke」アクティビティと「callbackClient」アクティビティの間にドラッグ・アンド・ドロップします。
invokeアクティビティをImportOrderCPサービスにリンクします。「Invokeの編集」ダイアログ・ボックスが表示されます。
最初のinvokeアクティビティの手順で説明したステップ3から6を繰り返します。
入力変数と出力変数は、「Invokeの編集」ダイアログ・ボックスで移入します。
BPELプロセスを完了するために必要なアプリケーション・コンテキストに渡す必要があるヘッダー・メッセージ・プロパティを設定するには、次の手順を使用します。
「Invokeの編集」ダイアログ・ボックスの「プロパティ」タブを選択します。
「作成」アイコンをクリックします。「送信先プロパティ」ダイアログが表示されます。
「名前」ドロップダウン・リストから「jca.apps.Username」プロパティを選択します。
プロパティの選択
「式」ラジオ・ボタンを選択し、プロパティ値として「'OPERATIONS'」を入力します。
「OK」をクリックします。
ステップ2からステップ4を繰り返して、次のプロパティを割り当てます。
jca.apps.Responsibility: 受注管理スーパーユーザー、Visionオペレーション (USA)
jca.apps.ORG_ID: 204
「適用」をクリックして、「OK」をクリックし、invokeアクティビティを完了します。
BPELプロセス・シナリオに基づいて、次の2つのassignアクティビティを構成する必要があります。
ファイル・アダプタの同期Read(getOrderDetails)サービスの出力をオープン・インタフェースInsertOrderサービスの入力として渡します。
コンカレント・プログラム(ImportOrderCP)サービスのペイロードを設定します。
最初のassignアクティビティを追加する手順は、次のとおりです。
JDeveloper BPEL Designerの「コンポーネント・パレット」で、「BPELコンストラクト」を展開します。
1番目の「Assign」アクティビティを、「基本アクティビティ」セクションから、プロセス・ダイアグラムの中央スイムレーンにある、さきほど作成した1番目と2番目の「Invoke」アクティビティの間にドラッグ・アンド・ドロップします。
「Assign」アクティビティをダブルクリックして、「Assignの編集」ダイアログにアクセスします。
「一般」タブをクリックして、assignアクティビティの名前を入力します。例: SetOrderDetails。
「コピー・ルール」タブを選択してターゲット・ツリーを展開します。
「From」ナビゲーション・ツリーで、「変数」→「プロセス」→「変数」→「Invoke_SynchRead_OutputVariable」の順にナビゲートして、「本体」を選択します。
「To」ナビゲーション・ツリーで、「変数」→「プロセス」→「変数」→「Invoke_insert_InputVariable」の順にナビゲートして、「OeHeadersIfaceAllCollection」を選択します。
ソース・ノード(本体)を、選択したターゲット・ノード(OeHeadersIfaceAllCollection)にドラッグします。 これでソース・ノードとターゲット・ノードを接続する線が作成されます。コピー・ルールは、「Assignの編集」ダイアログ・ボックスの下部にある「From」セクションと「To」セクションに表示されます。
パラメータの割当て
「適用」をクリックして、「OK」をクリックし、assignアクティビティの構成を完了します。
2番目のassignアクティビティを追加する手順は、次のとおりです。
JDeveloper BPEL Designerの「コンポーネント・パレット」で、「BPELコンストラクト」を展開します。
2番目の「Assign」アクティビティを、「基本アクティビティ」セクションから、プロセス・ダイアグラムの中央スイムレーンにある、さきほど作成した3番目と4番目の「Invoke」アクティビティの間にドラッグ・アンド・ドロップします。
「Assign」アクティビティをダブルクリックして、「Assignの編集」ダイアログにアクセスします。
「一般」タブをクリックして、assignアクティビティの名前を入力します。例: SetCPDetails。
「コピー・ルール」タブを選択してターゲット・ツリーを展開します。
「From」ナビゲーション・ツリーで、「変数」→「プロセス」→「変数」→「Invoke_SynchRead_OutputVariable_1」の順にナビゲートして、「本体」を選択します。
「To」ナビゲーション・ツリーで、「変数」→「プロセス」→「変数」→「Invoke_ImportOrderCP_InputVariable」にナビゲートして、「InputParameters」を選択します。
ソース・ノード(本体)を、選択したターゲット・ノード(InputParameters)にドラッグします。 これでソース・ノードとターゲット・ノードを接続する線が作成されます。コピー・ルールは、「Assignの編集」ダイアログ・ボックスの下部にある「From」セクションと「To」セクションに表示されます。
パラメータの割当て
「適用」をクリックして、「OK」をクリックし、assignアクティビティの構成を完了します。
BPELプロセス・ダイアグラムの表示
「OrderImportConcurrentProgram」(composite.xml)をクリックして、コンポジット・ダイアグラムを表示します。
コンポジット・ダイアグラムの表示
注意: 「OrderImportConcurrentProgram (composite.xml)」の「ソース」タブをクリックして、参照getOrderDetailsおよびgetCPDetailsの物理ディレクトリinputDirの値を入力します(/usr/tmpなど)。
<property name="inputDir" type="xs:string" many="false" override="may">/usr/tmp</property>
BPELプロセスを使用したSOAコンポジット・アプリケーションを設計したら、次の手順はそれをデプロイ、実行およびモニターすることです。
SOAコンポジットに含まれるBPELクライアントからサービスを起動するには、Oracle WebLogic管理対象サーバーにSOAコンポジットをデプロイする必要があります。それにはOracle JDeveloperが使用できます。コンポジットをデプロイしたら、Oracle Enterprise Manager Fusion Middleware Controlコンソールからテストできます。
前提条件
Oracle JDeveloperを使用してBPELプロセスとともにSOAコンポジットをデプロイする前に、設計時環境とランタイム・サーバーとの間の接続を確立する必要があります。詳細は、「Oracle WebLogic Serverのデータ・ソースの構成」と「アプリケーション・サーバーの接続の作成」を参照してください。
注意: WebLogic Serverのローカル・インスタンスを使用する場合は、Oracle JDeveloperから「実行」→「サーバー・インスタンスの起動」を選択して、WebLogic Serverを起動します。WebLogic Admin Serverの「DefaultServer」インスタンスが正常に起動されると、「実行中: DefaultServer」および「メッセージ」ログに「<サーバーが実行モードで起動されました」および「DefaultServerが起動されました」というメッセージが表示されます。
BPELプロセスを使用したSOAコンポジット・アプリケーションをデプロイする手順は、次のとおりです。
「アプリケーション・ナビゲータ」でSOAコンポジット・プロジェクトを選択します。
プロジェクト名を右クリックし、表示されるメニューから「デプロイ」→[プロジェクト名]→[serverConnection]を選択します。
接続が適切にセットアップされていれば、たとえば、「デプロイ」→「OrderImportConcurrentProgram」→「soa-server1」を選択してプロセスをデプロイできます。
注意: サーバー接続を初めてセットアップすると、「デプロイメント・アクション」ウィンドウが表示されます。「アプリケーション・サーバーにデプロイ」を選択して、「次へ」をクリックします。
「構成のデプロイ」ウィンドウで、次の情報が選択されていることを確認してから「次へ」をクリックすると新しいアプリケーション・サーバーが追加されます。
新規リビジョンID: 1.0
コンポジット・リビジョンをデフォルトとしてマークします: このチェック・ボックスを選択します。
同じリビジョンIDで既存のコンポジットを上書きします: このチェック・ボックスを選択します。
JDeveloperからOracle WebLogic Server接続を新規作成する手順は、「アプリケーション・サーバー接続の作成」に記載されています。
「サーバーの選択」ページで、前に確立したサーバー接続「soa-server1」を選択します。「次」をクリックします。
「SOAサーバー」ページでデフォルトのターゲットSOAサーバー('soa-server1')の選択を受け入れます。
「次へ」をクリックし、「終了」をクリックします。
Oracle JDeveloperセッションからコンポジットを初めてデプロイする場合は、「認証リクエスト」画面が表示されます。Oracle SOA Suiteのインストール中に、指定されたユーザー名とパスワードを入力します。「OK」をクリックします。
デプロイメント処理が開始されます。「SOA - ログ」ウィンドウでデプロイメントの進行とコンパイルの成功を確認します。
「デプロイメント - ログ」ウィンドウでデプロイメントの成功を確認します。
SOAコンポジット・アプリケーションに含まれるBPELプロセスを一度デプロイしたら、Oracle Enterprise Manager Fusion Middleware Controlコンソールからプロセスを管理およびモニターできます。また、プロセスを手動で開始して、プロセスと統合インタフェースをテストすることもできます。
BPELプロセスを使用したデプロイ済SOAコンポジット・アプリケーションをテストする手順は、次のとおりです。
Oracle Enterprise Manager Fusion Middleware Controlコンソールにナビゲートします(http://<サーバー名>:<ポート番号>/em)。デプロイしたコンポジットが「アプリケーション・ナビゲーション」ツリーに表示されます。
ユーザー名(weblogicなど)とパスワードを入力して、「ログイン」をクリックし、ファームにログインします。
複数のターゲットOracle Enterprise Manager Fusion Middleware Controlコンソール・ファームがある場合は、適切なターゲット・インスタンス・ファームを選択する必要がある場合があります。
ファームのベース・ドメインで、「SOA」→「soa-infra (soa_server1)」→「デフォルト」を展開して、SOAインフラストラクチャ・ホーム・ページとメニューをナビゲートし、その管理対象サーバーのSOAインフラストラクチャで実行されているデプロイ済のSOAコンポジット・アプリケーションにアクセスします。
注意: 「ファーム」メニューは常にナビゲータの最上部に表示されます。ナビゲータで「SOA」フォルダを展開し、その下に表示されるリンクをクリックすると、ページの最上部で「SOAインフラストラクチャ」メニューを使用できるようになります。
SOAインフラストラクチャから、開始するSOAコンポジット・アプリケーション(「OrderImportConcurrentProgram」など)をクリックします。
デプロイ済SOAコンポジットの表示
ページの最上部で「テスト」をクリックします。
インスタンスを起動するための「Webサービスのテスト」ページが表示されます。「入力引数」セクションで使用するXMLペイロード・データを指定できます。
プロセスに必要な入力文字列を入力して、「Webサービスのテスト」をクリックし、プロセスを起動します。
Webサービスのテスト
完了すると、「レスポンス」タブにテスト結果が表示されます。
「レスポンス」タブでの結果の表示
「Webサービスのテスト」ページの「フロー・トレースの起動」をクリックします。「フローのトレース」ページが表示されます。
「トレース」セクションに、一連のメッセージ・フロー(サービス・バインディング・コンポーネント(orderimportconcurrentprogram_client_ep)、BPELコンポーネント(OrderImportConcurrentProgram)および参照バインディング・コンポーネント(getOrderDetails、getCPDetails、InsertOrderおよびImportOrderCP))が表示されます。関連するすべてのコンポーネントが、メッセージを正常に受信および処理しました。
「フローのトレース」ページでの実行ステータスの表示
テスト中にエラーが発生した場合は、「フォルト」セクションに表示されます。
BPELサービス・コンポーネント・インスタンスのリンク(OrderImportConcurrentProgramなど)をクリックすると、「インスタンス」ページが表示され、「監査証跡」タブで、BPELアクティビティの実行詳細を表示できます。
BPELプロセス・フロー・ダイアグラムを確認するには、フロー・タブをクリックします。アクティビティの詳細およびプロセス全体のペイロードのフローを表示するには、プロセス・ダイアグラムのアクティビティをクリックします。
BPELプロセスを検証するには、Oracle E-Business Suiteフォームにログオンして、コンカレント・プログラムの実行のステータスをチェックします。それが正常に実行された後、購買オーダーもOracle E-Business Suiteアプリケーションに作成する必要があります。
Oracle E-Business Suiteアプリケーションでレコードを検証する手順は、次のとおりです。
「受注管理スーパーユーザー、Visionオペレーション (USA)」職責でOracle E-Business Suiteにログオンします。
「受注、返品」→「受注」を選択して、「受注」フォームを開きます。
販売注文の作成の検証
[F11]キーを押して、オーダーを検索します。「顧客発注」フィールドに、xmlファイルに存在するオーダーIDを入力します。たとえば、order_id_01と入力し、[CTRL]+[F11]キーを押して、問合せを実行します。
新しく作成されたオーダーが、オーダーID order_id_01として表示されます。
「明細項目」タブを選択して、オーダーの数量と品目タイプがxmlファイルに存在する値と同じであるかどうかを確認します。
または、次のSQL文を使用して、データベースに問合せることにより、結果を検証することもできます。
Select orig_sys_document_ref from oe_order_headers_all where orig_sys_document_ref = 'order_id_01';
コンカレント・プログラムの統合で問題が発生した場合は、次のトラブルシューティング手順を実行します。
複雑なデータ型(ブールなど)を使用している場合は、コンカレント・プログラムのターゲット・インスタンスにPL/SQLラッパーが適用されていることを確認します。
「オープン・インタフェース・トラッキング」フォームでトランザクション・データを確認します。
リクエストIDを使用して、コンカレント・プログラムのステータスをチェックします。
アダプタのロギングを有効化して、ミドルウェア側に問題がないか確認します。ログを有効化する方法の詳細は、ログのグローバルな有効化を参照してください。
Copyright © 2005, 2016, Oracle and/or its affiliates. All rights reserved.