om_SearchOrderNo_Ad [dstore]

Inhaltsverzeichnis

om_SearchOrderNo_Ad

om_SearchOrderNo_Ad

Wenn ein Auftrag im „dStore“ angelegt wird, bleibt die „OrderNo“ zunächst „NULL“. Bei einer Anbindung an eine Warenwirtschaft wird dann aber im Regelfall über om_AcknowledgeOrders_Ad eine Nummer zurückgemeldet.

Demzufolge ist eine Suche nach einer bestimmten „OrderNo“ - mit Hilfe dieser Prozedur - sinnvoll; allerdings gibt es zwei Dinge zu berücksichtigen :

1. Die „OrderNo“ ist nur als Zusatz-Information gedacht und es gibt daher keinen Index auf der Tabelle „Orders“, der eine Suche beschleunigen könnte. Meistens ist jedoch ungefähr bekannt, wann dieser Auftrag platziert wurde (→ „FromDate“), so daß in diesem Fall der Index auf „OrderDateAndTime“ genutzt werden kann.
2. Es ist im „dStore“ nicht gewährleistet, daß die „OrderNo“ EINDEUTIG ist (so wie die „OrderID“ etwa). Darum KANN es theoretisch vorkommen, daß es MEHRERE Aufträge mit gleicher „OrderNo“ gibt. Die Suche läßt sich aber erheblich beschleunigen, wenn vorausgesetzt werden darf, daß es nur „MaxPossibleOrdersPerOrderNo“ Aufräge mit der gleichen „OrderNo“ geben kann. Dieser Parameter muß mit einem Wert >= 1 angegeben sein !

Anmerkung zum Parameter „DateAndTimeFormat“ :
Die Möglichkeiten für diesen Parameter sind exakt die, die der ASE in der Funktion „convert“ für Datums-Formatierungen bietet (in Klammern ist das Format angegeben, um in der Jahreszahl das Jahrhundert angezeigt zu bekommen) :

(0 or 100) : mon dd yyyy hh:mm AM (or PM)

1 (101) : mm/dd/yy
2 : yy.mm.dd
3 (103) : dd/mm/yy
4 (104) : dd.mm.yy
5 (105) : dd-mm-yy
6 (106) : dd mon yy
7 (107) : mon dd, yy
8 (108) : hh:mm:ss

(9 or 109) : mon dd yyyy hh:mm:sss AM (or PM)

10 (110) : mm-dd-yy
11 (111) : yy/mm/dd
12 (112) : yymmdd

Wird ein Wert aus der Menge {0,8,9,100,108,109} angegeben, bedeutet dies, das bereits eine Uhrzeit enthalten ist (bei „8“ oder „108“ ist es sogar NUR die Uhrzeit), daher wird in diesem Fall „IncludeTime“ ignoriert bzw. quasi immer mit „0“ angenommen !

HTTP-Method	GET
HTTP-Auth	Optional
Tags	[om, Search, Order, No, Ad]
Engine-Kategorie	order management
Engine-Typ	Daten-Ermittlung
Letzte Aktualisierung	7.0.7 (2015-01-29)

Parameter

