pm_ConsistencyCheck_Ad [dstore]

Inhaltsverzeichnis

pm_ConsistencyCheck_Ad

pm_ConsistencyCheck_Ad

Überprüft die Daten-Konsistenz und -Integrität der zu einem Personen-Merkmal vorhandenen Eigenschaften.

ACHTUNG : Beim Aufruf dieser Prozedur können bis zu vier Ergebnismengen zurückgegeben werden !

HTTP-Method	POST
HTTP-Auth	Optional
Tags	[pm, Consistency, Check, Ad]
Engine-Kategorie	system administration
Engine-Typ	Daten-Ermittlung
Letzte Aktualisierung	7.0.7 (2015-01-29)

Parameter

Name ¹⁾	Standard-Wert	Beschreibung ²⁾	SQL-Datentyp³⁾	ab Version
PersonCharacteristicID	NULL	ID eines Personen-Merkmals. Wenn angegeben, muß der Aufrufer vollständigen lesenden Zugriff auf das Merkmal haben ! Wird „NULL“ angegeben, überprüft die Prozedur alle Personen-Merkmale (Merkmale mit Zugriffsbeschränkung werden ausgelassen).	smallint	3.5.13
WhatToCheck	7	Was soll gecheckt werden ? „1“ : Nicht referenzierter Eigenschaften „2“ : „UsedByPersonType_Bitmap“ in „PersonCharacteristicValues“ „4“ : „PersonCharacteristicSearch“ „8“ : „Unique“-Eigenschaft (Prüfung mehrerer Sachen : entsprechende Summe angeben)	tinyint	3.5.13

Rückgabe

wenn WhatToCheck IN (1,3,5,7,9,11,13,15)

Spaltenname	Beschreibung	SQL-Datentyp⁴⁾	ab Version
ValueID	ID der Eigenschaft, die nicht mehr referenziert wird	integer	3.5.13
PersonCharacteristicID	ID des Merkmals zu dem die nicht referenzierte Eigenschaft gehört	smallint	3.5.13
Value	Die Eigenschaft, die nicht mehr referenziert wird	varchar(100)	3.5.13
SortNo	Reihenfolge in der Sortierung ALLER Eigenschaften zu dem Merkmal	integer	3.5.13
UsedByPersonType_Bitmap	Bit-Muster, durch das angegeben ist, welche Personentypen die Eigenschaft verwenden (ist also falsch, wenn nicht „NULL“ oder „0“)	integer	3.5.13

Sortierung der Rückgabe

(parameterunabängige Sortierung)

PersonCharacteristicID (aufsteigend)
SortNo (absteigend)
Value (aufsteigend)

wenn WhatToCheck IN (2,3,6,7,10,11,14,15)

Spaltenname	Beschreibung	SQL-Datentyp⁵⁾	ab Version
SortNo⁶⁾	Reihenfolge in der Sortierung ALLER Eigenschaften zu dem Merkmal. Diese Spalte wird nicht ausgegeben, sondern nur zur Sortierung der Rückgabemenge verwendet !	integer	3.5.13
ValueID	ID der Eigenschaft mit einem falschen Wert in „UsedByPersonType_Bitmap“	integer	3.5.13
Wrong_UsedByPersonType_Btmp	Alter (falscher) Wert von „UsedByPersonType_Bitmap“	integer	3.5.13
Correct_UsedByPersonType_Btmp	Richtiger Wert von „UsedByPersonType_Bitmap“	integer	3.5.13
PersonCharacteristicID	ID des Merkmals, zu dem die Eigenschaft mit einem falschen Wert in „UsedByPersonType_Bitmap“ gehört	smallint	3.5.13
Value	Eigenschaft mit einem falschen Wert in „UsedByPersonType_Bitmap“	varchar(100)	3.5.13

Sortierung der Rückgabe

(parameterunabängige Sortierung)

PersonCharacteristicID (aufsteigend)
SortNo (absteigend)
Value (aufsteigend)

wenn WhatToCheck IN (4,5,6,7,12,13,14,15)

