Prozedur, um eine für Verkaufs-Aktionen zu verwendende Bedingung des Typs „extended item condition“ (eine evtl. um Mengen/Warenwert-Kriterien erweiterte Artikel-Bedingung) anlegen/ändern/löschen zu können.

Zum Verständnis :

Jeder „Verkaufs-Aktion“ (einer sogenannten „Campaign“) können Bedingungen zugeordnet werden, die erfüllt sein müssen, damit der Kunde die „Benefits“ der Aktion nutzen kann. (Genau) Eine dieser Bedingungen kann eine sogenannte „Erweiterte Artikel-Bedingung“ sein.
Dieser Bedingung ist genau eine (einfache) Artikel-Bedingung zugeordnet (deren Aufbau detailliert in im_GetItemConditions_Ad beschrieben ist), die kurz gesagt aus Bedingungs-Gruppen besteht, die ihrerseits aus Bedingungs-Teilen bestehen.
Die gesamte Artikel-Bedingung und/oder ihre „Bestandteile“ können (jeweils) „erweitert“ werden, und zwar um Mengen- und/oder
Warenwert-Kriterien. So wird beispielsweise aus einem (Artikel-)Bedingungs-Teil „Schuhe der Marke X“ der erweiterte (Artikel-)Bedingungs-Teil „mind. 2 Schuhe der Marke X im Wert von 250 Euro“ oder aus einer einer (einfachen Gesamt-)Artikel-Bedingung „Schuhe der Marke X ODER grüne Hosen“ eine „vollständige Bedingung“ wie „mind. 2 Schuhe der Marke X ODER 3 grüne Hosen im Gesamt-Wert von 250 Euro“.

Hinweise :

1.) Sofern die Bedingung („ConditionID“) einer AKTIVEN Verkaufs-Aktion zugeordnet ist, kann NICHTS mehr verändert (also auch Löschen ist nicht möglich) werden (ggf. gibt es dann also einen Fehler) !

2.) Wenn ein „Min…“- bzw. „From…“-Parameter angegeben ist, darf der zugehörige „Max…“- bzw. „To…“-Parameter mit „NULL“ übergeben werden. Wenn dem so ist, wählen wir nämlich automatisch den maximal möglichen Wert (für den entsprechenden Datentyp). Beispiel : Wenn „FromQuantity = 2“ und „ToQuantity = NULL“ ist, wählen wir automatisch den „max integer“-Wert (2147483647) für „ToQuantity“.

Anmerkung zum Parameter „ItemConditionID“ :

Die hierdurch angegebene Artikel-Bedingung wird der Verkaufs-Aktions-Bedingung zugeordnet. Dies Zuordnung kann aber auch nachträglich geändert werden (weil es eine 1:1-Zuordnung ist), d.h. in „ItemConditionID“ kann die ID einer anderen Artikel-Bedingung angegeben werden als die, die aktuell „ConditionID“ zugeordnet ist. Aber VORSICHT : Evtl. Erweiterungen (um Mengen/Warenwert-Kriterien) einzelner Bestandteile (Gruppen oder Teile) der alten Artikel-Bedingung zur „ConditionID“ werden dann GELÖSCHT (denn diese Bestandteile passen i.d.R. ja nicht zur neuen Artikel-Bedingung) !

Anmerkung zum Parameter „DeleteCondition“

Wenn man hier den Wert „1“ übergibt, soll die angegebene Verkaufs-Aktions-Bedingung gelöscht werden. Das Löschen einer Bedingung schlägt allerdings nicht nur fehl, wenn die Bedingung einer aktiven Aktion zugeordnet ist, sondern auch dann, wenn sie einer INAKTIVEN Verkaufs-Aktion zugeordnet ist. Möchte man, daß das Löschen gelingen soll, wenn die Bedingung nur inaktiven Aktionen zugeordnet ist, übergibt man den Wert „2“ für „DeleteCondition“ (dann werden evtl. vorhandene Datensätze zur „ConditionID“ in „CampaignConditions“ vorher gelöscht - was man normalerweise mit om_ModifyCampaignConditions_Ad macht).

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

Unformatierte Ausgabe:

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

Mit xmllint ²⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/om_ModifyCampaignItemConds_Ad?ItemConditionID=<value>&ConditionDescription=<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_ModifyCampaignItemConds_Ad',
		array(
			'ItemConditionID' => <value>,
			'ConditionDescription' => '<value>',
			// 'MinNumberOfItems' => NULL,
			// 'MaxNumberOfItems' => NULL,
			// 'FromQuantity' => NULL,
			// 'ToQuantity' => NULL,
			// 'FromItemBasicPrice' => NULL,
			// 'ToItemBasicPrice' => NULL,
			// 'FromBasicPriceSum' => NULL,
			// 'ToBasicPriceSum' => NULL,
			// 'DeleteCondition' => 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_ModifyCampaignItemConds_Ad">
			<Parameters>
				<Parameter Name="ItemConditionID"><!-- integer value --></Parameter>
				<Parameter Name="ConditionDescription"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="MinNumberOfItems">NULL</Parameter> -->
				<!-- <Parameter Name="MaxNumberOfItems">NULL</Parameter> -->
				<!-- <Parameter Name="FromQuantity">NULL</Parameter> -->
				<!-- <Parameter Name="ToQuantity">NULL</Parameter> -->
				<!-- <Parameter Name="FromItemBasicPrice">NULL</Parameter> -->
				<!-- <Parameter Name="ToItemBasicPrice">NULL</Parameter> -->
				<!-- <Parameter Name="FromBasicPriceSum">NULL</Parameter> -->
				<!-- <Parameter Name="ToBasicPriceSum">NULL</Parameter> -->
				<!-- <Parameter Name="DeleteCondition">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>