Name ¹⁾	Standard-Wert	Beschreibung ²⁾	SQL-Datentyp³⁾	ab Version
OrderNo		Auftragsnummer (des Fremdsystems), nach der gesucht werden soll. ACHTUNG : Gibt es KEINEN Datensatz in „Orders“ mit der angegebenen „OrderNo“, liefert die Prozedur nicht etwa eine leere Ergebnismenge, sondern den Fehler-Code „-374“ !	varchar(100)	3.5.14
MaxPossibleOrdersPerOrderNo	1	Wieviele Aufträge kann es maximal mit ein und derselben „OrderNo“ geben ? Hintergrund : siehe Beschreibung	integer	3.5.14
FromDate	NULL	(Optional) Zeitpunkt, ab dem gesucht werden soll (d.h. die „OrderNo“ wird nur in Aufträgen gesucht, die zu diesem oder einem späteren Zeitpunkt angelegt wurden)	datetime	3.5.14
ShowPersonCharacteristics	0	Falls „1“ angegeben ist, wird zu den ersten beiden Merkmalen, die im „PersonTypeSettings“-Eintrag zu „PersonOutputCharacteristicIDsForOrderLists“ zur <„PersonTypeID“ d. Auftraggebers> angegeben sind, die jeweilige Eigenschaft d. Auftraggebers ermittelt	bit	3.5.14
DateAndTimeFormat	104	Gibt an, wie „OrderDateAndTime“ und „DeliveryDateAndTime“ in der Rückgabemenge formatiert sein sollen. Der Parameter wird für die „style“-Option der ASE-Funktion „convert“ verwendet (siehe Beschreibung).	tinyint	3.5.14
IncludeTime	1	Gibt an, ob „OrderDateAndTime“ und „DeliveryDateAndTime“ in der Rückgabemenge zusätzlich eine Uhrzeit (Format „17:42:59“) enthalten sollen („0“ : Nein, „1“ : Ja). Wird ignoriert, wenn „DateAndTimeFormat“ bereits die Uhrzeit liefert !	bit	3.5.14
IncludeItemNo	0	Wird nur beachtet, falls „MaxPossibleOrdersPerOrderNo = 1“ ! Entscheidet, ob eine Artikelnummer (Eigenschaft zum Merkmal mit der ID „6“) zur jeweiligen Auftragsposition ermittelt werden soll (→ Rückgabespalte „ItemNo“) oder nicht („0“ : Nein, „1“ : Ja).	bit	3.5.14
NodeCharacteristicID	NULL	ID eines Merkmals. Wird nur beachtet, falls „MaxPossibleOrdersPerOrderNo = 1“ ! Wenn hier eine ID übergeben wird, ermittelt die Prozedur zur jeweiligen Auftragsposition die Eigenschaft zu diesem Merkmal (→ Rückgabespalte „ItemProperty“).	smallint	3.5.14
PurchaseOrder	0	Gibt an, ob grundsätzlich entweder nur Kunden-Aufträge („0“) oder nur Einkaufs-Aufträge („1“) beachtet werden sollen. (Bei letzteren haben die „OrderID“s und „OrderContentID“s negative Vorzeichen.)	bit	5.1.7

Rückgabe

wenn MaxPossibleOrdersPerOrderNo > 1

