Mit dieser Prozedur ordnet man ein Merkmal einer Merkmal-Kategorie zu bzw. löscht eine bestehende Zuordnung.

Wichtige Hinweise :

1. Wenn zum angegebenen Merkmal (→ „PersonCharacteristicID“) in der Tabelle „PersonCharacteristics“ „Required = 1“ hinterlegt ist, dann muß in „PersonCharacsInCatgories“ ebenfalls „Required = 1“ gespeichert sein.
Beim Erstellen einer Zuordnung wird in diesem Fall „Required“ automatisch auf „1“ gesetzt, es gibt also keinen Fehler, falls „0“ übergeben wurde !

2 Eine Änderung des „Required“-Flags von „0“ auf „1“ setzt natürlich voraus, daß alle Personen, die Eigenschaften zu (wenigstens) einem Merkmal der Kategorie „PersonCharacCategoryID“ besitzen, auch eine Eigenschaft zu „PersonCharacteristicID“ haben. Falls nicht, gibt es den Fehler „-686“ !

3. Eine Änderung des „Required“-Flags von „1“ auf „0“ ist problemlos möglich, es sei denn es handelt sich bei „PersonCharacteristicID“ um ein Pflichtmerkmal („Required = 1“ in „PersonCharacteristics“) - es gibt dann den Fehler „-500“

4. Es darf pro Personen-Typ nur eine Merkmal-Kategorie geben, die Pflicht-Merkmale („Required = 1“ in „PersonCharacteristics“) enthält

5. Ein Merkmal darf einem Personen-Typ nur einmal zugewiesen werden, d.h. nur in einer Merkmal-Kategorie zu diesem Personen-Typ vorkommen

6. Gelöscht werden kann ein Merkmal aus einer Kategorie nur dann, wenn es nicht bereits eine Person des zur Kategorie gehörenden Personen-Typs gibt, die eine Eigenschaft zu diesem Merkmal besitzt.

7. Ein Merkmal kann einer Kategorie als Pflichtfeld („Required = 1“) nur dann zugewiesen werden, wenn nicht bereits eine Person (des der Kategorie entsprechenden Typs) existiert, die Eigenschaften zu bereits vorhandenen Merkmalen der Kategorie besitzt.

8. Ein Merkmal kann maximal von 31 Personen-Typen verwendet werden (Hintergrund ist „UsedByPersonType_Bitmap“ in „PersonCharacteristicValues“; diese „Bitmap“-Information wird intern von der Personen-Suche pm_GetPersons_Conditions_Ad verwendet, um schnell erkennen zu können, von welchem Personen-Typ eine Eigenschaft verwendet wird).

Anmerkungen zum Parameter „DefaultValue“ :

1.) Via „DefaultValue“ kann man einen Wert konfigurieren, der automatisch vergeben wird, wenn eine Person noch gar keine
Eigenschaft zu Merkmalen der Kategorie „PersonCharacCategoryID“ besitzt und dann Daten dieser Kategorie hinzugefügt oder Eigenschaften dieser Kategorie gelöscht werden.
Letzteres macht scheinbar keinen Sinn (da die Logik ja nur greift, wenn noch KEINE Eigenschaften vorhanden sind), es ist aber ein hilfreicher Trick, um zu ermöglichen, NUR „DefaultValues“ in einer Kategorie speichern zu lassen.

2.) Ein Default-Wert muß natürlich dem (durch die „FieldTypeID“ konfigurierten) Format aller Eigenschaften des Merkmals (→ „PersonCharacteristicID“) entsprechen. Man beachte in diesem Zusammenhang daher den Parameter „Country“.

3.) Zu einem „unique“-Merkmal kann KEIN (fester) „DefaultValue“ konfiguriert werden, und falls das Merkmal vordefinierte Werte besitzt, kann nur einer dieser vordefinierten Werte als „DefaultValue“ verwendet werden. Ausnahme bei „unique“-Merkmalen sind „Funktions-Werte“ (s. 4.)

4.) Es wird zwischen festen und dynamischen Default-Werten unterschieden. Dynamische Default-Werte können durch Verwendung von „Funktionen“ konfiguriert werden. Dazu muß „DefaultValue“ die Form „#<eine Funktion (s.u.)>#“ besitzen.
Anmerkung :
Möchte man „#<irgendwas>#“ als Default-Wert setzen, muß „##<irgendwas>##“ übergeben werden, wobei innerhalb von „<irgendwas>“ dann das „#“ wiederum nur einmal vorkommen braucht (sprich „##“ wird innerhalb von „<irgendwas>“ auch als „##“ interpretiert).
Erlaubte Funktionen sind :

