Allgemeines

Der Navigator Pro ist die beste Möglichkeit auf alle Artikeldaten eines Portals zuzugreifen. Binden Sie diesen mit der Funktion oxomi.navigatorPro ein. Die Standardansicht ist eine Markenübersicht. Mithilfe von Filtern über Serien, Produktgruppen und ETIM Merkmalen lassen sich die Produkte des Portals anschließend durchsuchen.

Standardmäßig werden die Produkte herstellerübergreifend durchsucht. Sobald der Nutzer sich in einer Marke mit einer Lieferantennummer befindet, werden die Produkte des Herstellers dieser Marke durchsucht. Damit dies funktioniert, müssen in den Partnerschaften Lieferantennummern gepflegt werden.

Neben der klassischen direkten Integration steht Ihnen noch die Funktion oxomi.openNavigatorPro zur Verfügung, welche den Navigator Pro in einem Overlay öffnet. Die nachfolgend beschriebenen Parameter sind bei beiden Varianten identisch.

Hauptparameter

Diese Parameter geben an, in welchen Elementen, also wo auf der Seite, die einzelnen Komponenten der Suche platziert werden sollen. Geben Sie hierfür die DOM-ID des jeweiligen Elements an.

Parameter Parametertyp Beschreibung
target string

Gibt das Ziel-Element an, in welches die Markenübersicht/Suchergebnisse und die zugehörige Filterbox eingefügt wird.

Hinweis:

  • Wird der Parameter nicht angegeben, so wird #oxomi-navigator-pro als Default-Wert verwendet.
input string

Gibt das Ziel-Element an, in welches die Suchleiste eingefügt wird.

Hinweis:

  • Wird dieser Parameter nicht angegeben, so wird die Suchleiste in das Ziel-Element, welches mit dem Parameter target angegeben wurde, eingefügt.
showFilterBox boolean

Gibt an, ob die Filterbox angezeigt werden soll. Die Filterbox bietet verschiedene Filtermöglichkeiten für die Nutzer an.

Hinweis:

  • Wird der Parameter nicht angegeben, so wird true als Default-Wert verwendet.
showJumpToTopButton boolean

Gibt an, ob der Button zum Springen an den Anfang der Seite angezeigt werden soll.

Hinweis:

  • Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet.
invokeInfoplayOnProductClick boolean

Gibt an, ob bei einem Klick auf ein Produkt Infoplay ausgelöst werden soll, satt das Datenblatt zu öffnen.

Hinweis:

  • Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet.
hideStories boolean

Für den Fall, dass Stories (Navlets und Searchlets) nicht gewünscht sind, kann dieser Parameter mit dem Wert true belegt werden. Dieser Parameter ist nur für die direkte Integration verfügbar.

Hinweis:

  • Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet.
Filterparameter

Mit diesen Parametern können Sie die Produkte, die im Navigator Pro verfügbar sind, schon von vornherein filtern. So können sie beispielsweise einen Navigator Pro für eine einzelne Marke oder für alle Ersatzteile realisieren.

Die so gesetzten Filter können vom Nutzer nachträglich auch wieder entfernt werden. Verwenden Sie eine der “Versteckten Filterparameter”, falls dies nicht möglich sein soll.

Parameter Parametertyp Beschreibung
query string

Öffnet die Suche mit vorausgefüllter Suchanfrage. Ein Beispiel für die Verwendung dieses Parameters kann hier eingesehen werden:

Interaktives Code-Beispiel

brand string

Gibt die ID einer Marke an, auf welche gefiltert werden soll.

series string

Gibt die ID einer Serie an, auf welche gefiltert werden soll.

productGroup string

Gibt den Code der Produktgruppe an, auf welche gefiltert werden soll.

classification string

Gibt den Code einer Klassifikation (ETIM Klasse) an, auf welche gefiltert werden soll.

features object

Gibt eine Map von Feature Code auf Feature Wert an nach denen gefiltert werden sollen.

Hinweis:

  • Damit ein angegebener features Filter funktioniert, muss auch der Filter classification gesetzt sein.

Beispiel:

Für den Fall das nur Produkte aus dem Werkstoff „Keramik“ und der Farbe „weiß“ angezeigt werden sollen, muss der Parameter wie folgt gesetzt werden:

features: {
    'EF000007': 'EV000202',
    'EF002169': 'EV000572'
}

productType string

Gibt den Produkttyp an, auf welchen gefiltert werden soll. Die verfügbaren Werte können hier eingesehen werden: Produkttypen

productLifecycleState string

