st_InsertTreeNodeHits_Pu [dstore]

Inhaltsverzeichnis

st_InsertTreeNodeHits_Pu

st_InsertTreeNodeHits_Pu

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	[st, Insert, Tree, Node, Hits, Pu]
Engine-Kategorie	statistics
Engine-Typ	Daten-Änderung
Letzte Aktualisierung	6.0.6 (2012-03-01)

Parameter

Name ¹⁾	Standard-Wert	Beschreibung ²⁾	SQL-Datentyp³⁾	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

Rückgabe

Die Prozedur hat keine Rückgaben.

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code	Beschreibung	Quelle ⁴⁾
-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

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 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

Code-Snippets

Engine Playground

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

st_InsertTreeNodeHits_Pu im Engine Playground öffnen

cURL

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/st_InsertTreeNodeHits_Pu?TreeNodeID=<value>&UniqueID=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/st_InsertTreeNodeHits_Pu?TreeNodeID=<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_InsertTreeNodeHits_Pu',
		array(
			'TreeNodeID' => <value>,
			'UniqueID' => '<value>',
			// 'IsNodeID' => 0
		)
);
 
$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_InsertTreeNodeHits_Pu">
			<Parameters>
				<Parameter Name="TreeNodeID"><!-- integer value --></Parameter>
				<Parameter Name="UniqueID"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="IsNodeID">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>

¹⁾

Pflichtparameter sind unterstrichen

²⁾

siehe Parameter-Konventionen engine/<Prozedur-Name>

³⁾

siehe Datentypen im Bereich "engine"

⁴⁾

direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“

⁵⁾

I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Inhaltsverzeichnis