Benutzer-Werkzeuge

Webseiten-Werkzeuge


engine:procedures:mi_deletedstoreuser_ad

mi_DeletedStoreUser_Ad

Löscht einen „dStore“-Benutzer inkl. dem zugehörigen Datenbankbenutzer, dem ASE-Login und einer gleichnamigen Person des Typs „dStoreUser“ (1:1-Zuordnung über den Namen).

ACHTUNG : Zur erfolgreichen Ausführung dieser Prozedur muß der Aufrufer die ASE-Rolle „sso“ haben !

Hinweis :
Die nötigen Aktionen (Login-Entfernen, DB-Benutzer-Entfernen, Datensatz aus „UserInfo“ löschen) können aufgrund von Beschränkungen im ASE leider nicht in einer Transaktion ausgeführt werden. Daher kann es theoretisch bei einem Fehler dazu kommen, daß nur ein Teil der Schritte ausgeführt wurde. Man kann aber die Prozedur einfach (nachdem die Ursache erkannt und behoben wurde natürlich) erneut aufrufen !

Anmerkung zum Parameter „KillProcessesForUserFirst“ :

Ein Grund, warum das Löschen des Benutzers „UserName“ fehlschlagen kann, ist der, daß das zugehörige ASE-Login aktuell noch mit dem Server verbunden ist. Um diese Art von Fehler zu vermeiden, kann man „KillProcessesForUserFirst“ auf „1“ setzen. Um diese Aktion aber wiederum ausführen zu können, muß der Aufrufer die ASE-Rolle „sa“ haben !
Hinweis : Die Problematik gilt auch im Fall „OnlyDeleteUserFromThisEngine = 1“, weil selbst nur das Entfernen des Benutzers aus „dieser Engine“ (durch die ASE-System-Prozedur „sp_dropuser“) dann fehlschlagen kann. Gibt man „OnlyDeleteUserFromThisEngine = 1“ und „KillProcessesForUserFirst = 1“ an, werden aber nur die Prozesse (mit Login „UserName“) ge„kill“t, die auf „dieser Engine“ verbunden sind - weitere Prozesse zum Login „UserName“, die auf andere Datenbanken verbunden sind, bleiben also bestehen.

HTTP-MethodPOST
HTTP-AuthOptional
Tags
Engine-Kategorieconfigurations
Engine-TypDaten-Änderung
Letzte Aktualisierung7.0.7 (2015-01-29)

Parameter

Name 1) Standard-Wert Beschreibung 2) SQL-Datentyp3) ab Version
UserName Name des Benutzers der gelöscht werden soll (mögliche Werte : s. mi_GetUserInfo_Ad)
varchar(50)6.5.0
InvalidateUserInUserInfo0 Falls der Benutzer nicht gelöscht werden kann (weil noch „wichtige Datensätze“ zu ihm existieren), gibt es einen Fehler. Um diesen zu vermeiden, gibt man hier „1“ an - dann wird der Benutzer „invalidiert“ (derzeit : dem Namen wird ein „_“ vorangestellt).
bit6.5.0
OnlyDeleteUserFromThisEngine0 Das Löschen schlägt fehl, falls der Benutzer in einer anderen „Engine“ existiert. Gibt man in so einem Fall hier „1“ an, wird der Benutzer nur in dieser „Engine“ gelöscht u. bleibt in den anderen DBs bestehen (das zugeh. ASE-Login bleibt natürlich auch).
bit6.5.0
DropLoginWhenDBIsNotAvailable0 Auf Standby-Servern kann das Löschen fehlschlagen, weil die „standby“-DB „offline“ ist und daher evtl. Referenzen (des logins auf DB-Benutzer) vom ASE nicht geprüft werden können. Um dieses Problem zu ignorieren, übergibt man hier „1“.
bit6.5.1
KillProcessesForUserFirst0 „1“ angeben, um vorher Prozesse mit Login „UserName“ zu „kill“en, weil es sonst zu einem Fehler beim Löschen des Benutzers kommen kann („-516“). S.a. Beschreibung !
bit7.0.4

