| Oracle Cloud Oracle E-Business Suiteアダプタの使用 リリース18 品番E66534-10 | 目次 | 前 | 次 |
サンプル・ビジネス・シナリオ
この例では、Oracle E-Business Suiteアダプタを使用してOracle Integration Cloud Serviceで統合をトリガーすることを説明するために、ビジネス・イベントOIP状況更新通知のイベント(oracle.apps.ont.oip.statuschange.update)が使用されています。
この例では、受注がビジネス・フローの一部として登録されると、Oracle Order Managementはイベントoracle.apps.ont.oip.statuschange.updateを発生させ、Oracle Accounts Receivablesに請求書を作成します。
Oracle E-Business Suiteアダプタを介したトリガー(ソース)接続としてOracle E-Business Suite Order Managementを使用し、汎用RESTアダプタを介した呼出し(ターゲット)接続としてOracle E-Business Suite Accounts Receivablesを使用する、「Order to Invoice」という名前の統合をデザインタイムに作成します。 「Order to Invoice」統合はこのビジネス・イベントにサブスクライブします。
実行時に受注のステータスが受注ヘッダーで変更されると、統合をトリガーするOracle E-Business Suite受注管理でビジネス・イベントoracle.apps.ont.oip.statuschange.updateが発生します。 販売オーダーのステータスが「Booked」である場合は、Oracle E-Business Suite Order Managementからオーダーの詳細情報がフェッチされます。 Oracle E-Business Suiteアダプタは、Order Managementからのイベント・ペイロードとしてオーダー詳細を準備および伝播し、Oracle Integration Cloud Serviceの統合エンドポイントを呼び出します。 その結果、Oracle Accounts Receivablesでドラフト請求書が作成されます。
前提
RESTサービスには、Oracle Integration Cloud Serviceから直接アクセスできるものとします。したがって、この例ではICS接続性エージェントを使用しません。
この例では、Oracle E-Business Suite Order ManagementとOracle E-Business Suite Accounts Receivablesが2つの異なるインスタンスとして使用されます。
Oracle Integration Cloud Serviceの統合でのビジネス・イベントの使用
統合シナリオに基づいて、この項では次のタスクが含まれています。
Oracle E-Business Suite接続を追加する前に、次のOracle E-Business Suiteインスタンスを準備して、必要な設定または構成を行います。
次のタスクを実行して、Oracle E-Business Suite Order Managementで必要な設定および構成が行われ、Oracle Integration Cloud Serviceでの統合の準備が完了していることを確認します。
必要な設定タスクを実行して、Oracle E-Business Suiteアダプタを有効化してください。
これらのタスクには、Oracle E-Business Suite RESTサービスの構成、これらのサービスへのアクセスの構成、Oracle E-Business Suiteでの必要なRESTサービスのデプロイ、およびこれらのサービスに対するユーザー権限の付与が含まれます。
具体的には、次のRESTサービスをデプロイして、operationsユーザーの権限を付与してください:
メタデータ・プロバイダRESTサービス
サービス別名名として"provider"を指定してメタデータ・プロバイダAPIをデプロイ
APIに含まれるすべてのメソッドに対してGET HTTPメソッドを使用して、メタデータ・プロバイダAPIをデプロイします
「すべて」のアクセス権をoperationsユーザーにAPIに含まれるメソッドに与える
イベント・マネージャRESTサービス
サービス別名名としてsubscriptionを含むEvent Manager APIをデプロイ
APIに含まれるすべてのメソッドに対してPOST HTTPメソッドを使用して、イベント・マネージャAPIをデプロイします
「すべて」のアクセス権をoperationsユーザーにAPIに含まれるメソッドに与える
これらのタスクの手順の詳細は、「Oracle E-Business Suiteアダプタを有効化するための設定タスク」を参照してください。
必要な設定タスクを実行して、インバウンド(トリガーおよびソース)統合を有効化してください。
これらのタスクには、Oracle E-Business Suite FND VaultへのICSユーザー資格証明の保存、Oracle E-Business SuiteのプロキシURLの設定、およびOracle E-Business SuiteへのSSL証明書のインポートが含まれます。 手順の詳細は、「Oracle E-Business Suiteアダプタをトリガー(ソース)接続として使用するための設定タスク」を参照してください。
Order Management API OE_ORDER_PUB (Process Order)をRESTサービスとしてデプロイし、メソッドのアクセス権をoperationsユーザーに付与します。
この例では、APIに含まれるGet Orderメソッドのみをoperationsユーザーに付与します。
プロファイル・オプション"OM: ステータス変更ビジネス・イベントの発生はYesに設定されています。
次のタスクを実行して、Oracle Integration Cloud Serviceの統合でOracle E-Business Suite Accounts Receivablesの設定と構成を使用する準備が完了していることを確認します。
Oracle E-Business Suite統合SOAゲートウェイRESTサービスを構成します。
My Oracle Supportナレッジ・ドキュメント556540.1に記載されている設定タスクに従って、Oracle E-Business Suite統合SOAゲートウェイ・リリース12.1.3を構成し、RESTサービスのパッチを適用してRESTサービスの機能を有効化します。 詳細は、「Oracle E-Business Suiteアダプタを有効化するための設定タスク」のステップ1を参照してください。
請求書作成APIをRESTサービスとして以下の要件でデプロイし、operationsユーザーに希望のメソッドのアクセス権を付与します:
サービス別名名としてinvoiceを含む請求書作成APIをデプロイ
POSTを使用した請求書作成APIのデプロイAPIに含まれるCreate Single InvoiceメソッドのHTTPメソッドのみ
ノート: PL/SQL APIは、POST HTTPメソッドでのみ、RESTサービスとして公開できます。
operationsユーザーへのAPIに含まれるCreate Single Invoiceメソッドのアクセス権のみを付与
RESTサービスのデプロイの詳細は、Oracle E-Business Suite統合SOAゲートウェイ実装ガイドのREST Webサービスのデプロイ、ネイティブ統合インタフェースおよびサービスの管理に関する項を参照してください。
RESTサービスへのセキュリティ付与の作成の詳細は、Oracle E-Business Suite統合SOAゲートウェイ実装ガイドのSOAPおよびREST Webサービスのサポート付きインタフェースに関する付与の管理、ネイティブ統合インタフェースおよびサービスの管理に関する項を参照してください。
統合を作成する前に、この例の後の手順で使用する、次の接続を確立する必要があります。
この項では、Oracle E-Business Suiteアダプタを使用してOracle E-Business Suite Order Managementインスタンスの接続を作成する方法について説明します。 この接続は、後の手順で統合のトリガー(ソース)として追加されます。
次のステップを実行して、Oracle Integration Cloud ServiceでのOracle E-Businss Suite Order Managementの接続を確立します。
Oracle Integration Cloud Serviceにログインします。
Oracle Integration Cloud Serviceのホーム・ページで「Connections」をクリックします。
「Create New Connection」をクリックします。
「In the Create Connection - Select Adapter」ダイアログが表示されます。
ダイアログから「Oracle E-Business Suite」を探すために名前の全部または一部を入力することで、Oracle E-Business Suiteアダプタを見つけることができます。
たとえば、「Search」フィールドに「Oracle E-Business Suite」と入力します。 アダプタのリストからOracle E-Business Suiteアダプタがフィルタされます。
「Oracle E-Business Suite」の「Select」ボタンをクリックして、Oracle E-Business Suiteアダプタを使用します。 「New Connection - Information」ダイアログが表示されます。
Oracle E-Business Suite Order Management接続に関する次の情報を入力します。
Order Management接続の作成

