BizTalk Serverを使用して SAP で tRFC を呼び出す

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

トランザクションリモート関数呼び出し (tRFC) では、SAP システムでの RFC の 1 回限りの実行が保証されます。 SAP アダプターによって表示される任意の RFC を tRFC として呼び出すことができます。 tRFC の呼び出しは、RFC の呼び出しに似ています (「BizTalk Serverを使用して SAP で RFC を呼び出す」を参照してください)。

SAP アダプターは、RFC (RFC) とは異なるノード (TRFC) の下に tRFC を表示します。
tRFC 操作には、SAP アダプターによって tRFC の SAP トランザクション ID にマップされる GUID パラメーターが含まれます。
tRFC を呼び出した後、RfcConfirmTransID 操作を呼び出して、SAP システム上の tRFC を確認 (コミット) する必要があります。この操作は、アダプターサービスアドインの使用で TRFC ノードのすぐ下に表示されます。

SAP アダプターが tRFC の呼び出しをサポートする方法の詳細については、「 SAP での tRFC に対する操作」を参照してください。 tRFC を呼び出すための SOAP メッセージの構造の詳細については、「tRFC 操作のメッセージスキーマ」を参照してください。

BizTalk Serverを使用して SAP システムで tRFC を呼び出す方法

BizTalk Serverを使用して SAP システムで操作を実行するには、「SAP アプリケーションを作成するための構成要素」で説明されている手続き型タスクが含まれます。 SAP システムで tRFC を呼び出すには、次のタスクを実行します。

BizTalk プロジェクトを作成し、SAP システムで呼び出す tRFC のスキーマを生成します。また、 RFCConfirmTransID 操作のスキーマを生成して、SAP システムで TID をコミットする必要があります。
SAP システムからメッセージを送受信するためのメッセージを BizTalk プロジェクトに作成します。
SAP システムで tRFC を呼び出すオーケストレーションを作成し、SAP アダプターによる tRFC 呼び出しに応答して SAP システムで作成された TID をコミットします。
BizTalk プロジェクトをビルドして展開します。
物理送受信ポートを作成して BizTalk アプリケーションを構成します。
BizTalk アプリケーションを起動します。

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

このトピックに基づくサンプル

このトピックに基づくサンプル tRFCClient は、BizTalk アダプターパックでも提供されています。詳細については、「 SAP アダプターのサンプル」を参照してください。

スキーマの生成

このトピックでは、SAP アダプターを使用して tRFC を呼び出す方法を示すために、次のスキーマを生成します。

tRFC をBAPI_SALESORDER_CREATEFROMDAT2 します。
RfcConfirmTransID 操作。この操作を使用して、SAP システムで作成された TID をコミットする必要があります。 SAP システムがこの呼び出しを受信すると、システムから TID が削除されます。

スキーマの生成方法の詳細については、「 SAP での tRFC 操作のメタデータの参照、検索、取得」を参照してください。

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

前に生成したスキーマでは、オーケストレーション内のメッセージに必要な "型" について説明します。通常、メッセージは変数であり、対応するスキーマによって定義される型です。 BizTalk プロジェクトのオーケストレーションビューから、生成したスキーマをメッセージにリンクする必要があります。

このトピックでは、4 つのメッセージ (tRFC を呼び出す要求/応答メッセージセットと、RfcConfirmTransID 操作を呼び出す別の要求/応答メッセージセット) を作成する必要があります。

メッセージを作成し、スキーマにリンクするには、次の手順を実行します。

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

まだ開いていない場合は、BizTalk プロジェクトをオーケストレーションビューで開きます。 [ 表示] をクリックし、[ その他のウィンドウ] をポイントして、[ オーケストレーションビュー] をクリックします。
オーケストレーションビューで、[メッセージ] を右クリックし、[新しいメッセージ] をクリックします。
新しく作成したメッセージを右クリックし、[ プロパティウィンドウ] を選択します。

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

プロパティ	目的
識別子	「 Request」と入力します。
メッセージ型	ドロップダウンリストから [ スキーマ] を展開し、メッセージの種類を選択します。たとえば、[ tRFC_Client.SAPBindingSchema1.BAPI_SALESORDER_CREATEFROMDAT2] を選択します。ここで、tRFC_Client は BizTalk プロジェクトの名前です。 SAPBindingSchema1 は、 BAPI_SALESORDER_CREATEFROMDAT2に対して生成されるスキーマです。

プロパティ

目的

識別子

