om_GetPaymentAndShipping_Pu [dstore]

Inhaltsverzeichnis

om_GetPaymentAndShipping_Pu

om_GetPaymentAndShipping_Pu

Ermittelt zum Warenkorb eines Besuchers und des dazugehörigen (möglichen) Auftraggebers sowie der Lieferanschrift anhand des Warenbestellwertes alle möglichen Kombinationen an Versand- und Zahlungsmöglichkeiten.

Hierbei wird berücksichtigt, daß es für verschiedene Personengruppen und Artikelgruppen verschiedene Versandarten und Zahlungsmöglichkeiten gibt, die sich evtl. untereinander ausschließen. Die Prozedur geht bei der Ermittlung wie folgt vor :

1.) Zunächst werden zu jedem Artikel (im Warenkorb des Besuchers) die möglichen „PaymentForShippingID“s (also die Kombinationen aus Zahlungs- und Versandart) anhand der Konfiguration in „NodePaymentForShipping“ ermittelt. Bei dieser Ermittlung wird die Vererbungs-Logik des Artikelbaums verwendet, d.h. falls einem Element des Artikelbaums keine Zahlungs-Versandart-Kombinationen zugewiesen sind, wird geprüft, ob für den „Erblasser“ (Spalte „InheritsFrom“ in „TreeView“) vielleicht Kombinationen definiert sind. Ist dies auch nicht der Fall, geht man zum nächsten „Erblasser“ usw.
ACHTUNG : Entgegen der Vererbungs-Logik bzgl. „Properties“ hören wir jedoch für einen konkreten Artikel IMMER sofort auf, die „Erblasser-Kette nach oben zu klettern“, sobald „PaymentForShipping“s gefunden wurden !

2.) Von den so ermittelten IDs kommen jedoch nur die in Frage, …

die für ALLE (zu bestellenden) Artikel zur Verfügung stehen

ODER

bei denen das „Always-Bit“ auf „1“ gesetzt ist (siehe om_GetNodePaymentForShip_Ad).

3.) Falls es von den verbleibenden Kombinationen „PaymentForShippingID“s gibt, bei denen für ALLE Artikel das „HideWhenOrderedAlone-Bit“ auf „1“ gesetzt ist (siehe om_GetNodePaymentForShip_Ad), werden diese ausgeschlossen.

4.) Außerdem wird überprüft, ob der Warenbestellwert für die Versandarten bzw. Zahlungsarten ausreicht (siehe „GrossSumFrom“ und „GrossSumTo“ in om_GetPaymentTypes_Ad bzw. om_GetShippingTypes_Ad); so fallen evtl. weitere Kombinationen heraus.

5.) Es dürfen nur die „PaymentForShippingID“s berücksichtigt werden, die dem Auftraggeber („PersonID“) über die Gruppen, in denen er sich befindet, zugewiesen sind (siehe om_GetGroupPaymentForShip_Ad). Ist für den „Settings“-Eintrag zum Schlüssel „GroupPayForShipForOrdererOrDelivPers“ der Wert „1“ hinterlegt, werden jene „PaymentForShippingID“s berücksichtigt, die entweder dem Auftraggeber ODER der „DeliveryPersonID“ über die Gruppen zugewiesen sind.

6.) Der Auftraggeber („PersonID“) muß in einer Region wohnen, für die die einzelnen Zahlungsarten („PaymentTypes“) erlaubt sind (siehe „RegionID“ in om_GetPaymentTypes_Ad).

7.) Schließlich muß der Empfänger der Ware („DeliveryPersonID“) in einer Region wohnen, für die die einzelnen Versandarten („ShippingTypes“) erlaubt sind (siehe „RegionID“ in om_GetShippingTypes_Ad).

