Prozedur, um Posting-Merkmale (zu denen Foren-Beiträge Eigenschaften haben können) zu verwalten.

Grundsätzliches zu Posting-Eigenschaften :
1. Eigenschaften eines Beitrags sind immer an eine „PersonID“ gebunden. Dies bedeutet, daß eine Eigenschaft entweder „allgemein“ gültigt ist - nämlich wenn „PersonID = 0“ ist - oder die Eigenschaft hat nur Gültigkeit für die durch „PersonID“ angegebene Person. Pro Merkmal ist durch das sogenannte „CommonCharacteristic“-Flag (s. gleichnamiger Parameter dieser Prozedur) konfiguriert, ob

• nur
• auch
• keine

allgemeine(n) Eigenschaften hinterlegt werden können.
2. Genau wie im „Item-“ und „Person-Management“ gehören Eigenschaften immer zu einem Merkmal - Merkmale charakterisieren sozusagen die Eigenschaften.
Wenn für das zugehörige Forum eines Beitrags mindestens ein Merkmal zugeordnet ist (→ fo_ModifyCharacsForForums_Ad), können diesem Beitrag ausschließlich Eigenschaften zu Merkmalen hinzugefügt werden, die dem Forum zugeordnet sind.
3. Sind dem Forum eines Beitrags direkt KEINE Merkmale zugeordnet (→ fo_ModifyCharacsForForums_Ad), können diesem Beitrag ausschließlich Eigenschaften zu Merkmalen hinzugefügt werden, die wenigestens einer Kategorie, in die das Forum DIREKT eingeordnet ist, zugeordnet sind (→ fo_ModifyCharacForForumCats_Ad).

Anmerkungen :
1. „PostingCharacteristicID“s unter 50 sind für interne Zwecke vom „dStore“ reserviert. Diese können derzeit nicht geändert oder gelöscht werden, und neue Merkmale erhalten daher immer eine ID größer als „50“.
2. Wenn versucht wird, ein neues Merkmal mit einem „Ja-Nein“-Basisfeldtyp anzulegen, wird in jedem Fall „PredefinedValues“ und „MaxNumberOfProperties“ auf „1“ gesetzt und dafür gesorgt, daß zwei Eigenschaften „0“ und „1“ zu dem neuen Merkmal angelegt werden.
3. Im Falle von Änderungen gibt es einige Dinge zu beachten :
a) Änderungen der „FieldTypeID“, wenn die zugehörige „BasicFieldTypeID“ ANDERS ist oder aber die Länge oder Genauigkeit ERNIEDRIGT wird, können NICHT vorgenommen werden. Ausnahme : Alle Eigenschaften erfüllen die neuen Bedingungen.
Ein Wechsel des Basis-Feldtyps ist aber grundsätzlich verboten, wenn es in einer aktiven oder gerade in der Initialisierung befindlichen Sortierung von Hauptbeiträgen (s. fo_GetMainPostSortCriteria_Ad) verwendet wird !
b) Änderungen des „CommonCharacteristic“-Flags können nur vorgenommen werden, wenn sie nicht mit bestehenden Eigenschaften kollidieren
c) Änderungen von „MaxNumberOfProperties“ hängen natürlich ebenfalls von bestehenden Eigenschaften ab (Erhöhungen gehen immer, Erniedrigungen bedingt)
d) Bei einigen Änderungen müssen evtl. vorhandene Eigenschaften überprüft werden, was etwas Zeit in Anspruch nehmen kann !
4. Wird das Merkmal in einer aktiven oder gerade in der Initialisierung befindlichen Sortierung von Hauptbeiträgen (s. fo_GetMainPostSortCriteria_Ad) verwendet, ist das Löschen grundsätzlich verboten !

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:

• fo_ModifyPostingCharacs_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

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

Mit xmllint ²⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/fo_ModifyPostingCharacs_Ad?CharacteristicDescription=<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'),
	'fo_ModifyPostingCharacs_Ad',
		array(
			'CharacteristicDescription' => '<value>',
			'FieldTypeID' => <value>,
			// 'PropertyModificationAllowed' => 7,
			// 'CommonCharacteristic' => 1,
			// 'PredefinedValues' => 0,
			// 'CheckPostingVisibility' => 0,
			// 'MaxNumberOfProperties' => NULL,
			// 'DeleteCharacteristic' => 0
		)
);
 
$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="fo_ModifyPostingCharacs_Ad">
			<Parameters>
				<Parameter Name="CharacteristicDescription"><!-- varchar value --></Parameter>
				<Parameter Name="FieldTypeID"><!-- tinyint value --></Parameter>
				<!-- <Parameter Name="PropertyModificationAllowed">7</Parameter> -->
				<!-- <Parameter Name="CommonCharacteristic">1</Parameter> -->
				<!-- <Parameter Name="PredefinedValues">0</Parameter> -->
				<!-- <Parameter Name="CheckPostingVisibility">0</Parameter> -->
				<!-- <Parameter Name="MaxNumberOfProperties">NULL</Parameter> -->
				<!-- <Parameter Name="DeleteCharacteristic">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>