Oracle E-Business Suite で要求セットを呼び出す

[アーティクル]
05/04/2023

Microsoft BizTalk Adapter for Oracle E-Business Suite を使用すると、Oracle E-Business Suite で要求セットを実行できます。要求セットは 1 つ以上のステージに分割され、各ステージには一連のレポートと同時プログラムが含まれます。アダプターが要求セットをサポートする方法の詳細については、「要求セットに対する操作」を参照してください。要求セットを呼び出すための SOAP メッセージの構造については、「要求セットのメッセージスキーマ」を参照してください。

前提条件

「Oracle E-Business Suite アプリケーションを作成するための前提条件」の手順を完了している必要があります。

Oracle E-Business Suite で要求セットを呼び出す方法

BizTalk Serverを使用して Oracle E-Business アダプターを使用して Oracle E-Business Suite で操作を実行するには、「Oracle E-Business Suite アプリケーションを作成するための構成要素」で説明されている手続き型タスクが含まれます。要求セットを呼び出すには、次のタスクを実行します。

BizTalk プロジェクトを作成し、呼び出す要求セットのスキーマを生成します。
Oracle E-Business Suite との間でメッセージを送受信するためのメッセージを BizTalk プロジェクトに作成します。
要求セットを呼び出すオーケストレーションを作成します。
BizTalk プロジェクトをビルドして展開します。
物理送受信ポートを作成して BizTalk アプリケーションを構成します。
BizTalk アプリケーションを起動します。

このトピックでは、これらのタスクを実行する手順について説明します。

スキーマの生成

このトピックでは、アプリケーションオブジェクトライブラリ アプリケーションから関数セキュリティレポート (フレンドリ名) 要求セットを呼び出して、要求セットを呼び出す方法について説明します。要求セットの実際の名前は FNDRSSUB43。この要求セットは、既定の Oracle E-Business Suite アプリケーションで使用できます。この要求セットは要求 ID を返します。

そのため、このトピックでは、 FNDRSSUB43 要求セットのスキーマを生成します。スキーマの生成方法の詳細については、「 Visual Studio での Oracle E-Business Suite 操作のメタデータの取得」を参照してください。

メッセージとメッセージの種類の定義

先に生成したスキーマは、オーケストレーションのメッセージに求められる "型" を記述します。通常、メッセージは変数であり、対応するスキーマによって定義される型です。オーケストレーションのメッセージを作成し、前の手順で生成したスキーマにリンクする必要があります。

このオーケストレーションでは、2 つのメッセージを作成する必要があります。1 つは、要求セットを呼び出すためのメッセージを送信するメッセージと、要求セットの応答を受信するメッセージです。

メッセージを作成し、スキーマにリンクするには

BizTalk プロジェクトにオーケストレーションを追加します。ソリューションエクスプローラーで、BizTalk プロジェクト名を右クリックし、[追加] をポイントして、[新しい項目] をクリックします。 BizTalk オーケストレーションの名前を入力し、[ 追加] をクリックします。
BizTalk プロジェクトの [オーケストレーションの種類] ウィンドウを開きます (まだ表示されていない場合)。これを行うには、[ 表示] をクリックし、[ その他のウィンドウ] をポイントして、[ オーケストレーションビュー] をクリックします。
[オーケストレーションビュー] で、[ メッセージ] を右クリックし、[ 新しいメッセージ] をクリックします。
新しく作成したメッセージを右クリックし、[ プロパティウィンドウ] を選択します。

Message_1の [プロパティ] ウィンドウで、次の操作を行います。

プロパティ	目的
識別子	「`Request`」と入力します
メッセージ型	ドロップダウンリストから [ スキーマ] を展開し、[RequestSet.OracleEBSBindingRequestSets_FND] を選択します。FNDRSSUB43。RequestSet は BizTalk プロジェクトの名前です。 OracleEBSBindingRequestSets は、 FNDRSSUB43 要求セットを呼び出すためのスキーマです。

手順 3 を繰り返してメッセージを作成します。新しいメッセージの [プロパティ ] ウィンドウで、次の操作を行います。

プロパティ目的

Response RequestSet.OracleEBSBindingRequestSets_FND。FNDRSSUB43Response

プロパティ	目的
Response	RequestSet.OracleEBSBindingRequestSets_FND。FNDRSSUB43Response

オーケストレーションの設定

