Verwaltet die im „dStore“ registrierten Benutzer der Tabelle „UserInfo“. Vorraussetzung für die Registrierung eines neuen Benutzers ist, daß in der Datenbank ein gleichnamiger Benutzer existiert !

Anmerkungen:

1.) Diese Prozedur kann nur vom „Super“-Admin (das ist der Benutzer, dessen Name mit dem Datenbanknamen übereinstimmt) verwendet werden!

2.) Einige Prozeduren greifen auf die „dstore“-Datenbank oder die „dstorechecks“-Datenbank zu. Ein Benutzer, der diese Prozeduren ausführen möchte (z.B. mi_GetReturnCodeMessage), benötigt nicht nur Ausführungsrechte für die Prozedur selbst, es muß auch ein Benutzer mit dem gleichen Login in der „dstore“- / „dstorechecks“-Datenbank existieren !
Um einen neuen Benutzer für den „dStore“ einzurichten, muß also zunächst ein Datenbank-Benutzer (wie der „sa“-Benutzer z.B.) ein Login erstellen („sso“-Rolle erforderlich !) und entsprechende Benutzer in den Datenbanken erstellen („sa“-Rolle erforderlich !). Anschließend kann der „Super“-Admin dann mit dieser Prozedur die Registrierung in „UserInfo“ vornehmen.

3.) 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 diese Prozedur) : 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 !

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

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_ModifyUserInfo_Ad?UserName=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_ModifyUserInfo_Ad?UserName=<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_ModifyUserInfo_Ad',
		array(
			'UserName' => '<value>',
			// 'DeleteUser' => 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_ModifyUserInfo_Ad">
			<Parameters>
				<Parameter Name="UserName"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="DeleteUser">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>