Ermittelt Eigenschaften zu einer oder mehreren Person(en).

Anmerkung zum Parameter „IncludeCreationDateAndTime“ :

Falls hierfür „1“ angegeben wird, enthält die Rückgabemenge einen zusätzlichen Datensatz (nur im Fall „GetPersonTypeIDOnly = 0“), der wie folgt belegt ist :

• CharacteristicDescription : 'CreationDateAndTime'
• Value : <„CreationDateAndTime“ aus „PersonMetaInformation“ der Person>
• ValueRestrictedByPattern : NULL
• CharacteristicID : „-1“
• SortNo : „-32768“
• ValueID : „-1“
• Required : „1“
• Required_CharacCategory : „1“
• Visible : „0“
• Modify : „0“
• ReadAccessRestrictionPattern : NULL
• PredefinedValues : „0“
• FieldTypeID : „28“ (→ Datum mit Uhrzeit)
• MaxLength : „35“
• PersonCharacCategoryID : „0“ („NULL“ wenn „IncludePersonCharacCategoryID = 0“)
• CategoryDescription : 'MetaInformation' („NULL“ wenn „IncludePersonCharacCategoryID = 0“)
• ActualValue : <gleicher Wert wie „Value“> falls „GetActualProperties = 1“, sonst „NULL“
• LastEdited : NULL
• ActualValueID : „-1“ falls „GetActualProperties = 1“, sonst NULL

Anmerkung zum Parameter „IgnoreBadPersonIDsInOneID“ :

Sind GAR KEINE oder NUR „falsche“ IDs in „tempdb.dbo.OneID“, gibt es in jedem Fall „-500“ (auch wenn für diesen Parameter „1“ übergeben wurde) !

Anmerkung zum Parameter „CharacteristicIDList“ :

Merkmale, für die ein lesender Zugriff (für den Benutzer, der diese Prozedur aufruft) komplett verboten ist, werden IGNORIERT, d.h. es gibt auch keinen Fehler, wenn eine solche ID in „CharacteristicIDList“ angegeben ist (es gibt aber eben auch KEINEN entsprechenden Datensatz mit dieser ID) !

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.

(parameterunabängige Sortierung)

• PersonID (aufsteigend)
• SortNo (absteigend)

(parameterunabängige Sortierung)

• PersonID (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_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

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

Mit xmllint ⁷⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/pm_GetPersonProperties_Ad?PersonID=<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_Ad',
		array(
			'PersonID' => <value>,
			// 'LanguageID' => 0,
			// 'CharacteristicIDList' => NULL,
			// 'DateFormat' => 'german',
			// 'PersonCharacCategoryID' => NULL,
			// 'IncludeCreationDateAndTime' => 0,
			// 'IncludePersonCharacCategoryID' => 0,
			// 'DateAndTime' => NULL,
			// 'GetActualProperties' => 0,
			// 'GetPersonTypeIDOnly' => 0,
			// 'IgnoreBadPersonIDsInOneID' => 0,
			// 'OnlyRowsForExistingProperties' => 0,
			// 'GetDetailsInfo' => 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_GetPersonProperties_Ad">
			<Parameters>
				<Parameter Name="PersonID"><!-- integer value --></Parameter>
				<!-- <Parameter Name="LanguageID">0</Parameter> -->
				<!-- <Parameter Name="CharacteristicIDList">NULL</Parameter> -->
				<!-- <Parameter Name="DateFormat">'german'</Parameter> -->
				<!-- <Parameter Name="PersonCharacCategoryID">NULL</Parameter> -->
				<!-- <Parameter Name="IncludeCreationDateAndTime">0</Parameter> -->
				<!-- <Parameter Name="IncludePersonCharacCategoryID">0</Parameter> -->
				<!-- <Parameter Name="DateAndTime">NULL</Parameter> -->
				<!-- <Parameter Name="GetActualProperties">0</Parameter> -->
				<!-- <Parameter Name="GetPersonTypeIDOnly">0</Parameter> -->
				<!-- <Parameter Name="IgnoreBadPersonIDsInOneID">0</Parameter> -->
				<!-- <Parameter Name="OnlyRowsForExistingProperties">0</Parameter> -->
				<!-- <Parameter Name="GetDetailsInfo">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>