Für in „RegisteredProcedures“ eingetragene Prozeduren, die auf „Ad“ enden (sogenannte „Admin-Prozeduren“), wird bei jedem Aufruf jeweils überprüft, ob der Benutzer (der den Aufruf initiiert hat) grundsätzliches Ausführungsrecht besitzt - mit Ausnahme des „Super-Admins“ (Benutzername ist identisch mit dem Datenbanknamen), der grundsätzlich alle „Admin-Prozeduren“ ausführen darf.

Die Ausführungsrechte sind in der Tabelle „ProcedureExecRightsForUsers“ (pro Benutzer) und in der Tabelle „ProcedureExecRightsForGroups“ (pro Benutzer-Gruppe) hinterlegt und können mit Hilfe dieser Prozedur bzw. mit mi_ModifyProcExRight_Group_Ad konfiguriert werden.

Hier der Überprüfungs-Algorithmus des Ausführungsrechtes von „Admin-Prozeduren“ :

(i) Der grundsätzliche Standpunkt ist, daß der Benutzer die Prozedur NICHT aufrufen darf, d.h. es muß eine explizite Erlaubnis konfiguriert sein !

(ii) Gibt es in „ProcedureExecRightsForUsers“ zur „ProcedureID“ (der aufgerufenen Prozedur) und zur „UserID“ (des aufrufenden Benutzers) einen Datensatz, darf der Benutzer die Prozedur aufrufen, falls der „Ausführungs-NestingLevel“ größer oder gleich dem konfigurierten „ExecutionRight“-Wert ist - aber nur, wenn nicht „0“ für „ExecutionRight“ (explizites AusührungsVERBOT) eingetragen wurde !

Hinweis : Ein „Ausführungs-NestingLevel“ von „1“ bedeutet, daß die Prozedur direkt aufgerufen wird, „2“ heißt, daß sie innerhalb einer anderen Prozedur aufgerufen wird, ein Wert von „3“ gibt an, daß sie in einer Prozedur aufgerufen wird, die wiederum in einer anderen Prozedur ausgeführt wird usw.

(iii) Ist in „ProcedureExecRightsForUsers“ KEIN Datensatz zur Prozedur für den Benutzer vorhanden, ermitteln wir alle „ExecutionRight“-Werte aus „ProcedureExecRightsForGroups“ (zur Prozedur) für Gruppen, denen der Benutzer zugeordnet ist. Sobald wir einen „ExecutionRight“-Wert größer „0“ finden und gleichzeitig der „Ausführungs-NestingLevel“ größer oder gleich diesem Wert ist, ist die Ausführung erlaubt.

Anmerkung zum Parameter „ExecutionRight“ :
Wirklich „Sinn“ machen für „ExecutionRight“ eigentlich nur die Werte „0“, „1“ oder „2“.

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:

• mi_ModifyProcExRight_User_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_ModifyProcExRight_User_Ad?ProcedureID=<value>&UserID=<value>&ExecutionRight=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_ModifyProcExRight_User_Ad?ProcedureID=<value>&UserID=<value>&ExecutionRight=<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'),
	'mi_ModifyProcExRight_User_Ad',
		array(
			'ProcedureID' => <value>,
			'UserID' => <value>,
			'ExecutionRight' => <value>,
			// 'ProcedureName' => NULL,
			// 'UserName' => 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="mi_ModifyProcExRight_User_Ad">
			<Parameters>
				<Parameter Name="ProcedureID"><!-- smallint value --></Parameter>
				<Parameter Name="UserID"><!-- smallint value --></Parameter>
				<Parameter Name="ExecutionRight"><!-- tinyint value --></Parameter>
				<!-- <Parameter Name="ProcedureName">NULL</Parameter> -->
				<!-- <Parameter Name="UserName">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>