Löscht die durch „PersonID“ angegebene Person, sofern erfolgreich anhand von „PersonIdentificationValues“ eine Person des Typs „PersonTypeID“ identifiziert werden kann, und diese eine Beziehung zur „PersonID“ besitzt, die das Löschen erlaubt (s. Rückgabespalte „AccessLevel“ von pm_GetPersonRelationships_Pu).
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 identifizierte Person kann sich grundsätzlich nicht selbst löschen !
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 | 5.1.10 | |
PersonIdentificationValues | Liste (durch '¶' getrennt) von Werten, die die Person identifizieren. Diese Werte müssen Eigenschaften zu den Merkmal-IDs sein, die in „PersonTypeSettings“ zur „PersonTypeID“ zum Schlüssel „PersonIdentificationIDs“ hinterlegt sind. | varchar(255) | 5.1.10 | |
PersonTypeID | 1 | ID des Personen-Typs dem die zu identifizierende Person angehört. Dieser muß bei einer Identifizierung immer mit angegeben werden, da die Merkmale zur Identifizierung pro Personentyp variieren können. | tinyint | 5.1.10 |
CaseSensitive | 1 | „0“ : Der Vergleich der Identifizierungsdaten erfolgt unabhängig von der Groß- und Kleinschreibung „1“ : Die Schreibweise der Daten muß exakt sein | bit | 5.1.10 |
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 indirekt |
-678 | Eine andere Person kann nur gelöscht werden, wenn eine entsprechende Beziehung dies erlaubt | nur direkt |
-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 |
-660 | Identifikation fehlgeschlagen | nur indirekt |
-624 | Fehlender oder falscher Eintrag in RelationshipSettings | nur indirekt |
-621 | Fehlender oder falscher Eintrag in PersonTypeSettings | nur indirekt |
-610 | Fehlende oder falsche Daten in PersonMetaInformation | nur indirekt |
-599 | Lizenz ist ungültig oder abgelaufen | 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 |
-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 |
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.4 | 2013-04-29 | Anpassungen an aktuellen Code-Standard, u.a. wg. UTF8-Unterstützung |
5.1.10 | 2007-03-12 | 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_Pu?PersonID=<value>&PersonIdentificationValues=<value>'
Mit xmllint 5) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/pm_DeletePerson_Pu?PersonID=<value>&PersonIdentificationValues=<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_Pu', array( 'PersonID' => <value>, 'PersonIdentificationValues' => '<value>', // 'PersonTypeID' => 1, // 'CaseSensitive' => 1 ) ); $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_Pu"> <Parameters> <Parameter Name="PersonID"><!-- integer value --></Parameter> <Parameter Name="PersonIdentificationValues"><!-- varchar value --></Parameter> <!-- <Parameter Name="PersonTypeID">1</Parameter> --> <!-- <Parameter Name="CaseSensitive">1</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>