Oracle E-Business Suite で要求セットを呼び出すためにBizTalk Serverを使用するには、BizTalk オーケストレーションを作成する必要があります。このオーケストレーションでは、定義された受信場所に要求メッセージを削除します。オーケストレーションはこのメッセージを使用し、Oracle E-Business Suite に渡して 、FNDRSSUB43 要求セットを呼び出します。要求セットの応答は Oracle から受信され、別の場所に保存されます。要求セットを呼び出す一般的なオーケストレーションには、次のものが含まれます。

Oracle E-Business Suite にメッセージを送信し、応答を受信する図形を送受信します。
Oracle E-Business Suite に送信する要求メッセージを受信する一方向の受信ポート。
Oracle E-Business Suite に要求メッセージを送信し、応答を受信するための双方向送信ポート。
Oracle E-Business Suite からの応答をフォルダーに送信する一方向送信ポート。

要求セットを呼び出すサンプルオーケストレーションは、次のようになります。

メッセージ図形の追加

メッセージ図形ごとに次のプロパティを指定します。 [図形] 列に表示される名前は、前のオーケストレーションに表示されるメッセージ図形の名前です。

図形	図形の種類	プロパティ
ReceiveMessage	受信	- 名前を ReceiveMessage に設定する - アクティブ化を True に設定する
SendMessage	Send	- 名前を SendMessage に設定する
ReceiveResponse	受信	- 名前を ReceiveResponse に設定する - アクティブ化を False に設定する
SendResponse	Send	- 名前を SendResponse に設定する

ポートの追加

論理ポートごとに次のプロパティを指定してください。 [ ポート ] 列に表示される名前は、オーケストレーションに表示されるポートの名前です。

Port	プロパティ
MessageIn	- 識別子を MessageIn に設定する - Type を MessageInType に設定する - 通信パターンを一方向に設定する - 通信方向を受信に設定する
LOBPort	- 識別子を LOBPort に設定する - 型を LOBPortType に設定する - 通信パターンを Request-Response に設定する - [通信の方向] を [送受信] に設定する
ResponseOut	- 識別子を ResponseOut に設定する - Type を ResponseOutType に設定する - 通信パターンを一方向に設定する - [通信の方向] を [送信] に設定する

アクション図形のメッセージを指定し、ポートに接続する

次の表では、アクション図形のメッセージを指定し、ポートにリンクするために設定するプロパティとその値を指定します。 [図形] 列に表示される名前は、前のオーケストレーションに表示されているメッセージ図形の名前です。

図形	プロパティ
ReceiveMessage	- メッセージを要求に設定する - 操作を MessageIn.RequestSet.Request に設定する
SendMessage	- メッセージを要求に設定する - 操作を LOBPort.RequestSet.Request に設定する
ReceiveResponse	- [メッセージ] を [応答] に設定する - 操作を LOBPort.RequestSet.Response に設定する
SendResponse	- [メッセージ] を [応答] に設定する - 操作を ResponseOut.RequestSet.Request に設定する

これらのプロパティを指定すると、メッセージの図形とポートが接続され、オーケストレーションが完了します。

次に、BizTalk ソリューションをビルドし、それをBizTalk Serverに展開する必要があります。詳細については、「オーケストレーションのビルドと実行」を参照してください。

BizTalk アプリケーションの構成

BizTalk プロジェクトを展開すると、前に作成したオーケストレーションが、BizTalk Server管理コンソールの [オーケストレーション] ウィンドウの下に一覧表示されます。アプリケーションを構成するには、BizTalk Server管理コンソールを使用する必要があります。アプリケーションの構成の詳細については、「チュートリアル: 基本的な BizTalk アプリケーションの展開」を参照してください。

アプリケーションの構成には、次の作業が含まれます。

アプリケーションのホストの選択。

オーケストレーションで作成したポートを、BizTalk Server管理コンソールの物理ポートにマッピングします。このオーケストレーションでは、次の操作を行う必要があります。

ハードディスク上の場所と、要求メッセージを削除する対応するファイルポートを定義します。 BizTalk オーケストレーションは要求メッセージを使用し、Oracle E-Business Suite に送信します。
ハードディスク上の場所と、BizTalk オーケストレーションが Oracle E-Business Suite からの応答を含む応答メッセージをドロップする対応するファイルポートを定義します。

