Esquemas de mensaje para procedimientos almacenados, funciones y las API de PL/SQL
El adaptador de Microsoft BizTalk para Oracle E-Business Suitesurface los procedimientos almacenados, las funciones y las API de PL/SQL subyacentes de la base de datos de Oracle (procedimientos almacenados y funciones dentro de un paquete) como operaciones. En esta sección se describe la estructura de mensajes y las acciones que se usan para invocar procedimientos almacenados, funciones y API de PL/SQL.
Estructura de mensajes de procedimientos almacenados, funciones y API de PL/SQL
Las operaciones expuestas para funciones y procedimientos almacenados siguen un patrón de intercambio de mensajes de solicitud-respuesta. En la tabla siguiente se muestra la estructura de estos mensajes de solicitud y respuesta.
Nota
Consulte las descripciones de entidad después de la tabla.
| Operación | Mensaje XML | Descripción |
|---|---|---|
| Solicitud de procedimiento almacenado | <[SP_NAME] xmlns="[VERSION]/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]> |
Admite parámetros IN e IN OUT de Oracle en el cuerpo del mensaje |
| Respuesta de procedimiento almacenado | <[SP_NAME]Response xmlns="[VERSION]/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1<[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]Response> |
Admite parámetros OUT e IN OUT de Oracle en el cuerpo del mensaje. |
| Solicitud de función | <[FN_NAME] xmlns="[VERSION]/Functions/[SCHEMA] "> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[FN_NAME]> |
Admite parámetros IN e IN OUT de Oracle en el cuerpo del mensaje |
| Respuesta de función | <[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> |
Admite parámetros OUT e IN OUT de Oracle en el cuerpo del mensaje. El valor devuelto de la función se devuelve en el <elemento [FN_NAME]Result> . Este es el primer elemento del mensaje de respuesta. Viene antes de cualquier parámetro. |
| Solicitud de API de PL/SQL | <[SP_NAME] xmlns="[VERSION]/PackageApis/[SCHEMA]/[PACKAGE_NAME/[SP_NAME]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]> |
Igual que la función o el procedimiento almacenado |
| Procedimiento empaquetado o respuesta de función | <[SP_NAME]Response xmlns="[VERSION]/PackageApis/[SCHEMA]/[PACKAGE_NAME]/[SP_NAME]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]Response> |
Igual que la función o el procedimiento almacenado |
Descripciones de entidad:
[VERSION] = http://schemas.microsoft.com/OracleEBS/2008/05.
[SCHEMA] = Colección de artefactos de Oracle; por ejemplo, SCOTT.
[SP_NAME] = Procedimiento almacenado que se va a ejecutar; por ejemplo, SP_INSERT.
[FN_NAME] = La función que se va a ejecutar; por ejemplo, FN_GETID.
[PRM1_NAME] = Nombre del parámetro Oracle. Consulte la columna Descripción para obtener instrucciones de parámetro admitidas para cada mensaje.
[PACKAGE_NAME] = El nombre del paquete que contiene el procedimiento o función de destino.
La base de datos de Oracle admite la sobrecarga de procedimientos almacenados y funciones. El adaptador de Oracle E-Business admite esta funcionalidad anexando una cadena de sobrecarga al espacio de nombres de destino para cada artefacto sobrecargado. El valor de esta cadena es "overload1" para la primera sobrecarga, "overload2" para la segunda sobrecarga, etc. En el ejemplo siguiente se muestra la estructura de mensajes para dos procedimientos almacenados sobrecargados.
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]>
Acciones de mensaje de procedimientos almacenados, funciones y API de PL/SQL
El adaptador de Oracle E-Business usa las siguientes acciones de mensaje para las operaciones de procedimiento almacenado, función y API de PL/SQL.
Nota
Consulte las descripciones de entidad después de la tabla.
| Message | Acción | Ejemplo |
|---|---|---|
| Solicitud de procedimiento almacenado | Procedures/[SCHEMA]/[SP_NAME] | Procedimientos/SCOTT/SP_INSERT |
| Respuesta de procedimiento almacenado | Procedures/[SCHEMA]/[SP_NAME]/response | Procedimientos/SCOTT/SP_INSERT/respuesta |
| Solicitud de función | Funciones/[SCHEMA]/[FN_NAME] | Functions/SCOTT/FN_GETID |
| Respuesta de función | Functions/[SCHEMA]/[FN_NAME]/response | Functions/SCOTT/FN_GETID/response |
| Solicitud de API de PL/SQL | [SCHEMA]/Package/[PACKAGE_NAME]/[SP_NAME] | SCOTT/Package/CUSTOMER/SP_INSERT |
| Respuesta de procedimiento almacenado empaquetado | [SCHEMA]/Package/[PACKAGE_NAME]/[SP_NAME]/response | SCOTT/Package/CUSTOMER/SP_INSERT/response |
| Solicitud de función empaquetada | [SCHEMA]/Package/[PACKAGE_NAME]/[FN_NAME] | SCOTT/Package/CUSTOMER/FN_GETID |
| Respuesta de función empaquetada | [SCHEMA]/Package/[PACKAGE_NAME]/[FN_NAME]/response | SCOTT/Package/CUSTOMER/FN_GETID/response |
| Solicitud de procedimiento almacenado sobrecargado | [SCHEMA]/Procedure/[SP_NAME]/[OVERLOAD] | SCOTT/Procedure/SP_INSERT/overload1 |
| Respuesta de procedimiento almacenado sobrecargado | [SCHEMA]/Procedure/[SP_NAME]/[OVERLOAD]/response | SCOTT/Procedure/SP_INSERT/overload1/response |
Descripciones de entidad:
[SCHEMA] = Colección de artefactos de Oracle; por ejemplo, SCOTT.
[SP_NAME] = Procedimiento almacenado que se va a ejecutar; por ejemplo, SP_INSERT.
[FN_NAME] = La función que se va a ejecutar; por ejemplo, FN_GETID.
[PACKAGE_NAME] = El nombre del paquete que contiene el procedimiento o función de destino.
[OVERLOAD] = El parámetro Overload. Los valores posibles son overload1, overload2, etc.
Consulte también
Mensajes y esquemas de mensaje para el adaptador de BizTalk para Oracle E-Business Suite