Connection Name: 「Order Management」と入力します。
Identifier: 「ORDER_MANAGEMENT」などのデフォルトで入力されている識別子を受け入れます。
接続のロール:この接続のトリガーと呼び出しロールを選択します。
Description: 説明として「Create an Oracle E-Business Suite Order Management connection」と入力します。
「Create」をクリックして、接続を作成します。
作成した「Order Management」接続の「Connection Details」ページが表示されます。 次の情報を指定して追加の接続詳細を入力します。
「Email Address」: この接続で問題または変更が発生する場合に通知を受信する管理者の電子メール・アドレスを入力します。
接続プロパティ : 接続の構成をクリックして「接続プロパティ」ダイアログを開き、Oracle E-Business Suite Order Managementインスタンスに接続するURL (http://<ebs host name>:<port>)を入力します。
「OK」をクリックして、作業を保存します。
Security: 「Configure Security」をクリックして、「Credentials」ダイアログを開きます。
operationsをユーザー名として入力し、関連するパスワードをCredentialsダイアログに入力して、前述の「接続プロパティ」ダイアログで指定したOracle E-Business Suite Order Managementインスタンスにアクセスします。
「OK」をクリックして、作業を保存します。
必要な接続情報を指定すると、「Order Management」接続の詳細ページが表示されます。
「Test」をクリックして、作成した「Order Management」接続をテストします。
「Save」をクリックして、接続を保存します。
「Exit Connection」をクリックします。
Oracle E-Business Suite接続「Order Management」がConnectionsページに表示されます。
前述のように、この例ではOracle E-Business Suite Order ManagementとOracle E-Business Suite Accounts Receivablesが2つの異なるインスタンスとして使用されるため、RESTアダプタを使用してOracle Accounts Receivablesインスタンスの接続を作成する必要があります。 この接続は、後の手順で統合の呼出し(ターゲット)として追加されます。
Oracle Integration Cloud Serviceにログインします。
Oracle Integration Cloud Serviceのホーム・ページで「Connections」をクリックします。
「Create New Connection」をクリックします。
「In the Create Connection - Select Adapter」ダイアログが表示されます。
「Search」フィールドに「REST」と入力します。 アダプタのリストからRESTアダプタがフィルタされます。
「Create Connection - Select Adapter」ダイアログでのRESTアダプタの検索

「REST」の「Select」ボタンをクリックして、RESTアダプタを使用します。 「New Connection - Information」ダイアログが表示されます。
Oracle E-Business Suite Accounts Receivables接続に関する次の情報を入力します。
Accounts Receivables接続の作成

Connection Name: 接続名として「Receivables」を入力します。
Identifier: 「RECEIVABLES」などのデフォルトで入力されている識別子を受け入れます。
接続のロール:この接続のトリガーと呼び出しロールを選択します。
Description: 説明として「Create a connection for Oracle E-Business Suite Receivables」と入力します。
「Create」をクリックして、接続を作成します。
作成した「Receivables」接続の「Connection Details」ページが表示されます。 次の情報を指定して追加の接続詳細を入力します。
「Email Address」: この接続で問題または変更が発生する場合に通知を受信する管理者の電子メール・アドレスを入力します。
「Configure Connectivity」をクリックして、「Connection Properties」ダイアログを開きます。 次の情報を入力します。
Connection Type: 「REST API Base URL」を選択します。
接続URL: Receivablesインスタンスの準備中に先にデプロイしたinvoice別名名を含む請求書作成RESTサービスの接続URL (http://<ebs host name>:<port>/webservices/rest/invoice)を入力します。
RESTアダプタを介した接続プロパティの入力

「OK」をクリックして、作業を保存します。
Security: 「Configure Security」をクリックして、「Credentials」ダイアログを開きます。
デフォルト・セキュリティ・ポリシーとして「Basic Authentication」を受け入れます。
operationsをユーザー名として入力し、関連するパスワードをCredentialsダイアログに入力して、先に「接続プロパティ」ダイアログで指定した請求書作成RESTサービスにアクセスします。
「Credentials」ダイアログでのユーザー資格証明の入力

「OK」をクリックして、作業を保存します。
「Test」をクリックし、Oracle E-Business Suite Accounts Receivablesに指定した接続をテストします。
「Save」をクリックして、接続を保存します。
「Exit Connection」をクリックします
Oracle E-Business Suite接続「Receivables」が「Connections」ページに表示されるようになりました。
前述のビジネス・シナリオに基づいて、オーケストレーション・パターンを使用して「Order to Invoice」という名前の統合を作成します。 このパターンを使用すると、トリガーをオーケストレートし、呼び出し、また必要に応じてアクティビティを統合のプロセス・ダイアグラムに切り替えることができます。 必要に応じて、後で切替え分岐にマッピングを追加することもできます。
この項では、オーケストレーション・パターンを使用して統合を作成する方法について説明します。 各アクティビティをダイアグラムに追加するための情報は、この章で後述します。
次のステップを実行して統合を作成します。
Integration Cloud Serviceのツールバーで「Designer」をクリックします。
「Designer Portal」で、「Integrations」をクリックします。
Integrationsページで、「New Integration」をクリックします。
「Create Integration - Select a Style/Pattern」ダイアログが表示されます。
この例で使用する「Orchestration」統合パターンの「Select」をクリックします。
オーケストレーション・パターンを使用した統合の作成

「New Integration - Information」ダイアログが表示されます。 次の情報を入力します。
「What do you want to call your integration?」 統合についてわかりやすい「Order to Invoice」などの名前を入力します。
Identifier: デフォルトの識別子値「ORDER_TO_INVOICE」を受け入れます。
「Version」: デフォルトのバージョン番号を受け入れます。
「What does this integration do?」 この統合の説明として「Create an integration for order to invoice」と入力します。
「Which package does this integration belong to?」 空のままにしてください。
「New Integration - Information」ダイアログへの統合情報の入力

「Create」および「Save」をクリックします。
統合を完成させるには、以降の項で説明する次のタスクを追加する必要があります。
作成した統合に目的の接続を追加します。
統合へのOracle E-Business Suiteアダプタ(トリガー)の追加およびRESTアダプタ(呼出し)の追加を参照してください。
統合にマッピングを追加します。
マッピングの作成を参照してください。
追跡のためのビジネス識別子を割り当てます。
追跡のためのビジネス識別子の割当てを参照してください。
この例では、統合に次のアクティビティを追加します。
Oracle E-Business SuiteアダプタをOracle E-Business Suite Order Managementインスタンスの「Order_Status_Update」という名前のトリガー・アクティビティとして追加します。
このトリガー・アクティビティは、Oracle E-Business Suiteアダプタを介してビジネス・イベントoracle.apps.ont.oip.statuschange.updateを使用します。 販売オーダーのステータスが更新されると、Oracle Order Managementがこのイベントを発行します。
2つの分岐を持つ切替えを追加します。 「Booked Order」という名前の定義済の分岐には、統合の主オーケストレーション・フローが含まれており、他方の分岐は「それ以外の場合」の分岐であり、この例では使用しません。
「Get_Order」のマッピングを定義します。
これによって、「Get_Order」アクティビティにオーダーに関連するパラメータをマップして渡し、GET_ORDER RESTサービスを呼び出すことができます。
マッピングの作成を参照してください。
Oracle E-Business SuiteアダプタをOracle E-Business Suite Order Managementインスタンスの「Get_Order」という名前の呼出しアクティビティとして追加します。
Oracle E-Business Suiteアダプタを呼出しとして追加した場合、この呼出しアクティビティはProcess Order (OE_ORDER_PUB) RESTサービスのGET_ORDER操作を使用します。 このサービスは販売オーダー情報を取得します。
「Create_Invoice」のマッピングを定義します。
このアクティビティは、販売オーダーに関連する要素を「Get_Order」アクティビティから「Create_Invoice」アクティビティの請求書に関連する要素に割り当てます。
マッピングの作成を参照してください。
RESTアダプタをOracle E-Business Suite Accounts Receivablesインスタンスの「Create_Invoice」という名前の呼出しアクティビティとして追加します。
このアクティビティは、XMLスキーマ・ファイル・タイプを使用してリクエスト・ペイロードを構成してから、Oracle Accounts ReceivablesでCREATE_SINGLE_INVOICE RESTサービスを呼び出すことによって請求書を作成します。
ビジネス・イベントを使用したOracle E-Business Suiteアダプタのトリガーとしての追加
次のステップを実行して、Oracle E-Business Suite Order Management接続の「Order_Status_Update」という最初のアクティビティを追加します。
「Order to Invoice」の統合ページで、「Order Management」というOracle E-Business Suite接続を、左側の「TRIGGERS」ツールバーから、統合キャンバスの円で囲まれた大きい+のセクションにドラッグ・アンド・ドロップします。
Order Management接続を中央にドラッグして統合を開始

Configure Oracle E-Business Suite Adapter Endpointウィザードが表示されます。
「Basic Info」ページで次の情報を入力します。
What do you want to call your endpoint? - エンドポイント名として「Order_Status_Update」を入力します。
What does this endpoint do? - この統合エンドポイントの説明を入力します。
「What do you want to configure the endpoint for?」 - 「Business Event」を選択します。
ビジネス・イベントを使用したアダプタ・エンドポイントに関する基本情報の入力

「Next」をクリックして、残りの構成に進みます。
「Business Events」ページで、接続に関する次の情報を指定します。
Product Family: ドロップダウン・リストから「Order Management Suite」を選択します。
Product: ドロップダウン・リストから「Order Management」を選択します。
Business Event: 移入されたリストから「Event for OIP status update notification」を選択します。
イベント名を選択すると、内部名(oracle.apps.ont.oip.statuschange.update)と説明を含む対応するイベント情報がこのページに自動的に入力されます。
目的のビジネス・イベントの選択

「Next」をクリックします。
「Summary」ページに、選択したイベントの情報が表示されます。
Oracle E-Business Suiteアダプタのソース・エンドポイント構成が選択したイベントを使用して正しく作成されました。
「Done」をクリックします。
統合フローに「Order_Status_Update」エンドポイントがTRIGGERとして表示されるようになりました。
2つの分岐ルールを持つSWITCHの追加
次のステップを実行して、SWITCHを追加します。
「SWITCH」アクションを、左側の「ACTIONS」セクションから統合のOrder_Status_Updateアクティビティの直後にドラッグ・アンド・ドロップします。
SWITCHアクションをOrder_Status_Updateアクティビティの後に追加

このアクションによって2つのルールを追加し、統合にルーティング式分岐を定義することができます。
統合フローに2つの分岐を追加

1つ目のルール上で「edit」をクリックします。 「Condition Builder」ページが表示されます。
条件ビルダーで、以下の情報を入力して条件を作成 : All of Name = 'STATUS_CODE'およびValue = 'BOOKED' :
式名として「Booked Order」を入力します。
「Match」フィールドで、リストから「All of」を選択します。
「Source」セクションで、「BusinessEvent_Input」ノード、「InputParameters」ノード、「BusinessEvent」ノード、「ParameterList」ノード、「Parameter」ノードの順に展開します。
「Name」要素を、右上の「New Condition」セクションの下にドラッグ・アンド・ドロップします。
ドロップダウン・リストから=を選択します。
テキスト・ボックスに'STATUS_CODE'を条件値として入力します。
「Add Condition」 (+)アイコンをクリックします。
「Value」要素を、右上の「New Condition」セクションの下にドラッグ・アンド・ドロップします。
ドロップダウン・リストから=を選択します。
テキスト・ボックスに'BOOKED'を条件値として入力します。
「Add Condition」 (+)アイコンをクリックします。
必要な条件を使用して1つ目のルール(Booked Order)を編集

作業を保存します。 「Exit Condition Builder」をクリックして、統合に戻ります。
Oracle E-Business Suiteアダプタの「Get_Order」アクティビティの呼出しとしての追加
次のステップを実行して、Oracle E-Business Suiteアダプタを呼出し接続として追加します。
Oracle E-Business Suite接続「Order Management」を、左側の「INVOKES」ツールバーから統合の「Booked Order」ルールの直後にドラッグ・アンド・ドロップします。
Configure Oracle E-Business Suite Adapter Endpointウィザードが表示されます。
「Basic Info」ページで、次の情報を入力します。
What do you want to call your endpoint? - エンドポイント名として「Get_Order」を入力します。
「What does this endpoint do?」 - 「Get an order in Oracle E-Business Suite」など、この統合エンドポイントの説明を入力します。
「Next」をクリックします。
「Web Services」ページで、ターゲット接続に関する次の情報を指定します。
Product Family: ドロップダウン・リストから「Order Management Suite」を選択します。
Product: 「Order Management」を選択します。
API: この例の移入されたリストから「Process Order API」を選択します。
対応するAPI内部名(OE_ORDER_PUB)および説明が自動的に表示されます。
「Web Services」ページでのAPIの選択

「Next」をクリックします。
「Operations」ページに、選択したAPIの内部名OE_ORDER_PUBが表示されます。
「 Methods」フィールドで、APIに含まれる目的のメソッド名を選択します。 たとえば、「GET_ORDER」を選択します。 「Operations」ページに、対応するサービス・ステータス値と説明情報が表示されます。
ノート: 選択したメソッドGET_ORDERのサービス・ステータスは、「Ready to Use」です。
統合のターゲット・エンドポイントとしてのメソッドの選択

「Next」をクリックします。
「Summary」ページに、選択したAPIの情報が表示されます。 これには、製品ファミリ名(Order Management Suite)、製品名(Order Management)、Webサービス名(OE_ORDER_PUB)、統合パターン(Synchronous)、操作名(GET_ORDER)、および操作ステータス(Ready to Use)が含まれます。
選択したAPIの詳細が表示された「Summary」ページ

「Done」をクリックします。
Order Managementの「Get_Order」アクティビティと、後でマッピング定義に使用できる「Get_Order」マップ・アイコンが、統合フロー内に表示されるようになりました。 マッピングの作成を参照してください。
RESTアダプタの「Receivables」アクティビティの呼出しとしての追加
次のステップを実行して、RESTアダプタを呼出し接続として追加します。
Oracle E-Business Suite接続「Receivables」を、左側の「INVOKES」ツールバーから統合の「Booked Order」ルートのGet_Orderアクティビティの後にドラッグ・アンド・ドロップします。
Configure Oracle REST Endpointウィザードが表示されます。 「Basic Info」ページで次の情報を入力します。
What do you want to call your endpoint? - 「Create_Invoice」など、このエンドポイントの名前を入力します。
What does this endpoint do? - 「Provide REST endpoint with input payload for invoice creation」など、このエンドポイントの用途を入力します。
「エンドポイント相対リソースURIとは何ですか?」 - /create_single_invoice/と入力します。
What action does the endpoint perform? - ドロップダウン・リストから「POST」を選択します。
Configure a request payload for this endpoint - このチェック・ボックスを選択して、このアクティビティにリクエスト・ペイロードが必要であることを示します。
RESTエンドポイントの基本情報の入力

「Next」をクリックします。
「Request」ページで、次のタスクを実行します。
「Select the request payload file」セクションで、「XML schema」ラジオ・ボタンを選択します。
リクエスト・ペイロード・ファイル・タイプはXMLスキーマか、JSON形式のいずれもで構いません。
請求書作成RESTサービスのサンプルXSDを参照して選択します。
サンプルXSDの詳細は、「ビジネス・イベントの例で使用するCreate_InvoiceアクティビティのサンプルXSD」を参照してください。
「Element」フィールドで、ドロップダウン・リストから「CREATE_SINGLE_INVOICE_Input」を選択します。
「Select the type of payload with which you want the endpoint to receive」セクションで、ペイロード・タイプとして「XML」ボタンを選択します。

「Next」および「Next」をクリックします。
この例では、このエンドポイントでレスポンスを受信するように構成する必要はありません。
「Next」をクリックします。 「Summary」ページに、前の手順で指定した次のRESTサービス情報が表示されます。
RESTサービスのURL : http://<host name>:<port>/webservices/rest/invoice/create_single_invoice/。
Method: POST
メディア・タイプのリクエスト: application/xml
「Done」をクリックします。
Create_Invoiceアクティビティが統合フローに表示され、予約済みルールの最後のアクティビティとしてリストされます。
Get_Orderアクティビティと同様に、Create_Invoiceマップ・アイコンも表示され(Create_Invoiceアクティビティとともに)、後でマッピングを定義できます。 マッピングの作成を参照してください
統合を保存します。
このステップを終えると、この項で追加したアクティビティが統合フローに含まれています。
「Order to Invoice」の統合フロー・ダイアグラム

Oracle E-Business Suiteビジネス・イベントは、WF_EVENT_Tデータ構造体によって定義されます。 統合に必要な接続を追加したら、次のマッピングを作成して、後続のRESTサービスに必要なパラメータ値を渡せるようにします。
Get_Orderのマッピングを定義
Create_Invoiceのマッピングを定義
「マッピングを作成」 Get_Order 「マップ」
この例では、販売オーダーのヘッダーIDをビジネス・イベント・パラメータの1つとして使用できます。 WF_EVENT_Tでは、繰り返しのParameter要素でName-Valueペアとしてイベント・パラメータを使用できます。 Header Idパラメータの値を取得し、それを後続のGet_Orderサービス呼び出しに渡すには、Get_Orderマップのマッピングを作成する必要があります。
Order_Status_Update統合フローで、Get_Orderマップ・アイコンの「編集」をクリックします。
マッピングのためのGet_Orderマップの選択

「Mapper」ページが表示されます。
Mapperページでは、ビジネス・イベント関連の要素がソース・セクションに表示され、Get_Order関連のパラメータはターゲット領域にリストされます。 イベント・パラメータの一部として含まれている販売オーダーのヘッダーID (P_HEADER_ID)の値を取得して後続のGet_Order RESTサービスに渡すには、P_HEADER_IDパラメータのXSL式を定義する必要があります。
次のタスクを実行して、P_HEADER_IDパラメータのXSL式を定義します。
「Target」セクションで、「GET_ORDER_Input」ノード、「InputParameters」ノードの順に展開します。 「P_HEADER_ID」要素をクリックして、「Build Mappings」ページを開きます。
「Build Mappings」ページの「Mapping」領域では、「P_HEADER_ID」要素がターゲット要素として表示されていることに注意してください。
「Build Mappings」ページの「Source」セクションで、「BusinessEvent_Input」ノード、「InputParameters」ノード、「BusinessEvent」ノード、「ParameterList」ノード、「Parameter」ノードの順に展開します。
「Value」要素を、「Source」セクションから「Mapping」セクションに、「P_HEADER_ID」要素の値としてドラッグ・アンド・ドロップします。
同様に、XSL要素"if"とName要素をソース・セクションからマッピング・セクションにドラッグ・アンド・ドロップして、XSL式<xsl:if test="nssrcmpr:Name='HEADER_ID'">を定義します。
ソース・セクションからマッピング・セクションにXSL要素for-eachをドラッグ・アンド・ドロップして、XSL式<xsl:for-each select="/nssrcmpr:BusinessEvent_Input/nssrcmpr:InputParameters/nssrcmpr:BusinessEvent/nssrcmpr:ParameterList/nssrcmpr:Parameter">を定義します。
P_HEADER_IDパラメータのマッピングの表示

作業を保存します。
ノードを展開して、P_HEADER_IDパラメータが構造の一部に含まれていることを確認します。
次のタスクを実行して、ターゲット要素に定数値を割り当てます。
「Target」セクションで、「GET_ORDER_Input」ノード、「RESTHeader」ノードの順に展開します。
「Responsibility」要素をクリックして、「Build Mappings」ページを開きます。
「Responsibility」要素の値として、テキスト・ボックスに「ORDER_MGMT_SUPER_USER」と入力します。
同様に、同じ手順を使用して、次の表にリストされているターゲット要素に適切な値を割り当てます。
| パス | 要素 | 値 |
|---|---|---|
| GET_ORDER_Input/RESTHeader | RespApplication | ONT |
| GET_ORDER_Input/RESTHeader | SecurityGroup | STANDARD |
| GET_ORDER_Input/RESTHeader | NLSLanguage | AMERICAN |
| GET_ORDER_Input/RESTHeader | Org_Id | 204 |
| GET_ORDER_Input/InputParameters | P_API_VERSION_NUMBER | 1.0 |
| GET_ORDER_Input/InputParameters | P_INIT_MSG_LIST | F |
| GET_ORDER_Input/InputParameters | P_ORG_ID | 204 |
Get_Orderのマッピングを完了したら、マップされたソース値がターゲット・セクションのマッピング列に表示されます。
Get_Orderアクティビティのマッピングの表示

「Save」をクリックして、作業を保存します。
「マッピングを作成」 Create_Invoice 「マップ」
次のステップを実行して、マッピングを作成します。
Order_Status_Update統合フローで、Create_Invoiceマップ・アイコンの「編集」をクリックします。
「Mapper」ページが表示されます。
ターゲット要素に定数値を割り当てます。
「Target」セクションで、「execute」ノード、「CREATE_SINGLE_INVOICE_Input」ノード、「RESTHeader」ノードの順に展開します。
「Responsibility」要素をクリックして、「Build Mappings」ページを開きます。
「Responsibility」要素の値として、テキスト・ボックスに「RECEIVABLES_VISION_OPERATIONS」と入力します。
同様に、同じ手順を使用して、次の表にリストされているターゲット要素に適切な値を割り当てます。
| パス | 要素 | 値 |
|---|---|---|
| CREATE_SINGLE_INVOICE_Input/RESTHeader | RespApplication | AR |
| CREATE_SINGLE_INVOICE_Input/RESTHeader | SecurityGroup | STANDARD |
| CREATE_SINGLE_INVOICE_Input/RESTHeader | NLSLanguage | AMERICAN |
| CREATE_SINGLE_INVOICE_Input/RESTHeader | Org_Id | 204 |
| CREATE_SINGLE_INVOICE_Input/InputParameters | P_API_VERSION | 1.0 |
| CREATE_SINGLE_INVOICE_Input/InputParameters | P_INIT_MSG_LIST | T |
| CREATE_SINGLE_INVOICE_Input/InputParameters | P_COMMIT | T |
| CREATE_SINGLE_INVOICE_Input/InputParameters/P_BATCH_SOURCE_REC | BATCH_SOURCE_ID | 1188 |
| CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_HEADER_TBL/P_TRX_HEADER_TBL_ITEM | TRX_HEADER_ID | 101 |
| CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_HEADER_TBL/P_TRX_HEADER_TBL_ITEM | CUST_TRX_TYPE_ID | 1684 |
| CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_HEADER_TBL/P_TRX_HEADER_TBL_ITEM | BILL_TO_CUSTOMER_ID | 1290 |
| CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_HEADER_TBL/P_TRX_HEADER_TBL_ITEM | SHIP_TO_CUSTOMER_ID | 1290 |
| CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_HEADER_TBL/P_TRX_HEADER_TBL_ITEM | COMMENTS | Order Managementで発行された販売オーダーに対して、ICS統合を介して作成された請求書 |
このステップを完了すると、マップされたソースの値は「Target」セクションの「Mapping」列に表示されます。
定数値を使用したマッピングの表示

ヘッダーに対する次のマッピングを追加します。
「Source」セクションで、「Search」フィールドに「HEADER_ID」と入力して、このパラメータを探します。
「X_HEADER_REC」ノードから、「HEADER_ID」要素を選択します。
「Target」セクションで、「execute」ノード、「CREATE_SINGLE_INVOICE_Input」ノード、「InputParameters」ノード、「P_TRX_HEADER_TBL」ノード、「P_TRX_HEADER_TBL_ITEM」ノードの順に展開します。
「TRX_NUMBER」要素を選択します。
「Source」セクションから「HEADER_ID」要素を「Target」セクションの「TRX_NUMBER」要素にドラッグして、データをマッピングします。
マッピングした後、ソース要素「HEADER_ID」は、「Target」セクションの「TRX_NUMBER」要素の隣の「Mapping」列に表示されます。
ソースのHEADER_IDからターゲットのTRX_NUMBERへのマッピング

前のステップと同じ方法で、次の明細品目のマッピングのセットを追加します。
| ソース・パス | ソース要素 | ターゲット・パス | ターゲット要素 |
|---|---|---|---|
| BusinessEvent_Input/InputParameters/BusinessEvent/X_LINE_TBL/X_LINE_TBL_ITEM | LINE_NUMBER | execute/CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_LINES_TBL/P_TRX_LINES_TBL_ITEM | LINE_NUMBER |
| BusinessEvent_Input/InputParameters/BusinessEvent/X_LINE_TBL/X_LINE_TBL_ITEM | ORDERED_ITEM | execute/CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_LINES_TBL/P_TRX_LINES_TBL_ITEM | DESCRIPTION |
| BusinessEvent_Input/InputParameters/BusinessEvent/X_LINE_TBL/X_LINE_TBL_ITEM | ORDERED_QUANTITY | execute/CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_LINES_TBL/P_TRX_LINES_TBL_ITEM | QUANTITY_ORDERED |
| BusinessEvent_Input/InputParameters/BusinessEvent/X_LINE_TBL/X_LINE_TBL_ITEM | ORDERED_QUANTITY | execute/CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_LINES_TBL/P_TRX_LINES_TBL_ITEM | QUANTITY_INVOICED |
| BusinessEvent_Input/InputParameters/BusinessEvent/X_LINE_TBL/X_LINE_TBL_ITEM | UNIT_SELLING_PRICE | execute/CREATE_SINGLE_INVOICE_Input/InputParameters/P_TRX_LINES_TBL/P_TRX_LINES_TBL_ITEM | UNIT_SELLING_PRICE |
このステップを完了すると、マップされたソースの値は、緑色のチェック・マーク・アイコンとともに対応するターゲット要素の隣に表示されます。
明細品目のマッピングの表示

次の値を割り当てます。
「Target」セクションで、「execute」ノード、「CREATE_SINGLE_INVOICE_Input」ノード、「InputParameters」ノード、「P_TRX_DIST_TBL」ノードの順に展開します。
「P_TRX_DIST_TBL_ITEM」要素をクリックして、「Build Mappings」ページを開きます。
「Mapping」セクションに、次の情報を入力します。
<nsmpr1:P_TRX_DIST_ID/>。
「Target」セクションで、「execute」ノード、「CREATE_SINGLE_INVOICE_Input」ノード、「InputParameters」ノード、「P_TRX_SALESCREDITS_TBL」ノードの順に展開します。
「P_TRX_SALESCREDITS_TBL_ITEM」要素をクリックして、「Build Mappings」ページを開きます。
「Mapping」領域に、次の情報を入力します。
<nsmpr1:P_TRX_SALESCREDITS_ID/>。
新しくマッピングされた値が、「Target」セクションの対応する要素の隣に表示されます。
マッピングの表示

作業を保存します。
「Exit Mapper」をクリックします。
統合を保存します。
次のステップを実行して、ランタイムのメッセージのペイロード・フィールドを追跡します。
「Create Order Integration」ページで、「Tracking」をクリックします。
「Business Identifiers For Tracking」ダイアログが表示されます。
「Available Source Fields」セクションで、「BusinessEvent_Input」ノード、「InputParameters」ノード、「BusinessEvent」ノードの順に展開します。
「Event Key」要素を、表の「Tracking Field」列にプライマリ追跡フィールドとしてドラッグ・アンド・ドロップします。
「Done」をクリックします。
作業を保存し、「Exit Integration」をクリックします。
次のステップを実行して、統合をアクティブ化します。
「Integrations」ページで、前の手順で作成した「Order to Invoice」統合の「Activate」をクリックします。
「Confirmation」ダイアログが表示されます。 「Activate」をクリックして、このアクションを確認します。
「Order to Invoice」統合のステータスは「ACTIVE」に変わり、緑色のチェック・マーク・アイコンが付きます。
ランタイムでの統合のテスト
Oracle E-Business Suiteに、Order Management Super User、Vision Operations (USA)の責任を持つoperationsユーザーとしてログインします。
ナビゲーション・メニューから「Order, Returns」、「Sales Order」の順に選択し、「Sales Orders」フォームを開きます。
「Sales Orders」フォームで、「Order Information」タブを選択します。
次の情報を使用して、顧客「A.C. Networks」の新規販売オーダーを作成します。
Customer: A.C. Networks
Operation Unit: Vision Operations
Order Type: Mixed
Ship To Location: Provo (OPS) 3405 East Bay Blvd. Provo, UT 84606, US
Bill To Location: Provo (OPS) 3405 East Bay Blvd. Provo, UT 84606, US
Price List: Corporate
Currency: USD
「Sales Orders」フォームでの販売オーダーの作成

「Line Items」タブを選択して、次の明細品目を追加します。
Ordered Item: AS54888
Quantity: 1
Item Type: STANDARD
UOM: Each
Unit Price: 移入された単価を受け入れます。
Request Date: 移入された日付を受け入れます(14-MAY-2016など)
販売オーダーの明細品目の追加

この新規オーダーを保存します。
このオーダーは「Entered」ステータスで作成されます。
「Book Order」.をクリックします。
オーダー・ステータスは「Booked」に更新されます。 統合をトリガーするビジネス・イベントoracle.apps.ont.oip.statuschange.updateを内部的に発生させます。
デザインタイムに、前の手順でOracle Integration Cloud Serviceに作成された「Order to Invoice」統合は、このビジネス・イベントにサブスクライブされます。 ランタイムには、オーダー・ステータスが「Booked」に変更されているため、Oracle Order Managementによって、Oracle Integration Cloud Serviceの統合がトリガーされるビジネス・イベントが発行されます。 オーダー詳細情報は、Oracle E-Business Suite Order Managementからフェッチされ、Oracle Accounts Receivablesで請求書を作成するためのイベント・ペイロードとして渡されます。
Oracle Integration Cloud Serviceでの結果の監視
Oracle Integration Cloud Serviceにログインします。
Integration Cloud Serviceのツールバーで「Monitoring」をクリックします。
ナビゲーション・ペインで、「Tracking」をクリックします。
Trackingページが表示されます。
「Order to Invoice」統合用に作成されたインスタンスをクリックします。
「Order to Invoice」統合の追跡ページの表示

「Event Key」をクリックして、統合インスタンスのフロー・ダイアグラムを表示します。
このページには、インスタンスの追跡情報が表示されます。 このインスタンスのステータスは、統合が正常に実行されたことを示す「Completed」であることに注意してください。 必要に応じて、エラーが発生したかどうかを確認できます。
インスタンスのオーケストレーション・フローの表示と追跡

Oracle E-Business Suite Accounts Receivablesでの結果の検証
Receivables、Vision Operations (USA)責任を持つoperationsユーザーとしてOracle Accounts Receivablesにログインします。 ナビゲーション・メニューから、「Transactions」、「Transactions」の順に選択します。
「Query for Transaction」を選択して、「A.C. Networks」顧客の請求書トランザクションを探します。 請求書はOracle Accounts Receivablesで作成されています。
![]()
Copyright © 2015, 2018, Oracle and/or its affiliates. All rights reserved.