Zu einer Person werden „Detail-Eigenschaften“ (aus „PersonDetails“) zurückgegeben. Unter „Detail-Eigenschaften sind Eigenschaften zu verstehen, die mehr als 100 Byte enthalten (können).

Anmerkungen zum Parameter „CharacteristicIDList“ :

1. Es gibt keinen Fehler, wenn Merkmale übergeben werden, die nicht zum Personen-Typ der identifizierten bzw. angegebenen Person passen oder für den kein lesender Zugriff besteht (s. pm_GetPChAccRestrForUsers_Ad), sondern diese werden einfach ignoriert !
2. Wenn Details einer anderen Person (s. Anmerkung zum Parameter „PersonID“) ermittelt werden sollen, werden Merkmale, auf die KEIN Zugriff erlaubt ist, ebenfalls IGNORIERT !

Anmerkung zum Parameter „PersonID“ :

Sollen Personendaten zu einer anderen Person ausgegebenen werden, kann diese Person über den Parameter „PersonID“ identifiziert werden. Natürlich klappt dies nur, wenn die beiden Personen auch irgendwie in einer Beziehung zueinander stehen :
1. Zugriff ist erlaubt, wenn die identifizierte Person Auftraggeber eines Auftrags ist, bei dem „PersonID“ die Lieferanschrift („DeliveryPersonID“) ist UND der „PersonTypeSettings“-Eintrag zum Schlüssel „UnlimitedAccessToDeliveryPersonData“ (zur „PersonTypeID = 0“) auf „1“ konfiguriert ist. In diesem Fall besteht Zugriff auf Detail-Eigenschaften zu ALLEN Merkmalen.
2. Andernfalls ist der Zugriff nur erlaubt, wenn aktuell eine Beziehung der identifizierten Person zur „PersonID“ besteht, deren „AccessLevel“ (s. gleichnamige Rückgabespalte von pm_GetPersonRelationships_Pu) dies erlaubt. Zu welchen Merkmalen aber Detail-Eigenschaften eingesehen werden dürfen, regelt ein „RelationshipSettings“-Eintrag zum Schlüssel „AllowedCharacIDs_Read“ (siehe auch „Hinweis“ in pm_GetRelationshipSettingEntry).

Anmerkung zum Parameter „IncludeCharacsWithNoDetails“ :

Der Parameter „IncludeCharacsWithNoDetails“ gibt an, ob in der Ergebnismenge nur Merkmale sein sollen, zu denen es auch tatsächlich „Details“ zur Person gibt oder nicht. Ist z.B. nichts in „CharacteristicIDList“ angegeben, und wird „1“ in „IncludeCharacsWithNoDetails“ übergeben, enthält man somit für jedes dem Personen-Typ (der identifizierten Person bzw. von „PersonID“) zugeordneten Merkmals einen Datensatz.
ACHTUNG : Ist eine „PersonID“ angegeben, und besitzt die identifizierte Person nur auf bestimmte Merkmale Zugriffsrechte (s.o.), sind in jedem Fall nur die Merkmale im Ergebnis, die auch „gelesen“ werden dürfen (im schlechtesten Fall ist die Ergebnismenge also leer) !

Anmerkung zum Parameter „DetailsRelatedToUniqueID“ :

Eine weitere Möglichkeit, an „Details“ einer Person zu gelangen, ist im Parameter „DetailsRelatedToUniqueID“ die „UniqueID“ eines Besuchers anzugeben. Wenn dieser Parameter angegeben wird, ignorieren wir „PersonIdentificationValues“ (man kann dann dort auch z.B. „NULL“ übergeben) und tun folgendes :
Wir versuchen, eine Person des Typs „PersonTypeID“ zu ermitteln, die zum aktuellen Zeitpunkt dem durch „DetailsRelatedToUniqueID“ identifizierten Besucher zugeordnet ist (gelingt dies nicht, gibt es einen entsprechenden Fehler).
Zu dieser Person ermitteln wir entweder alle „Details“ zu Merkmalen, die (zur „PersonTypeID“) in „PersonTypeSettings“ zum Schlüssel „PersonCharacteristicIDsGrantedByUniqueID_Details“ konfiguriert sind oder nur die „Details“ zu den Merkmalen, die sich aus der Schnittmenge der in „CharacteristicIDList“ angegebenen IDs und den IDs in besagtem „PersonTypeSettings“-Eintrag
ergeben.
Hinweis : Es gibt also keinen Fehler, wenn in „CharacteristicIDList“ Merkmale angegeben sind, die nicht via „PersonCharacteristicIDsGrantedByUniqueID_Details“ freigeschaltet sind.

wenn CharacteristicIDList IN (NULL, '')

• SortNo (absteigend)

wenn SortedResult = 0 und CharacteristicIDList NOT IN (NULL, '')

• PositionOfCharacteristicIDInCharacteristicIDList (aufsteigend)

wenn SortedResult = 1 und CharacteristicIDList NOT IN (NULL, '')

• SortNo (absteigend)

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

Unformatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/pm_GetPersonDetails_Pu?PersonIdentificationValues=<value>'

Mit xmllint ⁸⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/pm_GetPersonDetails_Pu?PersonIdentificationValues=<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_GetPersonDetails_Pu',
		array(
			'PersonIdentificationValues' => '<value>',
			// 'PersonTypeID' => 1,
			// 'CaseSensitive' => 1,
			// 'CharacteristicIDList' => NULL,
			// 'PersonID' => NULL,
			// 'SortedResult' => 0,
			// 'IncludeCharacsWithNoDetails' => 0,
			// 'DetailsRelatedToUniqueID' => 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_GetPersonDetails_Pu">
			<Parameters>
				<Parameter Name="PersonIdentificationValues"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="PersonTypeID">1</Parameter> -->
				<!-- <Parameter Name="CaseSensitive">1</Parameter> -->
				<!-- <Parameter Name="CharacteristicIDList">NULL</Parameter> -->
				<!-- <Parameter Name="PersonID">NULL</Parameter> -->
				<!-- <Parameter Name="SortedResult">0</Parameter> -->
				<!-- <Parameter Name="IncludeCharacsWithNoDetails">0</Parameter> -->
				<!-- <Parameter Name="DetailsRelatedToUniqueID">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>