engine:procedures:mi_deletedstoreuser_ad
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| — |
engine:procedures:mi_deletedstoreuser_ad [11.01.2016 ] (aktuell) |
||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| + | ===== 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-Method|POST | | ||
| + | |HTTP-Auth|Optional | | ||
| + | |Tags|{{tag>[mi Deleted Store User Ad]}}| | ||
| + | |Engine-Kategorie|configurations | | ||
| + | |Engine-Typ|Daten-Änderung | | ||
| + | |Letzte Aktualisierung|7.0.7 (2015-01-29)| | ||
| + | |||
| + | ==== Parameter ==== | ||
| + | |||
| + | ^Name ((Pflichtparameter sind unterstrichen)) ^Standard-Wert ^Beschreibung ((siehe [[webservice:engine_parameterconventions|Parameter-Konventionen engine/<Prozedur-Name>]])) ^SQL-Datentyp((siehe [[:webservice:engine_datatypes|Datentypen im Bereich "engine"]])) ^ab Version ^ | ||
| + | |__UserName__| |Name des Benutzers der gelöscht werden soll (mögliche Werte : s. [[dstoreproc>mi_GetUserInfo_Ad]])\\ |varchar(50)|6.5.0| | ||
| + | |InvalidateUserInUserInfo|0 |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).\\ |bit|6.5.0| | ||
| + | |OnlyDeleteUserFromThisEngine|0 |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).\\ |bit|6.5.0| | ||
| + | |DropLoginWhenDBIsNotAvailable|0 |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".\\ |bit|6.5.1| | ||
| + | |KillProcessesForUserFirst|0 |"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 !\\ |bit|7.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 ((direkt meint "von der Prozedur selber" und indirekt meint "von intern aufgerufenen Unterprozeduren")) ^ | ||
| + | |-856|Fehlerhafte Daten in "MainPostingSorting"|nur indirekt| | ||
| + | |-855|Fehlerhafte Konfiguration des Sortier-Kriteriums|nur indirekt| | ||
| + | |-850|Sortier-Kriterium nicht definiert oder inaktiv oder nicht verwendbar|nur indirekt| | ||
| + | |-840|Posting kann nicht bearbeitet werden, weil es bereits von einem anderen Prozess bearbeitet wird|nur indirekt| | ||
| + | |-677|Die Person kann nicht gelöscht werden, da es mind. ein Posting gibt, das nicht gelöscht werden darf|nur indirekt| | ||
| + | |-672|Fehlende Berechtigung zum Löschen von Personen eines bestimmten Personentyps|nur indirekt| | ||
| + | |-671|Die Person kann nicht gelöscht werden, da mindestens ein Auftrag existiert|nur indirekt| | ||
| + | |-621|Fehlender oder falscher Eintrag in PersonTypeSettings|nur indirekt| | ||
| + | |-610|Fehlende oder falsche Daten in PersonMetaInformation|nur indirekt| | ||
| + | |-572|Die Prozedur darf nur innerhalb einer Transaktion ausgeführt werden|nur indirekt| | ||
| + | |-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| | ||
| + | |-561|Prozedur kann nicht ausgeführt werden|nur indirekt| | ||
| + | |-550|Fehlender oder falscher Eintrag in Settings|direkt und indirekt| | ||
| + | |-535|Das Datum liegt nicht in der Vergangenheit|nur indirekt| | ||
| + | |-530|Der Wert ist nicht konvertierbar|nur indirekt| | ||
| + | |-518|Es ist eine bestimte ASE-Rolle erforderlich, die der Benutzer aber nicht besitzt|nur direkt| | ||
| + | |-516|Aufruf einer ASE-Funktion/-Prozedur lieferte einen Fehler ! (s. standard out)|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|direkt und indirekt| | ||
| + | |-502|Die Parameter-Werte der Prozedur können nicht verarbeitet werden (kein passendes Trennzeichen)|nur indirekt| | ||
| + | |-500|Falsche Parameter|direkt und indirekt| | ||
| + | |-220|Es konnte keine Merkmal-ID für die Produktbezeichnung ermittelt werden|nur indirekt| | ||
| + | ==== XML-Schema ==== | ||
| + | |||
| + | Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema [[http://resources.dstore.de/xsd/webservice_SmartGate/Response/EngineProcedure_v1_0.xsd|Response/EngineProcedure_v1_0.xsd]] validiert. | ||
| + | ==== Historie ==== | ||
| + | |||
| + | |7.0.7 |2015-01-29|Interne Änderung : Datentyp-Erweiterung des "ReferenceKey" [für "_mi_StartProcedure"-Aufruf]\\ | | ||
| + | |7.0.4 |2014-03-19|Neuer Parameter "KillProcessesForUserFirst"\\ | | ||
| + | |6.5.1 |2012-11-02|1. 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-17|Erstmalig 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: | ||
| + | * [[http://playground.dstore.de/index.php?proc=mi_DeletedStoreUser_Ad|mi_DeletedStoreUser_Ad im Engine Playground öffnen]] | ||
| + | == cURL == | ||
| + | Unformatierte Ausgabe: | ||
| + | <code bash> | ||
| + | curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/mi_DeletedStoreUser_Ad?UserName=<value>'</code>Mit xmllint ((I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org)) formatierte Ausgabe: | ||
| + | <code bash> | ||
| + | curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/mi_DeletedStoreUser_Ad?UserName=<value>' | xmllint --format -</code>== dStore_php == | ||
| + | <code 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(); | ||
| + | |||
| + | </code> | ||
| + | == engine/execute == | ||
| + | XML zur Ausführung mit der Methode [[:webservice:engine:execute|engine/execute]], z.B. per | ||
| + | curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>' | ||
| + | |||
| + | <code xml> | ||
| + | <?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></code> | ||
engine/procedures/mi_deletedstoreuser_ad.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)