Gibt im „dStore“ definierte Merkmale zurück, zu denen Artikel-Elemente Eigenschaften besitzen können.
HTTP-Method | GET |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | item management |
Engine-Typ | Daten-Ermittlung |
Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
---|---|---|---|---|
NodeCharacteristicID | NULL | ID eines Merkmals, nach der das Ergebnis eingeschränkt werden soll - falls „NULL“ angegeben ist, werden ALLE Merkmale ermittelt | smallint | 5.1.2 |
LanguageIDForCharacDescript | NULL | ID einer Sprache. Falls angegeben, wird versucht für die Merkmal-Bezeichnung (s. Rückgabespalte „CharacteristicDescription“) eine Übersetzung in dieser Sprache zu finden. | tinyint | 5.1.2 |
NodeCharacCategoryID | NULL | Wird nur beachtet, wenn „NodeCharacteristicID = NULL“ ist ! ID einer Kategorie (mögliche Werte : s. im_GetNodeCharacCategories_Ad). Falls angegeben, werden nur die Merkmale ermittelt, die dieser Kategorie zugeordnet sind. | smallint | 7.0.2 |
OrderBySortNo | 0 | Bestimmt, wie die Rückgabemenge sortiert ist : - „0“ : aufsteigend nach „CharacteristicDescription“ - „1“ : absteigend nach „SortNo“ | bit | 7.0.2 |
Spaltenname | Beschreibung | SQL-Datentyp4) | ab Version |
---|---|---|---|
NodeCharacteristicID | ID eines Merkmals, zu dem Artikel-Elemente Eigenschaften haben können | smallint | 5.1.2 |
CharacteristicDescription | Bezeichnung des Merkmals „NodeCharacteristicID“ in der durch „LanguageIDForCharacDescript“ angegebenen Sprache bzw. (falls keine Übersetzung vorhanden ist oder für den Parameter „NULL“ angegeben wurde) in der Standardsprache | varchar(100) | 5.1.2 |
ValueLanguageID | ID einer Sprache, in der alle Eigenschaften des Merkmals „NodeCharacteristicID“ angegeben sind | tinyint | 5.1.2 |
UnitID | ID einer Einheit, in der alle Eigenschaften des Merkmals „NodeCharacteristicID“ sind | tinyint | 5.1.2 |
PredefinedValues | Hat das Merkmal „NodeCharacteristicID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ? | bit | 5.1.2 |
SortNo | Bestimmt die Reihenfolge des Merkmals „NodeCharacteristicID“ innerhalb aller Merkmale | smallint | 5.1.2 |
FieldTypeID | ID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „NodeCharacteristicID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“) | tinyint | 5.1.2 |
Recursive | Handelt es sich um ein rekursives Merkmal ? Rekursive Merkmale sind immer vordefiniert und haben als Eigenschaften „NodeCharacteristicID“s. (Beispiel ist der „Verkaufspreis“) | bit | 5.1.2 |
wenn OrderBySortNo = 0
wenn OrderBySortNo = 1
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 5) |
---|---|---|
-621 | Fehlender oder falscher Eintrag in PersonTypeSettings | nur indirekt |
-569 | Der Benutzer hat kein Ausführungsrecht für die Prozedur | nur indirekt |
-567 | Die Prozedur darf z. Zt. nicht ausgeführt werden | nur indirekt |
-566 | Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werden | nur indirekt |
-550 | Fehlender oder falscher Eintrag in Settings | nur indirekt |
-535 | Das Datum liegt nicht in der Vergangenheit | nur indirekt |
-530 | Der Wert ist nicht konvertierbar | nur indirekt |
-510 | Der Benutzer ist nicht registriert | nur indirekt |
-504 | Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochen | nur indirekt |
-500 | Falsche Parameter | nur indirekt |
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
7.0.7 | 2015-01-29 | „Start-/Finish-Procedure“-Logik eingebaut, s. Ticket #3670 |
7.0.2 | 2013-08-29 | 1. Neue Parameter „NodeCharacCategoryID“ und „OrderBySortNo“ 2. Anpassungen des Quellcodes an den aktuellen Standard |
5.1.2 | 2006-06-26 | Erstmalig in dieser Version erstellt |
Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:
Unformatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/im_GetNodeCharacteristics_Pu'
Mit xmllint 6) formatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/im_GetNodeCharacteristics_Pu' | 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_GetNodeCharacteristics_Pu', array( // 'NodeCharacteristicID' => NULL, // 'LanguageIDForCharacDescript' => NULL, // 'NodeCharacCategoryID' => NULL, // 'OrderBySortNo' => 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_GetNodeCharacteristics_Pu"> <Parameters> <!-- <Parameter Name="NodeCharacteristicID">NULL</Parameter> --> <!-- <Parameter Name="LanguageIDForCharacDescript">NULL</Parameter> --> <!-- <Parameter Name="NodeCharacCategoryID">NULL</Parameter> --> <!-- <Parameter Name="OrderBySortNo">0</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>