Nachrichtenschemas für tRFC-Vorgänge

  • Artikel

Transactiostructnal Remote Function Calls (tRFCs) werden verwendet, um RFC-Aufrufe in einer logischen Arbeitseinheit (LuW) auszuführen. Der SAP-Adapter unterstützt mehrere tRFCs pro LUW für eingehende tRFC-Aufrufe. Für ausgehende tRFC-Aufrufe (Client) kann der Adapter nur einen einzelnen tRFC in einer LUW unterstützen. daher für erstellt für jeden tRFC-Clientaufruf eine LUW in SAP. Weitere Informationen dazu, wie der SAP-Adapter tRFC-Vorgänge unterstützt, finden Sie unter Vorgänge für tRFCs in SAP. In diesem Abschnitt werden die Nachrichtenschemas und Aktionen für tRFC-Vorgänge beschrieben.

Nachrichtenstruktur für tRFC-Vorgänge

Jeder tRFC-Vorgang besteht aus einer Anforderungsnachricht und einer Antwortnachricht (Antwort). Der SAP-Adapter ordnet eine GUID der SAP-Systemtransaktions-ID (TID) zu, die die LUW im SAP-System identifiziert. Diese GUID kann sowohl in der tRFC-Anforderung als auch in den Antwortnachrichten im <TransactionalRfcOperationIdentifier-Element> vorhanden sein.

  • Bei ausgehenden tRFC-Aufrufen können Sie in der tRFC-Anforderungsnachricht eine GUID an den Adapter übergeben. Wenn Sie keine GUID angeben, generiert der Adapter eine für Sie. Der Adapter gibt immer die GUID in der tRFC-Antwortnachricht zurück. Sie übergeben diese GUID im RfcConfirmTransID-Vorgang, um die TID im SAP-System zu bestätigen.

  • Bei eingehenden tRFC-Aufrufen übergibt der Adapter eine GUID, die er generiert und der SAP TID in der tRFC-Anforderungsnachricht zugeordnet hat. Sie können diese GUID optional in der Antwortnachricht zurückgeben.

Wichtig

In einigen Szenarien, z. B. zur Behandlung eines Problems im SAP-System, benötigen Sie möglicherweise den tatsächlichen Wert der SAP-TID, der den tRFC im SAP-System identifiziert. Sie können den Wert der SAP TID abrufen, die einer GUID zugeordnet ist, indem Sie die ConvertGuidToTid-Methode aufrufen. Weitere Informationen zu ConvertGuidToTid finden Sie unter Spezielle Vorgänge.

Die folgende Tabelle zeigt die Nachrichtenschemas, die für tRFC-Vorgänge und für den RfcConfirmTransID-Vorgang verwendet werden. Der RfcConfirmTransID-Vorgang wird vom Adapter angezeigt, sodass Sie die SAP TID in tRFC-Clientaufrufen bestätigen können.

Vorgang XML-Struktur BESCHREIBUNG
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]> Ruft einen tRFC im SAP-System auf.

– Import-, Änderungs- und Tabellenparameter werden unterstützt.

- Importieren und Ändern von Parametern können SAP STRUCTURE TYPES, SAP TABLE TYPES oder einfache SAP-Datentypen sein.

- tRFC-Clientaufrufe haben keine Werte, die auf der Ausgabeseite zurückgegeben werden. SAP führt sie asynchron mit nur eingabeseitigen Werten aus.

Das <TransactionalRfcOperationIdentifier-Element> :

– Für ausgehende tRFC-Aufrufe können Sie optional eine GUID angeben, die vom Adapter in diesem Element der SAP TID zugeordnet werden soll. Wenn keine GUID angegeben wird, generiert der SAP-Adapter eine und ordnet sie der SAP-TID für tRFC zu.

– Bei eingehenden tRFC-Aufrufen übergibt der Adapter die GUID, die der SAP TID in diesem Element zugeordnet ist.
tRFC-Antwort

([RFC_NAME]Antwort)		 <[RFC_NAME]Response xmlns="[VERSION]/Trfc/"> <TransactionalRfcOperationIdentifier>GUID </TransactionalRfcOperationIdentifier> </[RFC_NAME]Response> Gibt an, dass der RFC an das SAP-System gesendet wurde.

- tRFC-Clientaufrufe haben keine Werte, die auf der Ausgabeseite zurückgegeben werden. SAP führt sie asynchron mit nur eingabeseitigen Werten aus.

Das <TransactionalRfcOperationIdentifier-Element> :

- Bei ausgehenden tRFC-Aufrufen sendet der Adapter die GUID, die der SAP TID für den tRFC in diesem Element zugeordnet ist.

– Bei eingehenden tRFC-Aufrufen können Sie optional die GUID zurückgeben, die vom Adapter in der Anforderungsnachricht gesendet wurde.
RfcConfirmTransID

(RfcConfirmTransID)		 <RfcConfirmTransID xmlns="[VERSION]/Trfc/"> <TransactionalRfcOperationIdentifier>GUID </TransactionalRfcOperationIdentifier> </RfcConfirmTransID> Der RfcConfirmTransID-Vorgang bestätigt die TID, die in einem ausgehenden tRFC-Vorgang auf dem SAP-System verwendet wird.

Das <TransactionalRfcOperationIdentifier-Element> enthält die GUID, die der TID zugeordnet ist, die dem ausgehenden tRFC-Aufruf zugeordnet ist. Sie sollten dies auf den Wert der GUID festlegen, die vom Adapter in der tRFC-Antwortnachricht zurückgegeben wurde.

Weitere Informationen zum RfcConfirmTransID-Vorgang finden Sie unter Spezielle Vorgänge.
RfcConfirmTransIDResponse

(RfcConfirmTransIDResponse)		 <RfcConfirmTransIDResponse xmlns="[VERSION]/Trfc/"> </RfcConfirmTransIDResponse> Gibt an, dass der SAP-Adapter die TID im SAP-System bestätigt hat.

[VERSION] = Die Nachrichtenversionszeichenfolge; beispiel: http://Microsoft.LobServices.Sap/2007/03.

[RFC_NAME] = Name des RFC; beispielsweise RFC_CUSTOMER_GET.

[IN_PARAM_NAME] = Der Name des RFC Import-Parameters.

[INOUT_PARAM_NAME] = Der Name eines RFC Changing-Parameters.

[TABLE_PARAM_NAME] = Der Name eines RFC Table-Parameters.

[STRUCT_PARAM_NAME] = Der Name eines RFC-Strukturparameters.

GUID = Eine GUID, die die sap TID identifiziert, die dem tRFC zugeordnet ist.

Nachrichtenaktionen für tRFC-Vorgänge

Die folgende Tabelle zeigt die Nachrichtenaktionen, die für tRFC-Vorgänge verwendet werden.

Vorgang Meldungsaktion Beispiel
[RFC_NAME] [VERSION]/Trfc/[RFC_NAME] http://Microsoft.LobServices.Sap/2007/03/Trfc/RFC_CUSTOMER_GET
[RFC_NAME] Antwort [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-Antwort [VERSION/Trfc/RfcConfirmTransID/response http://Microsoft.LobServices.Sap/2007/03/Trfc/RfcConfirmTransID/response

[VERSION] = Die Nachrichtenversionszeichenfolge; beispiel: http://Microsoft.LobServices.Sap/2007/03.

[RFC_NAME] = Der Name des aufzurufenden RFC; beispielsweise RFC_CUSTOMER_GET.

Weitere Informationen

Nachrichten und Nachrichtenschemas für Den BizTalk-Adapter für mySAP Business Suite