Produktdaten

Allgemeines

Die OXOMI Produktdaten-Integrationen ermöglichen es, produktbezogene Informationen wie Videos, Bilder, Dateianhänge und Artikeldetails in Webseiten zu integrieren. Die Art der Information kann dabei individuell gewählt werden.

Hierfür stehen im Detail die drei nachfolgenden JavaScript-Funktionen zur Verfügung:

Die Nutzung von oxomi.fillProductData ermöglicht die effiziente Befüllung von HTML-Elementen mit Produktdaten. Die Integration sucht automatisch nach speziellen data-Attributen und fügt entsprechende Informationen in die Elemente ein.

oxomi.productData bietet eine alternative Methode zur Informationsabfrage. Sie können gezielt Aufrufparameter verwenden, um individuelle Details zu einem Produkt abzurufen und in definierte DOM-Elemente zu integrieren.

Mit oxomi.productDataExists können Sie vor dem eigentlichen Abruf von Produktinformationen überprüfen, ob die gewünschten Daten vorhanden sind. Dies ermöglicht eine effiziente Handhabung von Anfragen.

Die nachfolgenden Abschnitte geben einen detaillierten Einblick in jede Integration und zeigen, wie sie optimal genutzt werden können, um Ihre Webseiten mit aktuellen und relevanten Produktdaten anzureichern.

Produktdatenbefüllung

Die oxomi.fillProductData Integration bietet mit minimalem Entwicklungsaufwand effizienten und einfachen Zugang zu den vielfältigen OXOMI Produktdaten. Die Funktion sucht automatisch HTML-Elemente mit speziellen data-Attributen und füllt diese mit entsprechenden Produktinformationen.

Die Methode ermöglicht die Angabe eines Ziels via DOM-Element oder Selektor-String. Dies ist besonders nützlich, wenn auf komplexen Seiten nur bestimmte Elemente befüllt werden sollen. Die Suche nach relevanten Elementen wird dadurch vorab eingeschränkt und somit beschleunigt.

Ein wichtiges Merkmal dieser Integration ist, dass bereits bearbeitete Elemente markiert werden. Dadurch wird sichergestellt, dass bei erneutem Aufruf der JavaScript-Funktion diese Elemente nicht erneut befüllt werden. Diese Vorgehensweise trägt nicht nur zur besseren Performance bei, sondern ermöglicht auch die optimale Bündelung von Anfragen. Das bedeutet, dass mehrere Elemente mit nur einem Funktionsaufruf effizient befüllt werden können. Daher wird die Verwendung der oxomi.fillProductData gegenüber oxomi.productData empfohlen.

Attribute

Die nachfolgende Tabelle zeigt die möglichen data-Attribute, die von der Integration unterstützt werden.

Attribut	Typ	Beschreibung
data-oxomi-product-data	string	Gibt den Informations-Typ an, der abgefragt werden soll. Die zur Verfügung stehenden Werte können hier eingesehen werden: Informationstypen
data-oxomi-item-number	string	Gibt die Artikelnummer des Produktes an, das abgefragt werden soll.
data-oxomi-supplier-number	string	Gibt die Lieferantennummer des Produktes an, das abgefragt werden soll. Hinweis: Sie können Ihre eigenen Lieferantennummern verwenden, wenn Sie diese in der Partnerschaft zum Lieferanten gepflegt haben (siehe: Lieferantennummern).

Parameter

Darüber hinaus bietet die Integration die folgenden Aufrufparameter an.

Parameter	Parametertyp	Beschreibung
target	string	Gibt das Ziel-Element an, auf welches die Elemente Suche eingeschränkt werden soll.

Beispiel

Das folgende Beispiel zeigt, wie die Integration verwendet werden kann, um die Produktbilder eines Produktes anzuzeigen.

<div data-oxomi-product-data="product-images"
     data-oxomi-supplier-number="SUPPLIER"
     data-oxomi-item-number="ARTIKELNR">
</div>
<script type="text/javascript">
    oxomi.fillProductData();
