Löscht alle „überflüssigen“ Personen eines bestimmten Typs.
„Überflüssig“ bedeutet :
1.) Die Person muß entweder eine vom „dStore“ generierte Kundennummer (die also mit „GEN“ beginnt) oder gar keine Kundennummer haben. Dabei ist „Kundennummer“ das Merkmal mit der ID, die in „PersonTypeSettings“ zur „PersonTypeID“ und zum Schlüssel „CustomerNoCharacteristicID“ konfiguriert ist (falls nichts konfiguriert ist, gehen wir von der ID „1“ aus).
2.) Außerdem darf es KEINE Aufträge in „Orders“ zu dieser Person geben und auch KEINE Statistiken in „PersonCharacteristicNos_PD“ bzw. „PersonCharacteristicNos_PM“ !
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 |
---|---|---|---|---|
PersonTypeID | 1 | ID eines Personen-Typs. Es werden nur Personen dieses Typs gelöscht. | tinyint | 3.5.5 |
MaxNumberOfPersonsToDelete | 100 | Es werden maximal so viele Personen gelöscht, wie durch diesen Parameter angegeben | tinyint | 3.5.5 |
PersonsCreatedDuringLastXDays | NULL | Weiteres Filter-Kriterium : Es werden nur Personen gelöscht, die in den letzten „PersonsCreatedDuringLastXDays“ Tagen angelegt wurden. Dabei werden immer GANZE Tage genommen - also mit 0 Uhr beginnend. | integer | 3.5.13 |
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 |
-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 |
-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 |
-565 | Die „Objekt-ID“ der Prozedur konnte nicht ermittelt werden | nur indirekt |
-564 | Der Status in BatchJobs konnte nicht gesetzt werden | nur indirekt |
-562 | Die Prozedur ist nicht in BatchJobs registriert | nur indirekt |
-561 | Prozedur kann nicht ausgeführt werden | nur indirekt |
-560 | Prozedur konnte nicht gestartet 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] |
7.0.4 | 2014-03-19 | Kleine Kosmetik-Korrektur : Bei einigen Code-Zeilen war am Ende ein CR-Zeichen, was wir entfernt haben |
6.0.3 | 2011-09-07 | MerkmalID für die „Kundennummer“ wird ab sofort über „PersonTypeSettings“ ermittelt [siehe #2637] |
4.0.15 | 2004-07-30 | 1. Aufruf der Prozeduren „_mi_StartProcedure“ und „_mi_FinishProcedure“ 2. Ausführen von „set transaction isolation level 1“ und „set rowcount 0“ zu Beginn der Prozedur 3. Konsequente Fehlerbehandlung |
4.0.7 | 2004-01-16 | 1. „_mi_TryToStartBatchJob“ hat zahlreiche neue Parameter bekommen, um u.a. die Parameter-Werte übergeben automatisch in „BatchJobParameters“ eingefügen zu lassen 2. Verwendung der neuen Prozedur „_mi_TryToFinishBatchJob“ zum Setzen des Status am Schluß |
4.0.3 | 2003-07-10 | 1. „CreationDateAndTime“ steht jetzt in „PersonMetaInformation“ und nicht mehr in „Persons“ 2. Performance-Verbesserung bzgl. der Überprüfung, daß nur Personen, die eine „GEN“-Kundennummer oder gar keine Kundennummer besitzen, gelöscht werden |
3.5.20 | 2002-07-22 | |
3.5.19 | 2002-06-17 | |
3.5.13 | 2001-12-06 | |
3.5.5 | 2001-03-30 | 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_DeleteDispensablePersons_Ad'
Mit xmllint 5) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/pm_DeleteDispensablePersons_Ad' | 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_DeleteDispensablePersons_Ad', array( // 'PersonTypeID' => 1, // 'MaxNumberOfPersonsToDelete' => 100, // 'PersonsCreatedDuringLastXDays' => NULL ) ); $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_DeleteDispensablePersons_Ad"> <Parameters> <!-- <Parameter Name="PersonTypeID">1</Parameter> --> <!-- <Parameter Name="MaxNumberOfPersonsToDelete">100</Parameter> --> <!-- <Parameter Name="PersonsCreatedDuringLastXDays">NULL</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>