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