Anmerkung : Die „Region“ einer Person (s. Punkte 5 und 6) wird durch die „Land“-Eigenschaft der Person bestimmt. Dabei handelt es sich um die Eigenschaft zum in „PersonTypeSettings“ zum Schlüssel „CountryCharacteristicID“ konfigurierten Merkmal (des entsprechenden Personentyps) bzw. (falls nicht konfiguriert) zum vordefinierten Merkmal mit der ID „15“. Zu einer solchen Eigenschaft muß entweder eine Referenz auf ein Land aus der Tabelle „Countries“ existieren (s. Parameter „TableID“ und „TableKeyID“ der Prozedur pm_ModifyPersonPredefVals_Ad) oder sie muß der Bezeichnung („CountryDescription“) eines Landes entsprechen.

Hinweis zum gewählten Steuersatz für die Brutto-Zahlungs- bzw. Brutto-Versand-Kosten :

Sollten die Zahlungs- bzw. Versand-Kosten aufgrund der „Aufschlagsart“ (→ „SurchargeTypeID“ im Ergebnis von om_GetPaymentTypes_Ad bzw. om_GetShippingTypes_Ad zur „PaymentTypeID“ bzw. „ShippingTypeID“) RELATIV konfiguriert worden sein (z.B. Dissagio bei Kreditkarten-Zahlung oder Gewährung von Skonto bei Vorkasse-Zahlung), kann nicht gesagt werden, was „DER“ herangezogene Steuersatz ist, da die Angabe von „BruttoSum“ allein ja keinen Aufschluß über evtl. enthaltene VERSCHIEDENE Steuersätze gibt ! Die Netto-(Zahlungs- oder Versand-)Kosten wurden einfach durch Multiplikation des konfigurierten (prozentualen) Wertes mit „NettoSum“ und die Brutto-Kosten durch entsprechende Multiplikation mit „BruttoSum“ errechnet.

Anmerkung zum Parameter „SelectMissingResultReason“ :

Wenn dieser auf „1“ gesetzt ist und tatsächlich keine gültigen „PaymentForShippingID“s ermittelt werden können, gibt es eine entsprechende Rückgabemenge. Hier die Bedeutung für die „ErrorCode“s :

1 : Es existiert keine „PaymentForShippingID“, die allen Artikeln zugewiesen ist oder bei der für wenigstens einen Artikel das „Always-Bit“ auf „1“ gesetzt ist
2 : Die gewählten Artikel sind nicht alleine, sondern nur in Verbindung mit weiteren Artikeln bestellbar (siehe „HideWhenOrderedAlone“ in om_GetNodePaymentForShip_Ad)
3 : Den Artikeln ist keine Versandart zugewiesen, die mit dem Bestellwert vereinbar ist
4 : Den Artikeln ist keine Zahlungsweise zugewiesen, die mit dem Bestellwert vereinbar ist
5 : Für die Gruppen, in denen der Auftraggeber („PersonID“) ist, sind keine zu dem Auftrag passenden Zahlungs-Versandart-Kombinationen definiert
6 : Der Auftraggeber („PersonID“) kommt aus einer Region, für die keine passende Zahlungsart definiert ist
7 : Der Empfänger der Ware („DeliveryPersonID“) kommt aus einer Region, für die keine passende Versandart definiert ist
8 : Die angegebene „PaymentForShippingID“ ist keine mögliche Zahlungs-/Versandart-Kombination

Hinweis: Wenn eine konkrete „PaymentForShippingID“ angegeben wurde und es zu einem „ErrorCode“ zwischen „3“ und „7“ kommt, mag dies daran liegen, daß NUR die angegebene ID überprüft wurde - d.h. ruft man die Prozedur erneut auf, aber mit „NULL“ für „PaymentForShippingID“, können durchaus Kombinationen aus Zahlungs- und Versandart zurückgegeben werden.

HTTP-Method	GET
HTTP-Auth	Optional
Tags	[om, Get, Payment, And, Shipping, Pu]
Engine-Kategorie	order management
Engine-Typ	Daten-Ermittlung
Letzte Aktualisierung	7.0.7 (2015-01-29)

Parameter

