Benutzer-Werkzeuge

Webseiten-Werkzeuge


engine:procedures:im_traversetreeview_pu

im_TraverseTreeView_Pu

Zu einem gegebenen Element des Artikelbaums wird das (nächste oder vorhergehende) benachbarte Element (auf Wunsch nur auf einer bestimmten Hierarchie) zurückgegeben.

Optional kann man auch nur einen Teilbaum „traversieren“.

HTTP-MethodPOST
HTTP-AuthOptional
Tags
Engine-Kategorieitem management
Engine-TypDaten-Ermittlung
Letzte Aktualisierung3.5.0 (2000-11-23)

Parameter

Name 1) Standard-Wert Beschreibung 2) SQL-Datentyp3) ab Version
TreeNodeID ID eines Elementes im Artikelbaum, zu dem das (vorhergehende bzw. nächste) Nachbar-Element ermittelt werden soll
integer3.5.0
Next1 „0“ : Das vorhergehende Nachbar-Element suchen
„1“ : Das nächste benachbarte Element ermitteln
bit3.5.0
LevelNoNULL Nummer einer Hierarchie, auf der das Nachbar-Element liegen muß
tinyint3.5.0
DomainTreeNodeID0 ID eines Elementes im Artikelbaum. Es wird dann nur der Teilbaum „traversiert“, der dieses Element als Wurzel hat.
integer3.5.0

Rückgabe

(parameterunabhängig)

Spaltenname Beschreibung SQL-Datentyp4) ab Version
ResultTreeNodeIDID des benachbarten Elementes von „TreeNodeID“. „-1“, falls keines gefunden wurde.
integer3.5.0

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code Beschreibung Quelle 5)
-510Der Benutzer ist nicht registriertnur indirekt
-500Falsche Parameternur indirekt
-120Der Benutzer hat keine Berechtigung für das (die) Element(e)nur indirekt

XML-Schema

Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.

Historie

3.5.0 2000-11-23Erstmalig in dieser Version erstellt

Code-Snippets

Engine Playground

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

cURL

Unformatierte Ausgabe:

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

Mit xmllint 6) formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_TraverseTreeView_Pu?TreeNodeID=<value>' | xmllint --format -
dStore_php
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_TraverseTreeView_Pu',
		array(
			'TreeNodeID' => <value>,
			// 'Next' => 1,
			// 'LevelNo' => NULL,
			// 'DomainTreeNodeID' => 0
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();
engine/execute

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_TraverseTreeView_Pu">
			<Parameters>
				<Parameter Name="TreeNodeID"><!-- integer value --></Parameter>
				<!-- <Parameter Name="Next">1</Parameter> -->
				<!-- <Parameter Name="LevelNo">NULL</Parameter> -->
				<!-- <Parameter Name="DomainTreeNodeID">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>
1)
Pflichtparameter sind unterstrichen
5)
direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“
6)
I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org
engine/procedures/im_traversetreeview_pu.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)