Ermittelt Eigenschaften zu einer Person.

Anmerkung zu den Parametern „InputParameter“, „InputIsUniqueID“ und „PersonTypeID“ :

Falls Identifizierungsdaten angegeben sind (also „InputIsUniqueID = 0“), wird die übliche Personen-Identifizierung durchgeführt; hier wird IMMER der „PersonTypeSettings“-Eintrag „PersonIdentificationIDs“ zur „PersonTypeID“ herangezogen - „PersonGrantAccessIDs“ (zur „PersonTypeID = 0“) werden NICHT beachtet ! Zur grundsätzlichen Funktsionsweise der Personen-Identifizierung siehe pm_CheckPersonIdentity_Pu.

Ist nur die „UniqueID“ eines Besuchers bekannt (also „InputIsUniqueID = 1“), werden Eigenschaften zur Person des Typs „PersonTypeID“ ermittelt, die aktuell dem durch die (in „InputParameter“ angegebene) „UniqueID“ gekennzeichneten Besucher zugeordnet ist. Dabei werden nur die Merkmale berücksichtigt, die in „PersonTypeSettings“ zur „PersonTypeID“ zum Schlüssel „PersonCharacteristicIDsGrantedByUniqueID“ hinterlegt sind. In diesem Fall werden natürlich die Parameter „CharacteristicIDList“ und „PersonID“ ignoriert !

Mit „InputIsUniqueID = 2“ kann man als dritte Möglichkeit angeben, daß „InputParameter“ eine „SessionID“ enthält. Zu dieser sollen die Identifizierungsdaten aus „SessionManagement“ (s. mi_GetSessionManagement_Pu) herangezogen werden, genauer zum Schlüssel „PersonIdentificationValues_Type<PersonTypeID>“. Alles weitere funktioniert dann genauso wie im Fall „InputIsUniqueID = 0“ (s.o.) !

Anmerkung zum Parameter „CharacteristicIDList“ :

Es gibt keinen Fehler, wenn Merkmale übergeben werden, die nicht zum Personen-Typ der identifizierten bzw. angegebenen Person passen oder für den Benutzer, der diese Prozedur aufruft bzw. (wenn „PCharacsBackwardCompatible“ in „PersonTypeSettings“ auf „1“ gesetzt ist) für den „publicuser“ („UserID = 0“) nicht sichtbar sind (s. pm_GetPChAccRestrForUsers_Ad), sondern diese werden einfach 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 eine bestimmte „Beziehung“ der identifizierten Person zur „PersonID“ besteht :
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 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 Eigenschaften eingesehen werden dürfen, regelt ein „RelationshipSettings“-Eintrag zum Schlüssel „AllowedCharacIDs_Read“ (siehe auch „Hinweis“ in pm_GetRelationshipSettingEntry).

Anmerkung zur Rückgabespalte „Modify“ :

Gibt an, ob der spezielle Benutzer „publicuser“ („UserID = 0“, s. mi_GetUserInfo_Ad) Eigenschaften/Details zum Merkmal „CharacteristicID“ ÄNDERN darf bzw. eingeschränkt ändern darf. Falls der „PersonTypeSettings“-Eintrag (zur „PersonTypeID = 0“) zum Schlüssel „PCharacsBackwardCompatible“ auf „1“ gesetzt ist, hat dieser Wert die Bedeutung, ob Änderungen mit z.B. pm_InsertNewPerson_Pu oder pm_ModifyPersonData_Pu (egal welcher Benutzer sie ausführt) möglich bzw. eingeschränkt erlaubt sind. Mögliche Werte :

