Die Prozedur generiert unterhalb eines Elementes im Artikelbaum „Varianten“ dieses Elementes. Das zugehörige Artikel-Element („NodeID“) muß allerdings auf der Produkt-Hierarchie (siehe „Settings“-Eintrag „ProductLevelID“) sein !

Durch den Parameter „HowManyVariantCharacteristics“ gibt man die Zahl der Merkmale an, aus denen die Varianten generiert werden; hieraus ergibt sich auch, aus welcher der temporären Tabellen „tempdb.dbo.OneID“, „tempdb.dbo.TwoIDs“ oder „tempdb.dbo.ThreeIDs“ die Eigenschaften übergeben werden. Das bedeutet insbesondere, daß genau so viele Varianten erzeugt werden, wie Datensätze in der jeweiligen „tempdb“-Tabelle angegeben sind, wobei die jeweilige Variante eben die in ID1 bzw. ID2 bzw. ID3 angegebene(n) Eigenschaft(en), sprich „ValueID(s)“, hat. Die „ValueID“s müssen je Spalte (ID1 bzw. ID2 bzw. ID3) alle zu genau einem Merkmal gehören !

Die Bezeichnung der generierten Elemente („NodeDescription“) besteht aus den angegebenen Eigenschaften, die die Variante hat (und durch die sich die Varianten untereinander unterscheiden); die Eigenschaften werden in der Bezeichnung dabei durch eine bestimmte Zeichenkette (→ „Delimiter“) voneinander getrennt.

Beispiel:
1. „Delimiter = '/'„
2. „HowManyVariantCharacteristics = 2“ und in „tempdb.dbo.TwoIDs“ wurden Eigenschaften zu den Merkmalen „Farbe“ und „Größe“ übergeben

=⇒ Dann sähe die Bezeichnung einer Variante, die die Eigenschaften „schwarz“ und „XL“ besitzt, so aus : „schwarz/XL“.

Die Prozedur hat keine Rückgaben.

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:

• im_GenerateVariants_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

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

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_GenerateVariants_Ad?Predecessor=<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'),
	'im_GenerateVariants_Ad',
		array(
			'Predecessor' => <value>,
			// 'HowManyVariantCharacteristics' => 2,
			// 'Delimiter' => '/'
		)
);
 
$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="im_GenerateVariants_Ad">
			<Parameters>
				<Parameter Name="Predecessor"><!-- integer value --></Parameter>
				<!-- <Parameter Name="HowManyVariantCharacteristics">2</Parameter> -->
				<!-- <Parameter Name="Delimiter">'/'</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>