UniqueID		Eindeutige ID eines Besuchers (aus „Visitors“), zu dessen „Warenkorb“ (Tabelle „Trolley“) die möglichen Zahlungsart-Versandart-Kombinationen ermittelt werden sollen	varchar(50)	3.5.0
PersonID		ID des (möglichen) Auftraggebers	integer	3.5.0
DeliveryPersonID	NULL	ID der (möglichen) Lieferanschrift. Wird hier „NULL“ angegeben, wählt die Prozedur den Auftraggeber („PersonID“) als Lieferanschrift	integer	3.5.0
BruttoSum		Versand- und Zahlungsart sind im Regelfall an den Warenwert der Bestellung gekoppelt (Mindestbestellwert etc.). Dieser Wert gibt daher den Brutto-Bestellwert an. Im Regelfall wird hier der Wert „TotalBruttoPrice“ von om_GetTrolley_Pu übergeben.	money	3.5.0
NettoSum		Versand- und Zahlungsart sind im Regelfall an den Warenwert der Bestellung gekoppelt (Mindestbestellwert etc.). Dieser Wert gibt daher den Netto-Bestellwert an. Im Regelfall wird hier der Wert „TotalNettoPrice“ von om_GetTrolley_Pu übergeben.	money	3.5.0
PaymentForShippingID	NULL	Möchte man checken, ob eine bestimmte Kombination aus Zahlungs- und Versandart gültig ist, kann man hier die ID dieser Kombination angeben	smallint	3.5.0
Date	NULL	Steuersätze für Zahlungs- und Versandart-Kosten sowie evtl. benötigte Währungs-Umrechnungs-Kurse sind mit einem Gültigkeitszeitraum hinterlegt. Zu welchem Datum diese Daten ermittelt werden sollen, wird hierdurch („NULL“ : aktueller Zeitpunkt) festgelegt.	datetime	3.5.20
SelectMissingResultReason	0	Falls „1“ angegeben ist und keine Kombination aus Zahlungs- und Versandart gefunden wird, gibt die Prozedur einen Fehler-Return-Code zurück und man erhält eine Rückgabemenge, der man den Grund (warum keine Kombination gefunden wurde) entnehmen kann.	bit	3.5.20
CalculateCosts	1	Ist man nur an den möglichen Kombinationen aus Zahlungs- und Versandart OHNE die enstprechenden Kosten interessiert, gibt man hier „0“ an (und erhält eine andere Ergebnismenge mit weniger Rückgabespalten)	bit	6.0.2

Rückgabe

wenn CalculateCosts = 1 und SelectMissingResultReason = 0

Spaltenname	Beschreibung	SQL-Datentyp¹⁾	ab Version
PaymentForShippingID	ID einer gefundenen Zahlungsart-Versandart-Kombination (die für die übergebenen Parameter gültig ist)	smallint	3.5.0
PaymentForShippingDescription	Bezeichnung der Zahlungsart-Versandart-Kombination „PaymentForShippingID“	varchar(100)	3.5.0
PaymentTypeID	ID der Zahlungsart der Kombination „PaymentForShippingID“	smallint	3.5.0
PaymentCost	(Netto-)Kosten für die Zahlungsart „PaymentTypeID“ - in der zum Besucher hinterlegten Währung	money	3.5.0
PaymentCostBrutto	Brutto-Kosten für die Zahlungsart „PaymentTypeID“ - in der zum Besucher hinterlegten Währung	money	3.5.0
ShippingTypeID	ID der Versandart der Kombination „PaymentForShippingID“	tinyint	3.5.0
ShippingCost	(Netto-)Kosten für die Versandart „ShippingTypeID“ - in der zum Besucher hinterlegten Währung	money	3.5.0
ShippingCostBrutto	Brutto-Kosten für die Versandart „ShippingTypeID“ - in der zum Besucher hinterlegten Währung	money	3.5.0
PersonCharacCategoryID	ID einer Kategorie von Personen-Merkmalen. Gibt an, daß der Auftraggeber - falls er die Zahlungsart „PaymentTypeID“ wählt - Eigenschaften zu den Merkmalen dieser Kategorie hinterlegen muß (Beispiel : Kreditkartendaten bei Kreditkarten-Zahlung).	tinyint	3.5.0
RegionID_PaymentType	ID der zur Zahlungsart „PaymentTypeID“ hinterlegten „Region“ (die bestimmte Länder zusammenfaßt). Wir geben diesen Datensatz nur dann aus, wenn der Auftraggeber („PersonID“) aus einem Land kommt, das dieser Region angehört.	smallint	5.5.2
RegionID_ShippingType	ID der zur Versandart „ShippingTypeID“ hinterlegten „Region“ (die bestimmte Länder zusammenfaßt). Wir geben diesen Datensatz nur dann aus, wenn die Person, an die die Ware zu liefern ist („DeliveryPersonID“), aus einem Land dieser Region kommt.	smallint	5.5.2

