Gibt den Inhalt des Warenkorbes zu einem Besucher zurück.

Falls Preise ermittelt werden (→ „CalculatePrices“), ist immer eine letzte Zeile im Ergebnis enthalten, die eine Summe aller Werte enthält. Die Summenzeile zeichnet sich dadurch aus, daß für die Rückgabespalte „HTreeNodeID“ der Wert „-1“ ist.

Hinweise und Anmerkungen zur Preisermittlung (falls „CalculatePrices = 1“ ist):

1. Wie die Preisermittlung grundsätzlich funktioniert, ist in der Dokumentation von om_GetPrices_Pu nachzulesen.

2. Gibt es einen „Settings“-Eintrag zum Schlüssel „PriceInTrolleyIsValidForXSeconds“ (eine Zahl größer als „0“), werden die Preise nicht zum aktuellen Zeitpunkt (des Aufrufs dieser Prozedur), sondern zu dem Zeitpunkt, an dem sie jeweils in den Warenkorb gelegt wurden, ermittelt - sofern nicht die konfigurierte Anzahl Sekunden überschritten ist !
Fügt also z.B. ein Kunde einen Artikel seinem Warenkorb hinzu, das zu einem „Aktionspreis“ angeboten wird, und ruft er die Warenkorb-Anzeige zu einem späteren Zeitpunkt auf, an dem die Aktion aber bereits beendet ist, bekommt er trotzdem den Aktionspreis angezeigt - und zu diesem Preis kann er dann auch bestellen, siehe om_CopyFromTrolleyToOrder_Pu.

3. Der Parameter „PriceNodeCharacteristicID“ durchbricht ein wenig das Sicherheits-Konzept der „public“-Prozeduren (alle Prozeduren, deren Name NICHT auf „_Ad“ endet und nicht mit „_“ beginnt). Normalerweise kann ein öffentlicher Benutzer, der sich DIREKT auf dem Datenbank-Server anmeldet (was i.d.R. schon schwierig genug sein sollte…) NUR Daten einsehen oder verändern, für die Zugriffsrechte vorhanden sind. Beispielsweise kann (siehe im_ModifyLockedNodeCharacs_Ad) verhindert werden, daß der „publicuser“ Eigenschaften zu bestimmten Merkmalen einsehen kann - insbesondere bestimmte „Preise“ („Händler-EK“s o.ä.). Evtl. wird es in einer zukünftigen „dStore“-Version daher die Möglichkeit geben, Berechtigungen für Merkmale an den Personen-TYP zu binden o.ä.

Anmerkungen zu den Ausgabespalten „HTreeNodeID“, „NodeID“ und „AssociatedOrChosenTreeNodeID“ :

Im Warenkorb werden immer „HTreeNodeID“s gespeichert. Eine „HTreeNodeID“ ist ein Element im „Artikelbaum“ mit Gültigkeitszeitraum. Jedes Element im „Artikelbaum“ besitzt einen/mehrere Gültigkeitszeitraum/-zeiträume. Für gelöschte Elemente ist dieser Zeitraum abgeschlossen, für momentan gültige (unabhängig davon ob aktiviert oder nicht !!!) Elemente ist dieser Zeitraum OFFEN. Bekommt ein Element eine andere Position im Artikelbaum (d.h. wird es „verschoben“), so existieren mindestens ZWEI Gültigkeitszeiträume : die alte(n) Position(en) im Baum haben natürlich abgeschlossene Zeiträume, die neue (nach dem Verschieben) hat entsprechend einen offenen Zeitraum.

Besonderheit : DERZEIT hat jedes Artikel-Element („NodeID“) eine EINDEUTIGE Position im Artikelbaum („TreeNodeID“). Es ist jedoch vorgesehen, ein Element MEHRFACH im Baum einordnen zu können. Dies hat zur Folge, daß man ein Artikel-Element nicht unbedingt EINDEUTIG in der Hierarchie einordnen kann. DESWEGEN gibt es zu jeder „NodeID“ GENAU EINE
„HTreeNodeID“ mit einem offenen Gültigkeitszeitraum, wobei die „TreeNodeID“ unbekannt ist (Weil dieses Element aber in jedem Fall unterhalb des „Wurzel-Elementes“ liegt, ist als „TreeNodeID“ die „0“ angegeben !)

Es kann also sein, daß sich im Warenkorb des Besuchers eine „HTreeNodeID“ befindet, deren zugehörige „TreeNodeID“ „0“ ist. Zur Preisermittlung (→ CalculatePrices = 1„) oder zur Ermittlung der Vorgänger (→ „IncludePredecessors = 1“) wird aber unbedingt ein Element im Artikelbaum benötigt ! Für solche Elemente wird dann einfach EIN „repräsentierendes“ Element (i.d. R. die kleinste „TreeNodeID“ ungleich „0“ zur „NodeID“) gewählt.

Anmerkung zur Rückgabespalte „QuantityPerBundleItemSetIDList“ :

