Die Prozedur gibt die einem oder mehreren Besucher(n) zugeordneten Personen bzw. die einer oder mehreren Person(en) zugeordneten Besucher aus.
Anmerkung :
Diese Besucher-Personen-Zuordnungen werden nur von der zentralen Prozedur zur Identifizierung von Personen, pm_CheckPersonIdentity_Pu, sowie von der öffentlichen Prozedur zum Anlegen von Personen, pm_InsertNewPerson_Pu, gepflegt.
HTTP-Method | GET |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | statistics |
Engine-Typ | Daten-Ermittlung |
Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
---|---|---|---|---|
VisitorID | ID des Besuchers, zu dem die Zuordnungen gesucht werden sollen. Wird nur beachtet, wenn „VisitorOrPersonIDsInOneID = 0“ ist ! | integer | 3.5.0 | |
FromDate | NULL | Falls angegeben, werden nur Zuordnungen herausgesucht, die zu diesem oder einem späteren Zeitpunkt eingetragen wurden. Bei „NULL“ werden alle jemals gespeicherten Zuordnungen zu Besuchern (bzw. zu Personen) berücksichtigt („ToDate“ wird dann ignoriert). | datetime | 3.5.0 |
ToDate | NULL | Falls angegeben, werden nur Zuordnungen herausgesucht, die zu diesem oder einem früheren Zeitpunkt eingetragen wurden | datetime | 3.5.0 |
PersonID | NULL | ID einer Person, zu der die zugeordneten Besucher ermittelt werden sollen. Wird nur beachtet, wenn „VisitorOrPersonIDsInOneID = 0“ und „VisitorID = NULL“ ist ! | integer | 4.0.8 |
VisitorOrPersonIDsInOneID | 0 | In „tempdb.dbo.OneID“ werden… „1“ : „VisitorID“s erwartet, zu denen die zugeordneten Personen ermittelt werden sollen „2“ : „PersonID“s erwartet, zu denen dann die zugeordneten Besucher herausgefunden werden | tinyint | 4.0.8 |
OutputIntoOneID | 0 | Soll keine Ergebnismenge zurückgegeben, sondern sollen die „PersonID“s bzw. „VisitorID“s in „tempdb.dbo.OneID“ gespeichert werden (z.B. um diese Prozedur nochmals mit „VisitorOrPersonIDsInOneID = 1“ aufzurufen), ist „1“ anzugeben. | bit | 4.0.8 |
Spaltenname | Beschreibung | SQL-Datentyp4) | ab Version |
---|---|---|---|
ValidFrom_datetime5) | Wird nicht ausgegeben, sondern nur zur Sortierung verwendet. Es handelt sich um den Beginn des Zeitraums, in dem die Zuordnung „VisitorID“-„PersonID“ bestand (bzw. evtl. noch besteht). | datetime | 3.5.0 |
VisitorID | ID eines Besuchers, der im Zeitraum „ValidFrom“ bis „ValidTo“ der Person „PersonID“ zugeordnet war (bzw. immer noch ist) | integer | 4.0.8 |
ValidFrom | Beginn des Zeitraums, in dem die Zuordnung „VisitorID“-„PersonID“ bestand (bzw. evtl. noch besteht) als „String“ im Format „01.04.2001 15:20:55:115“ | varchar(23) | 3.5.0 |
ValidTo | Ende des Zeitraums, in dem die Zuordnung „VisitorID“-„PersonID“ bestand (bzw. evtl. noch besteht) als „String“ im Format „01.04.2001 15:20:55:115“. „NULL“ bedeutet, daß die Zuordnung aktuell noch gültig ist. | varchar(21) | 3.5.0 |
PersonID | ID einer Person, die im Zeitraum „ValidFrom“ bis „ValidTo“ dem Besucher „VisitorID“ zugeordnet war (bzw. immer noch ist) | integer | 3.5.0 |
PersonType | Bezeichnung des Typs der Person „PersonID“ | varchar(100) | 3.5.0 |
CharacteristicValue1 | Eigenschaft von „PersonID“ zum 1. Merkmal, das in „PersonTypeSettings“ (zum entspr. Personentyp) zum Schlüssel „PersonCharacteristicIDsGrantedByUniqueID“ konfig. ist (u. nicht für den Aufrufer kompl. lesend gesperrt ist, s. pm_GetPChAccRestrForUsers_Ad) | varchar(100) | 3.5.0 |
CharacVal1RestrByPattern | Was enthält „CharacteristicValue1“ (womögl. wg. Zugriffsbeschr. nur einen Teil) ? - NULL : den vollständigen Wert - „#left(<n>)#“ : die ERSTEN n Zeichen - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ ⇒ „CharacteristicValue1“ dann „NULL“) | varchar(100) | 6.5.4 |
CharacteristicValue2 | Eigenschaft von „PersonID“ zum 2. Merkmal, das in „PersonTypeSettings“ (zum entspr. Personentyp) zum Schlüssel „PersonCharacteristicIDsGrantedByUniqueID“ konfig. ist (u. nicht für den Aufrufer kompl. lesend gesperrt ist, s. pm_GetPChAccRestrForUsers_Ad) | varchar(100) | 3.5.0 |
CharacVal2RestrByPattern | Wie „CharacVal1RestrByPattern“ - nur eben auf „CharacteristicValue2“ bezogen | varchar(100) | 6.5.4 |
PersonTypeID | ID des Typs der Person „PersonID“ | tinyint | 4.0.5 |
wenn VisitorOrPersonIDsInOneID = 0
wenn VisitorOrPersonIDsInOneID = 1
wenn VisitorOrPersonIDsInOneID = 2
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 6) |
---|---|---|
-621 | Fehlender oder falscher Eintrag in PersonTypeSettings | 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 |
-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 | direkt und 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] |
6.5.4 | 2013-04-29 | 1. Anpassungen an aktuellen Code-Standard 2. Implementierung des neuen Merkmal-Zugriffsbeschränkungen-Features [⇒ auch Hinweis in der Doku] 3. Neue Rückgabespalten „CharacVal…RestrByPattern“ [wg. „Zugriffsbeschränkungen“] |
5.1.8 | 2006-12-12 | Workaround für BUG im ASE beim „ORDER BY“ einer Ergebnismenge, die Spalten enthält, die „NULL“ sein können |
5.1.5 | 2006-08-29 | Explizites „ORDER BY“ eingefügt, um die Sortierung der Rückgabemenge zu garantieren |
4.0.9 | 2004-03-03 | 1. Fehler beim Aufruf von „_mi_StartProcedure“ 2. Ausführen von „set transaction isolation level 1“ und „set rowcount 0“ zu Beginn der Prozedur |
4.0.8 | 2004-02-20 | 1. Aufruf der Prozeduren „_mi_StartProcedure“ und „_mi_FinishProcedure“ 2. 3 neue Parameter 3. Neue Rückgabespalte „VisitorID“ 4. Möglichkeit, das Ergebnis in „tempdb.dbo.OneID“ speichern zu lassen 5. Anderes Format der Datums-Rückgabespalten |
4.0.5 | 2003-10-04 | 1. Verlagerung diverser „Settings“-Einträge auf entsprechende „PersonTypeSettings“-Einträge 2. Neue Rückgabespalte „PersonTypeID“ |
3.5.19 | 2002-06-17 | |
3.5.0 | 2000-11-23 | 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 GET 'http://<partner>-<project>.dstore.de/default/engine/st_GetVisitorPersons_Ad?VisitorID=<value>'
Mit xmllint 7) formatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/st_GetVisitorPersons_Ad?VisitorID=<value>' | 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'), 'st_GetVisitorPersons_Ad', array( 'VisitorID' => <value>, // 'FromDate' => NULL, // 'ToDate' => NULL, // 'PersonID' => NULL, // 'VisitorOrPersonIDsInOneID' => 0, // 'OutputIntoOneID' => 0 ) ); $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="st_GetVisitorPersons_Ad"> <Parameters> <Parameter Name="VisitorID"><!-- integer value --></Parameter> <!-- <Parameter Name="FromDate">NULL</Parameter> --> <!-- <Parameter Name="ToDate">NULL</Parameter> --> <!-- <Parameter Name="PersonID">NULL</Parameter> --> <!-- <Parameter Name="VisitorOrPersonIDsInOneID">0</Parameter> --> <!-- <Parameter Name="OutputIntoOneID">0</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>