Aufbau des Aufrufs

Um moveIT WEBCON zu integrieren, muss in einem iFrame die URL der moveIT WEBCON Installation inkl. ggf. URL Parametern aufgerufen werden. Dabei wird die Basis-URL dem Kunden übermittelt. Aufgrund dieser und den möglichen URL Parametern kann der Kunde drei verschiedene Aufrufvarianten für moveIT WEBCON kreieren.

Basis-URL

Eine Basis-URL ist ein zentraler Bestandteil der Webadresse einer Website. Sie setzt sich aus mehreren Komponenten zusammen: dem Protokoll (wie http oder https), dem Domänennamen (z.B. www.shop.com) und gegebenenfalls einem Verzeichnispfad (z.B. /service/). Die Basis-URL dient als Ausgangspunkt für alle relativen URLs.

Bestandteile der Basis-URL:

• Protokoll: Bestimmt, wie Daten zwischen dem Webbrowser und dem Server übertragen werden (z.B. http oder https).

• Domänenname: Der eindeutige Name der Website (z.B. shop.com).

• Verzeichnispfad: Optionaler Teil, der auf ein spezifisches Verzeichnis innerhalb der Website verweist (z.B. /service/).

Sprache (&Lng=)

nach ISO 639-1

Steuert die Sprache, in der die Web Anwendung aufgerufen wird. Voraussetzung dafür ist, dass Agents in den entsprechenden Sprachen gestartet wurden und das Backend mit den Korrekten Sprachen installiert wurde. Für Stammdaten ist zu beachten, dass diese generell die gewünschte Sprache mit ausliefern müssen. Zusätzlich muss die Stammdatenversion eingespielt werden NACHDEM die Sprache im Backend aktiviert wurde.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&Lng=DE

Land (&Country=)

nach Vehicle Registration Code

Der URL Parameter hat zwei Funktionen:

1. Definiert, welcher „DefaultCustomerForCountry“ (Admin-Setting) bei der Belegerzeugung verwendet wird.

2. Definiert, ob bzw. welche Labels bei der Preisanzeige verwendet werden.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&Lng=DE&Country=A

Modell (&Model=)

Hier kann die moveIT Modellnummer für den direkten Aufruf eines solchen Modells im Konfigurator angegeben werden. Kann durch den Parameter &OwnId ergänzt werden, wenn es mehrere Modelle mit der gleichen Modellnummer unterschiedlicher Lieferanten gibt.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&Lng=DE&Model=LPU42

Eignernummer (&OwnId=)

Bei diesem URL Parameter kann eine Eignernummer (eine eindeutige Nummer auf moveIT Lieferanten-Ebene) eingegeben werden. Dies bietet zwei Funktionen:

Es kann der eKatalog direkt mit dem definierten Eigner aufgerufen werden. Wenn es im Warenstamm z.B. zwei 1KF Modelle gibt und man genauer einschränken muss, welches Modell von welchem Eigner aufgerufen werden soll, so kann man zusätzlich zum Paramter &Model auch den Parameter &OwnId angeben um das Modell eindeutig zu definieren.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&OwnId=000

https://www.shop.at/web/index.html?ConfCatalog&Consumer&OwnId=000&Model=1KF

Statistikebenen-Code (&StaCdeX=)

Wichtig: es wird zwingend der URL Paramter &OwnId benötigt, damit dieser funktioniert

<Statistikebenen-Code> (X=1-8)

Um direkt in einer Statistikebene im eKatalog einsteigen zu können, kann man &StaCdeX angeben. Das X steht für die Ebenentiefe die dem XPro WarS0X entspricht (die X müssen zusammenpassen). Den bzw. die Statistikcode(s) muss man sich eben aus diesen XPros suchen.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&OwnId=000&StaCde0=04&StaCde1=04_02

Benutzercode (&UsrCde=)

Hier kann ein User-Code angegeben werden, unter dem dann die Session im Hintergrund angemeldet wird. Dies kann wiederum sehr viele Einstellungen im Hintergrund bewirken.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&UsrCde=MaxMustermann

Makrovariable (&McrVars=)

