Protokolliert (für einen Besucher) den Aufruf einer „Seite“ in der Tabelle „PageVisits“. Dabei ist mit „Seite“ eine Bildschirm-Seite der Client-Anwendung gemeint (wie z.B. eine Webseite).
Gleichzeitig wird automatisch die Anzahl „Besuche“ (in der Tabelle „Visits“) gepflegt. Der „dStore“ versteht in Anlehnung an die Richtlinien der von den Werbeträgern getragenen „Informationsgesellschaft zur Feststellung der Verbreitung von Werbeträgern“ (IVW) unter einem „Visit“ einen „zusammenhängenden Nutzungsvorgang (Besuch)“, sprich ein Folge von Aufrufen dieser Prozedur mit der gleichen „UniqueID“. Besuche gelten als beendet, wenn 30 Minuten lang kein Element abgerufen wurde !
HTTP-Method | POST |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | statistics |
Engine-Typ | Daten-Änderung |
Letzte Aktualisierung | 6.0.6 (2012-03-01) |
Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
---|---|---|---|---|
UniqueID | Eindeutige ID des Besuchers, für den ein Aufruf der durch „PageNo“ eindeutig gekennzeichneten „Seite“ gezählt werden soll | varchar(50) | 3.5.5 | |
PageNo | 0 | (Eindeutige) Nummer einer Seite, die vom Besucher aufgerufen wurde | smallint | 3.5.5 |
Die Prozedur hat keine Rückgaben.
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 4) |
---|---|---|
-602 | Zur defaultUniqueID („VisitorID = -2“) können keinerlei Daten gespeichert oder verändert werden | nur direkt |
-600 | Es konnte keine gültige VisitorID ermittelt werden | nur direkt |
-500 | Falsche Parameter | nur direkt |
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
6.0.6 | 2012-03-01 | 1. Beachtung des neuen, speziellen Besuchers „defaultUniqueID“ - für den keine Daten-Speicherung/-Änderung erlaubt ist 2. Anpassungen an den aktuellen Quellcode-Standard |
3.5.5 | 2001-03-30 | 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 POST 'http://<partner>-<project>.dstore.de/default/engine/st_LogPageVisits_Pu?UniqueID=<value>'
Mit xmllint 5) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/st_LogPageVisits_Pu?UniqueID=<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_LogPageVisits_Pu', array( 'UniqueID' => '<value>', // 'PageNo' => 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_LogPageVisits_Pu"> <Parameters> <Parameter Name="UniqueID"><!-- varchar value --></Parameter> <!-- <Parameter Name="PageNo">0</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>