Spaltenname	Beschreibung	SQL-Datentyp⁴⁾	ab Version
OrderDateAndTime_datetime⁵⁾	Wird nicht ausgegeben, sondern nur zur Sortierung verwendet - da „OrderDateAndTime“ als „String“ ausgegeben wird und ein alphanumerische Sortierung nach einem Datums-String nicht sinnvoll ist	datetime	3.5.14
LastEditedFromUserID⁶⁾	Ist in Version 4.0.13 durch „LastEditedByUserID“ ersetzt worden !	smallint	3.5.14
OrderID	ID eines Auftrags mit „OrderNo = OrderNo“	integer	3.5.14
OrderNo	Hier steht natürlich immer „OrderNo“. Hintergrund für diese Rückgabespalte ist, daß intern die gleiche Prozedur wie z.B. für om_GetOrders_Ad verwendet wird.	varchar(50)	3.5.14
OrderDateAndTime	Eingangsdatum der Bestellung als String im Format „DateAndTimeFormat“ (siehe Beschreibung). Falls „IncludeTime = 1“, dann ist zusätzlich die Uhrzeit (Format '17:42:22') angegeben.	varchar(30)	3.5.14
PersonID	ID der Person, die den Auftrag „OrderID“ aufgegeben hat	integer	3.5.14
CustomerCharacteristicValue1	Eigensch. von „PersonID“ zum Merkmal mit der 1. ID, die in „PersonTypSettings“ zu „PersonOutputCharacteristicIDsForOrderLists“ (zum entspr. Typ) konf. ist und nicht für den Aufrufer kompl. lesend gesperrt ist. „NULL“ wenn „ShowPersonCharacteristics = 0“.	varchar(100)	3.5.14
CharacVal1RestrByPattern	Was enthält „CustomerCharacteristicValue1“ (womögl. wg. Zugriffsbeschr. nur einen Teil) ? - NULL : den vollst. Wert - „#left(<n>)#“ : die ERSTEN n Zeichen - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ ⇒ „CustomerCharacteristicValue1“ dann „NULL“)	varchar(100)	6.5.4
CustomerCharacteristicValue2	Eigensch. von „PersonID“ zum Merkmal mit der 2. ID, die in „PersonTypSettings“ zu „PersonOutputCharacteristicIDsForOrderLists“ (zum entspr. Typ) konf. ist und nicht für den Aufrufer kompl. lesend gesperrt ist. „NULL“ wenn „ShowPersonCharacteristics = 0“.	varchar(100)	3.5.14
CharacVal2RestrByPattern	Wie „CharacVal1RestrByPattern“ - nur eben auf „CustomerCharacteristicValue2“ bezogen	varchar(100)	6.5.4
DeliveryPersonID	ID der Person, an die die Ware geliefert werden soll	integer	3.5.14
ShippingTypeID	ID einer Versandart für den Auftrag	tinyint	3.5.14
ShippingTypeDescription	Bezeichnung der Versandart „ShippingTypeID“	varchar(100)	5.1.6
ShippingCost	Evtl. anfallende Kosten (immer netto !) in der durch „CurrencyID“ angegebenen Währung für die Versandart „ShippingTypeID“. NICHT VERWENDEN, wird zukünftig durch „NetShippingCost“ ersetzt !	money	3.5.14
NetShippingCost	Netto-Versandkosten (entspricht „ShippingCost“)	money	5.0.1
PreciseNetShippingCost	Exakter (intern gespeicherter) Netto-Betrag für die Versandkosten „NetShippingCost“	decimal(16,4)	5.0.1
PaymentTypeID	ID einer Zahlungsart für den Auftrag	smallint	3.5.14
PaymentTypeDescription	Bezeichnung der Abrechnungsart „PaymentTypeID“	varchar(100)	5.1.6
PaymentCost	Evtl. anfallende Kosten (immer netto !) in der durch „CurrencyID“ angegebenen Währung für die Zahlungsart „PaymentTypeID“. NICHT VERWENDEN, wird zukünftig durch „NetPaymentCost“ ersetzt !	money	3.5.14
NetPaymentCost	Evtl. anfallende (Netto-)Kosten (in der durch „CurrencyID“ angegebenen Währung) für die Zahlungsart „PaymentTypeID“	money	5.0.1
PreciseNetPaymentCost	Exakter (intern gespeicherter) Netto-Betrag für die Abrechnungsart-Kosten „NetPaymentCost“	decimal(16,4)	5.0.1
NettoSum	Netto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für den Auftrag „OrderID“ (Englischer Spaltenname ist NICHT korrekt, NICHT verwenden !)	money	3.5.14
NetSum	Netto-Betrag der Bestellung „OrderID“	money	5.0.1
PreciseNetSum	Exakter (intern gespeicherter) Wert für „NetSum“	decimal(16,4)	5.0.1
BruttoSum	Brutto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für den Auftrag „OrderID“ (Englischer Spaltenname ist NICHT korrekt, NICHT verwenden !)	money	3.5.14
GrossSum	Brutto-Betrag der Bestellung „OrderID“	money	5.0.1
PreciseGrossSum	Exakter (intern gespeicherter) Wert für „GrossSum“	decimal(16,4)	5.0.1
CurrencyID	ID einer Währung, in der die Kosten „ShippingCost“, „PaymentCost“, „NettoSum“ und „BruttoSum“ angegeben sind	tinyint	3.5.14
UnitSymbol	Symbol (im Regelfall der ISO-Code) der Einheit „CurrencyID“	varchar(10)	3.5.14
LastEditedByUserID	ID des „dStore“-Benutzers (der in „UserInfo“ registriert ist) der den Auftrag zuletzt bearbeitet hat. Wird z.Zt. nur gepflegt beim Anlegen eines Auftrags und beim Ändern d. Auftraggebers durch om_AcknowledgeOrders_Ad.	smallint	4.0.13
PersonTypeID	ID des Personen-Typs von „PersonID“	tinyint	3.5.14
PositionCount	Wieviele Positionen enthält der Auftrag „OrderID“	smallint	3.5.14
OrderStateID	ID des Status, den alle Auftragsspositionen aktuell haben, oder „NULL“, falls die Positionen unterschiedliche Status besitzen	tinyint	3.5.14
DeliveryDateAndTime	Vom Auftraggeber gewünschter Liefertermin als String im Format „DateAndTimeFormat“ (siehe Beschreibung). Falls „IncludeTime = 1“, dann ist zusätzlich die Uhrzeit (Format '17:42:22') angegeben.	varchar(30)	3.5.14
OrderState	Bezeichnung des Status „OrderStateID“	varchar(50)	3.5.14
PublicDescription	Beschreibung des Status „OrderStateID“ für den Kunden	varchar(255)	3.5.14

