Mit dieser Prozedur kann man im „dStore“ registrieren lassen, daß ein bestimmtes Artikel-Element „getroffen“ bzw. „angesehen“ wurde. Durch einen Aufruf dieser Prozedur wird dann in die Tabelle „OLTP_StatisticData“ ein Datensatz zur Basis-Kennzahl „1“ („Views“) für das entsprechende Element eingefügt - sowie indirekte Treffer für die Vorgänger-Elemente, falls „IsNodeID = 0“.
Hinweise :
1. Damit die hierdurch registrierten Statistiken auch ausgewertet werden können, muß in regelmäßigen Abständen st_CopyFromOLTPtoDSS_Ad aufgerufen werden.
2. Ein „Treffer“ wird nur dann registriert, wenn die Hierarchie-Nummer des übergebenen Elementes größer ist als der in „Settings“ zum Schlüssel „HitLevelNo“ konfigurierte Wert. Ist diese Bedingung nicht erfüllt (insbesondere wenn „HitLevelNo“ in „Settings“ nicht konfiguriert ist !), gibt es jedoch keinen Fehler.
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 |
---|---|---|---|---|
TreeNodeID | ID eines Elementes im Artikelbaum bzw. eines Artikel-Elementes (je nach „IsNodeID“), für das ein „Treffer“ (zur Basis-Kennzahl „1“ [„Views“]) registriert werden soll | integer | 3.5.0 | |
UniqueID | Eindeutige ID des Besuchers, dem der „Treffer“ zuzuordnen ist | varchar(50) | 3.5.0 | |
IsNodeID | 0 | „0“ : „TreeNodeID“ ist ein Element im Artikelbaum (also eine „TreeNodeID“ aus „TreeView“) „1“ : Bei „TreeNodeID“ handelt es sich um ein Artikel-Element, also eine „NodeID“ aus der Tabelle „dStore“ | bit | 3.5.0 |
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 | direkt und indirekt |
-110 | Das (die) Element(e) ist (sind) nicht vorhanden | nur indirekt |
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 Besuchers „defaultUniqueID“ 2. Anpassungen an den Quellcode-Standard 3. Fehlende Fehlerbehandlung an einer Stelle 4. Ab jetzt gibt es einen Fehler, wenn eine ungültige „UniqueID“ angegeben wird |
4.0.0 | 2003-04-03 | 1. Ein unglaublicher HAMMER-Fehler bzgl. der Ermittlung der Hierarchie der übergebenen „TreeNodeID“ : Es wurde überhaupt nicht nach „IsNodeID“ unterschieden 2. Überarbeitung des Quelltextes 3. Überarbeitung der Doku |
3.5.15 | 2002-03-12 | |
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 POST 'http://<partner>-<project>.dstore.de/default/engine/st_InsertTreeNodeHits_Pu?TreeNodeID=<value>&UniqueID=<value>'
Mit xmllint 5) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/st_InsertTreeNodeHits_Pu?TreeNodeID=<value>&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_InsertTreeNodeHits_Pu', array( 'TreeNodeID' => <value>, 'UniqueID' => '<value>', // 'IsNodeID' => 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_InsertTreeNodeHits_Pu"> <Parameters> <Parameter Name="TreeNodeID"><!-- integer value --></Parameter> <Parameter Name="UniqueID"><!-- varchar value --></Parameter> <!-- <Parameter Name="IsNodeID">0</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>