Inhaltsverzeichnis
pm_ModifyPersonDetails_Ad
Prozedur zur Verwaltung von „Detail-Eigenschaften“ (zu einem Merkmal) einer oder mehrerer Personen. Unter „Detail-Eigenschaften sind Eigenschaften zu verstehen, die mehr als 100 Bytes enthalten (können).
Um eine Detailinformation für eine einzige Person zu verwalten, ist sowohl „PersonID“ als auch „SortNo“ anzugeben, wobei sich „SortNo“ auf die gleichnamige Spalte in „tempdb.dbo.TextData“ bezieht. Zu dieser „SortNo“ erwartet die Prozedur die „Detail-Eigenschaft“, die eingefügt werden soll.
Sollen zu mehreren Personen Detailinformationen eingefügt werden, muß sowohl für „PersonID“ als auch „SortNo“ „NULL“ übergeben werden. Die „Detail-Eigenschaften“ werden in diesem Fall (auch) in „tempdb.dbo.TextData“ erwartet, wobei in der „SortNo“-Spalte die gewünschten „PersonID“s einzutragen sind.
Um „Detail-Eigenschaften“ zu löschen, ist in „Data“ von „tempdb.dbo.TextData“ der Wert '' anzugeben.
Hinweis : Der übergebene Inhalt aus „tempdb.dbo.TextData“ wird nach erfolgreichem Durchlauf dieser Prozedur gelöscht.
| HTTP-Method | POST |
| HTTP-Auth | Optional |
| Tags | |
| Engine-Kategorie | person management |
| Engine-Typ | Daten-Änderung |
| Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Parameter
| Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
|---|---|---|---|---|
| PersonID | ID einer Person, zu der die „Detail-Eigenschaft“ zum Merkmal „PersonCharacteristicID“ verwaltet werden soll („NULL“ : siehe Beschreibung) | integer | 3.5.5 | |
| PersonCharacteristicID | ID eines Merkmals, auf das sich die „Detail-Eigenschaft(en)“ in „tempdb.dbo.TextData“ beziehen | smallint | 3.5.5 | |
| SortNo | Bezieht sich auf die gleichnamige Spalte in „tempdb.dbo.TextData“, in der die „Detail-Eigenschaft“ (in der Spalte „Data“) erwartet wird („NULL“ : siehe Beschreibung) | integer | 3.5.5 |
Rückgabe
Die Prozedur hat keine Rückgaben.
Output-Parameter
Die Prozedur hat keine Output-Parameter.
Mögliche Return-Codes
| Code | Beschreibung | Quelle 4) |
|---|---|---|
| -697 | Aktion kann nicht durchgeführt werden, da für ein Merkmal eine Zugriffsbeschränkung besteht | nur direkt |
| -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 |
| -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 |
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-29 | Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf] |
| 6.5.2 | 2013-02-26 | 1. Fehler : Es konnten Details zu Merkmalen übernommen werden, die nicht dem Persontyp zugeordnet waren 2. Anpassungen wg. des neuen features der „Zugriffsbeschränkungen für Merkmale“ |
| 6.0.0 | 2010-03-26 | 1. Fehlende Fehlerbehandlung an einer Stelle in der Transaktion 2. Quellcode-Anpassung an den aktuellen Standard |
| 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. Fehlende Transaktion |
| 4.0.3 | 2003-07-10 | Fehler beim Einfügen von Details zu einer einzelnen Person |
| 4.0.0 | 2003-04-03 | Komplette Überarbeitung des Quellcodes und der Doku (u.a. funktionierte das Löschen nie, falls „Detail-Eigenschaften“ für mehrere Personen angegeben wurden, hat die Prozedur immer die „Detail-Eigenschaften“ zu ALLEN Merkmalen gelöscht) |
| 3.5.5 | 2001-03-30 | 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:
cURL
Unformatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyPersonDetails_Ad?PersonID=<value>&PersonCharacteristicID=<value>&SortNo=<value>'
Mit xmllint 5) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyPersonDetails_Ad?PersonID=<value>&PersonCharacteristicID=<value>&SortNo=<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_ModifyPersonDetails_Ad', array( 'PersonID' => <value>, 'PersonCharacteristicID' => <value>, 'SortNo' => <value> ) ); $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_ModifyPersonDetails_Ad"> <Parameters> <Parameter Name="PersonID"><!-- integer value --></Parameter> <Parameter Name="PersonCharacteristicID"><!-- smallint value --></Parameter> <Parameter Name="SortNo"><!-- integer value --></Parameter> </Parameters> </Procedure> </Batch> </ListOfBatches>