Sortierung der Rückgabe

(parameterunabängige Sortierung)

OrderDateAndTime_datetime (aufsteigend)

wenn MaxPossibleOrdersPerOrderNo = 1

Spaltenname	Beschreibung	SQL-Datentyp⁷⁾	ab Version
OrderID	ID eines Auftrags mit „OrderNo = OrderNo“	integer	3.5.14
OrderNo	Hier steht natürlich immer „OrderNo“. Hintergrund für diese Rückgabespalte ist, daß intern die gleiche Prozedur wie z.B. für om_GetOrders_Ad verwendet wird.	varchar(50)	3.5.14
PersonID	ID der Person, die den Auftrag „OrderID“ aufgegeben hat	integer	3.5.14
CustomerCharacteristicValue1	Eigensch. von „PersonID“ zum Merkmal mit der 1. ID, die in „PersonTypSettings“ zu „PersonOutputCharacteristicIDsForOrderLists“ (zum entspr. Typ) konf. ist und nicht für den Aufrufer kompl. lesend gesperrt ist. „NULL“ wenn „ShowPersonCharacteristics = 0“.	varchar(100)	3.5.14
CharacVal1RestrByPattern	Was enthält „CustomerCharacteristicValue1“ (womögl. wg. Zugriffsbeschr. nur einen Teil) ? - NULL : den vollst. Wert - „#left(<n>)#“ : die ERSTEN n Zeichen - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ ⇒ „CustomerCharacteristicValue1“ dann „NULL“)	varchar(100)	6.5.4
CustomerCharacteristicValue2	Eigensch. von „PersonID“ zum Merkmal mit der 2. ID, die in „PersonTypSettings“ zu „PersonOutputCharacteristicIDsForOrderLists“ (zum entspr. Typ) konf. ist und nicht für den Aufrufer kompl. lesend gesperrt ist. „NULL“ wenn „ShowPersonCharacteristics = 0“.	varchar(100)	3.5.14
CharacVal2RestrByPattern	Wie „CharacVal1RestrByPattern“ - nur eben auf „CustomerCharacteristicValue2“ bezogen	varchar(100)	6.5.4
DeliveryPersonID	ID der Person, an die die Ware geliefert werden soll	integer	3.5.14
OrderDateAndTime	Eingangsdatum der Bestellung als String im Format „DateAndTimeFormat“ (siehe Beschreibung). Falls „IncludeTime = 1“, dann ist zusätzlich die Uhrzeit (Format '17:42:22') angegeben.	varchar(30)	3.5.14
OrderContentPosition	Nummer der Auftragsposition	smallint	3.5.14
NodeID	ID des Artikel-Elementes der Auftragsposition, das der Auftraggeber „PersonID“ bestellt hat	integer	3.5.14
Description	Bezeichnung der „NodeID“. Falls vorhanden, wird an dieser Stelle die Eigenschaft (des Elementes „NodeID“) zum Merkmal „Produktbezeichnung“ (in der Sprache „LanguageID“) ausgegeben.	varchar(1000)	3.5.14
Quantity	Wieviel wurde vom Artikel „NodeID“ bestellt	integer	3.5.14
NettoContentSum	Netto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für die Auftragsposition (also nicht der Stückpreis des Artikels „NodeID“, sondern „Stückpreis * Quantity“ !) - Englischer Spaltenname ist NICHT korrekt, NICHT mehr verwenden !	money	3.5.14
NetContentSum	Netto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für die Auftragsposition (also nicht der Stückpreis des Artikels „NodeID“, sondern „Stückpreis * Quantity“ !)	money	5.0.1
PreciseNetContentSum	Exakter (intern gespeicherter) Wert für „NetContentSum“	decimal(16,4)	5.0.1
BruttoContentSum	Brutto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für die Auftragsposition (also nicht der Stückpreis des Artikels „NodeID“, sondern „Stückpreis * Quantity“ !) - Englischer Spaltenname ist NICHT korrekt, NICHT mehr verwenden !	money	3.5.14
GrossContentSum	Brutto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für die Auftragsposition (also nicht der Stückpreis des Artikels „NodeID“, sondern „Stückpreis * Quantity“ !)	money	5.0.1
PreciseGrossContentSum	Exakter (intern gespeicherter) Wert für „GrossContentSum“	decimal(16,4)	5.0.1
NettoOrderSum	Netto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für den Auftrag - Englischer Spaltenname ist NICHT korrekt, NICHT mehr verwenden !	money	3.5.14
NetOrderSum	Netto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für den Auftrag	money	5.0.1
PreciseNetOrderSum	Exakter (intern gespeicherter) Wert für „NetOrderSum“	decimal(16,4)	5.0.1
BruttoOrderSum	Brutto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für den Auftrag - Englischer Spaltenname ist NICHT korrekt, NICHT mehr verwenden !	money	3.5.14
GrossOrderSum	Brutto-Betrag (in der durch „CurrencyID“ angegebenen Währung) für den Auftrag	money	5.0.1
PreciseGrossOrderSum	Exakter (intern gespeicherter) Wert für „GrossOrderSum“	decimal(16,4)	5.0.1
OrderStateID	ID des Status, den alle Auftragsspositionen aktuell haben, oder „NULL“, falls die Positionen unterschiedliche Status besitzen	tinyint	3.5.14
ShippingTypeID	ID einer Versandart für den Auftrag	tinyint	3.5.14
ShippingTypeDescription	Bezeichnung der Versandart „ShippingTypeID“	varchar(100)	5.0.2
ShippingCost	Evtl. anfallende Kosten (immer netto !) in der durch „CurrencyID“ angegebenen Währung für die Versandart „ShippingTypeID“. NICHT MEHR VERWENDEN, wird zukünftig durch „NetShippingCost“ ersetzt !	money	3.5.14
NetShippingCost	Netto-Versandkosten (entspricht „ShippingCost“)	money	5.0.1
PreciseNetShippingCost	Exakter (intern gespeicherter) Netto-Betrag für die Versandkosten „NetShippingCost“	decimal(16,4)	5.0.1
PaymentTypeID	ID einer Zahlungsart für den Auftrag	smallint	3.5.14
PaymentTypeDescription	Bezeichnung der Abrechnungsart „PaymentTypeID“	varchar(100)	5.0.2
PaymentCost	Evtl. anfallende Kosten (immer netto !) in der durch „CurrencyID“ angegebenen Währung für die Zahlungsart „PaymentTypeID“. NICHT VERWENDEN, wird zukünftig durch „NetPaymentCost“ ersetzt !	money	3.5.14
NetPaymentCost	Evtl. anfallende (Netto-)Kosten (in der durch „CurrencyID“ angegebenen Währung) für die Zahlungsart „PaymentTypeID“	money	5.0.1
PreciseNetPaymentCost	Exakter (intern gespeicherter) Netto-Betrag für die Abrechnungsart-Kosten „NetPaymentCost“	decimal(16,4)	5.0.1
CurrencyID	ID einer Währung, in der die Kosten „ShippingCost“, „PaymentCost“, „NettoSum“ und „BruttoSum“ angegeben sind	tinyint	3.5.14
CurrencySymbol	Symbol (im Regelfall der ISO-Code) der Einheit „CurrencyID“	varchar(10)	3.5.14
DeliveryDateAndTime	Vom Auftraggeber gewünschter Liefertermin als String im Format „DateAndTimeFormat“ (siehe Beschreibung). Falls „IncludeTime = 1“, dann ist zusätzlich die Uhrzeit (Format '17:42:22') angegeben.	varchar(30)	3.5.14
OrderContentID	ID der Auftragsposition	integer	3.5.14
OrderContentNo	Nummer der Bestellung eines Fremdsystems, in das die Position exportiert wurde. Immer „NULL“ falls „OrderNo“ NICHT „NULL“ ist !	varchar(50)	5.0.2
OrderContentWasModified	Wurde die Position „OrderContentID“ nachträglich geändert ? („0“ : Nein, „1“ : Ja) Anmerkung : Eine Änderung der „OrderNo“ wird übrigens NICHT berücksichtigt !	bit	5.0.2
ItemNo	Eigenschaft des Artikel-Elementes „NodeID“ zum Merkmal mit der ID „6“ (also die Artikelnummer). Immer „NULL“, wenn „IncludeItemNo = 0“ ist !	varchar(1000)	3.5.14
OrderState	Bezeichnung des Status „OrderStateID“	varchar(50)	3.5.14
PublicDescription	Beschreibung des Status „OrderStateID“ für den Kunden	varchar(255)	3.5.14
ItemProperty	Eigenschaft des Artikel-Elementes „NodeID“ zum Merkmal „NodeCharacteristicID“ (wenn „NULL“ für „NodeCharacteristicID“ angegeben wurde, steht hier auch „NULL“)	varchar(1000)	3.5.14

