Prozedur, um ein Set von Bundle-Artikeln anlegen/ändern/löschen zu können, das als Benefit einer Verkaufs-Aktion verwendet werden soll.

Hintergrund :
Der Benefit-Typ „Bundle-Preis“ für Verkaufs-Aktionen bietet die Möglichkeit, sogenannte Sets von Artikeln definieren zu können, aus denen der Kunde sich ein oder mehrere Artikel aussuchen muss. Dieses Artikelset erhält er dann zu einem spziellen Preis (überlicherweise rabbatiert).

Anmerkung zum Parameter „ItemConditionID“ :

Die Definition einer Artikel-Bedingung (s. im_GetItemConditions_Ad) kann recht komplex sein (große Anzahl Bedingungs-Teile sowie viele Möglichkeiten, sie zu verknüpfen), auf der anderen Seite können gerade auch einfache Bedingungen dazu führen, daß sehr viele Elemente diese erfüllen. Beides ist für Bundle-Preis-Artikel recht problematisch, da dem Kunden ja eine Auswahl über om_GetCampaignBundlePricing_Pu präsentiert werden muß - und das ist genau dann nachteilig, wenn die Ausführung sehr lange dauert (weil die Bedingung komplex ist) oder aber das Ergebnis zu groß ist (weil viele Elemente die Bedingung erfüllen). Deswegen gelten folgende Einschränkungen :
1.) Bei Erstellung eines Sets oder Änderung der „ItemConditionID“ eines bestehenden Sets wird geprüft, wieviele Elemente die Bedingung erfüllen. Übersteigt die Anzahl 1000 bzw. den in „Settings“ zum Schlüssel „MaximumNumberOfBundleItemsPerSet“ konfigurierten Wert, gibt es einen Fehler.
2.) Derzeit darf eine Bedingung nur aus einer Bedingungs-Gruppe mit genau einem Bedingungs-Teil bestehen oder muß aus einer Bedingungs-Gruppe bestehen, deren Bedingungs-Teile mit „AND“ verknüpft sind. In letzterem Fall gilt außerdem, daß die IDs der „TreeNodeID“s, die den ERSTEN Bedingungs-Teil erfüllen, in eine „varchar(16383)“-Liste passen müssen. Dies bedeutet, daß garantiert knapp 1500 Elemente, in der Praxis aber wohl mindestens 2500 Elemente den ersten Bedingungs-Teil erfüllen dürfen (bevor man Probleme bekommt). Für einen Bedingungsteil gilt außerdem :

• Die Operatoren '!I', 'E' und '!E' werden nicht unterstützt
• Bzgl. der Vererbungs-Einstellung („InheritDepth“) sind nur die Werte „0“ und „-1“ erlaubt (also entweder gar keine oder aber komplette Vererbung)
• Hinsichtlich der „RecursiveEvaluation“-Option (wie rekursiv ausgewertet werden soll) ist der Wert „2“ (Beschreibung der Merkmal-ID, die als Eigenschaft hinterlegt ist, soll gewählt werden) derzeit nicht erlaubt

Anmerkungen zum Parameter „DeleteSet“ :

1.) Sofern „ItemSetID“ bereits in einem Benefit einer AKTIVEN Bundle-Verkaufs-Aktion verwendet wird (s. om_GetCamBundlePricing_Ad), kann NICHTS mehr verändert (also auch Löschen ist nicht möglich) werden (ggf. gibt es dann also einen Fehler) !

2.) Das Löschen eines Sets schlägt auch dann fehl, wenn es über ein entsprechendes Benefit einer INAKTIVEN Verkaufs-Aktion zugeordnet ist. Übergibt man aber den Wert „2“ für „DeleteSet“, werden evtl. vorhandene Zuordnungen zu (Bundle–Preis-Aktions-)Benefits vorher gelöscht (was man normalerweise mit om_ModifySetsForBunBenefits_Ad macht), um dann das Set selbst zu löschen.

Die Prozedur hat keine Rückgaben.

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

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_ModifyBundleItemSets_Ad?ItemConditionID=<value>'

Mit xmllint ²⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_ModifyBundleItemSets_Ad?ItemConditionID=<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_ModifyBundleItemSets_Ad',
		array(
			'ItemConditionID' => <value>,
			// 'Quantity' => 1,
			// 'DistinctItemsOnly' => 0,
			// 'DeleteSet' => 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_ModifyBundleItemSets_Ad">
			<Parameters>
				<Parameter Name="ItemConditionID"><!-- integer value --></Parameter>
				<!-- <Parameter Name="Quantity">1</Parameter> -->
				<!-- <Parameter Name="DistinctItemsOnly">0</Parameter> -->
				<!-- <Parameter Name="DeleteSet">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>