Inhaltsverzeichnis
st_InsertPageHit_Pu
Fügt in die Tabelle „OLTP_StatisticData“ einen Eintrag ein, welche „PageTreeNode“ (von einem Besucher) aufgerufen wurde.
„PageTreeNodes“ zeichnen sich dadurch aus, daß sie eine „TreeNodeID“ kleiner „0“ besitzen. Gemeint sind Elemente, die nicht zur Artikelstruktur gehören, aber trotzdem in den Statistiken zur Basis-Kennzahl „1“ („Views“) auftauchen sollen. Da die Anwendungsfälle hierfür im Regelfall Web-SEITEN (außerhalb der Produkt-Navigation) sind, deren Aufruf man zählen möchte, wurde der Name „Page“-TreeNodes gewählt. Diese „TreeNodes“ sollten nur verwendet werden, wenn man am sogenannte „Click-Stream“ eines Besuchers interessiert ist (siehe st_GetClickStream_Ad), denn ansonsten gibt es die Tabelle „Pages“, „PagesInCategories“, „PageCategories“ und „PageVisits“, die dem Zählen von Seiten-Aufrufen dienen (siehe u.a. st_GetPages_Ad, st_GetPageVisits_Ad etc.).
Anmerkung :
Für Artikel-Elemente ist die Prozedur st_InsertTreeNodeHits_Pu zu verwenden.
| HTTP-Method | POST |
| HTTP-Auth | Optional |
| Tags | |
| Engine-Kategorie | statistics |
| Engine-Typ | Daten-Änderung |
| Letzte Aktualisierung | 6.0.6 (2012-03-01) |
Parameter
| Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
|---|---|---|---|---|
| PageDescription | Name einer „Seite“, für die ein Aufruf registriert werden soll. Es muß sich hierbei um die Bezeichnung („NodeDescription“) eines Elementes aus der Tabelle „dStore“ handeln, und die zugehörige „NodeID“ muß kleiner als „-1“ sein, sonst gibt es einen Fehler. | varchar(100) | 3.5.0 | |
| UniqueID | Eindeutige ID des Besuchers, für den ein Aufruf der Seite „PageDescription“ gezählt werden soll | varchar(50) | 3.5.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) |
|---|---|---|
| -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 |
XML-Schema
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
Historie
| 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 | |
| 3.5.0 | 2000-11-23 | 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/st_InsertPageHit_Pu?PageDescription=<value>&UniqueID=<value>'
Mit xmllint 5) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/st_InsertPageHit_Pu?PageDescription=<value>&UniqueID=<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'), 'st_InsertPageHit_Pu', array( 'PageDescription' => '<value>', 'UniqueID' => '<value>' ) ); $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="st_InsertPageHit_Pu"> <Parameters> <Parameter Name="PageDescription"><!-- varchar value --></Parameter> <Parameter Name="UniqueID"><!-- varchar value --></Parameter> </Parameters> </Procedure> </Batch> </ListOfBatches>