Sortierung der Rückgabe

(parameterunabängige Sortierung)

OrderContentPosition (aufsteigend)

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code	Beschreibung	Quelle ⁸⁾
-621	Fehlender oder falscher Eintrag in PersonTypeSettings	nur indirekt
-569	Der Benutzer hat kein Ausführungsrecht für die Prozedur	nur indirekt
-567	Die Prozedur darf z. Zt. nicht ausgeführt werden	nur indirekt
-566	Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werden	nur indirekt
-550	Fehlender oder falscher Eintrag in Settings	nur indirekt
-535	Das Datum liegt nicht in der Vergangenheit	nur indirekt
-530	Der Wert ist nicht konvertierbar	nur indirekt
-510	Der Benutzer ist nicht registriert	nur indirekt
-504	Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochen	nur indirekt
-503	Fehlerhafte Daten in einer Tabelle - genauere Fehlermeldung auf der Standardausgabe	nur indirekt
-502	Die Parameter-Werte der Prozedur können nicht verarbeitet werden (kein passendes Trennzeichen)	nur indirekt
-500	Falsche Parameter	direkt und indirekt
-374	Aufgrund der angegebenen Information konnte kein Auftrag gefunden werden	nur direkt
-286	Der Benutzer hat nicht die Berechtigung(en), Eigenschaften zu diesem(n) Merkmal(en) zu lesen/ändern	nur indirekt
-284	Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu modifizieren	nur indirekt
-283	Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu ermitteln	nur indirekt
-220	Es konnte keine Merkmal-ID für die Produktbezeichnung ermittelt werden	nur indirekt

