Benutzer-Werkzeuge

Webseiten-Werkzeuge


engine:procedures:im_insertnewnode_ad

im_InsertNewNode_Ad

Fügt ein neues Element in den Artikelbaum ein oder kopiert bzw. „clone“d ein Element (evtl. mit Nachfolger-Elementen) an eine Stelle des Artikelbaums.

Die Bezeichnung des zugehörigen neuen Artikel-Elementes („NodeID“) kann durch „NodeDescription“ (immer in der Standardsprache) angegeben werden. Falls ein Element kopiert bzw. ge„clone“d wird, hat dieser Parameter keine Bedeutung.

Soll eine Kopie oder ein Clone eines anderen Elementes des Artikelbaums angelegt werden, sind entsprechend die Parameter „ModelNode“ und „Clone“ zu setzen, wobei „IncludeSubNodes“ angibt, ob dabei auch die Nachfolger von „ModelNode“ kopiert bzw. ge„clone“d werden sollen.

ACHTUNG : Das Erstellen von „Clone“s ist derzeit NOCH NICHT IMPLEMENTIERT !!!

Eine Hierarchie („LevelID“) braucht nur angegeben zu werden, falls das neu anzulegende Element NICHT auf einer um
eins niedrigeren Hierarchie-Stufe als sein Vorgänger sein soll.

Die ID des neuen Elementes im Artikelbaum („TreeNodeID“) und die des neuen Artikel-Elementes („NodeID“) werden über zwei entsprechende Ausgabeparameter zurückgegeben.

Falls ein neues Element auf der Produkt-Hierarchie (siehe „Settings“-Eintrag zum Schlüssel „ProductLevelID“) angelegt wird, bekommt es automatisch die gleichen Templates zugewiesen, wie ein „Nachbar“-Element (das ist ein Produkt-Element mit dem gleichen Vorgänger) oder aber (falls es kein benachbartes Element gibt) das „Default“-Template der Produkt-Hierachie.

Wird ein NEUES Element angelegt, das sich auf der Produkt-Hierarchie („ProductLevelID“ in „Settings“) oder der Varianten-Hierarchie (per Definition die größte „LevelNo“ in „Levels“) befindet, wird automatisch eine Produktbezeichnung in der Standardsprache eingefügt.

Anmerkungen:

1. Das Merkmal für die Produktbezeichnung in einer Sprache ist DERZEIT das Merkmal, dessen Bezeichnung mit „Produktbez“ beginnt und die entsprechende „ValueLanguageID“ besitzt. Dies wird irgendwann einmal geändert werden (über eine separate Tabelle wahrscheinlich), da es wenig Sinn macht, z.B. das Merkmal für die französische Produktbezeichnung mit „Produktbez…“ zu bezeichnen…

2. Die Produktbezeichnungen werden derzeit nach folgendem Muster generiert :

Für Produkte…
<Bezeichnung („NodeDescription“) des Vorgängers> + ' „' + <Bezeichnung („NodeDescription“) des Produkt-Elementes> + '“'

Für Varianten…
<Produktbezeichnung des Produkt-Vorgängers> + ' ' + <Bezeichnung („NodeDescription“) des Varianten-Elementes>

HTTP-MethodPOST
HTTP-AuthOptional
Tags
Engine-Kategorieitem management
Engine-TypDaten-Änderung
Letzte Aktualisierung7.0.7 (2015-01-29)

Parameter

Name 1) Standard-Wert Beschreibung 2) SQL-Datentyp3) ab Version
Predecessor ID eines Elementes im Artikelbaum, unter dem ein neues Element angelegt werden soll
integer3.5.0
NodeDescription Bezeichnung des neuen Artikel-Elementes
varchar(100)3.5.0
LevelIDNULL Angabe einer ID einer Hierarchiestufe, auf der das neue Element liegen soll. Wenn „NULL“ angegeben ist, wählt die Prozedur automatisch die nächst niedrigere Hierarchie nach der Hierarchie des zu „Predecessor“ korrespondierenden Artikel-Elementes.
tinyint3.5.0
ModelNodeNULL Falls das neue Element von einem anderen Element ge„clone“d oder kopiert werden soll (→ „Clone“), gibt man hier die entsprechende „TreeNodeID“ an. ACHTUNG: Das „Cloning“ ist derzeit noch nicht implementiert !
integer3.5.0
Clone0 Wird nur beachtet, falls in „ModelNode“ ein Element des Artikelbaums angegeben ist !
„0“ : „ModelNode“ wird kopiert
„1“ : „ModelNode“ wird ge„clone“d (ACHTUNG ! Derzeit noch nicht implementiert !!!)
bit3.5.0
IncludeSubNodes1 Wird nur beachtet, falls in „ModelNode“ ein Element des Artikelbaums angegeben ist !
„0“ : Es wird nur das Element „ModelNode“ selbst ge„clone“d bzw. kopiert
„1“ : Auch die Elemente unterhalb von „ModelNode“ werden mitkopiert bzw. mitge„clone“d
bit3.5.0