Oracle E-Business Suite にメッセージを送信する物理 WCF-Custom または送信ポート WCF-OracleEBS 定義します。また、送信ポートでアクションを指定する必要があります。送信ポートを作成する方法については、「 Oracle E-Business Adapter への物理ポートバインドの手動構成」を参照してください。

Oracle E-Business アダプターを使用して要求セットを呼び出すには、操作が呼び出される適切なアプリケーションコンテキストを設定する必要があります。 Oracle E-Business アダプターには、任意の操作のアプリケーションコンテキストを指定するための特定のバインドプロパティが用意されています。これらのバインドプロパティは、要求セットの呼び出しに使用される WCF-Custom または WCF-OracleEBS ポートに設定する必要があります。

ClientCredentialType バインドプロパティが Database に設定されている場合は、次のバインドプロパティを指定してアプリケーションコンテキストを設定する必要があります。

Binding プロパティ	値
OracleUserName	Oracle E-Business Suite ユーザーの名前を指定します。 Oracle E-Business アダプターは、Oracle E-Business Suite に接続するときに OracleUserName バインディングプロパティに入力した値の大文字と小文字は保持されません。ユーザー名は、SQL*Plus の標準規則を使用して Oracle E-Business Suite に渡されます。ただし、ユーザー名の大文字と小文字を保持する場合、または特殊文字を含むユーザー名を入力する場合は、値を二重引用符で囲んで指定する必要があります。
OraclePassword	Oracle E-Business Suite ユーザーのパスワード。 Oracle E-Business アダプターは、Oracle E-Business Suite に接続するときに OraclePassword バインディングプロパティに入力した値の大文字と小文字は保持されません。パスワードは、SQL*Plus の標準規則を使用して Oracle E-Business Suite に渡されます。ただし、パスワードの大文字と小文字を保持する場合、または特殊文字を含むパスワードを入力する場合は、値を二重引用符で囲んで指定する必要があります。
OracleEBSResponsibilityName	Oracle E-Business Suite ユーザーに関連する責任。

ClientCredentialType バインドプロパティが EBusiness に設定されている場合は、接続の確立時に Oracle E-Business 資格情報を既に指定している必要があります。このような場合は、 OracleEBSResponsibilityName バインディングプロパティの値のみを指定する必要があります。

さまざまなバインドプロパティの詳細については、「 BizTalk Adapter for Oracle E-Business Suite Binding Properties 」を参照してください。アダプターがアプリケーションコンテキストの設定をサポートする方法の詳細については、「アプリケーションコンテキストの設定」を参照してください。

Note

アプリケーションコンテキストは、バインドプロパティを指定するか、Oracle E-Business アダプターによって公開されるメッセージコンテキストプロパティを設定することによって設定できます。バインドプロパティを設定する方法については、「 Oracle E-Business Suite のバインドプロパティを構成する」を参照してください。メッセージコンテキストプロパティを使用してアプリケーションコンテキストを設定する方法については、「 Oracle E-Business Suite でメッセージコンテキストプロパティを使用してアプリケーションコンテキストを構成する」を参照してください。

Note

アダプターサービス BizTalk プロジェクトアドインを使用してスキーマを生成すると、ポートとそれらのポートに設定するアクションに関する情報を含むバインドファイルも作成されます。このバインドファイルをBizTalk Server管理コンソールからインポートして、送信ポート (送信呼び出しの場合) または受信ポート (受信呼び出し用) を作成できます。詳細については、「 Oracle E-Business Suite へのポートバインドファイルを使用して物理ポートバインドを構成する」を参照してください。

アプリケーションの起動

要求セットを呼び出すには、BizTalk アプリケーションを起動する必要があります。 BizTalk アプリケーションを起動する手順については、「オーケストレーションを開始する方法」を参照してください。

この段階で、次のことを確認します。

オーケストレーションの要求メッセージを受信する FILE 受信ポートが実行されています。
オーケストレーションから応答メッセージを受信する FILE 送信ポートが実行されています。
FNDRSSUB43要求セットを呼び出す WCF-Custom または WCF-OracleEBS 送信ポートが実行されています。
操作の BizTalk オーケストレーションが実行されています。

操作の実行

アプリケーションを実行した後、 FNDRSSUB43 要求セットを呼び出すためのスキーマに準拠する要求メッセージを削除する必要があります。たとえば、 FNDRSSUB43 要求セットを呼び出す要求メッセージは次のとおりです。

