リリース18
品番E66534-10
目次
前
次
| Oracle Cloud Oracle E-Business Suiteアダプタの使用 リリース18 品番E66534-10 | 目次 | 前 | 次 |
Oracle E-Business Suiteアダプタを統合のトリガーまたは呼出し領域にドラッグすると、アダプタ・エンドポイント構成ウィザードが表示されます。 このウィザードで示される順序に従い、Oracle E-Business Suiteアダプタのエンドポイントのプロパティを構成します。
次の各項では、Oracle E-Business Suiteアダプタを統合のトリガーまたは呼出しとして構成する手順を示すウィザード・ページについて説明します。
統合内でOracle E-Business Suiteアダプタをトリガーとして使用する場合は、Oracle Integration Cloud Serviceのインバウンド統合として、ビジネス・イベントまたはXML Gatewayメッセージのいずれかを使用できます。
重要: Oracle E-Business Suiteアダプタをインバウンド統合のトリガー(ソース)接続として追加する前に、この機能を有効化するために必要な設定タスクを実行したことを確認してください。 Oracle E-Business Suiteアダプタをトリガー(ソース)接続として使用するための設定タスクを参照してください。
統合にOracle E-Business Suiteアダプタをトリガー(ソース)接続として追加しているときに発生する可能性があるエラー・メッセージの詳細は、「Oracle E-Business Suiteアダプタをトリガー(ソース)接続として使用して統合を作成しているときのエラー・メッセージ」を参照してください。
次のステップを実行して、Oracle E-Business Suiteアダプタを統合のトリガー(ソース)接続として追加します。
統合デザイナで、左側の「Connections」パネルから「Oracle E-Business Suite」をキャンバスの「Trigger」(ソース)領域にドラッグします。
Configure Oracle E-Business Suite Adapter Endpointウィザードが表示されます。
「Basic Info」ページで、作成中のOracle E-Business Suiteアダプタのエンドポイントに関する次の情報を入力します。
ビジネス・イベントを使用したアダプタ・エンドポイントに関する基本情報の入力
「What do you want to call your endpoint?」 - この接続の役割を他のユーザーが理解できるように、「EBS_Source_event」や「EBS_Source_XML」などの、わかりやすい名前を指定します。
「What does this endpoint do?」 - 「Raise a business event」や「Use XML Gateway message」などの、接続の役割の説明(オプション)を入力します。
「What do you want to configure the endpoint for?」 - 統合で構成するインタフェース・タイプとして次のいずれか1つを選択します。
Business Event
ビジネス・イベントのエンドポイントを構成するには、「統合でのOracle E-Business Suiteビジネス・イベントの構成」を参照してください。
XML Gateway Map
XML Gatewayメッセージ・マップのエンドポイントを構成するには、「統合でのOracle E-Business Suite XML Gatewayメッセージの構成」を参照してください。
「Next」をクリックして、統合の残りの構成に進みます。
Oracle E-Business SuiteからOracle Integration Cloud Serviceへのビジネス・イベントの発行
統合の「 Basic Info」ページで「Business Event」を選択した場合は、「Business Events」ページで目的のビジネス・イベントを指定する必要があります。
ランタイムにOracle E-Business Suiteでビジネス・イベントが発生すると、Oracle E-Business Suiteアダプタによって、イベントの情報がOracle E-Business SuiteからOracle Integration Cloud Serviceに伝えられます。
次のステップを実行して、統合のビジネス・イベントを構成します。
統合にOracle E-Business Suiteアダプタをトリガー(ソース)接続として追加したら、「 Basic Info」ページで「Business Event」を選択します。
「Business Events」ページで、次の情報を指定します。
Product Family: 統合に使用する希望のOracle E-Business Suiteアプリケーション・ファミリ(「Applications Technology」など)を選択します。
ドロップダウン・リストに表示されるOracle E-Business Suiteアプリケーション・ファミリは、接続するOracle E-Business Suiteインスタンスに基づきます。
Product: 選択した製品ファミリに表示されるものの中から希望の製品名(「XML Gateway」など)を選択します。
希望の製品を選択すると、選択した製品に含まれているOracleシード済およびカスタムのイベントなどの、ビジネス・イベントのリストが選択用に移入されます。
ノート: 必要に応じて、ニーズにあわせてカスタム・ビジネス・イベントを定義し、カスタム・ビジネス・イベントに注釈を付けた後、統合リポジトリにそれらをアップロードできます。 さらに、「ワークフロー管理者Webアプリケーション」の役割を持つOracle Workflow Business Event Systemで、これらのカスタム・イベントが有効になっていることを確認します(有効イベント・ステータスを使用)。 統合のためにこれらのカスタム・イベントを使用するには、Oracle Integration Cloud Service、統合のために使用する予定Oracle E-Business Suite接続を見つけるするにはログインする必要があります。 「アクション」メニュー・アイコンをクリックし、「メタデータのリフレッシュ」を選択します。
カスタム・ビジネス・イベントの作成の詳細は、Oracle E-Business Suite統合SOAゲートウェイ開発者ガイドの「カスタム統合インタフェースの作成および使用」の章のカスタム統合インタフェースの作成に関する項を参照してください。
Oracle E-Business Suite統合SOAゲートウェイに常駐するOracle統合リポジトリへのカスタム・インタフェースのアップロードの詳細は、Oracle E-Business Suite統合SOAゲートウェイ実装ガイドのiLDTファイルの生成およびアップロード、統合リポジトリへのILDTファイルのアップロードに関する項を参照してください。
Business Event: 次のいずれかの方法で、目的のビジネス・イベントを見つけます。
ドロップダウン・リストから目的のイベント名を選択します。 たとえば、「CLN: Event for Notification Processing」を選択します。
イベント・リストからのビジネス・イベントの選択
「Filter by name」フィールドを使用して目的のイベントを見つけます。 たとえば、先頭が「CLN」のイベント名を見つけるには、このフィールドに「CLN」と入力します。
目的のイベントを探すための、名前の一部または全部の入力
ビジネス・イベントを選択すると、対応するイベント情報がこのページに自動的に移入されます。 これには、イベント内部名(oracle.apps.cln.np.processnotification)とその記述情報が含まれます。
「Next」をクリックします。
「Summary」ページに、選択したビジネス・イベントの情報が表示されます。
Oracle E-Business Suiteアダプタのソース・エンドポイント構成が選択したイベントを使用して正しく作成されました。
「Done」をクリックします。
これで、Oracle E-Businses Suiteの接続がキャンバスの「Trigger」(ソース)領域に表示されます。
統合内でのビジネス・イベントの使用方法の詳細は、「統合内でのビジネス・イベントのトリガー(ソース)としての使用例」を参照してください。
統合の「 Basic Info」ページで「XML Gateway Map」を選択した場合は、「XML Gateway Message」ページで目的のXML Gatewayメッセージを指定する必要があります。
ランタイムにOracle E-Business SuiteでXML Gatewayアウトバウンド・トランザクションが発生すると、このメッセージが既存のXML Gateway処理としてECX_OUTBOUNDキューに入れられます。 Oracle XML GatewayからのOracle Transport Agent (OTA)は、そのキューからメッセージを取得し、それをOracle Integration Cloud Serviceにポストします。
次のステップを実行して、統合のXML Gatewayメッセージを構成します。
統合にOracle E-Business Suiteアダプタをトリガー(ソース)接続として追加したら、「 Basic Info」ページで「XML Gateway Map」を選択します。
「XML Gateway Message」ページで、ソース接続に関する次の情報を指定します。
Product Family: 統合に使用する希望のOracle E-Business Suiteアプリケーション・ファミリ(「Service Suite」など)を選択します。
ドロップダウン・リストに表示されるOracle E-Business Suiteアプリケーション・ファミリは、接続するOracle E-Business Suiteインスタンスに基づきます。
Product: 選択した製品ファミリに表示されるものの中から希望の製品名(「Telecommunications Billing Integrator」など)を選択します。
希望の製品を選択すると、選択した製品に含まれているOracleシード済およびカスタムのメッセージ・マップなどの、XML Gatewayメッセージ・マップのリストが選択用に移入されます。
ノート: 必要に応じて、ニーズにあわせてカスタムXML Gatewayメッセージ・マップを定義し、カスタム・メッセージ・マップに注釈を付けた後、統合リポジトリにそれらをアップロードできます。
カスタムXML Gatewayメッセージの作成の詳細は、Oracle E-Business Suite統合SOAゲートウェイ開発者ガイドの、統合リポジトリの注釈標準の、XML Gatewayの注釈に関する項を参照してください。
Oracle E-Business Suite統合SOAゲートウェイに常駐するOracle統合リポジトリへのカスタム・インタフェースのアップロードの詳細は、Oracle E-Business Suite統合SOAゲートウェイ実装ガイドのiLDTファイルの生成およびアップロード、統合リポジトリへのILDTファイルのアップロードに関する項を参照してください。
XML Gateway Message: 次のいずれかの方法で、目的のメッセージ・マップを見つけます。
ドロップダウン・リストから目的のメッセージ・マップ名を選択します。 たとえば、「Add Salesorder」を選択します。
目的のXML Gatewayメッセージ・マップのリストからの選択
「Filter by name」フィールドを使用して目的のマップを見つけます。 たとえば、先頭が「add」のメッセージ・マップ名を見つけるには、このフィールドに「add」と入力します。
目的のXML Gatewayメッセージ・マップを探すための、名前の一部または全部の入力
目的のメッセージ・マップを選択すると、対応する情報がこのページに自動的に移入されます。 これには、統合リポジトリ名(XNB:SOO)、内部名(XNB_OM_SALESORDER_OAG72_OUT)、統合標準(OAG 7.2)、およびメッセージ・マップの説明が含まれます。
「Next」をクリックします。
「Summary」ページに、選択したXML Gatewayメッセージに関する、前の手順で指定した情報が表示されます。 これには、選択したService Suite製品ファミリとTelecommunications Billing Integrator製品のXML Gatewayメッセージ名XNB_OM_SALESORDER_OAG72_OUTとRequest Onlyの対話パターンが含まれます。
Oracle E-Business Suiteアダプタのソース・エンドポイント構成が選択したメッセージ・マップを使用して正しく作成されました。
重要: 選択したメッセージ・マップをOracle Integration Cloud Serviceで正常に使用するには、統合をアクティブ化した後に、必要な手動タスクを実行する必要があります。 これらの手動ステップは、「Summary」ページの「Instructions」セクションに含まれています。 トリガーとしてのXML Gatewayメッセージのアクティブ化後のステップを参照してください。
「Done」をクリックします。
これで、Oracle E-Businses Suiteの接続がキャンバスの「Trigger」(ソース)領域に表示されます。
統合内でのXML Gatewayメッセージの使用方法の詳細は、「統合内でのXML Gatewayメッセージのトリガー(ソース)としての使用例」を参照してください。
Oracle Integration Cloud ServiceにOracle E-Business SuiteからのXML Gatewayメッセージを使用した統合を作成したら、次のタスクを手動で実行する必要があります。
統合をアクティブ化します。
統合のエンドポイントURLを取得します。
「Integrations」ページで、目的の統合の「Integration Details」アイコン(「i」)をクリックします。 ポップアップ・ウィンドウにエンドポイントURLが次の形式で表示されます。
https://<ICS Host>:<Port>/integration/flowapi/rest/<integration>/v01/。
URLは後に、Oracle XML Gatewayで取引パートナを構成する際に、プロトコル・アドレスとして使用されます。
<integration>は、このサンプルのPROCESS_POなど、デプロイされたRESTサービスの別名名を示します。
トレーディング・パートナを定義するときに、URLの最後にmetadataを含めないでください。
エンドポイントURLが表示された「Integrations」ページ
通信プロトコルとアドレス、および統合で指定されたXMLメッセージのユーザー資格証明を指定して、Oracle E-Business Suiteに目的の取引パートナを構成します。
Oracle E-Business Suiteに、XML Gatewayの責任を持つユーザー(sysadminなど)としてログインします。
XML Gateway職責を選択し、ナビゲータから「Define Trading Partners」を選択します。 「Define Trading Partner Setup」フォームが表示されます。
構成する目的の取引パートナを検索して見つけます。
「Trading Partner Details」リージョンで、取引パートナに関する次の情報を追加します。
Transaction Type: XML Gatewayメッセージの目的のトランザクション・タイプ(POなど)
Transaction Subtype: XML Gatewayメッセージの目的のサブタイプ(PROなど)
マップ: itg_process_po_007_outなどの望ましいXMLゲートウェイ・メッセージ
Connection/Hub: DIRECT
Protocol: HTTPS
プロトコル・アドレス : https://<ICS Host>:<Port>/integration/flowapi/rest/<integration>/v01/
前の手順で記録した、統合のエンドポイントURLを入力します。
ユーザー名: <ICS Username>
Oracle Integration Cloud Serviceに統合を実行するために使用されるOracle Integration Cloud Serviceユーザー資格証明を入力します。
パスワード: <ICS Password>
アウトバウンドXML Gatewayメッセージの取引パートナ詳細の更新
作業を保存します。
取引パートナの設定の詳細は、『Oracle XML Gatewayユーザーズ・ガイド』の取引パートナの設定に関する項を参照してください。
次のステップを実行して、Oracle E-Business Suiteアダプタを統合の呼出し(ターゲット)接続として追加します。
統合デザイナで、右側の「Connections」パネルから「Oracle E-Business Suite」をキャンバスの「Invoke」(ターゲット)領域にドラッグします。
Configure Oracle E-Business Suite Adapter Endpointウィザードが表示されます。
「Basic Info」ページで、Oracle E-Business Suiteアダプタのターゲット・エンドポイントに関する次の情報を入力します。
「What do you want to call your endpoint?」 - この接続の役割を他のユーザーが理解できるように、「EBS_CreateOrder」などのわかりやすい名前を指定します。
「What does this endpoint do?」 - 「Create a Sales Order in Oracle E-Business Suite」などの、接続の役割の説明(オプション)を入力します。
ターゲット・エンドポイントに関する基本情報の入力
「Next」をクリックします。
「Web Services」ページで、ターゲット接続に関する次の情報を指定します。
Product Family: 統合に使用する希望のOracle E-Business Suiteアプリケーション・ファミリ(「Order Management Suite」など)を選択します。
ドロップダウン・リストに表示されるOracle E-Business Suiteアプリケーション・ファミリは、接続するOracle E-Business Suiteインスタンスに基づきます。
Product: 選択した製品ファミリに表示されるものの中から希望の製品名(「Order Management」など)を選択します。
Webサービスの製品ファミリと製品の選択
目的の製品ファミリおよび製品を選択すると、選択した製品に含まれているOracleシード済およびカスタム・インタフェースなどの、サポートされているインタフェースのリストが選択用に移入されます。
重要: このリリースでは、統合でOracle E-Business Suiteアダプタを呼出し(ターゲット)接続として追加する際に、PL/SQL APIとコンカレント・プログラムのみを選択できます。
注意: 必要に応じてカスタムPL/SQL APIとコンカレント・プログラムを定義して、必要に応じてニーズに合わせてカスタム・インテグレーション・インタフェースに注釈を付け、統合リポジトリにアップロードしてOracle E-Business Suite Integrated SOA GatewayからRESTサービスとしてデプロイできます。 その後、これらのRESTサービスは、Oracle Integration Cloud Serviceでの統合に使用できるようになります。
カスタムのPL/SQL APIおよびコンカレント・プログラムの作成の詳細は、Oracle E-Business Suite統合SOAゲートウェイ開発者ガイドの、カスタム統合インタフェースの作成および使用の章のカスタム統合インタフェースの作成に関する項を参照してください。
Oracle E-Business Suite統合SOAゲートウェイに常駐するOracle統合リポジトリへのカスタム・インタフェースのアップロードの詳細は、Oracle E-Business Suite統合SOAゲートウェイ実装ガイドのiLDTファイルの生成およびアップロード、統合リポジトリへのILDTファイルのアップロードに関する項を参照してください。
API: 次のいずれかの方法で、目的のインタフェースを選択します。
ドロップダウン・リストから目的のインタフェース名を選択します。 たとえば、「Sales Order Services」PL/SQL APIを選択します。
移入されたリストからのPL/SQL APIの選択
対応するインタフェース情報が自動的に移入されます。 これには、インタフェースの内部名(OE_INBOUND_INT)と説明が含まれます。
ノート: PL/SQL APIを選択する以外に、統合内の目的のコンカレント・プログラムを選択できます。 たとえば、Marketing Suite製品ファミリおよびTrade Management製品からコンカレント・プログラム「Claim Settlement Fetcher Program」を選択します。
移入されたリストからのコンカレント・プログラムの選択
「Filter by name」フィールドを使用して目的のインタフェースを見つけます。 たとえば、先頭が「sales」のインタフェース名を見つけるには、このフィールドに「sales」と入力します。
ノート: 選択したインタフェースに含まれている1つ以上のメソッドがRESTサービス操作としてデプロイされている場合に「Next」をクリックすると、「Operations」ページが表示されます。
一方、選択したインタフェース内のメソッドがいずれもRESTサービス操作としてデプロイされていない場合には、関連付けられているRESTサービスが存在しないことを示すエラー・メッセージが表示されます。 選択したインタフェースをOracle E-Business SuiteのRESTサービスとしてデプロイする必要があります。
サービスをデプロイしたら、Oracle Integration Cloud Serviceにログインし、統合用に作成したOracle E-Business Suite接続に移動する必要があります。 Actionsメニューから「メタデータのリフレッシュ」をクリックします。 その後、新しくデプロイされたRESTサービスをOracle Integration Cloud Serviceの統合に使用できます。
APIを使用できないことを示すエラーの表示
「Next」をクリックします。
操作ページの構成
「Operations」ページに、選択したインタフェースの内部名、OE_INBOUND_INTが自動的に移入されます。
ターゲット接続に次の情報を指定します:
メソッド: このターゲット接続に対して、選択したインタフェースに含まれているメソッド名を選択します。 たとえば、「PROCESS_ORDER」を選択します。
注意: 選択した方法で表示されるメソッドのリストは、Oracle E-Business Suite Integrated SOA Gatewayを介して表示できるデプロイされたインタフェースのWADL記述のresource要素に対応しています。
「Operations」ページでのメソッドの選択
ノート: 統合内のコンカレント・プログラム(「Claim Settlement Fetcher Program」など)を選択した場合は、Operationsページで「Process」を選択できます。
「Operations」ページでのコンカレント・プログラムのメソッドの選択
希望のメソッドが選択されると、対応するRESTサービスのステータスが「Service Status」フィールドに表示されます。
Ready to Use
これは、選択したメソッドがRESTサービス操作としてデプロイされており、統合での使用が可能になっていることを示しています。
Not Deployed
一方、選択したメソッドがRESTサービス操作としてデプロイされていない場合には、「Not Deployed」がサービス・ステータスとして表示されます。 さらに、統合で使用する前にそのメソッドをまずRESTサービス操作としてデプロイする必要があることを示す警告メッセージが表示されます。
サービス・ステータスが「Not Deployed」のメソッドの表示
選択したメソッドをRESTサービス操作としてデプロイするには、Oracle E-Business Suiteに統合管理者ロールを持つユーザーとしてログインする必要があります。 ナビゲーション・メニューから「Integrated SOA Gateway」職責および「Integration Repository」リンクを選択します。 統合リポジトリから選択したインタフェースを検索して見つけ、RESTサービスとしてデプロイします。 RESTサービスがOracle E-Business Suiteで使用可能になっている場合にのみ、次へ進んでOracle E-Business Suiteを呼出し(ターゲット)接続として追加するプロセスを完了できます。
RESTサービスのデプロイの詳細は、Oracle E-Business Suite統合SOAゲートウェイ実装ガイドのREST Webサービスのデプロイ、ネイティブ統合インタフェースおよびサービスの管理に関する項を参照してください。
「Next」をクリックします。
「Summary」ページが、選択したインタフェースの情報ととともに表示されます。 Oracle E-Business Suiteアダプタのターゲット・エンドポイント構成が正しく作成されました。
「Done」をクリックします。
これで、Oracle E-Businses Suiteの接続がキャンバスの「Invoke」(ターゲット)領域に表示されます。
Oracle E-Businses Suiteの呼出し(ターゲット)接続が作成されたら、アプリケーション・アダプタをトリガー(ソース)接続として追加し、統合の作成を完了します。 トリガー(ソース)接続の追加の詳細は、『Oracle Cloud Oracle Integration Cloud Serviceの使用』のIntegration Cloud Serviceの開発に関する項を参照してください。
Oracle E-Business Suiteアダプタを呼出し(ターゲット)接続として使用してOracle Integration Cloud Serviceに統合を作成しているときに発生する可能性があるエラー・メッセージの詳細は、「Oracle E-Business Suiteアダプタを呼出し(ターゲット)接続として使用して統合を作成しているときのエラー・メッセージ」を参照してください。
Copyright © 2015, 2018, Oracle and/or its affiliates. All rights reserved.