Sortierung der Rückgabe

(parameterunabängige Sortierung)

ShippingTypeID (aufsteigend)
PaymentTypeID (aufsteigend)

wenn CalculateCosts = 0 und SelectMissingResultReason = 0

Spaltenname	Beschreibung	SQL-Datentyp²⁾	ab Version
PaymentForShippingID	ID einer gefundenen Zahlungsart-Versandart-Kombination (die für die übergebenen Parameter gültig ist)	smallint	6.0.2
PaymentForShippingDescription	Bezeichnung der Zahlungsart-Versandart-Kombination „PaymentForShippingID“	varchar(100)	6.0.2
PaymentTypeID	ID der Zahlungsart der Kombination „PaymentForShippingID“	smallint	6.0.2
ShippingTypeID	ID der Versandart der Kombination „PaymentForShippingID“	smallint	6.0.2
PersonCharacCategoryID	ID einer Kategorie von Personen-Merkmalen. Gibt an, daß der Auftraggeber - falls er die Zahlungsart „PaymentTypeID“ wählt - Eigenschaften zu den Merkmalen dieser Kategorie hinterlegen muß (Beispiel : Kreditkartendaten bei Kreditkarten-Zahlung).	tinyint	6.0.2
RegionID_PaymentType	ID der zur Zahlungsart „PaymentTypeID“ hinterlegten „Region“ (die bestimmte Länder zusammenfaßt). Wir geben diesen Datensatz nur dann aus, wenn der Auftraggeber („PersonID“) aus einem Land kommt, das dieser Region angehört.	smallint	6.0.2
RegionID_ShippingType	ID der zur Versandart „ShippingTypeID“ hinterlegten „Region“ (die bestimmte Länder zusammenfaßt). Wir geben diesen Datensatz nur dann aus, wenn die Person, an die die Ware zu liefern ist („DeliveryPersonID“), aus einem Land dieser Region kommt.	smallint	6.0.2

Sortierung der Rückgabe

(parameterunabängige Sortierung)

ShippingTypeID (aufsteigend)
PaymentTypeID (aufsteigend)

wenn Result (Pseudo-Parameter) = 0 und CalculateCosts = 1 und SelectMissingResultReason = 1