</script>

Interaktives Code-Beispiel

Produktdatenintegration

Die oxomi.productData Integration stellt eine alternative Methode zum Befüllen von HTML-Elementen mit Produktdaten dar. Im Wesentlichen dient sie demselben Zweck wie oxomi.fillProductData, weicht jedoch in der Herangehensweise ab.

Im Gegensatz zur Verwendung von data-Attributen zur Identifizierung von zu befüllenden Elementen ermöglicht oxomi.productData die Übermittlung von Aufrufparametern. Diese definieren dann die Ziel-Elemente, in welche die entsprechenden Daten gerendert werden sollen. Die definierten Ziel-Elemente werden nur sichtbar geschaltet, sofern Daten für das angeforderte Produkt existieren.

Es ist wichtig zu beachten, dass oxomi.productData auf einen Produktdatensatz pro Aufruf beschränkt ist. Anders als bei der oxomi.fillProductData Integration, die mehrere Elemente auf einmal befüllen kann, erfordert oxomi.productData also einen separaten Aufruf für jeden Produktdatensatz. Diese Einschränkung sollte berücksichtigt werden, insbesondere wenn eine größere Anzahl verschiedener Produkte auf einer Seite dargestellt und mit Produktdaten aus OXOMI angereichert werden soll.

Parameter

Die Integration bietet die folgenden Aufrufparameter an.

Parameter

Parametertyp

Beschreibung

information

Object

Gibt die Informations-Typen und deren Ziel-Elemente sowie mögliche weitere Einstellungsparameter an. Die zur Verfügung stehenden Werte können hier eingesehen werden: Informationstypen

Pro angefragtem Informations-Typ ist ein Objekt mit den folgenden Parametern anzugeben:

Parameter	Typ	Beschreibung
target	string	Gibt das Ziel-Element an, in welches die Elemente gerendert werden sollen.
*	*	Weitere Einstellungsparameter, die spezifisch für den Informationstyp sind.

products

Array

Gibt die Artikelnummern und Lieferantennummern der Produkte an, die abgefragt werden sollen. Die so gefundenen Inhalte werden bei Abfrage mehrerer Produkte kombiniert und in die entsprechenden Ziel-Elemente gerendert. Gefundene Produktinformationen (z. B. Bilder, Anhänge, Merkmale, …) werden konsistent vom ersten in einem Datensatz gefundenen Produkt übernommen.

Pro angefragtem Produkt ist ein Objekt mit den folgenden Parametern anzugeben:

Parameter

Typ

Beschreibung

itemNumber

string

Gibt die Artikelnummer des Produkts an, für welches die artikelbezogenen Daten gerendert werden soll.

supplierNumber

string

Gibt die Nummer des Lieferanten an, über welchen das Produkt bezogen wird.

Hinweis:

Wenn eigene Produkte angezeigt werden sollen, kann hier ein - eingetragen werden.
Sie können Ihre eigenen Lieferantennummern verwenden, wenn Sie diese in der Partnerschaft zum Lieferanten gepflegt haben (siehe: Lieferantennummern).

Beispiel

Das folgende Beispiel zeigt, wie die Integration verwendet werden kann, um die Produktbilder, Anhänge und Videos eines Produktes in entsprechenden DOM-Elementen anzuzeigen.

oxomi.productData({
    products: [{
        itemNumber: 'ARTIKELNR',
        supplierNumber: 'SUPPLIER'
    }],
    information: {
        'product-images': {
            target: '#product-images'
        },
        'attachments': {
            target: '#product-attachments',
            limit: 5
        }
        'videos': {
            target: '#product-videos'
            includeOutdated: true
        }
    }
});

Interaktives Code-Beispiel

Produktdatenabfrage

Die oxomi.productDataExists Funktion bietet eine Möglichkeit, zu überprüfen, ob bestimmte Informationen zu einem Produkt in OXOMI hinterlegt sind. Dieser Aufruf liefert ein Promise zurück, das mit einem Ergebnis-JSON-Objekt befüllt wird. Das JSON-Objekt gibt Auskunft darüber, welche der angefragten Produktinformationen verfügbar sind, dazu zählen beispielsweise Videos, Bilder, Anhänge und weitere relevante Daten.

