Gibt Statistiken aus der Tabelle „PageVisits“ aus.
„PageVisits“ enthält die Angaben, wie oft eine „Seite“ pro Tag aufgerufen wurde. Dabei ist mit „Seite“ eine Bildschirm-Seite der Client-Anwendung gemeint (wie z.B. eine Webseite). Die Aufrufe müssen dazu natürlich entsprechend registriert werden, dies geschieht durch st_LogPageVisits_Pu.
HTTP-Method | GET |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | statistics |
Engine-Typ | Daten-Ermittlung |
Letzte Aktualisierung | 7.0.7 (2015-01-29) |
PageNo | (Eindeutige) Nummer einer Seite, für die die Anzahl Aufrufe ermittelt werden soll. Wird hier und für „PageCategoryID“ „NULL“ angegeben, erwartet die Prozedur „PageNo“s in „tempdb.dbo.OneID“. Wird nicht beachtet, falls „GetSumOfAllPagesPerDay = 1“ ! | smallint | 3.5.12 | |
FromDay | Statistiken ab diesem Datum abrufen | datetime | 3.5.12 | |
ToDay | NULL | Statistiken bis diesem Datum abrufen | datetime | 3.5.12 |
PageCategoryID | NULL | Möchte man für alle Seiten einer bestimmten Kategorie die jeweilige Anzahl Aufrufe wissen, setzt man „PageNo“ auf „NULL“ und übergibt hier die ID einer Kategorie von Seiten. Wird nicht beachtet, falls „GetSumOfAllPagesPerDay = 1“ ! | smallint | 3.5.12 |
GroupByCategory | 0 | Wird nur beachtet, wenn „GetSumOfAllPagesPerDay = 0“ ist ! Gibt man hier „1“ an, liefert die Prozedur eine Kummulierung pro Kategorie; ist eine „PageCategoryID“ angegeben, wird nur die Summe der Aufrufe aller Seiten dieser Kategorie ermittelt. | bit | 3.5.13 |
OrderByDay | 0 | Wird nur beachtet, wenn „GetSumOfAllPagesPerDay = 0“ ist ! Bestimmt, ob primär nach dem Datum (→ Rückgabespalte „Day“) sortiert werden soll und dann nach „PageNo“ bzw. „PageCategoryID“ („1“) oder umgekehrt („0“). | bit | 3.5.14 |
GetSumOfAllPagesPerDay | 0 | Setzt man diesen Parameter auf „1“, erhält man für jeden Tag im gewünschten Zeitraum „FromDay“ bis „ToDay“ die SUMME ALLER Seiten an dem entsprechenden Tag. Insbesondere werden alle anderen Parameter ignoriert. | bit | 3.5.14 |
Spaltenname | Beschreibung | SQL-Datentyp1) | ab Version |
---|---|---|---|
Day_datetime2) | Wird nicht ausgegeben, sondern nur zur Sortierung verwendet | datetime | 3.5.5 |
PageNo | (Eindeutige) Nummer einer (Bildschirm-)Seite der Client-Anwendung | integer | 3.5.13 |
Page | Name/Bezeichnung der Seite „PageNo“ | varchar(100) | 3.5.5 |
Day | Tagesdatum (Format „15.03.2001“) im Zeitraum „FromDay“ bis „ToDay“ | varchar(10) | 3.5.5 |
Counter | Gibt an, wie oft die Seite „PageNo“ am Tag „Day“ aufgerufen wurde | integer | 3.5.5 |
wenn OrderByDay = 0
wenn OrderByDay = 1
Spaltenname | Beschreibung | SQL-Datentyp3) | ab Version |
---|---|---|---|
Day_datetime4) | Wird nicht ausgegeben, sondern nur zur Sortierung verwendet | datetime | 3.5.5 |
PageCategoryID | ID einer Kategorie für Seiten | smallint | 3.5.13 |
PageCategoryDescription | Bezeichung der Kategorie „PageCategoryID“ | varchar(100) | 3.5.13 |
Day | Tagesdatum (Format „15.03.2001“) im Zeitraum „FromDay“ bis „ToDay“ | varchar(10) | 3.5.13 |
Counter | Gibt die Summe aller Aufrufe von Seiten der Kategorie „PageCategoryID“ am Tag „Day“ an | integer | 3.5.13 |
wenn OrderByDay = 0
wenn OrderByDay = 1
Spaltenname | Beschreibung | SQL-Datentyp5) | ab Version |
---|---|---|---|
Day_datetime6) | Wird nicht ausgegeben, sondern nur zur Sortierung verwendet | datetime | 3.5.5 |
Day | Tagesdatum (Format „15.03.2001“) im Zeitraum „FromDay“ bis „ToDay“ | varchar(10) | 3.5.14 |
Counter | Gibt die Summe aller Aufrufe aller Seiten am Tag „Day“ an | integer | 3.5.14 |
(parameterunabängige Sortierung)
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 7) |
---|---|---|
-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 |
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] |
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.0 | 2003-04-03 | Name einer Rückgabespalte war in einem Fall nicht benannt |
3.5.14 | 2002-01-23 | |
3.5.13 | 2001-12-06 | |
3.5.12 | 2001-10-17 | |
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 GET 'http://<partner>-<project>.dstore.de/default/engine/st_GetPageVisits_Ad?PageNo=<value>&FromDay=<value>'
Mit xmllint 8) formatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/st_GetPageVisits_Ad?PageNo=<value>&FromDay=<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_GetPageVisits_Ad', array( 'PageNo' => <value>, 'FromDay' => <value>, // 'ToDay' => NULL, // 'PageCategoryID' => NULL, // 'GroupByCategory' => 0, // 'OrderByDay' => 0, // 'GetSumOfAllPagesPerDay' => 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_GetPageVisits_Ad"> <Parameters> <Parameter Name="PageNo"><!-- smallint value --></Parameter> <Parameter Name="FromDay"><!-- datetime value --></Parameter> <!-- <Parameter Name="ToDay">NULL</Parameter> --> <!-- <Parameter Name="PageCategoryID">NULL</Parameter> --> <!-- <Parameter Name="GroupByCategory">0</Parameter> --> <!-- <Parameter Name="OrderByDay">0</Parameter> --> <!-- <Parameter Name="GetSumOfAllPagesPerDay">0</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>