<FNDRSSUB43 xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSets/FND">  
  <StartTime></ StartTime>  
  <All_x0020_Requests_x0020_in_x0020_the_x0020_Set_STAGE10>  
    <FNDMNNAV xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSetStage/FND/FNDRSSUB43">  
      <Responsibility xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSetConcurrentProgram/FND/FNDRSSUB43/STAGE10/FND">System Administrator</Responsibility>  
      <ns3:Application xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSetConcurrentProgram/FND/FNDRSSUB43/STAGE10/FND"></ns3:Application>  
    </ns2:FNDMNNAV>  
    <ns2:FNDMNMNU xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSetStage/FND/FNDRSSUB43">  
      <ns3:Responsibility xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSetConcurrentProgram/FND/FNDRSSUB43/STAGE10/FND">System Administrator</ns3:Responsibility>  
      <ns3:Application xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSetConcurrentProgram/FND/FNDRSSUB43/STAGE10/FND"></ns3:Application>  
    </ns2:FNDMNMNU>  
    <ns2:FNDMNFUN xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSetStage/FND/FNDRSSUB43">  
      <ns3:Responsibility xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSetConcurrentProgram/FND/FNDRSSUB43/STAGE10/FND">System Administrator</ns3:Responsibility>  
      <ns3:Application xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSetConcurrentProgram/FND/FNDRSSUB43/STAGE10/FND"></ns3:Application>  
    </ns2:FNDMNFUN>  
  </ns0:All_x0020_Requests_x0020_in_x0020_the_x0020_Set_STAGE10>  
</ns0:FNDRSSUB43>

Note

要求セットを呼び出すための要求メッセージには、SetRelClassOptions、SetPrintOptions、SetRepeatOptions、SetNlsOptions などの省略可能なパラメーターが必要です。ここで提供される要求メッセージには、これらの省略可能なパラメーターは含まれていません。省略可能なパラメーターを含む完全な要求メッセージの詳細については、「要求セットのメッセージスキーマ」を参照してください。

オーケストレーションによってメッセージが使用され、Oracle E-Business Suite に渡され、応答が受信されます。応答メッセージは、オーケストレーションの一部として指定された他のファイルの場所に保存されます。 FNDRSSUB43要求セットの応答は次のようになります。

<?xml version="1.0" encoding="utf-8"?>  
<FNDRSSUB43Response xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/RequestSets/FND">  
  <FNDRSSUB43Result>2543208</FNDRSSUB43Result>  
</FNDRSSUB43Response>

Oracle E-Business Suite からの応答には、要求 ID が含まれています。要求 ID '0' は、要求セットに対する最終的な送信操作が失敗したことを示します。このような場合は、ContinueOnFail など、要求メッセージで他の省略可能なパラメーターを指定して、エラーの理由を確認し、さらにデバッグすることができます。

ベストプラクティス

BizTalk プロジェクトを展開して構成したら、構成設定をバインドファイルと呼ばれる XML ファイルにエクスポートできます。バインドファイルを生成したら、ファイルから構成設定をインポートして、同じオーケストレーションの送信ポートや受信ポートなどの項目を作成する必要がないようにすることができます。バインドファイルの詳細については、「 Oracle E-Business Suite でアダプターバインドを再利用する」を参照してください。

参照

Oracle E-Business Suite アダプターを使用して BizTalk アプリケーションを開発する

次の方法で共有

Oracle E-Business Suite で要求セットを呼び出す

前提条件

Oracle E-Business Suite で要求セットを呼び出す方法

スキーマの生成

メッセージとメッセージの種類の定義

メッセージを作成し、スキーマにリンクするには

オーケストレーションの設定

メッセージ図形の追加

ポートの追加

アクション図形のメッセージを指定し、ポートに接続する

BizTalk アプリケーションの構成

アプリケーションの起動

操作の実行

ベストプラクティス

参照

フィードバック

その他のリソース

次の方法で共有

Oracle E-Business Suite で要求セットを呼び出す

前提条件

Oracle E-Business Suite で要求セットを呼び出す方法

スキーマの生成

メッセージとメッセージの種類の定義

メッセージを作成し、スキーマにリンクするには

オーケストレーションの設定

メッセージ図形の追加

ポートの追加

アクション図形のメッセージを指定し、ポートに接続する

BizTalk アプリケーションの構成

アプリケーションの起動

操作の実行

ベスト プラクティス

参照

フィードバック

その他のリソース

ベストプラクティス