Schemi di messaggio per stored procedure, funzioni e API PL/SQL
L'adapter Microsoft BizTalk per Oracle E-Business Suiteurface le stored procedure, le funzioni e le API di database Oracle sottostanti (stored procedure e funzioni all'interno di un pacchetto) come operazioni. Questa sezione descrive la struttura dei messaggi e le azioni usate per richiamare stored procedure, funzioni e API PL/SQL.
Struttura dei messaggi di stored procedure, funzioni e API PL/SQL
Le operazioni illustrate per le funzioni e le stored procedure seguono un modello di scambio di messaggi di richiesta-risposta. Nella tabella seguente viene illustrata la struttura di questi messaggi di richiesta e risposta.
Nota
Vedere le descrizioni delle entità dopo la tabella.
| Operazione | Messaggio XML | Descrizione |
|---|---|---|
| Richiesta stored procedure | <[SP_NAME] xmlns="[VERSION]/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]> |
Supporta i parametri Oracle IN e IN OUT nel corpo del messaggio |
| Risposta stored procedure | <[SP_NAME]Response xmlns="[VERSION]/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1<[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]Response> |
Supporta i parametri ORACLE OUT e IN OUT nel corpo del messaggio |
| Richiesta di funzione | <[FN_NAME] xmlns="[VERSION]/Functions/[SCHEMA] "> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[FN_NAME]> |
Supporta i parametri Oracle IN e IN OUT nel corpo del messaggio |
| Risposta della funzione | <[FN_NAME]Response xmlns="[VERSION]/Functions/[SCHEMA]"> <[FN_NAME]Result>return_value</[FN_NAME]Result> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[FN_NAME]Response> |
Supporta i parametri ORACLE OUT e IN OUT nel corpo del messaggio Il valore restituito della funzione viene restituito nell'elemento <[FN_NAME]Result> . Questo è il primo elemento nel messaggio di risposta. Viene prima di tutti i parametri. |
| Richiesta API PL/SQL | <[SP_NAME] xmlns="[VERSION]/PackageApis/[SCHEMA]/[PACKAGE_NAME/[SP_NAME]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]> |
Uguale alla funzione o alla stored procedure |
| Risposta a routine o funzione in pacchetto | <[SP_NAME]Response xmlns="[VERSION]/PackageApis/[SCHEMA]/[PACKAGE_NAME]/[SP_NAME]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]Response> |
Uguale alla funzione o alla stored procedure |
Descrizioni delle entità:
[VERSION] = http://schemas.microsoft.com/OracleEBS/2008/05.
[SCHEMA] = Raccolta di artefatti Oracle; ad esempio SCOTT.
[SP_NAME] = Stored procedure da eseguire; ad esempio, SP_INSERT.
[FN_NAME] = Funzione da eseguire; ad esempio, FN_GETID.
[PRM1_NAME] = Nome del parametro Oracle. Per ogni messaggio, vedere la colonna Descrizione per le istruzioni dei parametri supportate.
[PACKAGE_NAME] = Nome del pacchetto che contiene la routine o la funzione di destinazione.
Il database Oracle supporta l'overload per stored procedure e funzioni. L'adattatore Oracle E-Business supporta questa funzionalità aggiungendo una stringa di overload allo spazio dei nomi di destinazione per ogni artefatto di overload. Il valore di questa stringa è "overload1" per il primo overload, "overload2" per il secondo overload e così via. Nell'esempio seguente viene illustrata la struttura dei messaggi per due stored procedure di overload.
Stored Procedure Overload 1:
<[SP_NAME] xmlns="[VERSION]/PackageApis/[SCHEMA]/[PACKAGE_NAME]/[SP_NAME]/overload1">
<[PRM1_NAME]>value1</[PRM1_NAME]>
<[PRM2_NAME]>value1</[PRM2_NAME]>
…
</[SP_NAME]>
Stored Procedure Overload 2:
<[SP_NAME] xmlns="[VERSION]/PackageApis/[SCHEMA]/[PACKAGE_NAME]/[SP_NAME]/overload2">
<[PRM1_NAME]>value1</I_[PRM1_NAME]>
<[PRM2_NAME]>value1</I_[PRM2_NAME]>
…
</[SP_NAME]>
Azioni dei messaggi di stored procedure, funzioni e API PL/SQL
L'adattatore Oracle E-Business usa le azioni del messaggio seguenti per le operazioni di stored procedure, funzione e API PL/SQL.
Nota
Vedere le descrizioni delle entità dopo la tabella.
| Messaggio | Azione | Esempio |
|---|---|---|
| Richiesta stored procedure | Procedure/[SCHEMA]/[SP_NAME] | Procedure/SCOTT/SP_INSERT |
| Risposta stored procedure | Procedure/[SCHEMA]/[SP_NAME]/risposta | Procedure/SCOTT/SP_INSERT/risposta |
| Richiesta di funzione | Funzioni/[SCHEMA]/[FN_NAME] | Funzioni/SCOTT/FN_GETID |
| Risposta della funzione | Funzioni/[SCHEMA]/[FN_NAME]/response | Funzioni/SCOTT/FN_GETID/risposta |
| Richiesta API PL/SQL | [SCHEMA]/Package/[PACKAGE_NAME]/[SP_NAME] | SCOTT/Package/CUSTOMER/SP_INSERT |
| Risposta stored procedure in pacchetto | [SCHEMA]/Package/[PACKAGE_NAME]/[SP_NAME]/response | SCOTT/Package/CUSTOMER/SP_INSERT/response |
| Richiesta di funzione in pacchetto | [SCHEMA]/Package/[PACKAGE_NAME]/[FN_NAME] | SCOTT/Package/CUSTOMER/FN_GETID |
| Risposta della funzione in pacchetto | [SCHEMA]/Package/[PACKAGE_NAME]/[FN_NAME]/response | SCOTT/Package/CUSTOMER/FN_GETID/response |
| Richiesta stored procedure di overload | [SCHEMA]/Procedure/[SP_NAME]/[OVERLOAD] | SCOTT/Procedure/SP_INSERT/overload1 |
| Risposta di stored procedure di overload | [SCHEMA]/Procedure/[SP_NAME]/[OVERLOAD]/response | SCOTT/Procedure/SP_INSERT/overload1/response |
Descrizioni delle entità:
[SCHEMA] = Raccolta di artefatti Oracle; ad esempio SCOTT.
[SP_NAME] = Stored procedure da eseguire; ad esempio, SP_INSERT.
[FN_NAME] = Funzione da eseguire; ad esempio, FN_GETID.
[PACKAGE_NAME] = Nome del pacchetto che contiene la routine o la funzione di destinazione.
[OVERLOAD] = Parametro overload. I valori possibili sono overload1, overload2 e così via.
Vedere anche
Messaggi e schemi di messaggio per l'adapter BizTalk per Oracle E-Business Suite