XML-Schema

Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.

Historie

7.0.7	2015-01-29	Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf]
7.0.1	2013-08-07	Datentyp der Rückgabespalten „Description“, „ItemNo“ und „ItemProperty“ hat sich erweitert ⇒ Anpassung der Doku
6.5.4	2013-04-29	1. Anpassungen an aktuellen Code-Standard 2. Doku-Hinweis („CustomerCharacteristicValue…“-Rückgabespalten) auf Zugriffsbeschränkungen 3. Neue Rückgabespalten „CharacVal…RestrByPattern“
5.1.7	2006-10-31	1. Neuer Parameter „PurchaseOrder“ 2. Ausgabe an die Standard-Ausgabe [via „print“] im Fehler-Fall „-500“, die nähere Informationen über die Ursache enthält
5.1.6	2006-09-14	Neue Rückgabespalten „ShippingTypeDescription“ und „PaymentTypeDescription“, falls für „MaxPossibleOrdersPerOrderNo“ ein größerer Wert als „1“ übergeben wurde
5.0.2	2005-04-29	1. Neue Rückgabespalten „ShippingTypeDescription“, „PaymentTypeDescription“, „OrderContentNo“ und „OrderContentWasModified“ im Fall „MaxPossibleOrdersPerOrderNo = 1“ 2. Präzisierung der Doku für die Rückgabespalte „OrderNo“ [in beiden Ergebnismengen]
5.0.1	2005-03-29	1. Neue Rückgabespalten 2. Änderung : Falls es KEINEN Auftrag mit der angegebenen „OrderNo“ gibt, erhält man nun den Fehler „-374“ 3. Kleine Performanceverbesserung und interne Ablauf-Änderung
4.0.13	2004-05-18	1. Aufruf von „_mi_StartProcedure“, „_mi_FinishProcedure“ und „_mi_ChooseParamValueSeperator“ 2. „set transaction isolation level 1“, „set rowcount 0“ zu Beginn 3. Div. interne Änderungen 4. Änderungen bzgl. „IncludeTime“ u. „LastEditedFromUserID“
4.0.5	2003-10-04	Verlagerung diverser „Settings“-Einträge auf entsprechende „PersonTypeSettings“-Einträge
3.5.19	2002-06-17
3.5.14	2002-01-23	Erstmalig in dieser Version erstellt