Rückgabe

Die Prozedur hat keine Rückgaben.

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code Beschreibung Quelle 4)
-856Fehlerhafte Daten in „MainPostingSorting“nur indirekt
-855Fehlerhafte Konfiguration des Sortier-Kriteriumsnur indirekt
-850Sortier-Kriterium nicht definiert oder inaktiv oder nicht verwendbarnur indirekt
-840Posting kann nicht bearbeitet werden, weil es bereits von einem anderen Prozess bearbeitet wirdnur indirekt
-677Die Person kann nicht gelöscht werden, da es mind. ein Posting gibt, das nicht gelöscht werden darfnur indirekt
-672Fehlende Berechtigung zum Löschen von Personen eines bestimmten Personentypsnur indirekt
-671Die Person kann nicht gelöscht werden, da mindestens ein Auftrag existiertnur indirekt
-621Fehlender oder falscher Eintrag in PersonTypeSettingsnur indirekt
-610Fehlende oder falsche Daten in PersonMetaInformationnur indirekt
-572Die Prozedur darf nur innerhalb einer Transaktion ausgeführt werdennur indirekt
-569Der Benutzer hat kein Ausführungsrecht für die Prozedurnur indirekt
-567Die Prozedur darf z. Zt. nicht ausgeführt werdennur indirekt
-566Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werdennur indirekt
-561Prozedur kann nicht ausgeführt werdennur indirekt
-550Fehlender oder falscher Eintrag in Settingsdirekt und indirekt
-535Das Datum liegt nicht in der Vergangenheitnur indirekt
-530Der Wert ist nicht konvertierbarnur indirekt
-518Es ist eine bestimte ASE-Rolle erforderlich, die der Benutzer aber nicht besitztnur direkt
-516Aufruf einer ASE-Funktion/-Prozedur lieferte einen Fehler ! (s. standard out)nur direkt
-510Der Benutzer ist nicht registriertnur indirekt
-504Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochendirekt und indirekt
-502Die Parameter-Werte der Prozedur können nicht verarbeitet werden (kein passendes Trennzeichen)nur indirekt
-500Falsche Parameterdirekt und indirekt
-220Es konnte keine Merkmal-ID für die Produktbezeichnung ermittelt werdennur indirekt

XML-Schema

Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.

Historie

7.0.7 2015-01-29Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf]
7.0.4 2014-03-19Neuer Parameter „KillProcessesForUserFirst“
6.5.1 2012-11-021. Neuer Parameter „DropLoginWhenDBIsNotAvailable“
2. Ab jetzt gibt es den Fehler „-516“, wenn eine ASE-System-Prozedur fehlschlägt
3. Datenbanken, die „offline“ sind, werden nun ausgelassen [um Fehler zu vermeiden]
6.5.0 2012-09-17Erstmalig in dieser Version erstellt

Code-Snippets

Engine Playground

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

cURL

Unformatierte Ausgabe:

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

Mit xmllint 5) formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_DeletedStoreUser_Ad?UserName=<value>' | xmllint --format -
dStore_php
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_DeletedStoreUser_Ad',
		array(
			'UserName' => '<value>',
			// 'InvalidateUserInUserInfo' => 0,
			// 'OnlyDeleteUserFromThisEngine' => 0,
			// 'DropLoginWhenDBIsNotAvailable' => 0,
			// 'KillProcessesForUserFirst' => 0
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();
engine/execute

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_DeletedStoreUser_Ad">
			<Parameters>
				<Parameter Name="UserName"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="InvalidateUserInUserInfo">0</Parameter> -->
				<!-- <Parameter Name="OnlyDeleteUserFromThisEngine">0</Parameter> -->
				<!-- <Parameter Name="DropLoginWhenDBIsNotAvailable">0</Parameter> -->
				<!-- <Parameter Name="KillProcessesForUserFirst">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>
1)
Pflichtparameter sind unterstrichen
4)
direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“
5)
I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org
engine/procedures/mi_deletedstoreuser_ad.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)