Makrovariablen sind Variablen, auf die vom Stammdatenhersteller in den Stammdaten reagiert werden kann und je nachdem unterschiedlichste Anpassungen, Vorbelegungen, etc. in den Stammdaten durchgeführt werden können.

Der Aufbau ist dabei folgender: ParamName(ParamValue)+ParamName2(ParamValue2)+ParamName3(ParamValue3)

Makrovariablen können einzeln oder in einer Liste angegeben werden.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&McrVars=Color1(907)+Color2(906)+Glass(WRK2)

Merkzettel-ID (&LeafletId=)

Wurde bereits eine Merkzettel-ID generiert, so kann diese für den Wiederaufruf verwendet werden.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&LeafletId=992-22321323-01

Marktnummer (&Branch=)

Damit kann z.B. eine virtuelle Marktnummer an moveIT WEBCOBN übergeben werden. Ist mit dieser Nummer auch eine Niederlassung im Backend vorhanden, so wird diese Niederlassung auf dem Beleg als „Zust. Niederlassung“ hinterlegt.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&Branch=223

Ausgehende Position (&BasePosition=) [Änderungsdienst]

Soll eine abgeschlossene, in den Warenkorb übergebene Konfiguration geändert werden, so muss der URL Parameter &BasePosition= angegeben werden, welcher mit der GUID der Position 1 der zu ändernden Konfiguration belegt wird. Diese GUID wird nach Abschluss der Änderung der Konfiguration bei der erneuten Übergabe an den Warenkorb mitgegeben, wodurch der WebShop erkennen kann, dass es sich um eine Änderung handelt und auch welche Position durch die „Neue“ ersetzt werden soll.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&Consumer&BasePosition=aacabbfe-5a8b-4313-ba7e-02f55151537e

Zusätzliche Informationen (&AdditionalResponseData=)

Ähnlich wie BasePosition ist „AdditionalResponseData“ auch ein URL-Parameter, dessen Inhalt beim Aufruf von moveIT WEBCON bis zur Übergabe an den Warenkorb durchgeschleust wird und dadurch der WebShop darauf reagieren kann. Der URL-Parameter kann frei belegt werden. Als möglicher Einsatzzweck kann „AdditionalResponseData“ in Verbindung mit „BasePosition“ z.B. mit „ChangeAndReplace“ belegt werden, damit der Web-Shop bei der Übergabe erkennt, dass er die BasePosition, die im Warenkorb liegt, mit der neuen Position überschreibt. Weitere Verwendungszwecke wären z.B. zur Session-Erkennung oder um zur Erkennung der User-Journey eine ID mit zu übergeben. Der angehängte Inhalt muss selbstverständlich URL-codiert sein.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&AdditionalResponseData=Session%28aacabbfe-5a8b-4313-ba7e-02f55151537e%29%7CAction%28CopyPaste%29

Grafikbereich ausblenden (&HideGraphicContainerAtStart=TRUE)

Default ist dieses Setting auf FALSE - im Standard wird immer der Grafikbereich beim Start einer Konfiguration angezeigt.

Wird dieser Parameter angegeben und mit TRUE belegt, so wird Grafikbereich beim Laden der Konfiguration nicht angezeigt. Der Grafikbereich wird wieder angezeigt, wenn man in einen anderen Frageparameter wechselt.

Diese Option könnte bei Modellen relevant sein, die keine optische „Geschmacksfindung“ beinhalten bzw. wo die Grafik wenig, bis keine Rolle spielt.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&HideGraphicContainerAtStart=TRUE

Grafikbereich bei Grafikänderung nicht automatisch öffnen (&AutomaticReopenGraphicContainerAtChange=FALSE)

Default ist dieses Setting auf TRUE - im Standard wird immer der Grafikbereich wieder automatisch aufgeklappt, wenn man in einen anderen Frageparameter navigiert.

Wird dieser Parameter angegeben und mit FALSE belegt, so wird der Grafikbereich beim Wechsel in einen anderen Frageparameter nicht wieder automatisch aufgeklappt. Der User muss aktiv den Grafikbereich wieder öffnen.

