Löscht eine Person aus dem System.
Hinweise :
1. Wenn eine Person gelöscht wird, gehen alle hierzu gespeicherten Daten verloren (wie z.B. „Ratings“). Einige Daten sind allerdings so wichtig, daß ein Löschen verhindert wird und damit diese Prozedur fehlschlägt. Zur Zeit gibt es folgende Dinge, die das Löschen einer Person verhindern :
2. Die besondere Person mit der ID „0“ kann niemals gelöscht werden
Anmerkung zum Parameter „ForceDelete“ :
Um eine Person trotz der (unter „Hinweise“) genannten Einschränkungen löschen zu können (was dann natürlich unweigerlich einen Verlust der entsprechenden Daten zur Folge hat !), gibt es den Parameter „ForceDelete“. Hierbei handelt es sich um die SUMME folgender Werte, die jeweils sozusagen eine der genannten Beschränkungen aufheben :
Übergibt man also „ForceDelete = 7“, wird die Person auf jeden Fall gelöscht, egal welche Daten auch immer zu dieser Person existieren ! Setzt man den Parameter auf „2“ ODER auf „1“, und gibt es einen Auftrag, bei dem die Person SOWOHL Auftraggeber als auch Lieferanschrift ist, schlägt das Löschen fehl !
HTTP-Method | POST |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | person management |
Engine-Typ | Daten-Änderung |
Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
---|---|---|---|---|
PersonID | ID der Person, die gelöscht werden soll | integer | 3.5.0 | |
ForceDelete | 0 | SUMME dieser Werte : „PersonID“ soll gelöscht werden, auch wenn sie… * „1“ : Auftraggeber eines Auftrags ist * „2“ : Lieferanschrift eines Auftrags ist * „4“ : Autor eines Forum-Beitrags ist, der nicht gelöscht werden darf (s. a. Beschreibung !) | tinyint | 4.0.7 |
Die Prozedur hat keine Rückgaben.
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 4) |
---|---|---|
-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 direkt |
-677 | Die Person kann nicht gelöscht werden, da es mind. ein Posting gibt, das nicht gelöscht werden darf | nur direkt |
-672 | Fehlende Berechtigung zum Löschen von Personen eines bestimmten Personentyps | nur direkt |
-671 | Die Person kann nicht gelöscht werden, da mindestens ein Auftrag existiert | nur direkt |
-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 | nur indirekt |
-535 | Das Datum liegt nicht in der Vergangenheit | nur indirekt |
-530 | Der Wert ist nicht konvertierbar | nur indirekt |
-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 |
-500 | Falsche Parameter | direkt und indirekt |
-220 | Es konnte keine Merkmal-ID für die Produktbezeichnung ermittelt werden | 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] |
5.1.4 | 2006-08-14 | Workaround für BUG im ASE 15 [bzgl. „isnull“ und „NOT“-Operator] |
5.0.4 | 2005-09-26 | 1. Umstellung der Datenübergabe an „_fo_UpdateForumStatistics“ auf „dstoreifin“ 2. Pflege der „MainPostingSorting“-Tabelle [neues feature zur Sortierung von Hauptbeiträgen nach Kriterien] |
5.0.1 | 2005-03-29 | Fehler bzgl. der Überprüfung, ob eine Person nicht gelöscht werden darf, wenn für eine Forum der „Settings“-Eintrag „PostingDeletionOptions“ gesetzt ist |
5.0.0 | 2004-12-21 | 1. Berücksichtigung des „ForumSettings“-Schlüssels „PostingDeletionOptions“, der dazu führen kann, daß das Löschen der Person fehlschlägt bzw. die „PersonID“ auf „0“ gesetzt werde muß 2. Aufgrund von 1. wurde „ForceDelete“ auch entsprechend geändert |
4.0.10 | 2004-03-15 | Interne Änderung : Änderung am Ende der Prozedur bzgl. „rollback tran“ |
4.0.9 | 2004-03-03 | Ausführen von „set transaction isolation level 1“ und „set rowcount 0“ zu Beginn der Prozedur |
4.0.7 | 2004-01-16 | 1. Neuer Parameter „ForceDelete“ 2. Aufruf der neuen Prozeduren „_mi_StartProcedure“ und „_mi_FinishProcedure“ |
4.0.3 | 2003-07-10 | Berücksichtigung der neuen Tabellen „PersonMetaInformation“ und „PersonTypeMetaInformation“ |
4.0.0 | 2003-04-03 | „AdditionalPersonProperties“ gibt's nicht mehr |
3.5.21 | 2002-08-06 | |
3.5.18 | 2002-05-15 | |
3.5.15 | 2002-03-12 | |
3.5.13 | 2001-12-06 | |
3.5.8 | 2001-05-19 | |
3.5.5 | 2001-03-30 | |
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/pm_DeletePerson_Ad?PersonID=<value>'
Mit xmllint 5) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/pm_DeletePerson_Ad?PersonID=<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'), 'pm_DeletePerson_Ad', array( 'PersonID' => <value>, // 'ForceDelete' => 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="pm_DeletePerson_Ad"> <Parameters> <Parameter Name="PersonID"><!-- integer value --></Parameter> <!-- <Parameter Name="ForceDelete">0</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>