tRFC 操作のメッセージ スキーマ
Transactiostructnal リモート関数呼び出し (tRFC) は、論理作業単位 (LUW) で RFC 呼び出しを実行するために使用されます。 SAP アダプターは、受信 tRFC 呼び出しに対して LUW ごとに複数の tRFC をサポートします。 送信 (クライアント) tRFC 呼び出しの場合、アダプターは LUW で 1 つの tRFC のみをサポートできます。そのため、 では、クライアント tRFC 呼び出しごとに SAP に LUW が作成されます。 SAP アダプターが tRFC 操作をサポートする方法の詳細については、「 SAP での tRFC に対する操作」を参照してください。 このセクションでは、tRFC 操作のメッセージ スキーマとアクションについて説明します。
tRFC 操作のメッセージ構造
各 tRFC 操作は、要求メッセージと応答 (応答) メッセージで構成されます。 SAP アダプターは、GUID を SAP システム上の LUW を識別する SAP システム トランザクション ID (TID) に関連付けます。 この GUID は、TransactionalRfcOperationIdentifier> 要素の tRFC 要求メッセージと応答メッセージの両方に<存在できます。
送信 tRFC 呼び出しの場合は、tRFC 要求メッセージでアダプターに GUID を渡すことができます。 GUID を指定しない場合、アダプターによって自動的に生成されます。 アダプターは常に tRFC 応答メッセージの GUID を返します。 この GUID を RfcConfirmTransID 操作で渡して、SAP システム上の TID を確認します。
受信 tRFC 呼び出しの場合、アダプターは生成され、tRFC 要求メッセージの SAP TID にマップされた GUID を渡します。 必要に応じて、応答メッセージでこの GUID を返すことができます。
重要
たとえば、SAP システムの問題のトラブルシューティングを行う場合など、一部のシナリオでは、SAP システム上の tRFC を識別する SAP TID の実際の値が必要になる場合があります。 ConvertGuidToTid メソッドを呼び出すことで、GUID に関連付けられている SAP TID の値を取得できます。 ConvertGuidToTid の詳細については、「特殊な操作」を参照してください。
次の表は、tRFC 操作と RfcConfirmTransID 操作に使用されるメッセージ スキーマを示しています。 RfcConfirmTransID 操作は、クライアント tRFC 呼び出しで SAP TID を確認できるように、アダプターによって表示されます。
| 操作 | XML 構造体 | 説明 |
|---|---|---|
| Trfc ([RFC_NAME]) |
<[RFC_NAME] xmlns="[VERSION]/Trfc/"> <IN1_PARAM_NAME>v1</IN1_PARAM_NAME> <IN2_PARAM_NAME>v2</IN2_PARAM_NAME> … <INOUT1_PARAM_NAME>v3</INOUT1_PARAM_NAME> <INOUT2_PARAM_NAME>v4</INOUT2_PARAM_NAME> … <TABLE1_PARAM_NAME xmlns="[VERSION]/Types/Trfc/"> <STRUCT1_PARAM_NAME> <[FIELD1_NAME]>value1</[FIELD1_NAME]> <[FIELD2_NAME]>value2</[FIELD2_NAME]> … </STRUCT1_PARAM_NAME> … </TABLE1_PARAM_NAME> … <TransactionalRfcOperationIdentifier>GUID </TransactionalRfcOperationIdentifier> </[RFC_NAME]> |
SAP システムで tRFC を呼び出します。 - インポート、変更、およびテーブル パラメーターがサポートされています。 - パラメーターのインポートと変更には、SAP STRUCTURE TYPES、SAP TABLE TYPES、または SAP 単純データ型を使用できます。 - tRFC クライアント呼び出しでは、出力側に値が返されません。 SAP は、入力側の値のみを使用して非同期的に実行します。 TransactionalRfcOperationIdentifier> 要素:< - 送信 tRFC 呼び出しの場合は、必要に応じて、この要素のアダプターによって SAP TID にマップされる GUID を指定できます。 GUID が指定されていない場合、SAP アダプターは GUID を生成し、tRFC の SAP TID にマップします。 - 受信 tRFC 呼び出しの場合、アダプターは、この要素の SAP TID にマップされた GUID を渡します。 |
| tRFC 応答 ([RFC_NAME]Response) |
<[RFC_NAME]Response xmlns="[VERSION]/Trfc/"> <TransactionalRfcOperationIdentifier>GUID </TransactionalRfcOperationIdentifier> </[RFC_NAME]Response> |
RFC が SAP システムに送信されたことを示します。 - tRFC クライアント呼び出しでは、出力側に値が返されません。 SAP は、入力側の値のみを使用して非同期的に実行します。 TransactionalRfcOperationIdentifier> 要素:< - 送信 tRFC 呼び出しの場合、アダプターは、この要素の tRFC の SAP TID に関連付けられている GUID を送信します。 - 受信 tRFC 呼び出しの場合は、必要に応じて、要求メッセージでアダプターによって送信された GUID を返すことができます。 |
| RfcConfirmTransID (RfcConfirmTransID) |
<RfcConfirmTransID xmlns="[VERSION]/Trfc/"> <TransactionalRfcOperationIdentifier>GUID </TransactionalRfcOperationIdentifier> </RfcConfirmTransID> |
RfcConfirmTransID 操作は、SAP システムの送信 tRFC 操作で使用される TID を確認します。 <TransactionalRfcOperationIdentifier> 要素には、送信 tRFC 呼び出しに関連付けられている TID にマップされる GUID が含まれています。 これは、tRFC 応答メッセージでアダプターによって返された GUID の値に設定する必要があります。 RfcConfirmTransID 操作の詳細については、「 特殊な操作」を参照してください。 |
| RfcConfirmTransIDResponse (RfcConfirmTransIDResponse) |
<RfcConfirmTransIDResponse xmlns="[VERSION]/Trfc/"> </RfcConfirmTransIDResponse> |
SAP アダプターが SAP システムで TID を確認したことを示します。 |
[VERSION] = メッセージのバージョン文字列。たとえば、 http://Microsoft.LobServices.Sap/2007/03です。
[RFC_NAME] = RFC の名前。たとえば、RFC_CUSTOMER_GET。
[IN_PARAM_NAME] = RFC Import パラメーターの名前。
[INOUT_PARAM_NAME] = RFC 変更パラメーターの名前。
[TABLE_PARAM_NAME] = RFC Table パラメーターの名前。
[STRUCT_PARAM_NAME] = RFC 構造体パラメーターの名前。
GUID = tRFC に関連付けられている SAP TID を識別する GUID。
tRFC 操作のメッセージ アクション
次の表は、tRFC 操作に使用されるメッセージ アクションを示しています。
| 操作 | メッセージ アクション | 例 |
|---|---|---|
| [RFC_NAME] | [VERSION]/Trfc/[RFC_NAME] | http://Microsoft.LobServices.Sap/2007/03/Trfc/RFC_CUSTOMER_GET |
| [RFC_NAME]応答 | [VERSION]/Trfc/[RFC_NAME]/response | http://Microsoft.LobServices.Sap/2007/03/Trfc/RFC_CUSTOMER_GET/response |
| RfcConfirmTransID | [VERSION]/Trfc/RfcConfirmTransID | http://Microsoft.LobServices.Sap/2007/03/Trfc/RfcConfirmTransID |
| RfcConfirmTransID 応答 | [VERSION/Trfc/RfcConfirmTransID/response | http://Microsoft.LobServices.Sap/2007/03/Trfc/RfcConfirmTransID/response |
[VERSION] = メッセージのバージョン文字列。たとえば、 http://Microsoft.LobServices.Sap/2007/03です。
[RFC_NAME] = 呼び出される RFC の名前。たとえば、RFC_CUSTOMER_GET。