Übernimmt alle gültigen Einträge aus dem Warenkorb eines Besuchers und legt einen Auftrag an.

Hinweise zur Preisermittlung :

1. Wie die Preise ermittelt werden, ist in der Dokumentation zu 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, so kann er (innerhalb dieser Toleranz) diesen Artikel auch tatsächlich zum „Aktionspreis“ bestellen, selbst wenn zum Zeitpunkt der Auftragsplatzierung die Aktion beendet ist.
3. Es können zusätzliche Informationen pro Position zur Preisermittlung gespeichert werden. Siehe hierzu den „Settings“-Eintrag „LoggedOrderContentInfoTypes“ !

Anmerkungen zum Parameter „PriceNodeCharacteristicID“ :

Dieser Parameter 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.ä.). Beim Anlegen eines Auftrags durch diese Prozedur könnte der „publicuser“ aber THEORETISCH durch „PriceNodeCharacteristicID“ ein Preis-Merkmal angeben, für das er eigentlich keine Lese-Berechtigung besitzt, geschweige denn einen Auftrag mit Artikeln zu diesem Preis platzieren darf…
Evtl. wird es in einer zukünftigen „dStore“-Version die Möglichkeit geben, Berechtigungen für Merkmale an den Personen-TYP zu binden o.ä.

Anmerkung zur Zahlungs- und Versandart :

Prinzipiell kann eine beliebige (existierende) „PaymentTypeID“ und „ShippingTypeID“ angegeben werden. Soll die angegebene Versand- und Zahlungsart aber wie bei om_GetPaymentAndShipping_Pu auf diverse Kriterien hin überprüft werden (Mindestbestellwert, die Lieferanschrift muß in einer bestimmten Region liegen etc.), kann dies über den „Settings“-Eintrag zum Schlüssel „CheckPaymentAndShippingForNewOrder“ festgelegt werden.

Anmerkung zum Parameter „AddOrderContentInformation“ :

Man kann auch zusätzliche Informationen zu den einzelnen Auftragspositionen speichern lassen. Dazu ist „AddOrderContentInformation“ auf „1“ zu setzen. Vor dem Aufruf ist eine temporäre Tabelle zu erstellen und mit den entsprechenden Daten zu füllen :

CREATE TABLE #OrderContentInfo ( HTreeNodeID integer,
InformationTypeID smallint,
Information varchar(1000)
)

Anmerkungen zu den Parametern „AddOrderInformation“ und „AddOrderContentInformation“ :

1.) Falls es sich bei einer „OrderInformation“ oder einer „OrderContentInformation“ um eine Datumsangabe handelt (d.h. wenn zur entsprechenden „InformationTypeID“ als Feldtyp ein Datumsformat konfiguriert ist), muß der Wert IMMER im „englischen“ Format (Monat-Tag-Jahr) übergeben werden !
2.) Seit Version 6.5.1 können die Informationen auch von den „Pendants“ des Warenkorbes („Trolley[Content]Information“) übernommen werden (Parameterwert jeweils „2“). Dazu muß natürlich bekannt sein, VON welcher „InformationTypeID“ (für Warenkörbe bzw. Warenkorbs-Positionen) NACH welcher „InformationTypeID“ (von Aufträgen bzw. Auftrags-Positionen) die evtl. vorhandenen Informationen übernommen werden sollen. Dies geschieht durch entsprechende Konfiguration der Warenkorbs- bzw. Warenkorbs-Positions-Informationsart, s. om_ModifyTrolleyInfoTypes_Ad bzw. om_ModifyTrolleyCInfoTypes_Ad.

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

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_CopyFromTrolleyToOrder_Pu?UniqueID=<value>&PersonID=<value>&ShippingTypeID=<value>&PaymentTypeID=<value>'

Mit xmllint ³⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_CopyFromTrolleyToOrder_Pu?UniqueID=<value>&PersonID=<value>&ShippingTypeID=<value>&PaymentTypeID=<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_CopyFromTrolleyToOrder_Pu',
		array(
			'UniqueID' => '<value>',
			'PersonID' => <value>,
			'ShippingTypeID' => <value>,
			'PaymentTypeID' => <value>,
			// 'DeliveryPersonID' => NULL,
			// 'DeliveryDateAndTime' => NULL,
			// 'StartOrderID' => 10000,
			// 'PriceNodeCharacteristicID' => NULL,
			// 'AddOrderInformation' => 0,
			// 'AddOrderContentInformation' => 0,
			// 'GetIncorrectInformation' => 0,
			// 'UseCashAccount_MaxValue' => NULL,
			// 'AbortIfItemsRemoved' => 0
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();
 
$OutputParams = $xml_result->getOutputParametersAsArray();

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_CopyFromTrolleyToOrder_Pu">
			<Parameters>
				<Parameter Name="UniqueID"><!-- varchar value --></Parameter>
				<Parameter Name="PersonID"><!-- integer value --></Parameter>
				<Parameter Name="ShippingTypeID"><!-- tinyint value --></Parameter>
				<Parameter Name="PaymentTypeID"><!-- smallint value --></Parameter>
				<!-- <Parameter Name="DeliveryPersonID">NULL</Parameter> -->
				<!-- <Parameter Name="DeliveryDateAndTime">NULL</Parameter> -->
				<!-- <Parameter Name="StartOrderID">10000</Parameter> -->
				<!-- <Parameter Name="PriceNodeCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="AddOrderInformation">0</Parameter> -->
				<!-- <Parameter Name="AddOrderContentInformation">0</Parameter> -->
				<!-- <Parameter Name="GetIncorrectInformation">0</Parameter> -->
				<!-- <Parameter Name="UseCashAccount_MaxValue">NULL</Parameter> -->
				<!-- <Parameter Name="AbortIfItemsRemoved">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>