Prozedur zum Anlegen, Ändern und Löschen von Bedingungen einer Gruppen-Bedingung. ACHTUNG : Ist eine Gruppen-Bedingung bereits einer Gruppe zugeordnet, können KEINERLEI Änderungen mehr vorgenommen werden !

Das Konzept der Gruppen-Bedingungen bietet die Möglichkeit, Personen AUTOMATISCH nach bestimmten Kriterien in Gruppen einzuordnen. „Automatisch“ bedeutet, daß (transaktionssicher) bei jeder Änderung von Personen-Daten evtl. vorhandene Bedingungen für Gruppen, die zum jeweiligen Personen-Typ passen (siehe Rückgabespalte „PersonTypeID“ von pm_GetGroups_Ad), geprüft werden und die Person dann evtl. einer Gruppe zugeordnet oder aus einer Gruppe entfernt wird.

Eine Gruppen-Bedingung besteht grundsätzlich aus Bedingungen, die sich auf die Eigenschaft einer Person zu einem bestimmten Merkmal beziehen. Bedingungen können mit „UND“ oder „ODER“ verknüpft werden - dazu dient die „ConditionPositionID“ (entsprechender Parameter „ConditionPositionID“) :
Hierbei handelt es sich um die Nummer (eine willkürliche Nummer) eines „Bedingungs-Blocks“. Pro Bedingungs-Block kann ein Merkmal (→ „PersonCharacteristicID“) nur einmal verwendet werden, da innerhalb des gleichen Blocks die Bedingungen mit UND verknüpft werden. Mehrere Bedingungs-Blöcke werden mit ODER verknüpft.

Zusammengefaßt :
Eine Person gehört nur dann in die Gruppe, der die Gruppen-Bedingung „ConditionID“ zugewiesen ist, wenn ihre Eigenschaft zum Merkmal „PersonCharacteristicID“ der Bedingung „Condition“ entspricht (und alle anderen Bedingungen des gleichen Bedingungs-Blocks „ConditionPositionID“ erfüllt sind) ODER alle Bedingungen einer anderen „ConditionPositionID“ (der gleichen Gruppen-Bedingung „ConditionID“) zutreffen.

Hinweis :

Der Benutzer, der diese Prozedur aufruft, muß mindestens lesenden Zugriff auf das Merkmal „PersonCharacteristicID“ bzw. (im Fall „DeleteConditionPositionID = 1“) auf alle Merkmale des Bedingungs-Blocks „ConditionPositionID“ besitzen. Falls jedoch eine Beschränkung existiert (s. pm_GetPChAccRestrForUsers_Ad), gibt es einen Fehler !

Anmerkung zum Parameter „Country“ :

Egal in welchem Format „Datums-Bedingungen“ angegeben wurden, gespeichert werden diese (in „Conditions“) IMMER im Format „Monat-Tag-Jahr“ !

Zum Parameter „Condition“ :

Das Format einer Bedingung entspricht genau dem erlaubten Format für eine Bedingung bei der Personen-Suche (Parameter „ConditionList“ von pm_GetPersons_Conditions_Ad).

1. Es können Werte und Wertbereiche angegeben werden. Jede einzelne Bedingung muß eines der folgenden Formate haben :

• Wert → „Like“ Wert
• ~Wert → „Like“ Wert, aber case-INsensitiv
• ^Wert → „= soundex(Wert)“
• {Wert → „<>“ Wert
• (Wert → „>=“ Wert
• Wert) → „⇐“ Wert
• [Wert → „>“ Wert
• Wert] → „<“ Wert
• (Wert1|Wert2) → „>=“ Wert1 und „⇐“ Wert2
• (Wert1|Wert2] → „>=“ Wert1 und „<“ Wert2
• [Wert1|Wert2) → „>“ Wert1 und „⇐“ Wert2
• [Wert1|Wert2] → „>“ Wert1 und „<“ Wert2
• {} oder {) oder {] oder (} oder () oder (] oder [} oder [) oder [] → Es sollen alle Personen gesucht werden, die das entsprechende Merkmal NICHT haben.

2. Sofern eine Bedingung eines der Formate „Wert“ oder „~Wert“ hat (also eine „LIKE“-Suche durchgeführt werden soll), können sogenannte Platzhalter verwendet werden :

• '_' oder '?' : Platzhalter für EIN Zeichen
• '%' oder '*' : Platzhalter für eine ZeichenKETTE

3. Um nach einem Wert zu suchen, der mit „[“ oder „(“ oder „{“ oder „~“ oder „^“ beginnt oder der mit „]“ oder „)“ oder „}“ endet, muß man den „~“-Operator verwenden (z.B. „~[*“ angeben, um nach Werten zu suchen, die mit „[“ beginnen)

4. Soll in einer „LIKE“-Suche (d.h. wenn die Bedingung das Format „Wert“ oder „~Wert“ hat) nach einem Platzhalter-Zeichen selbst gesucht werden, ist dieses Zeichen 2mal hintereinander einzugeben (z.B. würde durch Angabe von „%%%“ nach Werten gesucht werden, die mit „%“ beginnen)

5. Im Falle einer „LIKE“-Suche (d.h. wenn die Bedingung das Format „Wert“ oder „~Wert“ hat) werden (in dieser Reihenfolge !) folgende Ersetzungen vorgenommen :

• „?“ durch „_“, ausgenommen „??“ (diese Zeichenkette wird durch „?“ ersetzt)
• „*“ durch „%“, ausgenommen „**“ (diese Zeichenkette wird durch „*“ ersetzt)
• „__“ durch „[_] (um nach dem Zeichen „_“ selbst suchen zu können, siehe 4.)
• “%%„ durch “[%] (um nach dem Zeichen „%“ selbst suchen zu können, siehe 4.)

⇒ Daher wird z.B. „?_“ sowie „_?“ durch „[_]“ ersetzt, oder „*%“ sowie „%*“ durch „[%]“. Allerdings wird z.B. „__?“ durch „[_]_“ ersetzt !

6 . Falls eine Bedingung ein Datums-/Uhrzeitformat hat, muß angegeben sein, um welches Länderformat es sich dabei handelt (siehe Parameter „Country“)

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

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyConditions_Ad?ConditionID=<value>&ConditionPositionID=<value>&PersonCharacteristicID=<value>&Condition=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyConditions_Ad?ConditionID=<value>&ConditionPositionID=<value>&PersonCharacteristicID=<value>&Condition=<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_ModifyConditions_Ad',
		array(
			'ConditionID' => <value>,
			'ConditionPositionID' => <value>,
			'PersonCharacteristicID' => <value>,
			'Condition' => '<value>',
			// 'Country' => NULL,
			// 'DeleteConditionPositionID' => 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_ModifyConditions_Ad">
			<Parameters>
				<Parameter Name="ConditionID"><!-- smallint value --></Parameter>
				<Parameter Name="ConditionPositionID"><!-- tinyint value --></Parameter>
				<Parameter Name="PersonCharacteristicID"><!-- smallint value --></Parameter>
				<Parameter Name="Condition"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="Country">NULL</Parameter> -->
				<!-- <Parameter Name="DeleteConditionPositionID">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>