Diese Prozedur gibt die Benutzer, die in der Tablle „UserInfo“ registriert sind, zurück.

Anmerkung : Im Gegensatz zu mi_GetdStoreUser_Ad gibt die Prozedur NIE den vom „ASE“ vordefinierten Benutzer „sa“ und auch nicht den speziellen „dstore“-User zurück - s. folgende Erläuterungen.

Die Benutzer im „dStore“ unterteilen sich in drei Bereiche :

• Vom „dStore“ (bzw. „ASE“) vorgegebene Benutzer, die entweder Ausführungsrechte auf ALLE, KEINE oder nur auf bestimmte administrative (Name endet auf „_Ad“) Prozeduren besitzen
• Administratoren
• Anonyme Benutzer („publicuser“, „publicadmin“)

Die erste Gruppe von (vom dStore bzw. ASE vorgegebenen) Benutzern umfaßt derzeit (Stand : Version 7.0.4) die folgenden :

• „sa“ : Der vom „ASE“ vorgegebene Benutzer „sa“ (mit den umfangreichste Rechten ausgestattet) wird für Updates verwendet und muß daher bestimme administrative Prozeduren ausführugen können.
• „dstore“ : Häufig NICHT in „UserInfo“ registriert, weil er eigentlich nur dazu dient, „owner“ der Engine (sprich der „Customer-DB“) zu sein - aus Sicherheitsgründen in Abgrenzung zu „sa“also, weil dieser zu umfangreiche Rechte besitzt.
• „Global“ : Hierbei handelt es sich NUR um einen „dummy“-Benutzer, der kein Login für den ASE-Server besitzt, und es gibt auch keinen gleichnamigen Benutzer in der Datenbank. Er wird nur an einigen Stellen für allgemeine bzw. „globale“ Einstellungen benötigt, wie z.B. für die Tabelle „Settings“ (siehe mi_GetSettings_Ad bzw. mi_ModifySettings_Ad).
• „cronjob“ : Dieser ist für die Ausführung von „BatchJobs“ zuständig.
• „actionuser“ : Für die Abarbeitung von „Actions“ (siehe ac_GetActions_Ad) gedacht.
• „backupuser“ : Ausschließlich für die Sicherung der Datenbank (gesamt oder Transaktions-Logs) verwendet.
• „interfaceuser“ : Dieser Benutzer wird für jegliche Art von Schnittstellen benötigt (wie z.B. dem Artikelimport).
• „mailuser“ : Für bestimmte Aufgaben wie einem „Newsletter-Versand“ (allgemein „mailings“) gedacht, d.h. es bestehen sehr eingeschränkte lesende Rechte auf Prozeduren der Bereiche „Person Management“ und „Actions“.
• „dbapadmin“ und „dbaparead“ : Diese Benutzer sind dem Support (also Mitarbeitern) der dbap vorbehalten, wobei „dbapread“ nur lesende Prozeduren ausführen kann, „dbapadmin“ hingegen sehr umfangreiche Rechte besitzt.
• „sweeper“ : Dies ist der einzige Benutzer, der die spezielle im „Community“-Bereich benötigte Prozedur „_co_SweepCurrentlyUsersOnline“ ausführen kann (eine „interne“ Prozedur also, die eigentlich grundsätzlich von niemandem direkt ausgeführt werden darf und kann). Er ist im Regelfall NICHT in „UserInfo“ eingetragen, da er keinen anderen Zweck erfüllen muß.

Erläuterungen zu den Administratoren :

Sie gehören der (in der Datenbank eingerichteten) Gruppe „admin“ an und können standardmäßig alle öffentlichen und administrativen Prozeduren ausführen - also sämtliche Prozeduren, deren Name NICHT mit einem „_“ beginnt. Es gibt einen besonderen Administrator, der vom „dStore“ vorgegeben ist, und auch nicht aus „UserInfo“ gelöscht werden kann (zumindest nicht über mi_ModifyUserInfo_Ad) : der sogenannte „Super-Admin“. Er zeichnet sich dadurch aus, daß sein Name mit dem Datenbanknamen übereinstimmt und es administrative Prozeduren gibt, die NUR er ausführen darf - oder Prozeduren, die mit bestimmten Parametern nur diesem Benutzer gerufen werden dürfen.

Hinweise :
1. Um alle Administator-Benutzer zu sehen, führt man mi_GetdStoreUser_Ad mit dem Parameter „OnlyAdmins = 1“ aus.
2. Zu beachten ist auch die Möglichkeit, auf „dStore“-Ebene Ausführungsrechte- und beschränkungen konfigurieren zu können ! Siehe dazu die Prozeduren mi_ModifyProcExRight_User_Ad und mi_ModifyProcExRight_Group_Ad bzw. mi_ModifyProcExRestForUser_Ad und mi_ModifyProcExRestForGroup_Ad.

Zur dritten Benutzer-Gruppe :

Der Benutzer „publicuser“ ist der (in der Datenbank eingerichteten) Gruppe „public“ zugeordnet und besitzt somit nur Ausführungsrechte auf alle öffentlichen Prozeduren (Prozeduren, die NICHT mit einem „_“ beginnen und NICHT auf „_Ad“ enden). Der „publicuser“ ist also für „den Rest der Welt“ gedacht, d.h. für alle Nutzer, die eine auf dem „dStore“ basierende Anwendung „anonym“ verwenden möchten. Manchmal gibt es jedoch etwas speziellere Aufgaben, die die Ausführung einer „Ad“-Prozedur verlangen (wenn auch „anonym“). Aus diesem Grunde gibt es zusätzlich den „publicadmin“, dem man für solche Fälle spezielle Ausführungs-Rechte vergibt (also nur gezielt auf einzelne Prozeduren).

(parameterunabängige Sortierung)

• UserName (aufsteigend)

(parameterunabängige Sortierung)

• UserName (aufsteigend)
• SortNo (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:

• mi_GetUserInfo_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

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

Mit xmllint ⁷⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/mi_GetUserInfo_Ad' | 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_GetUserInfo_Ad',
		array(
			// 'UserID' => NULL,
			// 'IncludeSpecialUser' => 0,
			// 'GetAssignedGroups' => 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="mi_GetUserInfo_Ad">
			<Parameters>
				<!-- <Parameter Name="UserID">NULL</Parameter> -->
				<!-- <Parameter Name="IncludeSpecialUser">0</Parameter> -->
				<!-- <Parameter Name="GetAssignedGroups">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>