Rückgabe

Die Prozedur hat keine Rückgaben.

Output-Parameter

NewNodeIDAusgabeparameter für die ID des neuen Artikel-Elementes
NewTreeNodeIDAusgabeparameter für die ID des neuen Elementes im Artikelbaum

Mögliche Return-Codes

Code Beschreibung Quelle 4)
-621Fehlender oder falscher Eintrag in PersonTypeSettingsnur indirekt
-599Lizenz ist ungültig oder abgelaufennur indirekt
-569Der Benutzer hat kein Ausführungsrecht für die Prozedurnur indirekt
-567Die Prozedur darf z. Zt. nicht ausgeführt werdennur indirekt
-566Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werdennur indirekt
-550Fehlender oder falscher Eintrag in Settingsnur indirekt
-540Falsches Formatnur indirekt
-535Das Datum liegt nicht in der Vergangenheitnur indirekt
-530Der Wert ist nicht konvertierbarnur indirekt
-510Der Benutzer ist nicht registriertnur indirekt
-504Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochennur indirekt
-503Fehlerhafte Daten in einer Tabelle - genauere Fehlermeldung auf der Standardausgabenur indirekt
-502Die Parameter-Werte der Prozedur können nicht verarbeitet werden (kein passendes Trennzeichen)nur indirekt
-500Falsche Parameternur indirekt
-285Der Benutzer hat keine Berechtigung, vergangene Eigenschaften zu diesem(n) Merkmal(en) zu ändernnur indirekt
-284Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu modifizierennur indirekt
-245Einige Artikel-Eigenschaften sind ungültignur indirekt
-242Relative Änderung nicht möglich, da es eine Eigenschaft gibt, deren Gültigkeit in d. Zukunft beginntnur indirekt
-241Änderung(en) der Eigenschaft(en) konnte(n) aufgrund paralleler Änderungen nicht durchgeführt werdennur indirekt
-220Es konnte keine Merkmal-ID für die Produktbezeichnung ermittelt werdennur indirekt
-190Ein Element auf der niedrigsten Hierarchiestufe kann keine Nachfolger habennur indirekt
-180Falsche Hierarchie : Ein Element muß immer eine niedrigere Hierarchiestufe als sein Vorgänger habennur indirekt
-120Der Benutzer hat keine Berechtigung für das (die) Element(e)nur indirekt
-110Das (die) Element(e) ist (sind) nicht vorhandennur indirekt

XML-Schema

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

Historie

7.0.7 2015-01-29Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf]
6.5.4 2013-04-29Anpassungen an aktuellen Code-Standard
6.5.3 2013-03-18Anpassungen an aktuellen Code-Standard, u.a. wg. UTF8-Unterstützung
5.1.0 2006-02-08Verlagerung des Codes in die neuen Prozeduren „_im_InsertNewNode“ und „_im_CopyNode“
4.0.15 2004-07-301. Beim Anlegen eines neuen Elementes unterhalb von „root“ wurde bisher auch die „SortNo“ von „root“ immer erhöht
2. Bei der Überarbeitung in Version 4.0.11 entstand ein Fehler bzgl. einer temporären Tabelle
4.0.11 2004-03-311. „_mi_StartProcedure“, „_mi_FinishProcedure“ u. „_mi_ChooseParamValueSeperator“ sowie mi_GetSettingEntry
2. „set transaction isolation level 1“, „set rowcount 0“ zu Beginn
3. Konsequente Fehlerbehandlung
4. Fehlende Index-Angaben
4.0.1 2003-05-16Ab jetzt wird berücksichtigt, daß in „NodeProperties“ auch Gültigkeitszeiträume in der Zukunft vorhanden sein können !
3.5.20 2002-07-22
3.5.19 2002-06-17
3.5.14 2002-01-23
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_InsertNewNode_Ad?Predecessor=<value>&NodeDescription=<value>'

Mit xmllint 5) formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_InsertNewNode_Ad?Predecessor=<value>&NodeDescription=<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_InsertNewNode_Ad',
		array(
			'Predecessor' => <value>,
			'NodeDescription' => '<value>',
			// 'LevelID' => NULL,
			// 'ModelNode' => NULL,
			// 'Clone' => 0,
			// 'IncludeSubNodes' => 1
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();
 
$OutputParams = $xml_result->getOutputParametersAsArray();
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_InsertNewNode_Ad">
			<Parameters>
				<Parameter Name="Predecessor"><!-- integer value --></Parameter>
				<Parameter Name="NodeDescription"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="LevelID">NULL</Parameter> -->
				<!-- <Parameter Name="ModelNode">NULL</Parameter> -->
				<!-- <Parameter Name="Clone">0</Parameter> -->
				<!-- <Parameter Name="IncludeSubNodes">1</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>
1)
Pflichtparameter sind unterstrichen
4)
direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“
5)
I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org
engine/procedures/im_insertnewnode_ad.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)