Ermittelt alle DIREKTEN (!) Eigenschaften (zu einem oder mehreren Merkmalen mit vordefinierten Werten !), die von Nachfolgern (optional nur bis zu einer bestimmten Hierarchie) eines Elementes des Artikelbaums verwendet werden oder einer bestimmten (via „tempdb.dbo.OneID“ zu übergebenden) Menge von Elementen zugewiesen ist.

Optional kann eine Eigenschaft angegeben werden („FilterByCharacteristicID“ und „FilterByCharacValue“), die die Elemente zusätzlich haben müssen (es wird keine Vererbung berücksichtigt !) bzw. NICHT haben müssen (falls „NegateFilterByParams = 1“), d.h. es sind nur Eigenschaften in der Ergebnismenge, zu denen es mindestens ein in Frage kommendes Element gibt, das die Eigenschaft „FilterByCharacValue“ zum Merkmal „FilterByCharacteristicID“ hat bzw. NICHT hat (falls „NegateFilterByParams = 1“).

Zu den gefundenen Eigenschaften kann man sich zusätzlich die (jeweils kleinste) ID eines „Binaries“ ausgeben lassen, das der jeweiligen Eigenschaft zugewiesen ist und eine bestimmte Eigenschaft besitzt.

Bei der Ermittlung der verwendeten Eigenschaften gibt es im Fall „IDsInOneID = 0“ (wenn also Nachfolger-Elemente des durch „TreeNodeID“ angegebenen Elementes beachtet werden sollen) prinzipiell zwei Vorgehensweisen :

Methode 1 : Alle Nachfolger von „TreeNodeID“ ermitteln und dann zu diesen die verschiedenen Eigenschaften zum Merkmal „NodeCharacteristicID“ feststellen

Methode 2 : Von ALLEN Artikel-Elementen die Eigenschaft zu „NodeCharacteristicID“ ermitteln und anschließend diejenigen herausfiltern, die NICHT von Artikel-Elementen verwendet werden, zu denen es ein entsprechendes Element des Artikelbaums („TreeNodeID“) gibt, das unterhalb von „TreeNodeID“ liegt.

Die Prozedur bestimmt standardmäßig selbst, welches Vorgehen wahrscheinlich günstiger ist. Seit Version 3.5.9 kann man aber auch angeben, welche der beiden Methoden die Prozedur verwenden soll.

Anmerkungen zum Parameter „IncludeNumberOfNodesInResult“ und zur Rückgabespalte „NumberOfNodes“ :

Um herauszufinden, von wievielen Elementen eine Eigenschaft verwendet wird, kann man den Parameter „IncludeNumberOfNodesInResult“ angeben. Die Anzahl wird dann in der Spalte „NumberOfNodes“ zurückgegeben. Es gibt folgende mögliche Werte für den besagten Parameter :

• „0“ : Dann steht in „NumberOfNodes“ immer der Wert „-1“
• „1“ : „NumberOfNodes“ enthält die Anzahl „TreeNodeID“s deren zugehörige Artikel-Elemente die Eigenschaft „ValueID“ besitzen. Hinweis : Dieser Wert entspricht derzeit immer dem Wert, den man im Fall „2“ erhält, da noch kein „Cloning“ implementiert ist (genauer : derzeit ist einer „NodeID“ GENAU EINE „TreeNodeID“ zugewiesen) !
• „2“ : Man erhält die Anzahl „NodeID“s die die Eigenschaft „ValueID“ besitzen
• „3“ : Man erhält die Anzahl verschiedener Vorgänger („Predecessor“) der „TreeNodeID“s, deren zugehörige Artikel-Elemente die Eigenschaft „ValueID“ besitzen. Hintergrund : Wenn der aufrufenden Applikation bekannt ist, daß z.B. nur PRODUKT-VARIANTEN Eigenschaften zu dem/den gewünschten Merkmal(en) besitzen, erhält man somit hier die Anzahl PRODUKTE, die quasi die jeweilige Eigenschaft besitzen. Beispiel : Kleidungsgrößen ⇒ Man erhält die Anzahl Produkte, die es pro Größe gibt !

(parameterunabängige Sortierung)

• NodeCharacteristicID (aufsteigend)
• SortNo (aufsteigend)
• Value (aufsteigend)

(parameterunabängige Sortierung)

• NodeCharacteristicID (aufsteigend)
• SortNo (aufsteigend)
• Value (aufsteigend)

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

Unformatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/im_GetUsedValues_Pu?NodeCharacteristicID=<value>'

Mit xmllint ⁹⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/im_GetUsedValues_Pu?NodeCharacteristicID=<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_GetUsedValues_Pu',
		array(
			'NodeCharacteristicID' => <value>,
			// 'TreeNodeID' => 0,
			// 'MaxLevelNo' => 6,
			// 'BinaryCharacteristicValueID' => NULL,
			// 'Method' => NULL,
			// 'FilterByCharacteristicID' => NULL,
			// 'FilterByCharacValue' => NULL,
			// 'NegateFilterByParams' => 0,
			// 'IncludeNumberOfNodesInResult' => 0,
			// 'IDsInOneID' => 0,
			// 'CharacteristicIDList' => NULL,
			// 'GetValueDetails' => 0
		)
);
 
$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_GetUsedValues_Pu">
			<Parameters>
				<Parameter Name="NodeCharacteristicID"><!-- smallint value --></Parameter>
				<!-- <Parameter Name="TreeNodeID">0</Parameter> -->
				<!-- <Parameter Name="MaxLevelNo">6</Parameter> -->
				<!-- <Parameter Name="BinaryCharacteristicValueID">NULL</Parameter> -->
				<!-- <Parameter Name="Method">NULL</Parameter> -->
				<!-- <Parameter Name="FilterByCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="FilterByCharacValue">NULL</Parameter> -->
				<!-- <Parameter Name="NegateFilterByParams">0</Parameter> -->
				<!-- <Parameter Name="IncludeNumberOfNodesInResult">0</Parameter> -->
				<!-- <Parameter Name="IDsInOneID">0</Parameter> -->
				<!-- <Parameter Name="CharacteristicIDList">NULL</Parameter> -->
				<!-- <Parameter Name="GetValueDetails">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>