Prozedur für eine „unscharfe“ Suche von aktiven (und falls gewünscht auch inaktiven) Elementen innerhalb eines Bereichs: es werden die Elemente des Artikelbaums gesucht, die KEINE oder IRGENDEINE Eigenschaft zu einem bestimmten Merkmal haben.

Zusätzlich kann man eine Hierarchie angeben, auf der die Elemente sein müssen.

Desweitern kann optional eine Eigenschaft angegeben werden („FilterByCharacteristicID“ und „FilterByCharacValue“), die die Elemente zusätzlich haben müssen (es wird keine Vererbung gerücksichtigt !!), d.h. alle Artikel-Elemente, die diese Eigenschaft NICHT haben, sind NICHT in der Ergebnismenge. Setzt man „NegateFilterByParams“ auf „1“, sind NUR Elemente, die diese Eigenschaft NICHT haben, in der Ergebnismenge.

Wie gewohnt kann man sich mit Hilfe von „StartAtRowNo“ und „RowCount“ durch das Ergebnis „blättern“. Um alle Datensätze zu bekommen, gibt man „RowCount = 0“ an.

Die Parameter „FromDate“ und „ToDate“ bedeuten je nach Belegung folgendes :

1.) „FromDate“ UND „ToDate“ sind „NULL“ : Suche Elemente, die keine oder irgendeine Eigenschaft zum AKTUELLEN ZEITPUNKT (des Aufrufs der Prozedur) haben
2.) „FromDate“ is angegeben, „ToDate“ ist „NULL“ : Suche Elemente, die keine oder irgendeine Eigenschaft SEIT dem durch „FromDate“ angegebenen Zeitpunkt haben.
3.) „FromDate“ ist „NULL“, „ToDate“ is angegeben : Suche Elemente, die keine oder irgendeine Eigenschaft BIS zum durch „ToDate“ angegebenen Zeitpunkt haben.
4.) Sowohl „FromDate“ als auch „ToDate“ sind angegeben : Suche Elemente, die keine oder irgendeine Eigenschaft im angegebenen Zeitraum haben.
Sonderfall : „FromDate“ und „ToDate“ sind identisch ⇒ Suche Elemente, die keine oder irgendeine Eigenschaft ZUM angegebenen ZEITPUNKT haben.

Anmerkung : „FromDate < ToDate“ ist natürlich NICHT erlaubt.

wenn RowCount = 0

• PrePredecessorsTreeNodeID (aufsteigend)
• PredecessorSortNo (absteigend)
• SortNo (absteigend)

wenn RowCount > 0

• TreeNodeID (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_FuzzySearch_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

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

Mit xmllint ⁹⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_FuzzySearch_Ad?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_FuzzySearch_Ad',
		array(
			'NodeCharacteristicID' => <value>,
			// 'FuzzyType' => 0,
			// 'IncludeInactiveNodes' => 0,
			// 'FromDate' => NULL,
			// 'ToDate' => NULL,
			// 'LevelID' => NULL,
			// 'DomainTreeNodeID' => NULL,
			// 'FilterByCharacteristicID' => NULL,
			// 'FilterByCharacValue' => NULL,
			// 'StartAtRowNo' => 1,
			// 'RowCount' => 100,
			// 'NegateFilterByParams' => 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_FuzzySearch_Ad">
			<Parameters>
				<Parameter Name="NodeCharacteristicID"><!-- smallint value --></Parameter>
				<!-- <Parameter Name="FuzzyType">0</Parameter> -->
				<!-- <Parameter Name="IncludeInactiveNodes">0</Parameter> -->
				<!-- <Parameter Name="FromDate">NULL</Parameter> -->
				<!-- <Parameter Name="ToDate">NULL</Parameter> -->
				<!-- <Parameter Name="LevelID">NULL</Parameter> -->
				<!-- <Parameter Name="DomainTreeNodeID">NULL</Parameter> -->
				<!-- <Parameter Name="FilterByCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="FilterByCharacValue">NULL</Parameter> -->
				<!-- <Parameter Name="StartAtRowNo">1</Parameter> -->
				<!-- <Parameter Name="RowCount">100</Parameter> -->
				<!-- <Parameter Name="NegateFilterByParams">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>