• getdate()

⇒ Erzeugt das aktuelle Datum (ohne Uhrzeit) im Format mm.dd.yyyy

• gettime()

⇒ Erzeugt die aktuelle Uhrzeit im Format hh:mi:ss:mmm

• getdateandtime()

⇒ Erzeugt das aktuelle Datum inkl. aktueller Uhrzeit im Format mm.dd.yyyy hh:mi:ss:mmm

• randomstr(<strlength>,<opt. Prefix>,<opt. Postfix>)

⇒ Erzeugt einen zufälligen string der durch <strlength> angegebenen Länge (Zahl zwischen 1 und 50), wobei als Zeichen-Vorrat (0,..,9,a,..z,A,..Z) zugrunde liegt. Optional kann <opt. Prefix> vorangestellt und/oder <opt. Postfix> angehängt werden. Diese Parameter müssen jeweils einfach einen (auch durchaus leeren) string darstellen, der mit dem einfachan Anführungszeichen (') beginnen und enden muß !
Beispiele :
1.) #randomstr(20)#
⇒ Es wird eine zufällige Kette aus 20 Zeichen erzeugt
2.) #randomstr(20,'','_test')#
⇒ Es wird eine zufällige Kette aus 20 Zeichen erzeugt, an die „_test“ angehängt wird
3.) #randomstr(20,'GEN')#
⇒ Es wird eine zufällige Kette aus 20 Zeichen erzeugt, der „GEN“ vorangestellt wird
4.) #randomstr(20,'1,2')#
⇒ Es wird eine zufällige Kette aus 20 Zeichen erzeugt, der „1,2“ vorangestellt wird
5.) #randomstr(20,'1,2,', '3,4')#
⇒ Es wird eine zufällige Kette aus 20 Zeichen erzeugt, der „1,2,“ vorangestellt und and die „3,4“ angehängt wird

Die Datums-Funktionen sind natürlich nur erlaubt bei Merkmalen mit Datum als Basis-Feldtyp, die „randomstr“-Funktion darf nur bei Merkmalen mit Basis-Feldtyp „Text“ verwendet werden !

Hinweis :
Bei den Datums-Funktionen sind die zur Laufzeit generierten Werte für die zu verarbeitenden Personen (beim Import können es ja mehrere sein) identisch ! Im Gegensatz zur „randomstr“-Funktion : wenn beispielsweise drei Personen verarbeitet werden, findet auch dreimal ein entsprechender Funktions-Aufruf statt, so daß (ein ausreichender <strlength>-Wert vorausgesetzt) auch drei verschiedene Werte herauskommen.

Die Prozedur hat keine Rückgaben.

Die Prozedur hat keine Output-Parameter.

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:

• pm_ModifyPersonCharacsInCat_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyPersonCharacsInCat_Ad?PersonCharacCategoryID=<value>&PersonCharacteristicID=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyPersonCharacsInCat_Ad?PersonCharacCategoryID=<value>&PersonCharacteristicID=<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'),
	'pm_ModifyPersonCharacsInCat_Ad',
		array(
			'PersonCharacCategoryID' => <value>,
			'PersonCharacteristicID' => <value>,
			// 'Required' => 0,
			// 'Delete' => 0,
			// 'KeepPropertiesHistoryInDays' => NULL,
			// 'DefaultValue' => NULL,
			// 'Country' => 'german'
		)
);
 
$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="pm_ModifyPersonCharacsInCat_Ad">
			<Parameters>
				<Parameter Name="PersonCharacCategoryID"><!-- tinyint value --></Parameter>
				<Parameter Name="PersonCharacteristicID"><!-- smallint value --></Parameter>
				<!-- <Parameter Name="Required">0</Parameter> -->
				<!-- <Parameter Name="Delete">0</Parameter> -->
				<!-- <Parameter Name="KeepPropertiesHistoryInDays">NULL</Parameter> -->
				<!-- <Parameter Name="DefaultValue">NULL</Parameter> -->
				<!-- <Parameter Name="Country">'german'</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>