Oracle® Fusion Middleware Oracle WebLogic Server Application Adapter for SAP R/3(SAP JCo 3.0)ユーザーズ・ガイド 11g リリース1 (11.1.1.3.0) B61422-01 |
|
前 |
次 |
この章では、 Oracle SOA Suiteでのメディエータ・サービス・コンポーネントとの統合について説明します。次のトピックについて説明します。
この章で示すシナリオには、次の前提条件が必要です。
前提条件
次は、インストールおよび構成に関する要件です。
Oracle Application Adapter for SAP R/3がOracle WebLogic Serverにインストールされている必要があります。
インバウンドとアウトバウンドの処理用にSAPを構成する必要があります。詳細は、付録A「SAPリモート・プロセスにおけるSAPのシステム・ロールについて」を参照してください。
この章の例では、SAPとのサービスおよびイベント統合を示すのに必要な構成手順について説明しています。これを使用する前に、次のことについて理解する必要があります。
サービスおよびイベント用にOracle Application Adapter for SAP R/3を構成する方法。詳細は、第4章「Oracle Application Adapter for SAP R/3の構成」を参照してください。
Oracle JDeveloperを構成する方法。詳細は、第6章「Oracle SOA SuiteでのBPELサービス・コンポーネントの統合」を参照してください。
メディエータ統合の概要
メディエータは、包括的なアプリケーション統合フレームワークを提供します。Oracle Application Adapter for SAP R/3をメディエータと使用することにより、カスタム・コードを必要とせずに、シームレスにエンタープライズ・ソフトウェアを統合できます。カスタム・コード・ソリューションではなく機能的なモデリングなので、ソフトウェア再利用が可能になり、ソフトウェアのライフサイクルで発生する複雑さや管理上の問題を削減します。この統合モデルは、高レベルの統合ロジックと低レベルのプラットフォーム・サービスの2つのコンポーネントで構成されています。
Oracleとのアダプタの統合。メディエータは次の2つのステップからなるプロセスです。
設計時:Oracle Application Adapter for SAP R/3は、サービスおよびイベント用にアプリケーション・エクスプローラで構成されます。これについては、第4章「Oracle Application Adapter for SAP R/3の構成」を参照してください。統合論理は、メディエータでモデル化されています。
実行時: 基になるプラットフォームでは、このメタデータをランタイム・インストラクションとして処理し、特定のアプリケーション間の通信を可能にします。
Oracle JDeveloperでの新規のアプリケーション・サーバー接続の構成の詳細は、「新規アプリケーション・サーバー接続の構成」を参照してください。
次の例では、Oracle JDeveloperでメディエータ・プロジェクトを使用して、SAPシステム用にメディエータ・アウトバウンド・プロセスを構成する方法について説明します。
前提条件
メディエータ・アウトバウンド・プロセスを設計する前に、アプリケーション・エクスプローラを使用して各WSDLファイルを生成する必要があります。詳細は、「リクエスト/レスポンス型のサービス用のWSDLの生成」を参照してください。
この項では、次のステップで構成されるメディエータ・アウトバウンド・プロセスの定義方法について説明します。
サード・パーティ・アダプタ・サービス・コンポーネントの構成
アウトバウンド・メディエータ・プロセス・コンポーネントの構成
ルーティング・ルールの構成
サード・パーティ・アダプタ・サービス・コンポーネントの構成
サード・パーティ・アダプタ・サービス・コンポーネントを作成するには、次のステップを実行します:
図7-4に示すように、「サービス・アダプタ」ペインから「サード・パーティ・アダプタ」コンポーネントを「外部参照」ペインにドラッグ・アンド・ドロップします。
図7-5に示すように、「サード・パーティ・アダプタ・サービスの作成」ダイアログが表示されます。
サード・パーティ・アダプタ・サービスの名前を入力します。
「タイプ」ドロップダウン・リストから「参照」が選択されていることを確認してください(デフォルト)。
「WSDL URL」フィールドの右の既存のWSDLを検索アイコンをクリックします。
図7-6に示すように、「SOAリソース・ブラウザ」ダイアログが表示されます。
次のディレクトリまでブラウズし、アウトバウンドWSDLファイルを選択します。
<ADAPTER_HOME>
\soa\thirdparty\ApplicationAdapters\wsdls
「OK」をクリックします。
図7-7に示すように、「ファイルのローカライズ」ダイアログが表示されます。
「OK」をクリックします。
アウトバウンドWSDLファイルおよび関連リクエスト/レスポンスXMLスキーマ・ファイル(.xsd)が、作成済のプロジェクト・フォルダにインポートされます。
図7-8に示すように、「サード・パーティ・アダプタ・サービスの作成」ダイアログに戻ります。
「JCAファイル」フィールドの右の JCAファイルの検索アイコンをクリックします。
図7-9に示すように、「SOAリソース・ブラウザ」ダイアログが表示されます。
次のディレクトリまでブラウズし、JCAプロパティ・ファイルを選択します。
<ADAPTER_HOME>
\soa\thirdparty\ApplicationAdapters\wsdls
「OK」をクリックします。
図7-10に示すように、「ファイルのコピー」メッセージが表示されます。
「はい」をクリックします。
JCAプロパティ・ファイルのコピーがプロジェクト・フォルダ内に作成されます。
図7-11に示すように、「サード・パーティ・アダプタ・サービスの作成」ダイアログに戻ります。
「OK」をクリックします。
サード・パーティ・アダプタ・サービス・コンポーネント(GetDetail)が作成され、図7-12に示すように、「外部参照」ペインに表示されます。
これで、アウトバウンド・メディエータ・プロセス・コンポーネントを構成する準備ができました。
アウトバウンド・メディエータ・プロセス・コンポーネントの構成
アウトバウンド・メディエータ・プロセス・コンポーネントを構成するには、次のステップを実行します:
図7-13に示すように、「サービス・コンポーネント」ペインからメディエータ・プロセス・コンポーネントを「コンポーネント」ペインにドラッグ・アンド・ドロップします。
図7-14に示すように、「メディエータの作成」ダイアログが表示されます。
「名前」フィールドで、新規のアウトバウンド・メディエータ・プロセス・コンポーネントの名前を入力します(「CompanyCode_GetDetail」など)。
「テンプレート」ドロップダウン・リストで「同期インタフェース」を選択します。
関連するXMLリクエスト・スキーマ・ファイルの選択用の「入力」フィールドの右の「参照」アイコンをクリックします。
図7-15に示すように、「タイプ・チューザ」ダイアログが表示されます。
「プロジェクトのWSDLファイル」、「CC_GetDetail_invoke_Nov18.wsdl」、「インライン・スキーマ」の順に展開し、「CompanyCode.GetDetail」を選択します。
「OK」をクリックします。
図7-16に示すように、「メディエータの作成」ダイアログに戻ります。
関連するXMLレスポンス・スキーマ・ファイルの選択用の「出力」フィールドの右の「参照」アイコンをクリックします。
図7-17に示すように、「タイプ・チューザ」ダイアログが表示されます。
「プロジェクトのWSDLファイル」、「CC_GetDetail_invoke_Nov18.wsdl」、「インライン・スキーマ」、「スキーマ」の順に展開し、「CompanyCode.GetDetailResponse」を選択します。
「OK」をクリックします。
図7-18に示すように、「メディエータの作成」ダイアログに戻ります。
「OK」をクリックします。
図7-19に示すように、アウトバウンド・メディエータ・プロセス・コンポーネント(CompanyCode_ GetDetail)とサード・パーティ・アダプタ・サービス・コンポーネント(GetDetail)間の接続を作成します。
これで、ルーティング・ルールを構成する準備ができました。
ルーティング・ルールの構成
メディエータ・アウトバウンド・プロセス・コンポーネントのルーティング・ルール構成するには、次のステップを実行します:
図7-20に示すように、「コンポーネント」ペインでアウトバウンド・メディエータ・プロセス・コンポーネント(CompanyCode_ GetDetail)をダブルクリックします。
図7-21に示すように、「ルーティング・ルール」ダイアログが表示されます。
「フィルタ式」領域で、「次を使用して変換」の右側のアイコンをクリックします。
図7-22に示すように、「リクエスト・トランスフォーメーション・マップ」ダイアログが表示されます。
「新規マッパー・ファイルの作成」オプションを選択し、「OK」をクリックします。
図7-73に示すように、次のマッピング・ページが表示されます。
「iWayRequest:CompanyCode.GetDetail」ソース要素を「iWayRequest:CompanyCode.GetDetail」ターゲット要素にマップします。
図7-24に示すように、「自動マップ・プリファレンス」ダイアログが表示されます。
デフォルト値を維持し、「OK」をクリックします。
図7-25に示すように、「ルーティング・ルール」ダイアログに戻ります。
「同期リプライ」領域で、「次を使用して変換」の右側のアイコンをクリックします。
図7-26に示すように、「リプライ・トランスフォーメーション・マップ」ダイアログが表示されます。
「新規マッパー・ファイルの作成」オプションを選択し、「OK」をクリックします。
図7-27に示すように、マッピング・ページが表示されます。
「WayResponse:CompanyCode.GetDetail.Response」ソース要素を「iWayResponse:CompanyCode.GetDetail.Response」ターゲット要素にマップします。
図7-28に示すように、「自動マップ・プリファレンス」ダイアログが表示されます。
デフォルト値を維持し、「OK」をクリックします。
図7-29に示すように、マッピングが完成しました。
メニュー・バーで「すべて保存」アイコンをクリックし、構成された新規のアウトバウンド・メディエータ・プロセス・コンポーネントを保存します。
これで、メディエータ・アウトバウンド・プロセスをデプロイする準備ができました。
メディエータ・アウトバウンド・プロセスをデプロイするには、次のステップを実行します:
図7-30に示すように、左ペインでプロジェクト名を右クリックし(「sampleTest」など)、コンテキスト・メニューから「デプロイ」を選択して、「sampleTest」をクリックします。
図7-31に示すように、「デプロイメント・アクション」ページが表示されます。
「アプリケーション・サーバーにデプロイ」が選択されていることを確認します。
「Next」をクリックします。
図7-32に示すように、「構成のデプロイ」ページが表示されます。
デフォルト値を選択したままにし、「Next」をクリックします。
図7-33に示すように、「サーバーの選択」ページが表示されます。
構成済の使用可能なアプリケーション・サーバーを選択し、「Next」を選択します。
図7-34に示すように、「SOAサーバー」ページが表示されます。
ターゲットのSOAサーバーを選択し、「Next」をクリックします。
図7-35に示すように、「サマリー」ページが表示されます。
プロジェクトに使用可能なすべてのプロジェクトをレビューおよび確認し、「終了」をクリックします。
図7-36に示すように、プロセスが正常にデプロイされます。
次の例では、Oracle JDeveloperでメディエータ・プロジェクトを使用して、SAPシステム用にメディエータ・インバウンド・プロセスを構成する方法について説明します。
前提条件
メディエータ・インバウンド・プロセスを設計する前に、アプリケーション・エクスプローラを使用して、各WSDLファイルを生成する必要があります。詳細は、「イベント統合のためのWSDLの生成」を参照してください。
この項では、次のステップで構成されるメディエータ・インバウンド・プロセスの定義方法について説明します。
サード・パーティ・アダプタ・サービス・コンポーネントの構成
ファイル・アダプタを使用したインバウンド・メディエータ・プロセス・コンポーネントの構成
ルーティング・ルールの構成
サード・パーティ・アダプタ・サービス・コンポーネントの構成
サード・パーティ・アダプタ・サービス・コンポーネントを作成するには、次のステップを実行します:
図7-43に示すように、「サービス・アダプタ」ペインから「サード・パーティ・アダプタ」コンポーネントを「公開されたサービス」ペインにドラッグ・アンド・ドロップします。
図7-44に示すように、「サード・パーティ・アダプタ・サービスの作成」ダイアログが表示されます。
サード・パーティ・アダプタ・サービスの名前(CC_GetDetail_Mediator_IBなど)を入力します。
「タイプ」ドロップダウン・リストから「サービス」が選択されていることを確認してください(デフォルト)。
「WSDL URL」フィールドの右の既存のWSDLを検索アイコンをクリックします。
図7-45に示すように、「SOAリソース・ブラウザ」ダイアログが表示されます。
次のディレクトリまでブラウズし、インバウンドWSDLファイルを選択します。
<ADAPTER_HOME>
\soa\thirdparty\ApplicationAdapters\wsdls
「OK」をクリックします。
図7-46に示すように、「ファイルのローカライズ」ダイアログが表示されます。
「OK」をクリックします。
インバウンドWSDLファイルおよび関連リクエスト/レスポンス・スキーマ・ファイル(.xsd)が、作成済のプロジェクト・フォルダにインポートされます。
図7-47に示すように、「サード・パーティ・アダプタ・サービスの作成」ダイアログに戻ります。
「JCAファイル」フィールドの右の JCAファイルの検索アイコンをクリックします。
図7-48に示すように、「SOAリソース・ブラウザ」ダイアログが表示されます。
次のディレクトリまでブラウズし、JCAプロパティ・ファイルを選択します。
<ADAPTER_HOME>
\soa\thirdparty\ApplicationAdapters\wsdls
「OK」をクリックします。
図7-49に示すように、次のメッセージが表示されます。
「はい」をクリックします。
JCAプロパティ・ファイルのコピーがプロジェクト・フォルダ内に作成されます。
図7-50に示すように、「サード・パーティ・アダプタ・サービスの作成」ダイアログに戻ります。
「OK」をクリックします。
サード・パーティ・アダプタ・サービス・コンポーネント(CC_GetDetail_Mediator_IB)が作成され、図7-51に示すように、「公開されたサービス」ペインに表示されます。
これで、インバウンド・メディエータ・プロセス・コンポーネントを構成する準備ができました。
ファイル・アダプタを使用したインバウンド・メディエータ・プロセス・コンポーネントの構成
ファイル・アダプタを使用してインバウンド・メディエータ・プロセス・コンポーネントを構成するには、次のステップを実行します:
図7-52に示すように、「サービス・コンポーネント」ペインからメディエータ・プロセス・コンポーネントを「コンポーネント」ペインにドラッグ・アンド・ドロップします。
図7-53に示すように、「メディエータの作成」ダイアログが表示されます。
「名前」フィールドで、新規のインバウンド・メディエータ・プロセス・コンポーネントの名前を入力します(「CC_GetDetail_Mediator_IB」など)。
「テンプレート」ドロップダウン・リストで「インタフェースを後で定義」を選択します。
「OK」をクリックします。
図7-54に示すように、「コンポーネント」ペインに新規メディエータ・プロセス・コンポーネントが追加されます。
「サービス・アダプタ」ペインから「ファイル・アダプタ」コンポーネントを「外部参照」ペインにドラッグ・アンド・ドロップします。
図7-55に示すように、アダプタ構成ウィザードの「サービス名」ページが表示されます。
「サービス名」フィールドで、新規の「ファイル」アダプタの名前を入力し、「Next」をクリックします。
図7-56に示すように、「アダプタ・インタフェース」ページが表示されます。
「操作およびスキーマから定義(後で指定)」オプションが選択されていることを確認します。
「Next」をクリックします。
図7-57に示すように、「操作」ページが表示されます。
「操作タイプ」オプションのリストからSelect 「Write File」を選択し、「操作名」(「Write」など)を指定します。
「Next」をクリックします。
図7-58に示すように、「ファイル構成」ページが表示されます。
出力ファイルの書込み先となるファイル・システム上の場所を指定します。
「ファイル・ネーミング規則」フィールドで、出力ファイルの名前を指定します。
「Next」をクリックします。
図7-59に示すように、「メッセージ」ページが表示されます。
「URL」フィールドの右の「参照」アイコンをクリックします。
図7-60に示すように、「タイプ・チューザ」ダイアログが表示されます。
「プロジェクトのWSDLファイル」、「BAPI_COMPANYCODE_GETDETAIL_receive.wsdl」、「インライン・スキーマ」、「スキーマ」の順に展開します。
使用可能なプロジェクト(「BAPI.CompanyCode.GetDetail」など)を選択します。
「OK」をクリックします。
図7-61に示すように、「メッセージ」ページに戻ります。
「Next」をクリックします。
図7-62に示すように、「終了」ページが表示されます。
「終了」をクリックします。
図7-63に示すように、インバウンド・メディエータ・プロセス・コンポーネントとサード・パーティ・アダプタ・サービス・コンポーネント間の接続を作成します。
図7-64に示すように、インバウンド・メディエータ・プロセス・コンポーネントとファイル・アダプタ・コンポーネント間の接続を作成します。
これで、ルーティング・ルールを構成する準備ができました。
ルーティング・ルールの構成
メディエータ・インバウンド・プロセス・コンポーネントのルーティング・ルール構成するには、次のステップを実行します:
図7-65に示すように、「コンポーネント」ページでインバウンド・メディエータ・プロセス・コンポーネントをダブルクリックします。
図7-66に示すように、「ルーティング・ルール」ダイアログが表示されます。
「フィルタ式」領域で、「次を使用して変換」の右側のアイコンをクリックします。
図7-67に示すように、「リクエスト・トランスフォーメーション・マップ」ダイアログが表示されます。
「新規マッパー・ファイルの作成」オプションを選択し、「OK」をクリックします。
図7-68に示すように、マッピング・ページが表示されます。
「iWayEvent:BAPI_COMPANYCODE_GETDETAIL」ソース要素を「iWayEvent:BAPI_COMPANYCODE_GETDETAIL」ターゲット要素にマップします。
図7-69に示すように、「自動マップ・プリファレンス」ダイアログが表示されます。
デフォルト値を維持し、「OK」をクリックします。
「ルーティング・ルール」ダイアログに戻ります。これでマッピングは完了です。
メニュー・バーで「すべて保存」アイコンをクリックし、構成された新規のインバウンド・メディエータ・プロセス・コンポーネントを保存します。
これで、メディエータ・インバウンド・プロセスをデプロイする準備ができました。「BPELインバウンド・プロセスのデプロイ」と同じ手順に従います。
SAP GUIを介してイベント・メッセージがトリガーされたら、出力XMLが、「ファイル・アダプタ」コンポーネントで指定済の場所で受信されます。SAP R/3でのイベントのトリガー方法の詳細は、「SAP R/3でのイベントのトリガー」を参照してください。