Schémas de message pour les opérations tRFC
Les appels de fonction distante Transactiostructnal (tRFC) sont utilisés pour exécuter des appels RFC dans une unité de travail logique (LUW). L’adaptateur SAP prend en charge plusieurs TRFC par LUW pour les appels tRFC entrants. Pour les appels tRFC sortants (client), l’adaptateur ne peut prendre en charge qu’une seule tRFC dans un LUW ; il crée donc un LUW sur SAP pour chaque appel tRFC client. Pour plus d’informations sur la façon dont l’adaptateur SAP prend en charge les opérations tRFC, consultez Opérations sur les TRFC dans SAP. Cette section décrit les schémas de message et les actions pour les opérations tRFC.
Structure des messages pour les opérations tRFC
Chaque opération tRFC se compose d’un message de demande et d’un message de réponse (réponse). L’adaptateur SAP associe un GUID à l’ID de transaction système (TID) SAP qui identifie le LUW sur le système SAP. Ce GUID peut être présent dans les messages de requête et de réponse tRFC dans l’élément <TransactionalRfcOperationIdentifier> .
Pour les appels tRFC sortants, vous pouvez passer un GUID à l’adaptateur dans le message de demande tRFC. Si vous ne fournissez pas de GUID, l’adaptateur en génère un pour vous. L’adaptateur retourne toujours le GUID dans le message de réponse tRFC. Vous transmettez ce GUID dans l’opération RfcConfirmTransID pour confirmer le TID sur le système SAP.
Pour les appels tRFC entrants, l’adaptateur transmet un GUID qu’il a généré et mappé au TID SAP dans le message de requête tRFC. Vous pouvez éventuellement retourner ce GUID dans le message de réponse.
Important
Dans certains scénarios, par exemple pour résoudre un problème sur le système SAP, vous pouvez avoir besoin de la valeur réelle du TID SAP qui identifie le tRFC sur le système SAP. Vous pouvez obtenir la valeur du TID SAP associé à un GUID en appelant la méthode ConvertGuidToTid . Pour plus d’informations sur ConvertGuidToTid, consultez Opérations spéciales.
Le tableau suivant montre les schémas de message utilisés pour les opérations tRFC et pour l’opération RfcConfirmTransID. L’opération RfcConfirmTransID est exposée par l’adaptateur afin que vous puissiez confirmer le TID SAP dans les appels tRFC du client.
| Opération | XML Structure | Description |
|---|---|---|
| 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]> |
Appelle une tRFC sur le système SAP. - Les paramètres d’importation, de modification et de table sont pris en charge. - L’importation et la modification des paramètres peuvent être de TYPES DE STRUCTURE SAP, DE TYPES DE TABLES SAP ou de types de données SIMPLES SAP. - Les appels clients tRFC n’ont pas de valeurs retournées côté sortie. SAP les exécute de manière asynchrone avec uniquement des valeurs côté entrée. L’élément <TransactionalRfcOperationIdentifier> : - Pour les appels tRFC sortants, vous pouvez éventuellement spécifier un GUID qui doit être mappé au TID SAP par l’adaptateur dans cet élément. Si aucun GUID n’est spécifié, l’adaptateur SAP en génère un et le mappe au TID SAP pour le tRFC. - Pour les appels tRFC entrants, l’adaptateur transmet le GUID mappé au TID SAP dans cet élément. |
| Réponse tRFC ([RFC_NAME]Réponse) |
<[RFC_NAME]Response xmlns="[VERSION]/Trfc/"> <TransactionalRfcOperationIdentifier>GUID </TransactionalRfcOperationIdentifier> </[RFC_NAME]Response> |
Indique que la RFC a été envoyée au système SAP. - Les appels clients tRFC n’ont pas de valeurs retournées côté sortie. SAP les exécute de manière asynchrone avec uniquement des valeurs côté entrée. L’élément <TransactionalRfcOperationIdentifier> : - Pour les appels tRFC sortants, l’adaptateur envoie le GUID associé au TID SAP pour le tRFC dans cet élément. - Pour les appels tRFC entrants, vous pouvez éventuellement retourner le GUID envoyé par l’adaptateur dans le message de demande. |
| RfcConfirmTransID (RfcConfirmTransID) |
<RfcConfirmTransID xmlns="[VERSION]/Trfc/"> <TransactionalRfcOperationIdentifier>GUID </TransactionalRfcOperationIdentifier> </RfcConfirmTransID> |
L’opération RfcConfirmTransID confirme le TID utilisé dans une opération tRFC sortante sur le système SAP. L’élément <TransactionalRfcOperationIdentifier> contient le GUID mappé au TID associé à l’appel tRFC sortant. Vous devez définir cette valeur sur la valeur du GUID retourné par l’adaptateur dans le message de réponse tRFC. Pour plus d’informations sur l’opération RfcConfirmTransID, consultez Opérations spéciales. |
| RfcConfirmTransIDResponse (RfcConfirmTransIDResponse) |
<RfcConfirmTransIDResponse xmlns="[VERSION]/Trfc/"> </RfcConfirmTransIDResponse> |
Indique que l’adaptateur SAP a confirmé le TID sur le système SAP. |
[VERSION] = Chaîne de version du message ; par exemple, http://Microsoft.LobServices.Sap/2007/03.
[RFC_NAME] = Nom de la RFC ; par exemple, RFC_CUSTOMER_GET.
[IN_PARAM_NAME] = Nom du paramètre RFC Import.
[INOUT_PARAM_NAME] = Nom d’un paramètre RFC Changing.
[TABLE_PARAM_NAME] = Nom d’un paramètre table RFC.
[STRUCT_PARAM_NAME] = Nom d’un paramètre de structure RFC.
GUID = GUID qui identifie le TID SAP associé au tRFC.
Actions de message pour les opérations tRFC
Le tableau suivant montre les actions de message utilisées pour les opérations tRFC.
| Opération | Message Action | Exemple |
|---|---|---|
| [RFC_NAME] | [VERSION]/Trfc/[RFC_NAME] | http://Microsoft.LobServices.Sap/2007/03/Trfc/RFC_CUSTOMER_GET |
| [RFC_NAME] Réponse | [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 Response | [VERSION/Trfc/RfcConfirmTransID/response | http://Microsoft.LobServices.Sap/2007/03/Trfc/RfcConfirmTransID/response |
[VERSION] = Chaîne de version du message ; par exemple, http://Microsoft.LobServices.Sap/2007/03.
[RFC_NAME] = Nom de la RFC à appeler ; par exemple, RFC_CUSTOMER_GET.
Voir aussi
Messages et schémas de message pour l’adaptateur BizTalk pour mySAP Business Suite