Spaltenname	Beschreibung	SQL-Datentyp⁷⁾	ab Version
InconsistenceType	Gibt die Art des Fehlers des Datensatzes an: „1“ : falscher Wert „2“ : fehlender Wert „3“ : überfüssiger Wert	tinyint	3.5.13
PersonCharacteristicID	ID des Merkmals zu dem der fehlerhafte Datensatz gehört	smallint	3.5.13
PersonTypeID	ID des Personentyps zu dem der fehlerhafte Datensatz gehört	tinyint	3.5.13
FirstFourCharactersLowerCase	Repräsentiert alle Eigenschaften zu dem Merkmal, die von dem Personentyp verwendet werden, die in den ersten vier Buchstaben (case-insensitiv) mit diesem Wert übereinstimmen.	varchar(10)	3.5.13
Wrong_CountPersons	Alter (falscher bzw. nicht vorhandener) Wert von „CountPersons“, also der Anzahl Personen, die eine Eigenschaft haben, die durch „FirstFourCharactersLowerCase“ repräsentiert wird.	integer	3.5.13
Correct_CountPersons	Richtiger Wert für „CountPersons“	integer	3.5.13
Wrong_CountValues	Alter (falscher bzw. nicht vorhandener) Wert für „CountValues“; das ist die Anzahl verschiedener Eigenschaften, die von dem Personentyp verwendet werden und in den ersten vier Buchstaben (case-insensitiv) mit „FirstFourCharactersLowerCase“ übereinstimmen.	integer	3.5.13
Correct_CountValues	Richtiger Wert für „CountValues“	integer	3.5.13

Sortierung der Rückgabe

(parameterunabängige Sortierung)

InconsistenceType (aufsteigend)
PersonCharacteristicID (aufsteigend)
PersonTypeID (aufsteigend)
FirstFourCharactersLowerCase (aufsteigend)

wenn WhatToCheck IN (8,9,10,11,12,13,14,15)

Spaltenname	Beschreibung	SQL-Datentyp⁸⁾	ab Version
PersonCharacteristicID	ID eines „unique“-Merkmals zu der eine Eigenschaft mehrfach verwendet wird oder der zugehörige Datensatz in „UniquePersonProperties“ fehlt	smallint	6.0.3
Value_lowercase	Eigenschaft (lowercase) zum „unique“-Merkmal „PersonCharacteristicID“, die mehrfache verwendet wird oder für die der zugehörige Datensatz in „UniquePersonProperties“ fehlt	varchar(100)	6.0.3
PersonID	ID der Person, der „Value“ als Eigenschaft zugeord. ist, und es gilt : Entweder gibt es in der Ergebnismenge eine ANDERE „PersonID“, der eine Eigensch. mit ident. „Value_lowercase“ zugeord. ist oder es fehlt der zugehör. Datensatz in „UniquePersonProperti	integer	6.0.3
ValueID	ID der Eigenschaft „Value“	integer	6.0.3
Value	Eigenschaft zum „unique“-Merkmal, die mehrfach verwendet wird oder zu der ein entsprechender Eintrag in „UniquePersonProperties“ fehlt	varchar(100)	6.0.3
SortNo	Reihenfolge in der Sortierung ALLER Eigenschaften zu dem Merkmal	integer	6.0.3
UsedByPersonType_Bitmap	Bit-Muster, durch das angegeben ist, welche Personentypen die Eigenschaft verwenden	integer	6.0.3

Sortierung der Rückgabe

(parameterunabängige Sortierung)

PersonCharacteristicID (aufsteigend)
Value_lowercase (aufsteigend)
PersonID (aufsteigend)

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code	Beschreibung	Quelle ⁹⁾
-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	direkt und indirekt
-500	Falsche Parameter	nur 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.3	2013-03-18	Doku-Anpassung : „varchar“-Datentyp der Rückgabespalte „FirstFourCharactersLowerCase“ hat sich aufgrund einer entsprechenden Tabellenänderung erweitert [von „4“ auf „10“]
6.5.2	2013-02-26	Beachtung der neuen Zugriffs-Beschränkungen für Merkmale
6.0.3	2011-09-07	1. Quellcode-Anpassung an den aktuellen Standard 2. Neue Check-Möglichkeit [⇒ Neue Werte möglich für „WhatToCheck“]
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.5.19	2002-06-17
3.5.13	2001-12-06	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:

pm_ConsistencyCheck_Ad im Engine Playground öffnen

cURL

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ConsistencyCheck_Ad'

Mit xmllint ¹⁰⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ConsistencyCheck_Ad' | 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_ConsistencyCheck_Ad',
		array(
			// 'PersonCharacteristicID' => NULL,
			// 'WhatToCheck' => 7
		)
);
 
$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_ConsistencyCheck_Ad">
			<Parameters>
				<!-- <Parameter Name="PersonCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="WhatToCheck">7</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>

¹⁾

Pflichtparameter sind unterstrichen

²⁾

siehe Parameter-Konventionen engine/<Prozedur-Name>

³⁾ , ⁴⁾ , ⁵⁾ , ⁷⁾ , ⁸⁾

siehe Datentypen im Bereich "engine"

⁶⁾

Spalte wird nicht zurückgegeben und ist hier nur aus Dokumentationsgründen aufgeführt.

⁹⁾

direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“

¹⁰⁾

I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Inhaltsverzeichnis