Schemi di messaggio per operazioni tRFC
Le chiamate di funzioni remote transactiostructnali (tRFCs) vengono usate per eseguire chiamate RFC in un'unità logica di lavoro (LUW). L'adattatore SAP supporta più TRFC per LUW per le chiamate tRFC in ingresso. Per le chiamate tRFC in uscita (client), l'adapter può supportare solo un singolo TRFC in un LUW; pertanto per crea un LUW in SAP per ogni chiamata tRFC del client. Per altre informazioni sul modo in cui l'adattatore SAP supporta le operazioni tRFC, vedere Operazioni sui TRFC in SAP. In questa sezione vengono descritti gli schemi e le azioni dei messaggi per le operazioni tRFC.
Struttura dei messaggi per le operazioni tRFC
Ogni operazione tRFC è costituita da un messaggio di richiesta e da un messaggio di risposta (risposta). L'adapter SAP associa un GUID all'ID di transazione di sistema SAP (TID) che identifica LUW nel sistema SAP. Questo GUID può essere presente sia nei messaggi di richiesta tRFC che nei messaggi di risposta nell'elemento <TransactionalRfcOperationIdentifier> .
Per le chiamate tRFC in uscita, è possibile passare un GUID all'adattatore nel messaggio di richiesta tRFC. Se non si specifica un GUID, l'adattatore ne genera uno automaticamente. L'adapter restituisce sempre il GUID nel messaggio di risposta tRFC. Questo GUID viene passato nell'operazione RfcConfirmTransID per confermare il TID nel sistema SAP.
Per le chiamate tRFC in ingresso, l'adattatore passa un GUID generato e mappato a SAP TID nel messaggio di richiesta tRFC. Facoltativamente, è possibile restituire questo GUID nel messaggio di risposta.
Importante
In alcuni scenari, ad esempio per risolvere un problema nel sistema SAP, potrebbe essere necessario il valore effettivo di SAP TID che identifica il tRFC nel sistema SAP. È possibile ottenere il valore di SAP TID associato a un GUID chiamando il metodo ConvertGuidToTid . Per altre informazioni su ConvertGuidToTid, vedere Operazioni speciali.
La tabella seguente illustra gli schemi dei messaggi usati per le operazioni tRFC e per l'operazione RfcConfirmTransID. L'operazione RfcConfirmTransID viene visualizzata dalla scheda in modo da poter confermare il TID SAP nelle chiamate tRFC client.
| Operazione | Struttura XML | Descrizione |
|---|---|---|
| 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]> |
Richiama un TRFC nel sistema SAP. - Sono supportati i parametri di importazione, modifica e tabella. - I parametri di importazione e modifica possono essere tipi di struttura SAP, TIPI di tabella SAP o tipi di dati semplici SAP. - Le chiamate client tRFC non hanno valori restituiti sul lato output. SAP li esegue in modo asincrono con solo valori lato input. Elemento <TransactionalRfcOperationIdentifier> : - Per le chiamate tRFC in uscita, è possibile specificare facoltativamente un GUID di cui eseguire il mapping al TID SAP dall'adattatore in questo elemento. Se non viene specificato un GUID, l'adattatore SAP ne genera uno ed esegue il mapping al TID SAP per tRFC. - Per le chiamate tRFC in ingresso, l'adapter passa il GUID mappato al TID SAP in questo elemento. |
| Risposta tRFC ([RFC_NAME]Response) |
<[RFC_NAME]Response xmlns="[VERSION]/Trfc/"> <TransactionalRfcOperationIdentifier>GUID </TransactionalRfcOperationIdentifier> </[RFC_NAME]Response> |
Indica che l'RFC è stato inviato al sistema SAP. - Le chiamate client tRFC non hanno valori restituiti sul lato output. SAP li esegue in modo asincrono con solo valori lato input. Elemento <TransactionalRfcOperationIdentifier> : - Per le chiamate tRFC in uscita, l'adattatore invia il GUID associato al TID SAP per tRFC in questo elemento. - Per le chiamate tRFC in ingresso, è possibile restituire facoltativamente il GUID inviato dall'adapter nel messaggio di richiesta. |
| RfcConfirmTransID (RfcConfirmTransID) |
<RfcConfirmTransID xmlns="[VERSION]/Trfc/"> <TransactionalRfcOperationIdentifier>GUID </TransactionalRfcOperationIdentifier> </RfcConfirmTransID> |
L'operazione RfcConfirmTransID conferma il TID usato in un'operazione tRFC in uscita nel sistema SAP. L'elemento <TransactionalRfcOperationIdentifier> contiene il GUID mappato al TID associato alla chiamata tRFC in uscita. È necessario impostare questo valore sul valore del GUID restituito dall'adattatore nel messaggio di risposta tRFC. Per altre informazioni sull'operazione RfcConfirmTransID, vedere Operazioni speciali. |
| RfcConfirmTransIDResponse (RfcConfirmTransIDResponse) |
<RfcConfirmTransIDResponse xmlns="[VERSION]/Trfc/"> </RfcConfirmTransIDResponse> |
Indica che l'adattatore SAP ha confermato il TID nel sistema SAP. |
[VERSION] = Stringa di versione del messaggio; ad esempio . http://Microsoft.LobServices.Sap/2007/03
[RFC_NAME] = Nome della RFC; ad esempio, RFC_CUSTOMER_GET.
[IN_PARAM_NAME] = Nome del parametro Di importazione RFC.
[INOUT_PARAM_NAME] = Nome di un parametro RFC Changing.
[TABLE_PARAM_NAME] = Nome di un parametro Table RFC.
[STRUCT_PARAM_NAME] = Nome di un parametro Struttura RFC.
GUID = GUID che identifica il TID SAP associato a tRFC.
Azioni messaggio per le operazioni tRFC
La tabella seguente illustra le azioni del messaggio usate per le operazioni tRFC.
| Operazione | Azione messaggio | Esempio |
|---|---|---|
| [RFC_NAME] | [VERSION]/Trfc/[RFC_NAME] | http://Microsoft.LobServices.Sap/2007/03/Trfc/RFC_CUSTOMER_GET |
| [RFC_NAME] Risposta | [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 |
| Risposta RfcConfirmTransID | [VERSION/Trfc/RfcConfirmTransID/response | http://Microsoft.LobServices.Sap/2007/03/Trfc/RfcConfirmTransID/response |
[VERSION] = Stringa di versione del messaggio; ad esempio . http://Microsoft.LobServices.Sap/2007/03
[RFC_NAME] = Nome della RFC da richiamare; ad esempio, RFC_CUSTOMER_GET.
Vedere anche
Messaggi e schemi di messaggio per l'adapter BizTalk per mySAP Business Suite