Durch die Verwendung von oxomi.productDataExists kann vor dem eigentlichen Abruf von Produktinformationen festgestellt werden, ob die gewünschten Daten überhaupt vorhanden sind. Dies ermöglicht eine effiziente und gezielte Handhabung von Anfragen, da unnötige Abfragen vermieden werden können, wenn die benötigten Informationen nicht verfügbar sind.

Parameter

Die Integration bietet die folgenden Aufrufparameter an.

Parameter	Parametertyp	Beschreibung
information	Object	Gibt den Informations-Typen an, welcher überprüft werden soll. Die zur Verfügung stehenden Werte können hier eingesehen werden: Informationstypen
itemNumber	string	Gibt die Artikelnummer des Produkts an, für welches die Abfrage durch geführt werden soll.
supplierNumber	string	Gibt die Nummer des Lieferanten an, über welchen das Produkt bezogen wird. Hinweis: Wenn eigene Produkte angezeigt werden sollen, kann hier ein - eingetragen werden. Sie können Ihre eigenen Lieferantennummern verwenden, wenn Sie diese in der Partnerschaft zum Lieferanten gepflegt haben (siehe: Lieferantennummern).

Beispiel

Das folgende Beispiel zeigt, wie die Integration verwendet werden kann, um zu überprüfen, ob ein Produkt Videos, Bilder und Anhänge enthält.

oxomi.productDataExists({
    itemNumber: 'ARTIKELNR',
    supplierNumber: 'SUPPLIER',
    information: ['product-images', 'attachments', 'videos']
});

Die Antwort auf die Anfrage könnte wie folgt aussehen:

{
    product-images: true
    attachments: false
    videos: true
}

Um die Existenz von Daten mehrerer Produkte in einem einzigen Aufruf zu überprüfen, können Sie die Parameter der Integration durchnummerieren. Analog zur Produktdatenintegration wird für Inhalte hierbei die Existenz bekundet, wenn mindestens eins der angegebenen Produkte entsprechende Inhalte bereit stellt. Bei Produktinformationen (z. B. Bilder, Anhänge, Merkmale, …) wird die Existenz konsistent vom ersten in einem Datensatz gefundenen Produkt übernommen. Beispiel:

oxomi.productDataExists({
    itemNumber1: 'ARTIKELNR',
    supplierNumber1: '-',
    itemNumber2: 'WERKSARTIKELNR',
    supplierNumber2: 'SUPPLIER',
    information: ['product-images', 'attachments', 'videos']
});

Informations-Typen

Einzelinformationen

Die nachfolgende Tabelle zeigt die zur Verfügung stehenden Einzelinformationen an. Mit diesen können die einzelnen Informationen eines Produktes abgefragt werden.

Wert

Beschreibung

stories

Stellt die mit dem Produkt verknüpften Stories zur Verfügung.

