mi_GetVisitorProperties_Pu [dstore]

Inhaltsverzeichnis

mi_GetVisitorProperties_Pu

mi_GetVisitorProperties_Pu

Ermittelt zu einem Besucher diverse Eigenschaften bzw. Einstellungen - diese sind im Gegensatz zur „VisitorInformations“ [siehe mi_GetVisitorInformation_Pu] jedoch vom „dStore“ vordefiniert.

Hinweis:
Falls es zur „UniqueID“ keinen Besucher (in „Visitors“) gibt, werden die „DefaultLanguageID“ und die „DefaultCurrencyID“ aus „Settings“ zurückgegeben (als „CountryID“ wird die „0“ ausgegeben).

HTTP-Method	GET
HTTP-Auth	Optional
Tags	[mi, Get, Visitor, Properties, Pu]
Engine-Kategorie	miscellaneous
Engine-Typ	Daten-Ermittlung
Letzte Aktualisierung	5.0.0 (2004-12-21)

Parameter

Name ¹⁾	Standard-Wert	Beschreibung ²⁾	SQL-Datentyp³⁾	ab Version
UniqueID		Eindeutige ID eines Besuchers (aus „Visitors“)	varchar(50)	3.5.0

Rückgabe

(parameterunabhängig)

Spaltenname	Beschreibung	SQL-Datentyp⁴⁾	ab Version
LanguageID	ID einer Sprache, die der Besucher bevorzugt	tinyint	3.5.0
CountryID	ID des Landes aus dem der Besucher kommt (zumindest hat er das vorgegeben)	smallint	3.5.0
CurrencyID	ID der Währung, die der Besucher bevorzugt	tinyint	3.5.0

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code	Beschreibung	Quelle ⁵⁾
-621	Fehlender oder falscher Eintrag in PersonTypeSettings	nur indirekt
-550	Fehlender oder falscher Eintrag in Settings	nur indirekt
-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

5.0.0	2004-12-21	Neukodierung der Prozedur aufgrund Performance-Verbesserungen und zahlreicher „Umstrukturierungen“. Die Dokumentation wurde ebenfalls überarbeitet.
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:

mi_GetVisitorProperties_Pu im Engine Playground öffnen

cURL

Unformatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/mi_GetVisitorProperties_Pu?UniqueID=<value>'

Mit xmllint ⁶⁾ formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/mi_GetVisitorProperties_Pu?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'),
	'mi_GetVisitorProperties_Pu',
		array(
			'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="mi_GetVisitorProperties_Pu">
			<Parameters>
				<Parameter Name="UniqueID"><!-- varchar value --></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