Schémas de message pour les procédures stockées, les fonctions et les API PL/SQL
L’adaptateur Microsoft BizTalk pour Oracle E-Business Suitesurface les procédures stockées de base de données Oracle sous-jacentes, les fonctions et les API PL/SQL (procédures stockées et fonctions dans un package) en tant qu’opérations. Cette section décrit la structure des messages et les actions utilisées pour appeler des procédures stockées, des fonctions et des API PL/SQL.
Structure des messages des procédures stockées, des fonctions et des API PL/SQL
Les opérations exposées pour les fonctions et les procédures stockées suivent un modèle d’échange de messages demande-réponse. Le tableau suivant montre la structure de ces messages de demande et de réponse.
Notes
Consultez les descriptions d’entité après le tableau.
| Opération | Message XML | Description |
|---|---|---|
| Demande de procédure stockée | <[SP_NAME] xmlns="[VERSION]/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]> |
Prend en charge les paramètres Oracle IN et IN OUT dans le corps du message |
| Réponse de procédure stockée | <[SP_NAME]Response xmlns="[VERSION]/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1<[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]Response> |
Prend en charge les paramètres Oracle OUT et IN OUT dans le corps du message |
| Demande de fonction | <[FN_NAME] xmlns="[VERSION]/Functions/[SCHEMA] "> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[FN_NAME]> |
Prend en charge les paramètres Oracle IN et IN OUT dans le corps du message |
| Réponse de fonction | <[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> |
Prend en charge les paramètres Oracle OUT et IN OUT dans le corps du message La valeur de retour de la fonction est retournée dans l’élément <[FN_NAME]Result> . Il s’agit du premier élément du message de réponse. Il précède tous les paramètres. |
| Requête d’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]> |
Identique à la fonction ou à la procédure stockée |
| Procédure empaquetée ou réponse de fonction | <[SP_NAME]Response xmlns="[VERSION]/PackageApis/[SCHEMA]/[PACKAGE_NAME]/[SP_NAME]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]Response> |
Identique à la fonction ou à la procédure stockée |
Descriptions des entités :
[VERSION] = http://schemas.microsoft.com/OracleEBS/2008/05.
[SCHEMA] = Collection d’artefacts Oracle ; par exemple, SCOTT.
[SP_NAME] = Procédure stockée à exécuter ; par exemple, SP_INSERT.
[FN_NAME] = Fonction à exécuter ; par exemple, FN_GETID.
[PRM1_NAME] = Nom du paramètre Oracle. Consultez la colonne Description pour connaître les instructions de paramètre prises en charge pour chaque message.
[PACKAGE_NAME] = Nom du package qui contient la procédure ou la fonction ciblée.
La base de données Oracle prend en charge la surcharge des procédures stockées et des fonctions. L’adaptateur Oracle E-Business prend en charge cette fonctionnalité en ajoutant une chaîne de surcharge à l’espace de noms cible pour chaque artefact surchargé. La valeur de cette chaîne est « overload1 » pour la première surcharge, « overload2 » pour la deuxième surcharge, et ainsi de suite. L’exemple suivant montre la structure des messages pour deux procédures stockées surchargées.
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]>
Actions de message des procédures stockées, des fonctions et des API PL/SQL
L’adaptateur Oracle E-Business utilise les actions de message suivantes pour les opérations de procédure stockée, de fonction et d’API PL/SQL.
Notes
Consultez les descriptions d’entité après le tableau.
| Message | Action | Exemple |
|---|---|---|
| Demande de procédure stockée | Procédures/[SCHEMA]/[SP_NAME] | Procédures/SCOTT/SP_INSERT |
| Réponse de procédure stockée | Procédures/[SCHEMA]/[SP_NAME]/response | Procédures/SCOTT/SP_INSERT/réponse |
| Demande de fonction | Functions/[SCHEMA]/[FN_NAME] | Functions/SCOTT/FN_GETID |
| Réponse de fonction | Functions/[SCHEMA]/[FN_NAME]/response | Fonctions/SCOTT/FN_GETID/réponse |
| Requête d’API PL/SQL | [SCHEMA]/Package/[PACKAGE_NAME]/[SP_NAME] | SCOTT/Package/CUSTOMER/SP_INSERT |
| Réponse de procédure stockée empaquetée | [SCHEMA]/Package/[PACKAGE_NAME]/[SP_NAME]/response | SCOTT/Package/CUSTOMER/SP_INSERT/response |
| Demande de fonction empaquetée | [SCHEMA]/Package/[PACKAGE_NAME]/[FN_NAME] | SCOTT/Package/CUSTOMER/FN_GETID |
| Réponse de fonction empaquetée | [SCHEMA]/Package/[PACKAGE_NAME]/[FN_NAME]/response | SCOTT/Package/CUSTOMER/FN_GETID/response |
| Demande de procédure stockée surchargée | [SCHEMA]/Procedure/[SP_NAME]/[OVERLOAD] | SCOTT/Procedure/SP_INSERT/overload1 |
| Réponse de procédure stockée surchargée | [SCHEMA]/Procedure/[SP_NAME]/[OVERLOAD]/response | SCOTT/Procedure/SP_INSERT/overload1/response |
Descriptions des entités :
[SCHEMA] = Collection d’artefacts Oracle ; par exemple, SCOTT.
[SP_NAME] = Procédure stockée à exécuter ; par exemple, SP_INSERT.
[FN_NAME] = Fonction à exécuter ; par exemple, FN_GETID.
[PACKAGE_NAME] = Nom du package qui contient la procédure ou la fonction ciblée.
[OVERLOAD] = Paramètre Overload. Les valeurs possibles sont overload1, overload2, etc.
Voir aussi
Messages et schémas de message pour l’adaptateur BizTalk pour Oracle E-Business Suite