Gibt den Produktstatus an, auf welchen gefiltert werden soll. Die verfügbaren Werte können hier eingesehen werden: Produktstatus

outputMode string

Zeigt das initiale Suchergebnis in der gewählten Ansicht falls möglich.

Die nachfolgenden Werte stehen hier zur Verfügung:

Wert Beschreibung
AUTO Lässt den Navigator Pro dynamisch entscheiden welcher Anzeigemodus genutzt werden sollte. (Standardwert)
CARDS Zeigt Produkte in kleinen Karten an, am besten geeignet bei vielen Suchtreffern.
LARGE_CARDS Zeigt Produkte in großen Karten an, am besten geeignet bei wenigen Suchtreffern.
TABLE Zeigt Produkte in einer Tabelle mit Vergleichsmöglichkeit der ETIM Merkmale an.
Versteckte Filterparameter

Neben den zuvor beschriebenen Filtermöglichkeiten existieren auch versteckte Filter. Diese können vom Nutzer weder eingesehen noch verändert werden. Damit kann die Suche etwa auf spezifische Marken, Serien oder Produkttypen eingeschränkt werden.

Parameter Parametertyp Beschreibung
hiddenBrand string

Gibt die ID einer Marke an, auf welche die Suche eingeschränkt werden soll.

hiddenSeries string

Gibt die ID einer Serie an, auf welche die Suche eingeschränkt werden soll.

hiddenProductGroup string

Gibt den Code der Produktgruppe an, auf welche die Suche eingeschränkt werden soll.

hiddenClassification string

Gibt den Code einer Klassifikation (ETIM Klasse) an, auf welche die Suche eingeschränkt werden soll.

hiddenProductType string

Gibt den Produkttyp an, auf welchen die Suche eingeschränkt werden soll. Die verfügbaren Werte können hier eingesehen werden: Produkttypen

hiddenProductLifecycleState string

Gibt den Produktstatus an, auf welchen die Suche eingeschränkt werden soll. Die verfügbaren Werte können hier eingesehen werden: Produktstatus

Showcase

Allgemeine Parameter

Bitte geben Sie hier den Portal-Code beziehungsweise die Portal-ID an. Hier finden Sie weitere Informationen.
Für die externe Authentifizierung kann ein im integrierenden System generierter Access-Token eingesetzt werden. Benutzen Sie den Access-Token Rechner, um Ihren individuellen Access-Token zu berechnen. Diese Eingabe wird zum Pflichtfeld, falls das entsprechende Portal Login-geschützt ist. Hier finden Sie weitere Informationen.
Bitte geben Sie hier den Benutzernamen eines Portalbenutzers ein. Diese Eingabe wird zum Pflichtfeld, falls das entsprechende Portal Login-geschützt ist. Hier finden Sie weitere Informationen.
Bitte geben Sie hier wahlweise die Portallrollen an, um den Zugriff auf Dokumente zu steuern. Hier finden Sie weitere Informationen.

Aufruf Parameter

Einstellungsparameter
Gibt an, ob die Filterbox angezeigt werden soll. Die Filterbox bietet verschiedene Filtermöglichkeiten für die Nutzer an.
Gibt an, ob der Button zum Springen an den Anfang der Seite angezeigt werden soll.
Filterparameter
Öffnet die Suche mit vorausgefüllter Suchanfrage.
Gibt die ID einer Marke an, auf welche gefiltert werden soll.
Gibt die ID einer Serie an, auf welche gefiltert werden soll.
Gibt den Code der Produktgruppe an, auf welche gefiltert werden soll.
Gibt den Code einer Klassifikation (ETIM Klasse) an, auf welche gefiltert werden soll.
Gibt den Produkttyp an, auf welchen gefiltert werden soll.
Gibt den Produktstatus an, auf welchen gefiltert werden soll.
Versteckte Filterparameter
Gibt die ID einer Marke an, auf welche die Suche eingeschränkt werden soll.
Gibt die ID einer Serie an, auf welche die Suche eingeschränkt werden soll.
Gibt den Code der Produktgruppe an, auf welche die Suche eingeschränkt werden soll.
Gibt den Code einer Klassifikation (ETIM Klasse) an, auf welche die Suche eingeschränkt werden soll.
Gibt den Produkttyp an, auf welchen die Suche eingeschränkt werden soll.
Gibt den Produktstatus an, auf welchen die Suche eingeschränkt werden soll.

Ausgabebereich

Siehe auch
Enthält die Grundlagen zum Thema Javascript Integration.