Bietet die Möglichkeit, daß ein Besucher ein Artikel-Element bzw. ein Element des Artikelbaums in den Warenkorb legen bzw. die Anzahl erhöhen kann. Es wird geprüft, ob
a) das Element auch nicht für den Benutzer, der diese Prozedur aufruft, gesperrt ist und ob
b) ein Preis in der Standardwährung vorhanden ist und ob
c) das Element auch lieferbar ist [bzw. NICHT die Eigenschaft „Nicht lieferbar“ besitzt] !

Hinweise :
1.) Falls ein „Settings“-Eintrag zum Schlüssel „MaxNumberOfElementsInTrolley“ existiert und der Wert größer als „0“ ist, kann dieser Vorgang fehlschlagen, wenn die konfigurierte Anzahl bereits im Warenkorb erreicht ist !
2.) Ebenfalls fehlschlagen kann die Aktion aufgrund einer weiteren Beschränkung, nämlich durch einen Eintrag in „Settings“ zum Schlüssel „MaxQuantityPerElementInTrolley“, der angibt, wieviel von einem Element maximal in den Warenkorb gelegt werden darf.

Anmerkung zum Parameter „NodeID“ :

Es besteht die Möglichkeit, mehrere Elemente gleichzeitig in den Warenkorb zu legen. Belegt man „NodeID“ mit „NULL“, so erwartet die Prozedur eine Menge von „ID-Quantity“-Paaren in „tempdb.dbo.TwoIDs“ :

• ID1 : Je nach „IsTreeNodeID“ eine „NodeID“ oder „TreeNodeID“
• ID2 : „Quantity“-Wert

Anmerkungen zum Parameter „InputNestLevelForContInfo“ :

Zu der/den neue(n) Positionen können auch zusätzliche Informationen („TrolleyContentInformation“) hinterlegt werden. Dazu sind zuvor mit Hilfe von „if_om_ModifyTrolleyContentInfo“ die Daten in die enstprechende „Input-Schnittstelle“ einzutragen - zu welchem „NestingLevel“ diese gespeichert wurden (s .Ausgabeparameter „InputNestingLevel“ von „if_om_ModifyTrolleyContentInfo“), ist dann hier im Parameter „InputNestLevelForContInfo“ mitzuteilen.

Achtung : Eigentlich müssen Informationen zu Warenkorbs-Positionen immer zu einer „HTreeNodeID“ (s. Parameter „HTreeNodeIDList“ von „if_om_ModifyTrolleyContentInfo“) übergeben werden. Bei dieser Prozedur hier müssen aber (je nach „IsTreeNodeID“) „NodeID“s bzw. „TreeNodeID“s übergeben werden - eben genau die, die man über „NodeID“ bzw. „tempdb.dbo.TwoIDs“ übergibt !

Sollte bei der Speicherung zusätzlicher Informationen ein Fehler auftreten, bricht die Prozedur mit einem Fehler ab und auch die Änderung am Warenkorb - das Hinzufügen des/der Artikel(s) - schlägt dann fehl !

Um evtl. aufgetretene Fehler analysieren zu können, erhält man im Falle der Speicherung zusätzlicher Informationen (wenn also „InputNestLevelForContInfo“ NICHT „NULL“ ist) eine Rückgabemenge.

Anmerkung zum Parameter „BonusItemForItemSetID“ :

Gibt man für „BonusItemForItemSetID“ die ID eines Sets von Bonus-Artikeln an, die als Benefit einer existierenden, aktiven und laufenden Verkaufsaktion konfiguriert ist, wird „NodeID“ als Bonus-Artikel in den Warenkorb eingefügt. Wir prüfen natürlich, ob das gegeben Set auch tatsächlich aktuell gültig ist. Weiterhin gilt grundsätzlich für Bonus-Artikel, daß sie genau mit der Menge (→ „Quantity“) „1“ im Warenkorb angegeben sein müssen.

Hintergrund-Information :

Im Gegensatz zu dieser Prozedur erwartet om_UpdateTrolley_Pu die Angabe einer „HTreeNodeID“, da im Warenkorb immer „HTreeNodeID“s gespeichert werden. 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 !)

Führt ein Besucher also z.B. eine Produktsuche durch, wählt aus dem Suchergebnis einen Artikel aus und möchte diesen in den Warenkorb legen, sollte man diese Prozedur mit der entsprechenden „NodeID“ aufrufen, um in den Statistiken sehen zu können, wieviele Produkte über eine Suche und wieviele Artikel über die Navigation durch den „Artikelbaum“ erreicht wurden.

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_InsertIntoTrolley_Pu im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_InsertIntoTrolley_Pu?UniqueID=<value>&NodeID=<value>&Quantity=<value>'

Mit xmllint ⁶⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_InsertIntoTrolley_Pu?UniqueID=<value>&NodeID=<value>&Quantity=<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_InsertIntoTrolley_Pu',
		array(
			'UniqueID' => '<value>',
			'NodeID' => <value>,
			'Quantity' => <value>,
			// 'IsTreeNodeID' => 1,
			// 'InputNestLevelForContInfo' => NULL,
			// 'Country' => 'german',
			// 'BonusItemForItemSetID' => 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_InsertIntoTrolley_Pu">
			<Parameters>
				<Parameter Name="UniqueID"><!-- varchar value --></Parameter>
				<Parameter Name="NodeID"><!-- integer value --></Parameter>
				<Parameter Name="Quantity"><!-- integer value --></Parameter>
				<!-- <Parameter Name="IsTreeNodeID">1</Parameter> -->
				<!-- <Parameter Name="InputNestLevelForContInfo">NULL</Parameter> -->
				<!-- <Parameter Name="Country">'german'</Parameter> -->
				<!-- <Parameter Name="BonusItemForItemSetID">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>