im_GetBinaryCodeIDsForNode_Pu [dstore]

Inhaltsverzeichnis

im_GetBinaryCodeIDsForNode_Pu

im_GetBinaryCodeIDsForNode_Pu

Liefert zu einem oder mehreren Artikel-Element(en) bzw. Element(en) des Artikelbaums die zugewiesenen „BinaryCodeID“s (IDs für „Binaries“).

Optional kann man sich nur „BinaryCodeID“s mit einer bestimmten bzw. mit irgendeiner Eigenschaft zu einem „Binary“-Merkmal ausgeben lassen. Daher ist es z.B. möglich, nur GIF-Dateien oder „Detailansichten“ eines Artikel-Elementes zu ermitteln.

HTTP-Method	GET
HTTP-Auth	Optional
Tags	[im, Get, Binary, Code, Ds, For, Node, Pu]
Engine-Kategorie	item management
Engine-Typ	Daten-Ermittlung
Letzte Aktualisierung	5.1.4 (2006-08-14)

Parameter

Name ¹⁾	Standard-Wert	Beschreibung ²⁾	SQL-Datentyp³⁾	ab Version
TreeNodeID		ID eines Artikel-Elementes („NodeID“ aus „dStore“) bzw. eines Elementes im Artikelbaum („TreeNodeID“ aus „TreeView“) - je nach „IsNodeID“. Wird „NULL“ angegeben erwartet die Prozedur IDs in „tempdb.dbo.OneID“.	integer	3.5.0
BinaryPropertyValueID	NULL	Optionale Angabe einer Eigenschaft, die das Binärobjekt besitzen soll	integer	3.5.0
IsNodeID	0	Bei dem durch „TreeNodeID“ angegebenen Element bzw. den in „tempdb.dbo.OneID“ angegebenen Elementen handelt es sich um… „0“ : … eine „TreeNodeID“ bzw. „TreeNodeID“s aus „TreeView“ „1“ : … eine „NodeID“ bzw. „NodeID“s aus „dStore“	bit	3.5.0
BinaryCharacteristicID	NULL	ID eines Merkmals für „Binaries“. Falls angegeben, werden nur die „BinaryCodeID“s berücksichtigt, die (irgend)eine Eigenschaft zu diesem Merkmal besitzen - diese Eigenschaft wird dann auch jeweils im Ergebnis ausgegeben.	tinyint	3.5.17

Rückgabe

wenn BinaryCharacteristicID = NULL

Spaltenname	Beschreibung	SQL-Datentyp⁴⁾	ab Version
BinaryCodeID	ID eines „Binaries“, das dem Element „TreeNodeID“ zugeordnet ist	integer	3.5.0
TreeNodeID	ID des zum übergebenen Element zugehörigen Elementes im Artikelbaum (da es prinzipiell möglich ist, daß es zu einer „NodeID“ MEHRERE „TreeNodeID“s gibt, steht hier im Fall „IsNodeID = 1“ die KLEINSTE zur „NodeID“ gehörige „TreeNodeID“)	integer	3.5.3
NodeID	ID des zum übergebenen Element zugehörigen Artikel-Elementes (falls „IsNodeID = 1“ ist, steht hier natürlich immer die übergebene „TreeNodeID“)	integer	3.5.3

Sortierungen der Rückgabe

wenn IsNodeID = 0

TreeNodeID (aufsteigend)

wenn IsNodeID = 1

NodeID (aufsteigend)

wenn BinaryCharacteristicID <> NULL

Spaltenname	Beschreibung	SQL-Datentyp⁵⁾	ab Version
BinaryCharacteristicID⁶⁾	In Version 4.0.5 entfernt	tinyint	3.5.17
BinaryCodeID	ID eines „Binaries“, das dem Element „TreeNodeID“ zugeordnet ist	integer	3.5.0
TreeNodeID	ID des zum übergebenen Element zugehörigen Elementes im Artikelbaum (da es prinzipiell möglich ist, daß es zu einer „NodeID“ MEHRERE „TreeNodeID“s gibt, steht hier im Fall „IsNodeID = 1“ die KLEINSTE zur „NodeID“ gehörige „TreeNodeID“)	integer	3.5.3
NodeID	ID des zum übergebenen Element zugehörigen Artikel-Elementes (falls „IsNodeID = 1“ ist, steht hier natürlich immer die übergebene „TreeNodeID“)	integer	3.5.3
BinaryPropertyValueID	ID der Eigenschaft der „BinaryCodeID“ zum Merkmal „BinaryCharacteristicID“. Sofern auch „BinaryPropertyValueID“ angegeben wurde, steht hier der Wert dieses Parameters.	integer	3.5.17
BinaryPropertyValue	Die Eigenschaft der „BinaryCodeID“ zum Merkmal „BinaryCharacteristicID“	varchar(250)	4.0.5

Sortierungen der Rückgabe

wenn IsNodeID = 0

TreeNodeID (aufsteigend)

wenn IsNodeID = 1

NodeID (aufsteigend)

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code	Beschreibung	Quelle ⁷⁾
-500	Falsche Parameter	nur direkt

XML-Schema

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

Historie

5.1.4	2006-08-14	Explizites „ORDER BY“ eingefügt, um die Sortierung der Rückgabemenge zu garantieren
4.0.5	2003-10-04	1. Fehler falls „TreeNodeID“ nicht „NULL“, „IsNodeID = 1“ und sowohl „BinaryPropertyValueID“ als auch „BinaryCharacteristicID“ „NULL“ waren 2. Rückgabespalte „BinaryCharacteristicID“ entfernt 3. Neue Rückgabespalte : „BinaryPropertyValue“
3.5.17	2002-05-02
3.5.16	2002-04-25
3.5.3	2001-02-11
3.5.0	2000-11-23	Erstmalig 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:

im_GetBinaryCodeIDsForNode_Pu im Engine Playground öffnen

cURL

Unformatierte Ausgabe:

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

Mit xmllint ⁸⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/im_GetBinaryCodeIDsForNode_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_GetBinaryCodeIDsForNode_Pu',
		array(
			'TreeNodeID' => <value>,
			// 'BinaryPropertyValueID' => NULL,
			// 'IsNodeID' => 0,
			// 'BinaryCharacteristicID' => NULL
		)
);
 
$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_GetBinaryCodeIDsForNode_Pu">
			<Parameters>
				<Parameter Name="TreeNodeID"><!-- integer value --></Parameter>
				<!-- <Parameter Name="BinaryPropertyValueID">NULL</Parameter> -->
				<!-- <Parameter Name="IsNodeID">0</Parameter> -->
				<!-- <Parameter Name="BinaryCharacteristicID">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>

¹⁾

Pflichtparameter sind unterstrichen

²⁾

siehe Parameter-Konventionen engine/<Prozedur-Name>

³⁾ , ⁴⁾ , ⁵⁾

siehe Datentypen im Bereich "engine"

⁶⁾

Spalte wird nicht zurückgegeben und ist hier nur aus Dokumentationsgründen aufgeführt.

⁷⁾

direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“

⁸⁾

I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Inhaltsverzeichnis