Nachrichtenschemas für gespeicherte Prozeduren, Funktionen und PL/SQL-APIs
Der Microsoft BizTalk-Adapter für Oracle E-Business-Suites stellt die zugrunde liegenden gespeicherten Prozeduren, Funktionen und PL/SQL-APIs (gespeicherte Prozeduren und Funktionen innerhalb eines Pakets) als Vorgänge bereit. In diesem Abschnitt werden die Nachrichtenstruktur und die Aktionen zum Aufrufen gespeicherter Prozeduren, Funktionen und PL/SQL-APIs beschrieben.
Nachrichtenstruktur von gespeicherten Prozeduren, Funktionen und PL/SQL-APIs
Die vorgänge, die für Funktionen und gespeicherte Prozeduren angezeigt werden, folgen einem Anforderungs-Antwort-Nachrichtenaustauschmuster. Die folgende Tabelle zeigt die Struktur dieser Anforderungs- und Antwortnachrichten.
Hinweis
Siehe Entitätsbeschreibungen nach der Tabelle.
| Vorgang | XML-Nachricht | BESCHREIBUNG |
|---|---|---|
| Anforderung für gespeicherte Prozeduren | <[SP_NAME] xmlns="[VERSION]/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]> |
Unterstützt Oracle IN- und IN OUT-Parameter im Nachrichtentext |
| Antwort auf gespeicherte Prozeduren | <[SP_NAME]Response xmlns="[VERSION]/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1<[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]Response> |
Unterstützt Oracle OUT- und IN OUT-Parameter im Nachrichtentext |
| Funktionsanforderung | <[FN_NAME] xmlns="[VERSION]/Functions/[SCHEMA] "> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[FN_NAME]> |
Unterstützt Oracle IN- und IN OUT-Parameter im Nachrichtentext |
| Funktionsantwort | <[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> |
Unterstützt Oracle OUT- und IN OUT-Parameter im Nachrichtentext Der Rückgabewert der Funktion wird im <[FN_NAME]Result-Element> zurückgegeben. Dies ist das erste Element in der Antwortnachricht. Sie kommt vor allen Parametern. |
| PL/SQL-API-Anforderung | <[SP_NAME] xmlns="[VERSION]/PackageApis/[SCHEMA]/[PACKAGE_NAME/[SP_NAME]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]> |
Identisch mit der Funktion oder gespeicherten Prozedur |
| Verpackte Prozedur oder Funktionsantwort | <[SP_NAME]Response xmlns="[VERSION]/PackageApis/[SCHEMA]/[PACKAGE_NAME]/[SP_NAME]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]Response> |
Identisch mit der Funktion oder gespeicherten Prozedur |
Entitätsbeschreibungen:
[VERSION] = http://schemas.microsoft.com/OracleEBS/2008/05.
[SCHEMA] = Sammlung von Oracle-Artefakten; z. B. SCOTT.
[SP_NAME] = Die auszuführende gespeicherte Prozedur; beispielsweise SP_INSERT.
[FN_NAME] = Die auszuführende Funktion; z. B. FN_GETID.
[PRM1_NAME] = Der Name des Oracle-Parameters. In der Spalte Beschreibung finden Sie unterstützte Parameteranweisungen für jede Nachricht.
[PACKAGE_NAME] = Der Name des Pakets, das die zielorientierte Prozedur oder Funktion enthält.
Die Oracle-Datenbank unterstützt das Überladen von gespeicherten Prozeduren und Funktionen. Der Oracle E-Business-Adapter unterstützt diese Funktion, indem für jedes überladene Artefakt eine Überladungszeichenfolge an den Zielnamespace angefügt wird. Der Wert dieser Zeichenfolge ist "overload1" für die erste Überladung, "overload2" für die zweite Überladung usw. Das folgende Beispiel zeigt die Nachrichtenstruktur für zwei überladene gespeicherte Prozeduren.
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]>
Nachrichtenaktionen von gespeicherten Prozeduren, Funktionen und PL/SQL-APIs
Der Oracle E-Business-Adapter verwendet die folgenden Nachrichtenaktionen für gespeicherte Prozeduren, Funktionen und PL/SQL-API-Vorgänge.
Hinweis
Siehe Entitätsbeschreibungen nach der Tabelle.
| `Message` | Aktion | Beispiel |
|---|---|---|
| Anforderung für gespeicherte Prozeduren | Procedures/[SCHEMA]/[SP_NAME] | Verfahren/SCOTT/SP_INSERT |
| Antwort auf gespeicherte Prozeduren | Procedures/[SCHEMA]/[SP_NAME]/response | Procedures/SCOTT/SP_INSERT/response |
| Funktionsanforderung | Functions/[SCHEMA]/[FN_NAME] | Funktionen/SCOTT/FN_GETID |
| Funktionsantwort | Functions/[SCHEMA]/[FN_NAME]/response | Functions/SCOTT/FN_GETID/response |
| PL/SQL-API-Anforderung | [SCHEMA]/Package/[PACKAGE_NAME]/[SP_NAME] | SCOTT/Package/CUSTOMER/SP_INSERT |
| Verpackte Antwort auf gespeicherte Prozeduren | [SCHEMA]/Package/[PACKAGE_NAME]/[SP_NAME]/response | SCOTT/Package/CUSTOMER/SP_INSERT/response |
| Paketfunktionsanforderung | [SCHEMA]/Package/[PACKAGE_NAME]/[FN_NAME] | SCOTT/Package/CUSTOMER/FN_GETID |
| Antwort der verpackten Funktion | [SCHEMA]/Package/[PACKAGE_NAME]/[FN_NAME]/response | SCOTT/Package/CUSTOMER/FN_GETID/response |
| Anforderung für überladene gespeicherte Prozeduren | [SCHEMA]/Procedure/[SP_NAME]/[OVERLOAD] | SCOTT/Procedure/SP_INSERT/overload1 |
| Überladene gespeicherte Prozedurantwort | [SCHEMA]/Procedure/[SP_NAME]/[OVERLOAD]/response | SCOTT/Procedure/SP_INSERT/overload1/response |
Entitätsbeschreibungen:
[SCHEMA] = Sammlung von Oracle-Artefakten; z. B. SCOTT.
[SP_NAME] = Die auszuführende gespeicherte Prozedur; beispielsweise SP_INSERT.
[FN_NAME] = Die auszuführende Funktion; z. B. FN_GETID.
[PACKAGE_NAME] = Der Name des Pakets, das die zielorientierte Prozedur oder Funktion enthält.
[OVERLOAD] = Der Overload-Parameter. Die möglichen Werte sind overload1, overload2 usw.
Weitere Informationen
Nachrichten und Nachrichtenschemas für den BizTalk-Adapter für Oracle E-Business Suite