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…
(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.)
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 :
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 !
HTTP-Method | POST |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | configurations |
Engine-Typ | Daten-Änderung |
Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Die Prozedur hat keine Rückgaben.
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 4) |
---|---|---|
-571 | Der Super-Admin darf sich nicht selbst die Zugriffsrechte entziehen | nur direkt |
-570 | Nur der Super-Admin darf diese Prozedur (mit diesen Parametern) ausführen | nur direkt |
-569 | Der Benutzer hat kein Ausführungsrecht für die Prozedur | nur indirekt |
-567 | Die Prozedur darf z. Zt. nicht ausgeführt werden | nur indirekt |
-566 | Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werden | nur indirekt |
-535 | Das Datum liegt nicht in der Vergangenheit | nur indirekt |
-530 | Der Wert ist nicht konvertierbar | nur indirekt |
-511 | Der Benutzer existiert nicht in dieser Datenbank | nur direkt |
-510 | Der Benutzer ist nicht registriert | nur indirekt |
-504 | Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochen | nur indirekt |
-502 | Die Parameter-Werte der Prozedur können nicht verarbeitet werden (kein passendes Trennzeichen) | nur indirekt |
-500 | Falsche Parameter | nur indirekt |
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
7.0.7 | 2015-01-29 | Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf] |
6.5.3 | 2013-03-18 | Anpassungen an den aktuellen Quellcode-Standard, u.a. wg. UTF8-Unterstützung |
4.0.14 | 2004-06-03 | 1. Aufruf der Prozeduren „_mi_StartProcedure“, „_mi_FinishProcedure“ und „_mi_ChooseParamValueSeperator“ 2. Ausführen von „set transaction isolation level 1“ und „set rowcount 0“ zu Beginn der Prozedur 3. Konsequente Fehlerbehandlung |
4.0.0 | 2003-04-03 | Änderung des Klartextes für den Return-Code „-570“ |
3.5.15 | 2002-03-12 | |
3.5.0 | 2000-11-23 | Erstmalig in dieser Version erstellt |
Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:
Unformatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/mi_ModifyUserInfo_Ad?UserName=<value>'
Mit xmllint 5) 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>