「 Request」と入力します。

メッセージ型

ドロップダウンリストから [ スキーマ] を展開し、メッセージの種類を選択します。たとえば、[ tRFC_Client.SAPBindingSchema1.BAPI_SALESORDER_CREATEFROMDAT2] を選択 します。ここで、tRFC_Client は BizTalk プロジェクトの名前です。 SAPBindingSchema1 は、 BAPI_SALESORDER_CREATEFROMDAT2に対して生成されるスキーマです。

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

識別子をに設定する	メッセージの種類をに設定する
Response	tRFC_Client.SAPBindingSchema1.BAPI_SALESORDER_CREATEFROMDAT2Response
TIDRequest	tRFC_Client.SAPBindingSchema3.RfcConfirmTransID
TIDResponse	tRFC_Client.SAPBindingSchema3.RfcConfirmTransIDResponse

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

SAP システムで tRFC を呼び出すためにBizTalk Serverを使用するには、BizTalk オーケストレーションを作成する必要があります。このオーケストレーションでは、定義された受信場所に要求メッセージを削除します。オーケストレーションはこのメッセージを使用して SAP システムに渡します。応答は SAP から受信され、別の場所に保存されます。応答メッセージには GUID が含まれています。オーケストレーションには、応答から GUID を抽出し、RfcConfirmTransID 操作のスキーマに準拠するメッセージを構築するメッセージの構築図形が含まれています。 RfcConfirmTransID 操作を呼び出すメッセージは、GUID をパラメーターとして使用して SAP システムに送信されます_ SAP システムで tRFC を呼び出すための一般的なオーケストレーションで、RfcConfirmTransID 操作の後に次のものが含まれます。

SAP システムにメッセージを送信し、応答を受信する図形を送受信します。
RfcConfirmTransID 操作のメッセージを作成するためのメッセージの割り当て図形とその中のメッセージの構築図形。
tRFC を呼び出すために SAP システムに送信する要求メッセージを受信する一方向の受信ポート。
tRFC を呼び出して応答を受信するメッセージを送信する双方向送信ポート。
RfcConfirmTransID 操作を呼び出して応答を受信するメッセージを送信する双方向送信ポート。
SAP システムからフォルダーに応答を送信する 2 つの一方向送信ポート。

サンプルオーケストレーションは次のようになります。

メッセージ図形の追加

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

図形	図形の種類	プロパティ
ReceiveXml	受信	- 名前を ReceiveXml に設定する - アクティブ化を True に設定する
SendToLOB	Send	- [名前] を SendToLOB に設定する
ReceiveResponse	受信	- 名前を ReceiveResponse に設定する - アクティブ化を False に設定する
SendResponse	Send	- 名前を SendResponse に設定する
SendTIDMsg	Send	- 名前を SendTIDMsg に設定する
ReceiveTIDRsp	受信	- 名前を ReceiveTIDRsp に設定する - Activate をFalse に設定する
SendTIDRsp	Send	- 名前を SendTIDRsp に設定する

メッセージの構築図形の追加

tRFC 呼び出しに対する SAP システムからの応答には GUID が含まれています。 tRFC 呼び出しをコミットするには、同じ GUID を RfcConfirmTransID 操作に渡す必要があります。これを行うには、オーケストレーションにメッセージの構築図形を含め、その中にメッセージの割り当て図形を含める必要があります。ここでは、メッセージの構築図形の目的は次のとおりです。

tRFC 呼び出しのために SAP システムから受信した応答から GUID を抽出します。
RfcConfirmTransID 操作のメッセージスキーマに準拠するメッセージを作成します。

[メッセージの構築] 図形では、 Message Constructed プロパティを TIDRequest に設定する必要があります。

次のコードの抜粋を [メッセージの割り当て] 図形に追加する必要があります。

XmlDoc = new System.Xml.XmlDocument();  
XmlDoc.LoadXml("<RfcConfirmTransID xmlns='http://Microsoft.LobServices.Sap/2007/03/RfcApi/'><TransactionalRfcOperationIdentifier /></RfcConfirmTransID>");  
TIDRequest = XmlDoc;  
TIDRequest.TransactionalRfcOperationIdentifier = xpath(Response,"string(/*[local-name()='BAPI_SALESORDER_CREATEFROMDAT2Response']/*[local-name()='TransactionalRfcOperationIdentifier']/text())");

上記のコードの抜粋を使用するには、次が必要です。

