Inhaltsverzeichnis
pm_ModifyPeriodsForPredVals_Ad
Ändert, erstellt oder löscht Einträge in der Tabelle „PeriodsForPersonPredefiniedVals“, in der angegeben ist, zu welchen Zeiträumen bestimmte vordefinierte Eigenschaften (aus „PersonCharacteristicValues“) gültig sind.
Hinweise :
1. Ist für eine vordefinierten Eigenschaft in „PeriodsForPersonPredefiniedVals“ KEINE Eintrag vorhanden, bedeutet dies, daß der Wert eine uneingeschränke Gültigkeit besitzt.
2. Die Prozedur gewährleistet, daß sich Gültigkeits-Zeiträume für die gleiche Eigenschaft nicht überschneiden. Würde dies aber aufgrund der angegebenen Parameter „ValidFrom“ und „ValidTo“ der Fall sein, gibt es den Fehler „-500“ !
Anmerkung zum Parameter „ValidFrom“ :
Hierfür kann auch „NULL“ übergeben werden. Falls „Delete = 1“ ist, wird nichts ausgeführt (die Prozedur gibt aber auch keinen Fehler), da es in der Tabelle „PeriodsForPersonPredefiniedVals“ keinen Datensatz mit „ValidFrom = NULL“ geben kann !
Andernfalls soll also ein neuer Gültigkeits-Zeitraum angelegt werden (wiederum da es ja keinen Datensatz mit „ValidFrom = NULL“ geben kann). Die Prozedur versucht nun, „ValidFrom“ selbst mit einem sinnvollen Wert zu belegen : sie schaut zuerst nach, ob der Wert „ValueID“ schon verwendet wurde und wählt gegebenenfalls für „ValidFrom“ dann das Datum, an dem die Eigenschaft ZUERST einer Person zugewiesen wurde. Ist danach der Wert immer noch „NULL“, wählt die Prozedur das aktuelle Datum.
| HTTP-Method | POST |
| HTTP-Auth | Optional |
| Alias | pm_ModifyPeriodsForPredefinedValues_Ad |
| 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 |
|---|---|---|---|---|
| ValueID | ID einer vordefinierten Eigenschaft, die Personen haben können. Falls das zugehörige Merkmal für den Aufrufer lesend gesperrt ist (komplett oder eingeschränkt, s. pm_GetPChAccRestrForUsers_Ad), gibt es einen Fehler ! | integer | 4.0.0 | |
| ValidFrom | Beginn des Gültigkeits-Zeitraums für die Eigenschaft „ValueID“. Es kann auch „NULL“ angegeben werden, siehe Beschreibung. | datetime | 4.0.0 | |
| ValidTo | Ende des Gültigkeits-Zeitraums („NULL“ : „unbeschränkt gültig“) für die Eigenschaft „ValueID“. Gibt es den Datensatz mit „ValueID“ und „ValidFrom“ bereits (und ist „Delete = 0“), wird „ValidTo“ des bestehende Datensatzes mit diesem Wert aktualisiert. | datetime | 4.0.0 | |
| Delete | 0 | „1“ : Der bestehende Zeitraum zur „ValueID“, der mit „ValidFrom“ beginnt, soll gelöscht werden „0“ : Falls es schon einen Zeitraum zur „ValueID“ gibt, der mit „ValidFrom“ beginnt, wird dieser aktualisiert, ansonsten wird ein neuer Datensatz eingefügt | bit | 4.0.0 |
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. Beachtung der neuen Zugriffs-Beschränkungen für Merkmale [⇒ Doku-Anpassung] 2. Anpassungen an den aktuellen Quellcode-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.0.1 | 2003-05-16 | 1. Fehler bzgl. der Überprüfung, ob sich Zeiträume überschneiden 2. Fehler bei der automatischen Belegung von „ValidFrom“, falls hierfür „NULL“ übergeben wurde 3. Fehler im Aktualisierungs-Fall 4. Interne Dokumentations-Fehler |
| 4.0.0 | 2003-04-03 | 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_ModifyPeriodsForPredVals_Ad?ValueID=<value>&ValidFrom=<value>&ValidTo=<value>'
Mit xmllint 5) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/pm_ModifyPeriodsForPredVals_Ad?ValueID=<value>&ValidFrom=<value>&ValidTo=<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_ModifyPeriodsForPredVals_Ad', array( 'ValueID' => <value>, 'ValidFrom' => <value>, 'ValidTo' => <value>, // 'Delete' => 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_ModifyPeriodsForPredVals_Ad"> <Parameters> <Parameter Name="ValueID"><!-- integer value --></Parameter> <Parameter Name="ValidFrom"><!-- datetime value --></Parameter> <Parameter Name="ValidTo"><!-- datetime value --></Parameter> <!-- <Parameter Name="Delete">0</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>