• „0“ : Keinerlei Änderung erlaubt (anlagen, ändern und löschen sind verboten)
• „1“ : Alle Arten von Änderungen erlaubt (d.h. anlegen, ändern, löschen)
• „2“ : Nur die Neu-Anlage ist erlaubt, (ändern und löschen sind verboten)
• „3“ : Nur Ändern ist erlaubt (anlegen und löschen sind verboten)
• „4“ : Nur Neu-Anlage und Ändern sind erlaubt (löschen ist verboten)
• „5“ : Nur Löschen ist erlaubt (anlegen und ändern sind verboten)
• „6“ : Nur Neu-Anlage und Löschen sind erlaubt (ändern ist verboten)
• „7“ : Nur Ändern und Löschen sind erlaubt (anlegen ist verboten)

Anmerkung zur Rückgabespalte „Visible“ :

Wird hier eine „0“ ausgegeben, werden in Prozeduren, die vom Benutzer „publicuser“ („UserID = 0“, s. mi_GetUserInfo_Ad) ausgeführt werden, KEINE Eigenschaften/Details bzw. nur „Teile von Eigenschaften“ (s. Rückgabespalte „ReadAccessRestrictionPattern“) zum Merkmal „CharacteristicID“ ausgegeben. Falls der „PersonTypeSettings“-Eintrag (zur „PersonTypeID = 0“) zum Schlüssel „PCharacsBackwardCompatible“ auf „1“ gesetzt ist, hat dieser Wert die Bedeutung, daß in „public“-Prozeduren KEINE Eigenschaften/Details bzw. nur „Teile von Eigenschaften“ zum Merkmal „CharacteristicID“ ausgegeben werden.

Anmerkung zur Rückgabespalte „ReadAccessRestrictionPattern“ :

Immer „NULL“ wenn „Visible = 1“ ist. Falls hier ein Wert zurückkommt, bedeutet dies, daß der „publicuser“ („UserID = 0“, s. mi_GetUserInfo_Ad) den Teil von Eigenschaften zum Merkmal „CharacteristicID“ einsehen darf, der diesem „pattern“ entspricht (für Details bedeutungslos). Derzeit mögliche Werte :

• „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) werden ausgegeben
• „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) werden ausgegeben

Beispielsweise bedeutet „#left(4)#“, daß nur (maximal) die ERSTEN 4 Zeichen der Eigenschaft zurückgeliefert werden.

wenn InputIsUniqueID = 0 und CharacteristicIDList IN (NULL, '')

• PersonCharacCategoryID (aufsteigend)
• SortNo (absteigend)

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

• PositionOfCharacteristicIDInCharacteristicIDList (aufsteigend)

wenn InputIsUniqueID = 1

• PositionOfCharacteristicIDInSettingsEntry (aufsteigend)

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

Unformatierte Ausgabe:

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

Mit xmllint ⁶⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/pm_GetPersonProperties_Pu?InputParameter=<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_GetPersonProperties_Pu',
		array(
			'InputParameter' => '<value>',
			// 'InputIsUniqueID' => 0,
			// 'PersonTypeID' => 1,
			// 'LanguageID' => 0,
			// 'CharacteristicIDList' => NULL,
			// 'DateFormat' => 'german',
			// 'CaseSensitive' => 1,
			// 'PersonID' => NULL,
			// 'DateAndTime' => NULL,
			// 'GetActualProperties' => 0,
			// 'SeparatorForIdentVals' => '¶'
		)
);
 
$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_GetPersonProperties_Pu">
			<Parameters>
				<Parameter Name="InputParameter"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="InputIsUniqueID">0</Parameter> -->
				<!-- <Parameter Name="PersonTypeID">1</Parameter> -->
				<!-- <Parameter Name="LanguageID">0</Parameter> -->
				<!-- <Parameter Name="CharacteristicIDList">NULL</Parameter> -->
				<!-- <Parameter Name="DateFormat">'german'</Parameter> -->
				<!-- <Parameter Name="CaseSensitive">1</Parameter> -->
				<!-- <Parameter Name="PersonID">NULL</Parameter> -->
				<!-- <Parameter Name="DateAndTime">NULL</Parameter> -->
				<!-- <Parameter Name="GetActualProperties">0</Parameter> -->
				<!-- <Parameter Name="SeparatorForIdentVals">'¶'</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>