BizTalk プロジェクトに XmlDoc という変数を作成し、その型を System.Xml に設定します。Xmldocument。変数の作成の詳細については、「オーケストレーションでの変数の使用」を参照してください。
RfcConfirmTransID 操作のスキーマで TransactionalRfcOperationIdentifier プロパティを昇格しました。プロパティの昇格の詳細については、「プロパティの昇格」を参照してください。

ポートの追加

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

Port	プロパティ
FileIn	- 識別子を FileIn に設定する - Type を FileInPortType に設定する - 通信パターンを一方向に設定する - 受信する通信方向を設定する
tRFC_Port	- 識別子を tRFC_Port に設定する - 型を tRFC_PortType に設定する - 通信パターンを Request-Response に設定する - [通信の方向] を [送受信] に設定する
SavetRFCResponse	- 識別子を SavetRFCResponse に設定する - Type を SavetRFCResponsePortType に設定する - 通信パターンを一方向に設定する - [通信の方向] を [送信] に設定する
TID_Port	- 識別子を TID_Port に設定する - Type を TIDPortType に設定する - 通信パターンを Request-Response に設定する - [通信の方向] を [送受信] に設定する
SaveTIDResponse	- 識別子を SaveTIDResponse に設定する - Type を SaveTIDResponsePortType に設定する - 通信パターンを一方向に設定する - [通信の方向] を [送信] に設定する

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

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

図形	プロパティ
ReceiveXml	- メッセージを要求に設定する - 操作を FileIn.tRFC.Request に設定する
SendToLOB	- メッセージを要求に設定する - 操作を tRFC_Port.tRFC.Request に設定する
ReceiveResponse	- [メッセージ] を [応答] に設定する - 操作を tRFC_Port.tRFC.Response に設定する
SendResponse	- [メッセージ] を [応答] に設定する - 操作を SavetRFCResponse.tRFC.Request に設定する
SendTIDMsg	- メッセージを TIDRequest に設定する - 操作を TID_Port.TID.Request に設定する
ReceiveTIDRsp	- メッセージを TIDResponse に設定する - 操作を TID_Port.TID.Response に設定する
SendTIDRsp	- メッセージを TIDResponse に設定する - 操作を SaveTIDResponse.TID.Request に設定する

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

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

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

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

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

アプリケーションのホストの選択。
オーケストレーションで作成したポートを、BizTalk Server管理コンソールの物理ポートにマッピングします。このオーケストレーションでは、次の操作を行う必要があります。
- ハードディスク上の場所と、要求メッセージを削除する対応するファイルポートを定義します。 BizTalk オーケストレーションは、要求メッセージを使用して SAP システムに送信します。
- ハードディスク上の場所と、BizTalk オーケストレーションが SAP システムからの応答を含む応答メッセージを削除する対応するファイルポートを定義します。
- SAP システムにメッセージを送信するための物理 WCF-Custom または WCF-SAP 送信ポート (tRFC 要求メッセージと RfcConfirmTransID メッセージ用にそれぞれ 1 つ) を定義します。また、送信ポートでアクションを指定する必要があります。ポートを作成する方法については、「 SAP アダプターへの物理ポートバインドを手動で構成する」を参照してください。
  
  Note
  
  アダプターサービス BizTalk プロジェクトアドインを使用してスキーマを生成すると、ポートとそれらのポートに設定するアクションに関する情報を含むバインドファイルも作成されます。このバインドファイルをBizTalk Server管理コンソールからインポートして、送信ポート (送信呼び出しの場合) または受信ポート (受信呼び出し用) を作成できます。詳細については、「 SAP へのポートバインドファイルを使用して物理ポートバインドを構成する」を参照してください。

アプリケーションの起動

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

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

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

操作の実行

アプリケーションを実行した後、オーケストレーションの要求メッセージを削除する必要があります。 SAP システムで tRFC を呼び出すための要求メッセージのスキーマについては、「 tRFC 操作のメッセージスキーマ」を参照してください。たとえば、tRFC としてBAPI_SALEASORDER_CREATEFROMDAT2を呼び出す要求メッセージは次のとおりです。