Spaltenname	Beschreibung	SQL-Datentyp³⁾	ab Version
PaymentForShippingID	ID einer gefundenen Zahlungsart-Versandart-Kombination (die für die übergebenen Parameter gültig ist)	smallint	3.5.20
PaymentForShippingDescription	Bezeichnung der Zahlungsart-Versandart-Kombination „PaymentForShippingID“	varchar(100)	3.5.20
PaymentTypeID	ID der Zahlungsart der Kombination „PaymentForShippingID“	smallint	3.5.20
PaymentCost	(Netto-)Kosten für die Zahlungsart „PaymentTypeID“ - in der zum Besucher hinterlegten Währung	money	3.5.20
PaymentCostBrutto	Brutto-Kosten für die Zahlungsart „PaymentTypeID“ - in der zum Besucher hinterlegten Währung	money	3.5.20
ShippingTypeID	ID der Versandart der Kombination „PaymentForShippingID“	tinyint	3.5.20
ShippingCost	(Netto-)Kosten für die Versandart „ShippingTypeID“ - in der zum Besucher hinterlegten Währung	money	3.5.20
ShippingCostBrutto	Brutto-Kosten für die Versandart „ShippingTypeID“ - in der zum Besucher hinterlegten Währung	money	3.5.20
PersonCharacCategoryID	ID einer Kategorie von Personen-Merkmalen. Gibt an, daß der Auftraggeber - falls er die Zahlungsart „PaymentTypeID“ wählt - Eigenschaften zu den Merkmalen dieser Kategorie hinterlegen muß (Beispiel : Kreditkartendaten bei Kreditkarten-Zahlung).	tinyint	3.5.20
RegionID_PaymentType	ID der zur Zahlungsart „PaymentTypeID“ hinterlegten „Region“ (die bestimmte Länder zusammenfaßt). Wir geben diesen Datensatz nur dann aus, wenn der Auftraggeber („PersonID“) aus einem Land kommt, das dieser Region angehört.	smallint	5.5.2
RegionID_ShippingType	ID der zur Versandart „ShippingTypeID“ hinterlegten „Region“ (die bestimmte Länder zusammenfaßt). Wir geben diesen Datensatz nur dann aus, wenn die Person, an die die Ware zu liefern ist („DeliveryPersonID“), aus einem Land dieser Region kommt.	smallint	5.5.2

Sortierung der Rückgabe

(parameterunabängige Sortierung)

ShippingTypeID (aufsteigend)
PaymentTypeID (aufsteigend)

wenn Result (Pseudo-Parameter) = 0 und CalculateCosts = 0 und SelectMissingResultReason = 1

Spaltenname	Beschreibung	SQL-Datentyp⁴⁾	ab Version
PaymentForShippingID	ID einer gefundenen Zahlungsart-Versandart-Kombination (die für die übergebenen Parameter gültig ist)	smallint	6.0.2
PaymentForShippingDescription	Bezeichnung der Zahlungsart-Versandart-Kombination „PaymentForShippingID“	varchar(100)	6.0.2
PaymentTypeID	ID der Zahlungsart der Kombination „PaymentForShippingID“	smallint	6.0.2
ShippingTypeID	ID der Versandart der Kombination „PaymentForShippingID“	smallint	6.0.2
PersonCharacCategoryID	ID einer Kategorie von Personen-Merkmalen. Gibt an, daß der Auftraggeber - falls er die Zahlungsart „PaymentTypeID“ wählt - Eigenschaften zu den Merkmalen dieser Kategorie hinterlegen muß (Beispiel : Kreditkartendaten bei Kreditkarten-Zahlung).	tinyint	6.0.2
RegionID_PaymentType	ID der zur Zahlungsart „PaymentTypeID“ hinterlegten „Region“ (die bestimmte Länder zusammenfaßt). Wir geben diesen Datensatz nur dann aus, wenn der Auftraggeber („PersonID“) aus einem Land kommt, das dieser Region angehört.	smallint	6.0.2
RegionID_ShippingType	ID der zur Versandart „ShippingTypeID“ hinterlegten „Region“ (die bestimmte Länder zusammenfaßt). Wir geben diesen Datensatz nur dann aus, wenn die Person, an die die Ware zu liefern ist („DeliveryPersonID“), aus einem Land dieser Region kommt.	smallint	6.0.2

Sortierung der Rückgabe

(parameterunabängige Sortierung)

ShippingTypeID (aufsteigend)
PaymentTypeID (aufsteigend)

wenn Result (Pseudo-Parameter) = -335 und SelectMissingResultReason = 1

