Gibt die Merkmal-IDs (mit einigen zusätzlichen Informationen) aus „PersonTypeSettings“ zurück, die zur „PersonTypeID = 0“ zum Schlüssel „PersonGrantAccessIDs“ konfiguriert sind.

Hintergrund : siehe pm_CheckPersonIdentity_Pu.

Hinweis :

Besteht für ein Merkmal eine komplett lesende Zugriffsbeschränkung (s. pm_GetPChAccRestrForUsers_Ad, „komplett lesende Beschränkung“ zeigt sich dadurch, daß „ReadAccessRestrictionPattern“ „NULL“ ist) für den Benutzer, der diese Prozedur aufruft, FEHLEN normalerweise entsprechende Datensätze in der Rückgabe von Prozeduren, die Daten zu Merkmalen bzw. Eigenschaften zu Merkmalen zurückgeben.
Bei DIESER Prozedur hier werden solche Zugriffsbeschränkungen BEWUSST NICHT beachtet, weil es keinen SINN macht, dies an dieser Stelle zu tun (man würde dann ja nur einen Teil der „PersonGrantAccessIDs“ zurückbekommen OHNE das man es bemerkt).
Einzige Alternative wäre noch, einen Fehler zurückzugeben und gar keine Ergebnismenge (wie z.B. bei pm_GetPersonOutputCharacs_Ad), aber die Variante, evtl. Beschränkungen hier zu ignorieren, erschien für die Implementierung sinnvoller.

Anmerkung zur Rückgabespalte „Modify“ :

Gibt an, ob der spezielle Benutzer „publicuser“ („UserID = 0“, s. mi_GetUserInfo_Ad) Eigenschaften/Details zum Merkmal „ID“ Ä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 „ID“ 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 „ID“ 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 „ID“ 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)

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

Unformatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/pm_GetPersonAccessCharacs_Pu'

Mit xmllint ⁶⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/pm_GetPersonAccessCharacs_Pu' | 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_GetPersonAccessCharacs_Pu',
		array(
			// 'LanguageID' => 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_GetPersonAccessCharacs_Pu">
			<Parameters>
				<!-- <Parameter Name="LanguageID">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>