Prozedur zur Verwaltung von vordefinierten Eigenschaften bzw. von Übersetzungen von vordefinierten Eigenschaften zu einem Personen-Merkmal.

Allgemeiner Hinweis :

Existiert „ValueID“ und ist diese ID bereits einer Person zugewiesen, darf der Wert NICHT mehr geändert werden, wohl aber die „SortNo“ ! Die „PersonCharacteristicID“ kann grundsätzlich nachträglich NICHT mehr geändert werden !

Anmerkungen zu den Parametern „TableID“ und „TableKeyID“ :

1. Möchte man einen neuen (oder geänderten) Wert einem anderen Wert einer anderen Tabelle zuordnen, kann man durch die Angabe von „TableID“ und „TableKeyID“ quasi einen Datensatz in einer anderen Tabelle referenzieren. Beispielsweise kann man so ein Merkmal der Art „Bevorzugte Währung“ erstellen, dessen vordefinierte Werte „Währungs-Namen“ sind, und denen jeweils eine entsprechende „UnitID“ (die der Kategorie „Währung angehört) aus „Units“ zugeordnet ist.

2. Mögliche Werte für „TableID“ : siehe Rückgabespalte „TableID“ der Ergebnismenge des Aufrufs
„exec mi_GetTabsRefInOtherTabs_Ad UsedInPersonCharacValueRefs = 1“
„TableKeyID“ muß dann ein Wert aus der entsprechenden Tabelle sein, der in der durch „PrimaryKeyColumnName“ angegebenen Spalte dieser Tabelle vorkommt.

3. Einem vordefinierten Wert können MEHRERE (aber zu unterschiedlichen „TableID“s !) „Referenzen“ hinterlegt werden.

4.Übergibt man „NULL“ für „TableID“ und ÄNDERT man den vordefinierten Wert selbst (d.h. ist „Value“ ANDERS), werden sämtliche „Referenzen“ gelöscht, es sei denn „KeepReferencesIfValueChanges“ ist mit „1“ belegt (in diesem Fall werden die Parameter „TableID“ und „TableKeyID“ einfach ignoriert) !
Wird jedoch nur die „SortNo“ geändert (entspricht „Value“ also bereits dem alten Wert), und hat man „NULL“ für „TableID“ angegeben, wird eine evtl. vorhandene „Referenz“ jedoch NICHT gelöscht (genauer wird nichts weiter getan außer die „SortNo“ zu ändern) !

5. Um das Löschen aller oder bestimmter „Referenzen“ explizit zu steuern, ist der Parameter „DeleteTableKeyReference“ auf „1“ zu setzen. Ist „TableID“ dann „NULL“, werden ALLE evtl. vorhandenen „Referenzen“ gelöscht, ansonsten nur die angegebene (da es pro „TableID“ nur eine „Referenz“ geben kann, wir „TableKeyID“ ignoriert, d.h. es spielt keine Rolle, was dort angegeben ist).

6. Falls „LanguageID“ angegeben (also weder „0“ oder „NULL“) ist, werden die Parameter „TableID“, „TableKeyID“, „KeepReferencesIfValueChanges“ und „DeleteTableKeyReference“ ignoriert !

Anmerkung zum Parameter „PersonCharacteristicID“ :

Soll ein neuer Wert hinzugefügt oder ein bestehender Wert geändert werden, gibt es noch eine Besonderheit :

Handelt es sich bei „PersonCharacteristicID“ um ein Merkmal, das in „PersonTypeSettings“ zum Schlüssel „CountryCharacteristicID“ konfiguriert ist oder um die ID „15“, wird überprüft, ob es auch einen entsprechenden Eintrag in „Countries“ gibt ! „Entsprechend“ bedeutet in diesem Fall, daß es eine „CountryDescription“ geben muß, die mit „Value“ übereinstimmt.

Möchte man eine andere Schreibweise des Landes, gibt es aber noch die Möglichkeit, „TableID = 8“ anzugeben und in „TableKeyID“ die entsprechende „CountryID“ zu übergeben. Klar formuliert : Sobald „TableID“ angegeben ist, wird die Referenz über „TableKeyID“ überprüft, und nur, falls „TableID = NULL“ ist, wird gecheckt, ob es eine „CountryDescription“ gibt, die „Value“ entspricht.

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

Unformatierte Ausgabe:

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

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyPersonPredefVals_Ad?PersonCharacteristicID=<value>&Value=<value>&SortNo=<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_ModifyPersonPredefVals_Ad',
		array(
			'PersonCharacteristicID' => <value>,
			'Value' => '<value>',
			'SortNo' => <value>,
			// 'ValueID' => NULL,
			// 'LanguageID' => 0,
			// 'DeleteValue' => 0,
			// 'TableID' => NULL,
			// 'TableKeyID' => NULL,
			// 'KeepReferencesIfValueChanges' => 0,
			// 'DeleteTableKeyReference' => 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="pm_ModifyPersonPredefVals_Ad">
			<Parameters>
				<Parameter Name="PersonCharacteristicID"><!-- smallint value --></Parameter>
				<Parameter Name="Value"><!-- varchar value --></Parameter>
				<Parameter Name="SortNo"><!-- integer value --></Parameter>
				<!-- <Parameter Name="ValueID">NULL</Parameter> -->
				<!-- <Parameter Name="LanguageID">0</Parameter> -->
				<!-- <Parameter Name="DeleteValue">0</Parameter> -->
				<!-- <Parameter Name="TableID">NULL</Parameter> -->
				<!-- <Parameter Name="TableKeyID">NULL</Parameter> -->
				<!-- <Parameter Name="KeepReferencesIfValueChanges">0</Parameter> -->
				<!-- <Parameter Name="DeleteTableKeyReference">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>