Spaltenname	Beschreibung	SQL-Datentyp⁵⁾	ab Version
ErrorCode	Eine Zahl, die den Grund angibt, warum keine gültige Kombination aus Zahlungs- und Versandart gefunden wurde (siehe Beschreibung)	tinyint	3.5.20

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code	Beschreibung	Quelle ⁶⁾
-1323	Die Person besitzt kein Konto zum angegebenen Typ	nur indirekt
-1204	Fehlender oder falscher Eintrag in CampaignSettings	nur indirekt
-684	Die Eigenschaft gehört zum Merkmal „Land“, aber es gibt keinen entsprechenden Eintrag in „Countries“	nur indirekt
-661	Die Person besitzt keine oder eine ungültige Eigenschaft zu einem bestimmten Merkmal	nur indirekt
-655	Die VisitorID steht nicht mit der PersonID in Verbindung	nur direkt
-621	Fehlender oder falscher Eintrag in PersonTypeSettings	nur indirekt
-600	Es konnte keine gültige VisitorID ermittelt werden	nur direkt
-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	direkt und indirekt
-540	Falsches Format	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
-507	Fehlerhafte Implementierung einer Prozedur - Daten in einem Ausgabeparameter sind ungültig	nur indirekt
-506	Fehlerhafte Implementierung einer Prozedur - Daten in der Output-Schnittstelle sind ungültig	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
-385	Die Brutto-Summe aus Warenwert plus Surcharges unterschreitet den vorgegebenen Mindestwert	nur indirekt
-338	Die gegebene PaymentForShippingID ist keine mögliche Zahlungs-/Versandart-Kombination	nur indirekt
-337	Keine PaymentForShippingID aufgrund HideWhenOrderedAlone-Einstellung möglich	nur indirekt
-336	Keine PaymentForShippingID gefunden, die für alle Artikel im Warenkorb möglich ist	nur indirekt
-335	Es konnte keine gültige Zahlungs-Versandart-Kombination ermittelt werden	nur direkt
-334	Mindestens einem Artikel ist keine PaymentForShippingID zugewiesen	nur indirekt
-333	Ein benötigter Steuersatz ist nicht bekannt oder konnte nicht ermittelt werden	nur indirekt
-329	Keine PaymentForShippingID aufgrund der Gruppen-Zugehörigkeit des Auftraggebers gefunden	nur indirekt
-328	Keine PaymentForShippingID gefunden, da Bestellwert nicht die Zahlungsarten-Beschränkungen erfüllt	nur indirekt
-327	Keine PaymentForShippingID gefunden, da Bestellwert nicht die Versandarten-Beschränkungen erfüllt	nur indirekt
-326	Keine PaymentForShippingID aufgrund der Region der Lieferanschrift gefunden	nur indirekt
-325	Keine PaymentForShippingID aufgrund der Region des Auftraggebers gefunden	nur indirekt
-310	Der Besucher hat keine gültigen Artikel im Warenkorb	nur indirekt
-283	Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu ermitteln	nur indirekt
-221	Es konnte kein rekursives Merkmal mit der Standardwährung als Einheit 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	„Start-/Finish-Procedure“-Logik eingebaut, s. Ticket #3670
7.0.4	2014-03-19	Kleine Kosmetik-Korrektur : Bei einigen Code-Zeilen war am Ende ein CR-Zeichen, was wir entfernt haben
6.0.7	2012-05-08	Dokumentation bzgl. verändertem Verhalten beim Auswerten der „GroupPaymentForShippings“ wenn Einstellung „GroupPayForShipForOrdererOrDelivPers=1“ aktualisiert.
6.0.3	2011-09-07	Bugfix : „Subquery returned more than 1 value“-Fehler aufgrund eines kartesischen Produktes mit der Tabelle „Persons“ beim Ausgeben des Ergebnisses ganz am Schluß
6.0.2	2011-06-08	1. Neukodierung wg. zahlreicher Tabellen-Änderungen 2. Bugfix : „Date“ wurde nicht bei Währungs-Umrechn. beachtet 3. Neuer mögl. „ErrorCode“ 4. Bugfix : Datentyp „ErrorCode“ war „integer“ anstatt „tinyint“ 5. Neuer Parameter „CalculateCosts“
6.0.1	2010-07-20	1. Zusätzliche Einschränkung auf Tabelle „Countries“ beim Ermitteln des zur Eigenschaft der Person für „CountryCharacID“ korrespondierenden Eintrags. 2. Neue Rückgabespalten „RegionID_PaymentType“ und „RegionID_ShippingType“
5.5.2	2008-10-21	Neue Rückgabespalten „RegionID_PaymentType“ und „RegionID_ShippingType“
5.5.1	2008-07-29	1. Interne Umstellung bei der Belegung von Variablen, die eine Liste von Werten enthalten, damit die Prozedur auch für ASE 15.0.2 läuft 2. Quellcode-Änderungen gemäß aktuellem Standard 3. Fehlende Fehler-Behandlung in einigen Fällen
5.1.7	2006-10-31	Umstellung bei der Ermittlung des Landes von „PersonID“ bzw. „DeliveryPersonID“ auf die neue Tabelle „PersonCharacValueReferences“
5.0.4	2005-09-26	1. Umstellung auf den neuen „PersonTypeSettings“-Schlüssel „CountryCharacteristicID“ bei der Ermittlung des Landes von „PersonID“ bzw. „DeliveryPersonID“ 2. Konsequente Fehlerbehandlung 3. Zugriff auf „Settings“ ab jetzt über mi_GetSettingEntry
4.0.3	2003-07-10	Fehlende Index-Angabe für „Persons“ in einem Fall
4.0.0	2003-04-03	1. Ab jetzt : Fehler-Returncode falls „SelectMissingResultReason = 1“ UND keine Zahlart-Versandart-Kombination ermittelt werden kann 2. Fehler in der Doku 3. Fehlende/falsche Index-Angaben (für den „optimizer“)
3.5.21	2002-08-06
3.5.20	2002-07-22
3.5.17	2002-05-02
3.5.5	2001-03-30
3.5.0	2000-11-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_GetPaymentAndShipping_Pu im Engine Playground öffnen