Parameter	Parametertyp	Beschreibung
types	string	Gibt die Story-Typen an, auf welche die Ergebnisse eingeschränkt werden sollen. Die verfügbaren Werte können hier eingesehen werden: Story-Typen Hinweis: Die Angabe von mehreren Werten erfolgt durch die Verwendung von , (Komma) oder \| (Pipe) als Trennzeichen. Es dürfen keine Leerzeichen enthalten sein.
limit	integer	Gibt die maximale Anzahl an Elementen an, welche abgefragt werden sollen.
skip	integer	Ermöglicht das Überspringen einer bestimmten Anzahl an Elementen. Dies is beispielsweise nützlich, wenn die Elemente seitenweise abgefragt werden sollen.
own	boolean	Gibt an, ob nur eigene Inhalte oder nur Inhalte von anderen Anbietern angezeigt werden sollen. Hinweis: Dieser Parameter bezieht sich dabei ausschließlich auf die eigene Standardmarke. Wird dieser Parameter auf true gesetzt, so werden ausschließlich eigene Inhalte angezeigt. Wird dieser Parameter auf false gesetzt, so werden ausschließlich Inhalte von anderen Anbietern angezeigt. Wird dieser Parameter nicht angegeben, so werden sowohl eigene als auch Inhalte von anderen Anbietern angezeigt, sofern diese über eine Partnerschaft verfügbar sind.
includeOutdated	boolean	Gibt an, ob auch archivierte Inhalte in den Ergebnissen angezeigt werden sollen. Hinweis: Wird dieser Parameter auf true gesetzt, so werden auch archivierte Inhalte angezeigt. Wird dieser Parameter auf false gesetzt, so werden ausschließlich aktuelle Inhalte angezeigt. Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet. Dieser Parameter wird nur angewendet, wenn in den Portaleinstellungen im Abschnitt „Standard“ die Option „Archiv aktivieren“ mit einem Wert größer 0 eingestellt ist.
onlyOutdated	boolean	Gibt an, ob ausschließlich archivierte Inhalte in den Ergebnissen angezeigt werden sollen. Hinweis: Wird dieser Parameter auf true gesetzt, so werden ausschließlich archivierte Inhalte in den Ergebnissen angezeigt. Sollte der Parameter auf true gesetzt sein, hat er Vorrang vor dem Parameter includeOutdated. Bei Einstellung auf false verhält sich der Parameter so, als wäre er nicht angegeben worden. Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet. Dieser Parameter wird nur angewendet, wenn in den Portaleinstellungen im Abschnitt „Standard“ die Option „Archiv aktivieren“ mit einem Wert größer 0 eingestellt ist.

product-images

Stellt die Abbildungen eines Produkts zur Verfügung.

Parameter	Parametertyp	Beschreibung
types	string	Gibt die Anhangs-Typen an, auf welche die Ergebnisse eingeschränkt werden sollen. Die verfügbaren Werte können hier eingesehen werden: Dateianhänge und Bildtypen Hinweis: Die Angabe von mehreren Werten erfolgt durch die Verwendung von , (Komma) oder \| (Pipe) als Trennzeichen. Es dürfen keine Leerzeichen enthalten sein.
limit	integer	Gibt die maximale Anzahl an Elementen an, welche abgefragt werden sollen.
skip	integer	Ermöglicht das Überspringen einer bestimmten Anzahl an Elementen. Dies is beispielsweise nützlich, wenn die Elemente seitenweise abgefragt werden sollen.

datasheet-story

Stellt die aktive Hauptstory eines Produkts zur Verfügung.

attachments

Stellt die Anhänge eines Produkts zur Verfügung.

Parameter	Parametertyp	Beschreibung
types	string	Gibt die Anhangs-Typen an, auf welche die Ergebnisse eingeschränkt werden sollen. Die verfügbaren Werte können hier eingesehen werden: Dateianhänge und Bildtypen Hinweis: Die Angabe von mehreren Werten erfolgt durch die Verwendung von , (Komma) oder \| (Pipe) als Trennzeichen. Es dürfen keine Leerzeichen enthalten sein.
limit	integer	Gibt die maximale Anzahl an Elementen an, welche abgefragt werden sollen.
skip	integer	Ermöglicht das Überspringen einer bestimmten Anzahl an Elementen. Dies is beispielsweise nützlich, wenn die Elemente seitenweise abgefragt werden sollen.

pages

Stellt die zum Produkt passenden Dokumentseiten zur Verfügung.

Parameter

Parametertyp

Beschreibung

types

string

Gibt die Dokument-Typen an, auf welche die Ergebnisse eingeschränkt werden sollen. Die verfügbaren Werte können hier eingesehen werden: Dokumenttypen

Hinweis:

Die Angabe von mehreren Werten erfolgt durch die Verwendung von , (Komma) oder | (Pipe) als Trennzeichen. Es dürfen keine Leerzeichen enthalten sein.

