Legt ein neues Merkmal an bzw. modifiziert es. Gelöscht werden können natürlich nur Merkmale, die explizit als löschbar („Deletable = 1“) angegeben sind.

Alle Merkmale, die über diese Prozedur angelegt werden, sind löschbar, d.h. „Deletable“ wird automatisch auf „1“ gesetzt.

Das Löschen eines Merkmals schlägt fehl, wenn Eigenschaften zu diesem Merkmal in „NodeProperties“ vorhanden sind. Das gilt auch, wenn die MerkmalID eine Eigenschaft zu einem rekursiven Merkmal ist, die von einem Element verwendet wird.
Ab 5.0.2 werden vor dem Löschen evtl. vorhandene Werte in „NodeCharacteristicValues“ (z.B. weil für das Merkmal „PredefinedValues = 1“ konfiguriert war) entfernt (sofern nicht in „NodeProperties“ verwendet), um einen „trigger“-Fehler zu vermeiden.

Wenn versucht wird, ein neues Merkmal mit einem „Ja-Nein“-Basisfeldtyp anzulegen, wird in jedem Fall „PredefinedValues“ auf „1“ gesetzt und dafür gesorgt, daß zwei Eigenschaften „0“ und „1“ zu dem neuen Merkmal angelegt werden.

Eine Änderung des „Feld-Typs“ (→ Parameter „FieldTypeID“) ist nur möglich, wenn …

• der Basis-Feldtyp gleich geblieben ist und „Length“ und/oder „Precision“ nicht verkürzt werden bzw. falls keine Eigenschaften existieren, die nicht der neuen Länge und Genauigkeit entsprechen oder wenn …
• vom Basis-Feldtyp „Zahl“ bzw. „Datum“ auf den Basis-Feldtyp „Text“ gewechselt wird und alle Eigenschaften von der Länge her

in einen „string“ konvertiert werden können (d.h. die maximal erlaubte Anzahl Zeichen beim neuen Feldtyp von bestehenden
Daten nicht überschritten wird)

Anmerkungen:

1. Es ist derzeit nicht möglich, die Einstellung „Recursive“ auf „1“ zu setzen oder zu ändern („Recursive“ wird quasi nicht beachtet; wenn beim Anlegen einens neuen Merkmals „1“ übergeben wird, gibt die Prozedur „-500“ zurück !).
2. Die „UnitID“ eines bestehenden Merkmals kann nicht geändert werden !
3. Die „PredefinedValues“-Einstellung kann problemlos von „1“ auf „0“ geändert werden. Umgekehrt ist das nur dann erlaubt, wenn zum Merkmal nicht schon mehr als 100 Werte existieren. Dieses Limit kann aber durch den „Settings“-Eintrag „MaxNumberOfValuesAllowedForPredefinedConfigChange“ erhöht werden (auf maximal 32767).
4. Wird bei Neu-Anlage eines Merkmals als Einheit eine „Währung“ ausgewählt, muß zu dieser Einheit unbedingt ein „UnitSymbol“ hinterlegt sein (sonst gibt es den Fehler „-531“) !
5. Die IDs „⇐ 50“ sind für interne Zwecke reserviert. Neue Merkmale haben daher automatisch eine ID „> 50“.
6. Bei internen Merkmalen (IDs „⇐ 50“) kann sowohl die Bezeichnung als auch der „Feld-Typ“ (unter den oben stehenden Bedingungen) geändert werden, was an der internen Funktionalität, die an das Merkmals geknüpft wurde, aber nichts ändert.
⇒ Daher sind diese Änderungen mit Vorsicht zu geniessen ! Insbesondere sollte eine neue Bezeichnung nicht sinnentfremdend sein !

Die Prozedur hat keine Rückgaben.

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_ModifyNodeCharacs_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_ModifyNodeCharacs_Ad?CharacteristicDescription=<value>&ValueLanguageID=<value>&UnitID=<value>&FieldTypeID=<value>'

Mit xmllint ²⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_ModifyNodeCharacs_Ad?CharacteristicDescription=<value>&ValueLanguageID=<value>&UnitID=<value>&FieldTypeID=<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_ModifyNodeCharacs_Ad',
		array(
			'CharacteristicDescription' => '<value>',
			'ValueLanguageID' => <value>,
			'UnitID' => <value>,
			'FieldTypeID' => <value>,
			// 'PredefinedValues' => 0,
			// 'SortNo' => 1,
			// 'Recursive' => 0,
			// 'DeleteCharacteristic' => 0,
			// 'KeepPropertiesHistoryInHours' => NULL
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();
 
$OutputParams = $xml_result->getOutputParametersAsArray();

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_ModifyNodeCharacs_Ad">
			<Parameters>
				<Parameter Name="CharacteristicDescription"><!-- varchar value --></Parameter>
				<Parameter Name="ValueLanguageID"><!-- tinyint value --></Parameter>
				<Parameter Name="UnitID"><!-- tinyint value --></Parameter>
				<Parameter Name="FieldTypeID"><!-- tinyint value --></Parameter>
				<!-- <Parameter Name="PredefinedValues">0</Parameter> -->
				<!-- <Parameter Name="SortNo">1</Parameter> -->
				<!-- <Parameter Name="Recursive">0</Parameter> -->
				<!-- <Parameter Name="DeleteCharacteristic">0</Parameter> -->
				<!-- <Parameter Name="KeepPropertiesHistoryInHours">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>