<BAPI_SALESORDER_CREATEFROMDAT2 xmlns="http://Microsoft.LobServices.Sap/2007/03/Trfc/">  
  <ORDER_HEADER_IN>  
    <DOC_TYPE xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">TA</DOC_TYPE>  
    <SALES_ORG xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">1000</SALES_ORG>  
    <DISTR_CHAN xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">10</DISTR_CHAN>  
    <DIVISION xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">00</DIVISION>  
    <SALES_OFF xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">1000</SALES_OFF>  
    <REQ_DATE_H xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">2006-09-01T23:50:00</REQ_DATE_H>  
    <PURCH_DATE xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">2006-08-25T23:50:00</PURCH_DATE>  
    <PURCH_NO_C xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">Cust PO</PURCH_NO_C>  
    <CURRENCY xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">EUR</CURRENCY>  
  </ORDER_HEADER_IN>  
  <ORDER_ITEMS_IN>  
    <BAPISDITM xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">  
      <MATERIAL>P-109</MATERIAL>  
      <PLANT>1000</PLANT>  
      <TARGET_QU>ST</TARGET_QU>  
    </BAPISDITM>  
  </ORDER_ITEMS_IN>  
  <ORDER_PARTNERS>  
    <BAPIPARNR xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">  
      <PARTN_ROLE>AG</PARTN_ROLE>  
      <PARTN_NUMB>0000001390</PARTN_NUMB>  
    </BAPIPARNR>  
  </ORDER_PARTNERS>  
  <RETURN/>  
  <TransactionalRfcOperationIdentifier>def689b1-b514-4627-a861-d6d7f51c84e3</TransactionalRfcOperationIdentifier>  
</BAPI_SALESORDER_CREATEFROMDAT2>

オーケストレーションはメッセージを使用し、それを SAP システムに渡し、SAP システムから応答を受け取ります。応答メッセージは、オーケストレーションの一部として指定された他のファイルの場所に保存されます。 SAP システムからの応答には GUID が含まれています。その後、オーケストレーションは応答から別の要求メッセージを生成し、それを SAP システムに渡して RfcConfirmTransID を実行します。 RfcConfirmTransID 操作に対する応答が SAP システムから受信されると、ファイルの場所にコピーされます。要約すると、操作が正常に実行された後、

tRFC を呼び出すための SAP からの応答メッセージがファイルの場所にコピーされます。これには、SAP システムに送信されたのと同じ GUID が含まれています。 tRFC としてBAPI_SALESORDER_CREATEFROMDAT2を呼び出す応答メッセージは次のとおりです。
```
<?xml version="1.0" encoding="utf-8"?>  
<BAPI_SALESORDER_CREATEFROMDAT2Response xmlns="http://Microsoft.LobServices.Sap/2007/03/Trfc/">  
  <TransactionalRfcOperationIdentifier>def689b1-b514-4627-a861-d6d7f51c84e3</TransactionalRfcOperationIdentifier>  
</BAPI_SALESORDER_CREATEFROMDAT2Response>  
```
RfcConfirmTransID の応答メッセージが同じ場所にコピーされます。これは空の応答です。 RfcConfirmTransID の応答メッセージは次のとおりです。
```
<?xml version="1.0" encoding="utf-8"?>  
<RfcConfirmTransIDResponse xmlns="http://Microsoft.LobServices.Sap/2007/03/RfcApi/"></RfcConfirmTransIDResponse>  
```

Note

SAP アダプターアセンブリによって公開される ConvertGuidToTid() パブリックメソッドを使用して、GUID にマップされた SAP システムの TID を取得できます。詳細については、「特殊な操作」を参照してください。

考えられる例外

BizTalk Serverを使用して SAP システムで tRFC を呼び出すときに発生する可能性がある例外については、「SAP アダプターでの例外とエラー処理」を参照してください。

ベストプラクティス

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

参照

BizTalk アプリケーションの開発

次の方法で共有

BizTalk Serverを使用して SAP で tRFC を呼び出す

BizTalk Serverを使用して SAP システムで tRFC を呼び出す方法

このトピックに基づくサンプル

スキーマの生成

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

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

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

メッセージ図形の追加

メッセージの構築図形の追加

ポートの追加

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

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

アプリケーションの起動

操作の実行

考えられる例外

ベストプラクティス

参照

フィードバック

その他のリソース

次の方法で共有

BizTalk Serverを使用して SAP で tRFC を呼び出す

BizTalk Serverを使用して SAP システムで tRFC を呼び出す方法

このトピックに基づくサンプル

スキーマの生成

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

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

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

メッセージ図形の追加

メッセージの構築図形の追加

ポートの追加

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

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

アプリケーションの起動

操作の実行

考えられる例外

ベスト プラクティス

参照

フィードバック

その他のリソース

ベストプラクティス