showActions

boolean

Gibt an, ob zusätzliche Aktionen für Dokumente angezeigt werden sollen. Die zusätzlichen Aktionen werden als Schaltflächen unterhalb des Dokumentnamens angezeigt. Wird dieser Parameter auf true gesetzt, so werden die zusätzlichen Aktionen angezeigt. Die folgenden zusätzlichen Aktionen stehen zur Verfügung:

Aktion	Beschreibung
Anschauen	Öffnet den WebViewer so, als wäre das Cover-Bild des Dokuments angeklickt worden.
Downloaden	Startet den Download des Dokuments. Voraussetzung für die Anzeige Download-Button ist, dass in Ihrer Portalkonfiguration unter „Sicherheit“ die Option „PDF-Download zulassen“ aktiv gesetzt ist
Bestellen	Löst die Bestellaktion für das Dokument aus, sofern eine JavaScript-Funktion mit dem Parameter orderHandler hinterlegt wurde.

Hinweis:

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

limit

integer

Gibt die maximale Anzahl an Elementen an, welche abgefragt werden sollen.

skip

integer

Ermöglicht das Überspringen einer bestimmten Anzahl an Elementen. Dies is beispielsweise nützlich, wenn die Elemente seitenweise abgefragt werden sollen.

own

boolean

Gibt an, ob nur eigene Inhalte oder nur Inhalte von anderen Anbietern angezeigt werden sollen.

Hinweis:

Dieser Parameter bezieht sich dabei ausschließlich auf die eigene Standardmarke.
Wird dieser Parameter auf true gesetzt, so werden ausschließlich eigene Inhalte angezeigt.
Wird dieser Parameter auf false gesetzt, so werden ausschließlich Inhalte von anderen Anbietern angezeigt.
Wird dieser Parameter nicht angegeben, so werden sowohl eigene als auch Inhalte von anderen Anbietern angezeigt, sofern diese über eine Partnerschaft verfügbar sind.

includeOutdated

boolean

Gibt an, ob auch archivierte Inhalte in den Ergebnissen angezeigt werden sollen.

Hinweis:

Wird dieser Parameter auf true gesetzt, so werden auch archivierte Inhalte angezeigt.
Wird dieser Parameter auf false gesetzt, so werden ausschließlich aktuelle Inhalte angezeigt.
Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet.
Dieser Parameter wird nur angewendet, wenn in den Portaleinstellungen im Abschnitt „Standard“ die Option „Archiv aktivieren“ mit einem Wert größer 0 eingestellt ist.

onlyOutdated

boolean

Gibt an, ob ausschließlich archivierte Inhalte in den Ergebnissen angezeigt werden sollen.

Hinweis:

Wird dieser Parameter auf true gesetzt, so werden ausschließlich archivierte Inhalte in den Ergebnissen angezeigt.
Sollte der Parameter auf true gesetzt sein, hat er Vorrang vor dem Parameter includeOutdated. Bei Einstellung auf false verhält sich der Parameter so, als wäre er nicht angegeben worden.
Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet.
Dieser Parameter wird nur angewendet, wenn in den Portaleinstellungen im Abschnitt „Standard“ die Option „Archiv aktivieren“ mit einem Wert größer 0 eingestellt ist.

cover

Stellt das Datenblatt-Titelbild eines Produkts zur Verfügung.

videos

Stellt die mit dem Produkt verknüpften Videos zur Verfügung.