Durch ein “,„ getrennte Liste von Listen, deren Werte wiederum durch “&„ getrennt sind, und ein Wert die Form <Menge>x<BundleItemSetID> hat. Dies besagt jeweils, wieviel (<Menge>) von „Quantity“ der „HTreeNodeID“ zu der “<BundleItemSetID>„ des Bundles gehört. Die zugehörige „BenefitID“ ergibt sich automatisch, weil eine „ItemSetID“ nur einer „BenefitID“ zugeordnet werden darf. Alle Datensätze haben die gleiche Anzahl Elemente (sowohl die Liste von Listen als auch die “<Menge>x<ItemSetID>„-Liste). Ist „HTreeNodeID“ kein Teil eines Bundles, wird als “<Menge>„ eben „0“ eingetragen.
Hinweis : Die “<Menge>„-Werte haben pro Element in der Liste dieselbe Anzahl Stellen (einige sind also ggf. mit „0“en zu Beginn aufgefüllt).

Anmerkung zum Parameter „RepairEntriesWithSameNodeID“ :

Der Parameter „RepairEntriesWithSameNodeID“ gibt an, ob der Fehler “-311„ zurückgegeben wird (wenn „NULL“ oder „0“ angegeben ist), falls im Warenkorb mehrere „HTreeNodeID“s mit gleicher „NodeID“ vorhanden sind, oder ob die betroffenen Datensätze „repariert“ werden sollen. Solche fehlerhaften Datensätze treten im Regelfall nicht auf, aber durch das „Zusammenlegen von Warenkörben“ beim Identifizierungsvorgang - siehe pm_CheckPersonIdentity_Pu - kann es in sehr, sehr seltenen Fällen auftreten !
„Reparieren“ sieht je nach übergebenem Wert so aus :

• „1“ : Datensätze mit jeweils gleicher „NodeID“ werden zusammengefaßt, d.h. über „Quantity“ wird die Summe gebildet und als „HTreeNodeID“ wird diejenige ausgewählt, die ZUERST in den Warenkorb gelegt wurde
• „2“ : Wie „1“, nur daß die „HTreeNodeID“ gewählt wird, die ZULETZT in den Warenkorb gelegt wurde
• „3“ : Von den Datensätzen mit gleicher „NodeID“ wird die Position übernommen, die ZUERST im Warenkorb war, die anderen werden gelöscht
• „4“ : Wie „3“ mit dem Unterschied, daß die ZULETZT eingefügte Position gewählt wird

Anmerkung zum Parameter „DeliveryPersonID“ :

Über „DeliveryPersonID“ kann optional die ID einer Lieferanschrift übergeben werden, um z.B. eine „Brutto=Netto“-Berechnung im Falle einer Lieferung an ein Land außerhalb der EU (unter der Annahme, daß die Ware aus einem EU-Land heraus geliefert wird) zu ermöglichen.
Hinweis : Letzteres ist nämlich KEIN Standard-Verhalten, sondern muß in „_ac_om_GetBasicPrices“ bzw. „_ac_om_ComputePrices“ implementiert werden !

(parameterunabängige Sortierung)

• InputDateAndTime (aufsteigend)

(parameterunabängige Sortierung)

• InputDateAndTime (aufsteigend)

(parameterunabängige Sortierung)

• InputDateAndTime (aufsteigend)

Die Prozedur hat keine Output-Parameter.

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

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

• om_GetTrolley_Pu im Engine Playground öffnen

Unformatierte Ausgabe:

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

Mit xmllint ⁸⁾ formatierte Ausgabe:

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

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_GetTrolley_Pu',
		array(
			'UniqueID' => '<value>',
			// 'PersonID' => NULL,
			// 'CalculatePrices' => 1,
			// 'CheckAvailability' => 1,
			// 'ShowDescriptions' => 1,
			// 'PriceNodeCharacteristicID' => NULL,
			// 'NodeCharacteristicID' => NULL,
			// 'IncludePredecessors' => 0,
			// 'LookForProductDescription' => 1,
			// 'RepairEntriesWithSameNodeID' => 0,
			// 'GetPlainTrolley' => 0,
			// 'DeliveryPersonID' => NULL,
			// 'OutputIntoTrolleySurchInterf' => 0,
			// 'PaymentTypeID' => NULL,
			// 'ShippingTypeID' => NULL
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();

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_GetTrolley_Pu">
			<Parameters>
				<Parameter Name="UniqueID"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="PersonID">NULL</Parameter> -->
				<!-- <Parameter Name="CalculatePrices">1</Parameter> -->
				<!-- <Parameter Name="CheckAvailability">1</Parameter> -->
				<!-- <Parameter Name="ShowDescriptions">1</Parameter> -->
				<!-- <Parameter Name="PriceNodeCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="NodeCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="IncludePredecessors">0</Parameter> -->
				<!-- <Parameter Name="LookForProductDescription">1</Parameter> -->
				<!-- <Parameter Name="RepairEntriesWithSameNodeID">0</Parameter> -->
				<!-- <Parameter Name="GetPlainTrolley">0</Parameter> -->
				<!-- <Parameter Name="DeliveryPersonID">NULL</Parameter> -->
				<!-- <Parameter Name="OutputIntoTrolleySurchInterf">0</Parameter> -->
				<!-- <Parameter Name="PaymentTypeID">NULL</Parameter> -->
				<!-- <Parameter Name="ShippingTypeID">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>