Verwaltet „Beziehungen“ von Personen. Darunter sind Zuordnungen einer Person zu einer anderen Person zu verstehen, wobei immer angegeben ist, welcher Art die Beziehung ist, in welchem Zeitraum sie gültig ist und welche Zugriffsrechte bestehen.

Anmerkung zum Parameter „SortNo“ :

Soll ein neuer Datensatz, d.h. eine neue Beziehung, angelegt werden, kann dieser Parameter entweder angegeben werden (der Wert muß „>= 1“ sein !) oder auf „NULL“ gesetzt werden. In letzterem Fall generiert die Prozedur automatisch eine „SortNo“, und zwar so, daß die neue Beziehung die niedrigste Priorität besitzt.

Anmerkungen zum Parameter „AccessLevel“ :

1.) Wird hier „NULL“ übergeben, gilt folgendes :
Bei Neu-Anlage einer Beziehung suchen wir nach einer zu den Personentypen von „PersonID“ und „RelatedPersonID“ sowie der „RelationshipID“ passenden Einstellung zum Schlüssel „DefaultAccessLevels“ und übernehmen diese ggf. Ansonsten wird der Wert „0“ gewählt, was bedeutet, daß „PersonID“ KEINE Zugriffsrechte auf die Daten von „RelatedPersonID“ hat.
Bei Änderung einer bestehenden Beziehung bedeutet „NULL“, daß das vorhandene Zugriffsrecht NICHT geändert werden soll.

2.) Ist dieser Parameter angegeben, und soll eine bestehende Beziehung geändert werden (ist also „OldValidFrom“ NICHT „NULL“), und ist der Wert ANDERS als der bestehende, werden „SortNo“, „ValidFrom“ UND „ValidTo“ IGNORIERT !

3.) Es handelt sich um eine „Summe“ von Zugriffsrechten (mögliche Einzel-Zugriffsrechte : s. pm_GetRelationAccessLevels), die „PersonID“ auf „RelatedPersonID“ hat.

4.) Eine tatsächliche Änderung des „AccessLevel“ („OldValidFrom“ NICHT „NULL“, „AccessLevel“ anders als der bestehende) löst intern ZWEI Schritte aus :

• Abschluß des bestehenden Zeitraums, d.h. „ValidTo“ wird auf das aktuelle Datum gesetzt
• Anlage eines NEUEN Datensatzes (mit dem neuen „AccesssLevel“), der mit dem aktuellen Datum beginnt und entweder offen ist oder mit dem alten „ValidTo“ endet, wenn dieser in der Zukunft lag

Ausnahme : Der Zeitraum liegt in der Zukunft, dann wird der Wert tatsächlich einfach geändert

5.) Wird ein Zugriffrecht gesetzt oder geändert (ist also „AccessLevel > 0“), muß in „RelationshipSettings“ zur „RelationshipID“ zum Schlüssel „AllowedAccessLevels“ ein für die beiden Personentypen (von „PersonID“ und „RelatedPersonID“) gültiger Eintrag konfiguriert sein (s. pm_GetRelationshipSettingEntry), der angibt, welche Zugriffsrechte maximal vergeben werden können. Verletzt „AccessLevel“ diese Bedingung, gibt es einen Fehler.

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

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyPersonRelationship_Ad?PersonID=<value>&RelatedPersonID=<value>&RelationshipID=<value>&ValidFrom=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyPersonRelationship_Ad?PersonID=<value>&RelatedPersonID=<value>&RelationshipID=<value>&ValidFrom=<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_ModifyPersonRelationship_Ad',
		array(
			'PersonID' => <value>,
			'RelatedPersonID' => <value>,
			'RelationshipID' => <value>,
			'ValidFrom' => <value>,
			// 'SortNo' => NULL,
			// 'ValidTo' => NULL,
			// 'OldValidFrom' => NULL,
			// 'DeletePersonRelationship' => 0,
			// 'AccessLevel' => NULL
		)
);
 
$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_ModifyPersonRelationship_Ad">
			<Parameters>
				<Parameter Name="PersonID"><!-- integer value --></Parameter>
				<Parameter Name="RelatedPersonID"><!-- integer value --></Parameter>
				<Parameter Name="RelationshipID"><!-- tinyint value --></Parameter>
				<Parameter Name="ValidFrom"><!-- datetime value --></Parameter>
				<!-- <Parameter Name="SortNo">NULL</Parameter> -->
				<!-- <Parameter Name="ValidTo">NULL</Parameter> -->
				<!-- <Parameter Name="OldValidFrom">NULL</Parameter> -->
				<!-- <Parameter Name="DeletePersonRelationship">0</Parameter> -->
				<!-- <Parameter Name="AccessLevel">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>