Parameter	Parametertyp	Beschreibung
types	string	Gibt die Video-Typen an, auf welche die Ergebnisse eingeschränkt werden sollen. Die verfügbaren Werte können hier eingesehen werden: Videotypen Hinweis: Die Angabe von mehreren Werten erfolgt durch die Verwendung von , (Komma) oder \| (Pipe) als Trennzeichen. Es dürfen keine Leerzeichen enthalten sein.
limit	integer	Gibt die maximale Anzahl an Elementen an, welche abgefragt werden sollen.
skip	integer	Ermöglicht das Überspringen einer bestimmten Anzahl an Elementen. Dies is beispielsweise nützlich, wenn die Elemente seitenweise abgefragt werden sollen.
own	boolean	Gibt an, ob nur eigene Inhalte oder nur Inhalte von anderen Anbietern angezeigt werden sollen. Hinweis: Dieser Parameter bezieht sich dabei ausschließlich auf die eigene Standardmarke. Wird dieser Parameter auf true gesetzt, so werden ausschließlich eigene Inhalte angezeigt. Wird dieser Parameter auf false gesetzt, so werden ausschließlich Inhalte von anderen Anbietern angezeigt. Wird dieser Parameter nicht angegeben, so werden sowohl eigene als auch Inhalte von anderen Anbietern angezeigt, sofern diese über eine Partnerschaft verfügbar sind.
includeOutdated	boolean	Gibt an, ob auch archivierte Inhalte in den Ergebnissen angezeigt werden sollen. Hinweis: Wird dieser Parameter auf true gesetzt, so werden auch archivierte Inhalte angezeigt. Wird dieser Parameter auf false gesetzt, so werden ausschließlich aktuelle Inhalte angezeigt. Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet. Dieser Parameter wird nur angewendet, wenn in den Portaleinstellungen im Abschnitt „Standard“ die Option „Archiv aktivieren“ mit einem Wert größer 0 eingestellt ist.
onlyOutdated	boolean	Gibt an, ob ausschließlich archivierte Inhalte in den Ergebnissen angezeigt werden sollen. Hinweis: Wird dieser Parameter auf true gesetzt, so werden ausschließlich archivierte Inhalte in den Ergebnissen angezeigt. Sollte der Parameter auf true gesetzt sein, hat er Vorrang vor dem Parameter includeOutdated. Bei Einstellung auf false verhält sich der Parameter so, als wäre er nicht angegeben worden. Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet. Dieser Parameter wird nur angewendet, wenn in den Portaleinstellungen im Abschnitt „Standard“ die Option „Archiv aktivieren“ mit einem Wert größer 0 eingestellt ist.

html-description

Stellt den HTML-formatierten Beschreibungstext eines Produkts zur Verfügung.

spare-parts

Stellt die Ersatzteilinformationen eines Produkts zur Verfügung.

Parameter	Parametertyp	Beschreibung
limit	integer	Gibt die maximale Anzahl an Elementen an, welche abgefragt werden sollen.
skip	integer	Ermöglicht das Überspringen einer bestimmten Anzahl an Elementen. Dies is beispielsweise nützlich, wenn die Elemente seitenweise abgefragt werden sollen.

properties

Stellt die Eigenschaften eines Produkts zur Verfügung.

base-info

Stellt die Basisinformationen eines Produkts zur Verfügung.

commercial

Stellt die gewerblichen Informationen eines Produkts zur Verfügung.

Parameter	Parametertyp	Beschreibung
hideGroups	integer	Blendet die Produktgruppen aus, wenn der Wert auf true gesetzt wird.

galleries

Stellt die mit dem Produkt verknüpften Exposés zur Verfügung.