In Kombination mit &HideGraphicContainerAtStart=TRUE kann der Grafikbereich für eine Konfiguration in der Mobile Ansicht komplett ausgeblendet werden. Also wenn folgende Parameter gesetzt werden, wird ein User keine Grafikanzeige für diese Konfiguration zu Gesicht bekommen, außer auf den Ergebnisseiten.

&AutomaticReopenGraphicContainerAtChange=FALSE&HideGraphicContainerAtStart=TRUE

Diese Option könnte bei Modellen relevant sein, die keine optische „Geschmacksfindung“ beinhalten bzw. wo die Grafik wenig bis keine Rolle spielt.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&HideGraphicContainerAtStart=TRUE&AutomaticReopenGraphicContainerAtChange=FALSE

Automatisch weiter bei Antwortauswahl (&AutomaticNextAtAnswerClick=TRUE)

Barrierefreiheit

Dieser Punkt wirkt sich negativ auf die Barrierefreiheit aus.

Default ist dieses Setting auf FALSE - im Standard ist immer ein aktiver Klick auf [Weiter] bzw. einen anderen Frageparameter durch den User notwendig.

Wird dieser Parameter angegeben und mit TRUE belegt, so wird ein Klick auf eine Antwort automatisch als [Weiter] interpretiert. [Zurück] ist nur mehr durch einen direkten Klick auf einen vorigen Frageparameter möglich.

Diese Option könnte bei Modellen relevant sein, die keine optische „Geschmacksfindung“ beinhalten und eher fixe, vorher bekannte Werte verlangt bzw. wo die Grafik wenig bis keine Rolle spielt.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&AutomaticNextAtAnswerClick=TRUE

Designer Modus ausblenden (&HideDesignerMode=TRUE)

Default ist dieses Setting FALSE - damit im Standard immer der/die Button/s zum Designer Modus [In Foto einsetzen]/[Bearbeiten] angezeigt werden. Voraussetzung, dass die Add-On Lizenz für den Designer-Modus vorhanden ist.

Wird dieser Parameter angegeben und mit TRUE belegt, so wird der Button [In Foto einsetzen] im Grafikbereich nicht angezeigt – die Anzeige soll so sein, wie wenn keine Lizenz dafür vorhanden wäre.

Diese Option könnte bei Modellen relevant sein, deren Produktgrafik nicht über den Designer-Modus in ein Foto eingesetzt werden können, oder die das Einsetzen für diesen Produkttyp (noch) nicht vorbereitet ist, weil es z.B. keine Symbolbilder gibt.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&HideDesignerMode=TRUE

Aktionen Button ausblenden (&PutInBasketVisible=FALSE)

Default ist dieses Setting TRUE - damit im Standard, wenn die Installation einen Aktions-Button (Online bestellen, In den Warenkorb legen …) auf der Ergebnisseite hat, dieser auch angezeigt wird.

Wird dieser Parameter angegeben und mit FALSE belegt, so ist der Aktions-Button auf der Ergebnisseite ausgeblendet.

Beispiel:

• https://www.shop.at/web/index.html?ConfCatalog&PutInBasketVisible=FALSE

Aufruf-Varianten

Im Webshop sind eine oder mehrere Aufrufvarianten von moveIT WEBCON (analog zu den unterhalb beschriebenen Möglichkeiten) verfügbar:

Direkter Aufruf einer moveIT WEBCON Konfiguration

Die meist genutzte Variante ist der direkte Aufruf einer moveIT WEBCON Konfiguration aus z.B. einer ProductPage. Die ProductPage wird durch den Webshop zur Verfügung gestellt und verweist über einen Link, Banner oder Schaltfläche auf die tatsächliche Konfiguration (=Aufruf moveIT WEBCON).

Aufruf der ersten Ebene des eKatalogs

Aufruf der ersten Ebene des eKatalogs aus moveIT WEBCON, wo alle vom Webshopbetreiber definierten Artikel und deren Statistikebenen aufgelistet werden

Aufruf einer gewissen vorgefilterten Produktebene

Dabei muss die sogenannte Vorfilterung in moveIT WEBCON vorab für alle Produktebenen definiert werden. Über StaCdeX= kann dann direkt eine Ebene aufgerufen werden.