Code-Snippets

Engine Playground

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

om_SearchOrderNo_Ad im Engine Playground öffnen

cURL

Unformatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/om_SearchOrderNo_Ad?OrderNo=<value>'

Mit xmllint ⁹⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/om_SearchOrderNo_Ad?OrderNo=<value>' | xmllint --format -

dStore_php

use dStore_php\WebService;
 
$service = new WebService\Service( WebService\Scheme::HTTP,'<partner>-<project>.dstore.de', 80);
 
$request = new WebService\Requests\Engine\Procedure\Request(
			new WebService\Requests\AccessData('default'),
	'om_SearchOrderNo_Ad',
		array(
			'OrderNo' => '<value>',
			// 'MaxPossibleOrdersPerOrderNo' => 1,
			// 'FromDate' => NULL,
			// 'ShowPersonCharacteristics' => 0,
			// 'DateAndTimeFormat' => 104,
			// 'IncludeTime' => 1,
			// 'IncludeItemNo' => 0,
			// 'NodeCharacteristicID' => NULL,
			// 'PurchaseOrder' => 0
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();

engine/execute

XML zur Ausführung mit der Methode engine/execute, z.B. per

curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'

<?xml version="1.0" encoding="UTF-8"?>
<ListOfBatches>
	<Batch No="0">
		<Procedure Name="om_SearchOrderNo_Ad">
			<Parameters>
				<Parameter Name="OrderNo"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="MaxPossibleOrdersPerOrderNo">1</Parameter> -->
				<!-- <Parameter Name="FromDate">NULL</Parameter> -->
				<!-- <Parameter Name="ShowPersonCharacteristics">0</Parameter> -->
				<!-- <Parameter Name="DateAndTimeFormat">104</Parameter> -->
				<!-- <Parameter Name="IncludeTime">1</Parameter> -->
				<!-- <Parameter Name="IncludeItemNo">0</Parameter> -->
				<!-- <Parameter Name="NodeCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="PurchaseOrder">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>

¹⁾

Pflichtparameter sind unterstrichen

²⁾

siehe Parameter-Konventionen engine/<Prozedur-Name>

³⁾ , ⁴⁾ , ⁷⁾

siehe Datentypen im Bereich "engine"

⁵⁾ , ⁶⁾

Spalte wird nicht zurückgegeben und ist hier nur aus Dokumentationsgründen aufgeführt.

⁸⁾

direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“

⁹⁾

I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Inhaltsverzeichnis