Parameter	Parametertyp	Beschreibung
types	string	Gibt die Video-Typen an, auf welche die Ergebnisse eingeschränkt werden sollen. Die verfügbaren Werte können hier eingesehen werden: Videotypen Hinweis: Die Angabe von mehreren Werten erfolgt durch die Verwendung von , (Komma) oder \| (Pipe) als Trennzeichen. Es dürfen keine Leerzeichen enthalten sein.
limit	integer	Gibt die maximale Anzahl an Elementen an, welche abgefragt werden sollen.
skip	integer	Ermöglicht das Überspringen einer bestimmten Anzahl an Elementen. Dies is beispielsweise nützlich, wenn die Elemente seitenweise abgefragt werden sollen.
own	boolean	Gibt an, ob nur eigene Inhalte oder nur Inhalte von anderen Anbietern angezeigt werden sollen. Hinweis: Dieser Parameter bezieht sich dabei ausschließlich auf die eigene Standardmarke. Wird dieser Parameter auf true gesetzt, so werden ausschließlich eigene Inhalte angezeigt. Wird dieser Parameter auf false gesetzt, so werden ausschließlich Inhalte von anderen Anbietern angezeigt. Wird dieser Parameter nicht angegeben, so werden sowohl eigene als auch Inhalte von anderen Anbietern angezeigt, sofern diese über eine Partnerschaft verfügbar sind.
includeOutdated	boolean	Gibt an, ob auch archivierte Inhalte in den Ergebnissen angezeigt werden sollen. Hinweis: Wird dieser Parameter auf true gesetzt, so werden auch archivierte Inhalte angezeigt. Wird dieser Parameter auf false gesetzt, so werden ausschließlich aktuelle Inhalte angezeigt. Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet. Dieser Parameter wird nur angewendet, wenn in den Portaleinstellungen im Abschnitt „Standard“ die Option „Archiv aktivieren“ mit einem Wert größer 0 eingestellt ist.
onlyOutdated	boolean	Gibt an, ob ausschließlich archivierte Inhalte in den Ergebnissen angezeigt werden sollen. Hinweis: Wird dieser Parameter auf true gesetzt, so werden ausschließlich archivierte Inhalte in den Ergebnissen angezeigt. Sollte der Parameter auf true gesetzt sein, hat er Vorrang vor dem Parameter includeOutdated. Bei Einstellung auf false verhält sich der Parameter so, als wäre er nicht angegeben worden. Wird der Parameter nicht angegeben, so wird false als Default-Wert verwendet. Dieser Parameter wird nur angewendet, wenn in den Portaleinstellungen im Abschnitt „Standard“ die Option „Archiv aktivieren“ mit einem Wert größer 0 eingestellt ist.

icons

Stellt die Icons, Piktogramme und Gütesiegel eines Produkts zur Verfügung.

Parameter	Parametertyp	Beschreibung
limit	integer	Gibt die maximale Anzahl an Elementen an, welche abgefragt werden sollen.
skip	integer	Ermöglicht das Überspringen einer bestimmten Anzahl an Elementen. Dies is beispielsweise nützlich, wenn die Elemente seitenweise abgefragt werden sollen.

features

Stellt die Merkmale eines Produkts zur Verfügung.

energy-label

Stellt das ErP-Energielabel eines Produkts zur Verfügung.

measurements

Stellt die Abmessungen eines Produkts zur Verfügung.

relationships

Stellt die Beziehungen eines Produkts zur Verfügung.

Parameter	Parametertyp	Beschreibung
limit	integer	Gibt die maximale Anzahl an Elementen an, welche abgefragt werden sollen.
skip	integer	Ermöglicht das Überspringen einer bestimmten Anzahl an Elementen. Dies is beispielsweise nützlich, wenn die Elemente seitenweise abgefragt werden sollen.

Datenblatt-Blöcke

Die nachfolgende Tabelle zeigt die zur Verfügung stehenden Informationsblöcke an. Mit diesen können ganze Blöcke an Informationen abgefragt werden. Die Darstellung der Blöcke entspricht dabei der aus dem OXOMI-Datenblatt.

Wert	Beschreibung
details	Rendert den Block 'Artikeldetails' des Datenblatts.
bim-3d	Rendert den Block 'BIM / 3D' des Datenblatts.
header	Rendert den Block 'Kopfbereich' des Datenblatts.
relations	Rendert den Block 'Beziehungen' des Datenblatts.
related-files	Rendert den Block 'Medien' des Datenblatts.
characteristics	Rendert den Block 'Eigenschaften' des Datenblatts.
datasheet-story	Rendert den Block 'Informationen' des Datenblatts.

Siehe auch

JavaScript Integrationsgrundlagen

Enthält die Grundlagen zum Thema Javascript Integration.

Datenblatt

Beschreibt die verschiedenen Integrationen zur Anzeige des Produkt-Datenblatts.