Ermittelt alle „dStore“-Benutzer aus „UserInfo“. Im Gegensatz zu mi_GetUserInfo_Ad bekommt man aber garantiert ALLE Datensätze (also auch evtl. Benutzer wie „sa“ oder „dstore“) zurück bzw. man kann angeben, daß man nur Administratoren ausgegeben bekommt (s. Anmerkung).

Anmerkung:

Die Benutzer im „dStore“ unterteilen sich in…

• Vom „dStore“ (bzw. „ASE“) vorgegebene Benutzer, die entweder Ausführungsrechte auf ALLE, KEINE oder nur auf bestimmte Prozeduren besitzen
• „sa“ : Der vom „ASE“ vorgegebene Benutzer „sa“ ist im Regelfall NICHT in „UserInfo“ eingetragen, da dieser eigentlich nur für den Datenbank-Server betreffende administrative Aufgaben gedacht ist.
• „dstore“ : Wie „sa“ ist er im Regelfall auch nicht in „UserInfo“ eingetragen. „dstore“ „besitzt“ die Datenbank (d.h. ist „owner“ in der Sybase-Terminologie), auf der die Software „dStore“ installiert wurde und sollte nur für administrative Aufgaben, die die Datenbank betreffen, verwendet werden.

(Man kann die beiden Benutzer „sa“ und „dstore“ natürlich „zu Fuß“ in „UserInfo“, via „INSERT INTO …“, eintragen - zu Testzwecken etwa, denn viele Prozeduren können nicht ausgeführt werden, wenn der Benutzer nicht in „UserInfo“ registriert ist.)

• „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 / „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 „Batch-Jobs“ gedacht, die in einem bestimmten Rhythmus (stündlich, täglich etc.) ausgeführt werden, d.h. er sollte nur für sehr wenige Prozeduren Ausführungsrechte benötigen. Im Regelfall implementiert man in der „dstore“-Datenbank die „sp_Cronjob…“-Prozeduren und vergibt nur auf diese Ausführungsrechte für den „cronjob“.
• „actionuser“ : Für die Abarbeitung von „Actions“ (siehe ac_GetActions_Ad) gedacht.
• „interfaceuser“ : Gehört in der Regel der (in der Datenbank eingerichteten) Gruppe „interface“ an und sollte für jegliche Art von Schnittstellen verwendet werden (Artikelimport z.B.).
• sweeper : Dies ist der einzige Benutzer, der „_co_SweepCurrentlyUsersOnline“ ausführen kann, und er ist im Regelfall NICHT in „UserInfo“ eingetragen, da er keinen anderen Zweck erfüllen muß.

• Administratoren

Sie gehören der (in der Datenbank eingerichteten !) Gruppe „admin“ an und können standardmäßig alle Prozeduren ausführen AUSSER die „internen“ (das sind Prozeduren, deren Name mit einem „_“ beginnt). Durch mi_SetExecuteRights_Ad kann man jedoch gezielt Ausführungsrechte verteilen.
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 „Super“-Admin. Er zeichnet sich dadurch aus, daß sein Name mit dem Datenbanknamen übereinstimmt (in der die Software „dStore“ installiert ist) und es „…_Ad“-Prozeduren gibt, die NUR er ausführen darf - oder Prozeduren, die mit bestimmten Parametern nur vom „Super“-Admin aufgerufen werden dürfen.
Um alle Administator-Benutzer zu sehen, führt man mi_GetdStoreUser_Ad OnlyAdmins = 1 aus.

und schließlich :

• „publicuser“

Dieser Benutzer ist der (in der Datenbank eingerichteten) Gruppe „public“ zugeordnet und besitzt somit nur Ausführungsrechte auf „…_Pu“-Prozeduren. Der „publicuser“ ist also für „den Rest der Welt“ gedacht, d.h. für alle Nutzer, die eine Anwendung, die auf dem „dStore“ basiert („Web-Shop“, „Community“ etc.), verwenden. Man sollte dem „publicuser“ also AUF KEINEN FALL Ausführungsrechte auf „…_Ad“-Prozeduren oder gar interne Prozeduren geben !

(parameterunabängige Sortierung)

• UserName (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_GetdStoreUser_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

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

Mit xmllint ⁶⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/mi_GetdStoreUser_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_GetdStoreUser_Ad',
		array(
			// 'OnlyAdmins' => 1
		)
);
 
$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_GetdStoreUser_Ad">
			<Parameters>
				<!-- <Parameter Name="OnlyAdmins">1</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>