Benutzer-Werkzeuge

Webseiten-Werkzeuge


engine:procedures:pm_deleteperson_ad

pm_DeletePerson_Ad

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 :

  • Die Person ist Auftraggeber eines Auftrags
  • Die Person ist Lieferanschrift eines Auftrags
  • Die Person ist Autor eines Forum-Beitrags eines Forums, für das durch den „ForumSettings“-Eintrag „PostingDeletionOptions“ das Löschen dieses Beitrags verhindert werden soll

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 :

  • „1“ : Löschen auch wenn Aufträge vorhanden sind, bei denen die Person Auftraggeber ist
  • „2“ : Löschen auch wenn Aufträge vorhanden sind, bei denen die Person Lieferanschrift ist
  • „4“ : Löschen auch wenn Forum-Beiträge vorhanden sind, bei denen die Person Autor ist, diese Beiträge aber eigentlich nicht gelöscht werden dürfen

Ü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-MethodPOST
HTTP-AuthOptional
Tags
Engine-Kategorieperson management
Engine-TypDaten-Änderung
Letzte Aktualisierung7.0.7 (2015-01-29)

Parameter

Name 1) Standard-Wert Beschreibung 2) SQL-Datentyp3) ab Version
PersonID ID der Person, die gelöscht werden soll
integer3.5.0
ForceDelete0 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 !)
tinyint4.0.7

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 direkt
-677Die Person kann nicht gelöscht werden, da es mind. ein Posting gibt, das nicht gelöscht werden darfnur direkt
-672Fehlende Berechtigung zum Löschen von Personen eines bestimmten Personentypsnur direkt
-671Die Person kann nicht gelöscht werden, da mindestens ein Auftrag existiertnur direkt
-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 Settingsnur indirekt
-535Das Datum liegt nicht in der Vergangenheitnur indirekt
-530Der Wert ist nicht konvertierbarnur indirekt
-510Der Benutzer ist nicht registriertnur indirekt
-504Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochennur 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]
5.1.4 2006-08-14Workaround für BUG im ASE 15 [bzgl. „isnull“ und „NOT“-Operator]
5.0.4 2005-09-261. 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-29Fehler 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-211. 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-15Interne Änderung : Änderung am Ende der Prozedur bzgl. „rollback tran“
4.0.9 2004-03-03Ausführen von „set transaction isolation level 1“ und „set rowcount 0“ zu Beginn der Prozedur
4.0.7 2004-01-161. Neuer Parameter „ForceDelete“
2. Aufruf der neuen Prozeduren „_mi_StartProcedure“ und „_mi_FinishProcedure“
4.0.3 2003-07-10Berü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-23Erstmalig 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/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 -
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'),
	'pm_DeletePerson_Ad',
		array(
			'PersonID' => <value>,
			// 'ForceDelete' => 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="pm_DeletePerson_Ad">
			<Parameters>
				<Parameter Name="PersonID"><!-- integer value --></Parameter>
				<!-- <Parameter Name="ForceDelete">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/pm_deleteperson_ad.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)