cURL

Unformatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/om_GetPaymentAndShipping_Pu?UniqueID=<value>&PersonID=<value>&BruttoSum=<value>&NettoSum=<value>'

Mit xmllint ⁷⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/om_GetPaymentAndShipping_Pu?UniqueID=<value>&PersonID=<value>&BruttoSum=<value>&NettoSum=<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_GetPaymentAndShipping_Pu',
		array(
			'UniqueID' => '<value>',
			'PersonID' => <value>,
			'BruttoSum' => <value>,
			'NettoSum' => <value>,
			// 'DeliveryPersonID' => NULL,
			// 'PaymentForShippingID' => NULL,
			// 'Date' => NULL,
			// 'SelectMissingResultReason' => 0,
			// 'CalculateCosts' => 1
		)
);
 
$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_GetPaymentAndShipping_Pu">
			<Parameters>
				<Parameter Name="UniqueID"><!-- varchar value --></Parameter>
				<Parameter Name="PersonID"><!-- integer value --></Parameter>
				<Parameter Name="BruttoSum"><!-- money value --></Parameter>
				<Parameter Name="NettoSum"><!-- money value --></Parameter>
				<!-- <Parameter Name="DeliveryPersonID">NULL</Parameter> -->
				<!-- <Parameter Name="PaymentForShippingID">NULL</Parameter> -->
				<!-- <Parameter Name="Date">NULL</Parameter> -->
				<!-- <Parameter Name="SelectMissingResultReason">0</Parameter> -->
				<!-- <Parameter Name="CalculateCosts">1</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>

¹⁾ , ²⁾ , ³⁾ , ⁴⁾ , ⁵⁾

siehe Datentypen im Bereich "engine"

⁶⁾

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