Texte
In Zusatztexten können Sie ausführliche Produktbeschreibungen hinterlegen. In der Regel handelt es sich um ausformulierte Texte, die beispielsweise auf dem Produkt aufgebracht, aber auch als ergänzende Angabe verfasst sein können.
Zu Zusatztexten gehören Angaben wie die Hauptbeschreibung, Klappentexte oder Rezensionen.
Bitte beachten Sie: Zusatztexte sind in Ihrem ONIX-Datensatz als Text einzutragen. Falls Sie Zusatztexte in einer Datei vorliegen haben und einen Link auf die Datei weitergeben möchten, erfahren Sie im Bereich Mediendateien, wie Sie diesen an das VLB übermitteln können.
Zusatztexte werden in ONIX 3.0 im TextContent- und in ONIX 2.1 im OtherText-Composite angegeben.
Art des Zusatztextes und Zielgruppe
In ONIX 3.0 legen Sie in TextType bzw. x426 mit Werten aus Codeliste 153 und in ONIX 2.1 in TextTypeCode bzw. d102 durch Werte aus Codeliste 33 fest, um welche Art von Zusatztext es sich handelt.
In ONIX 3.0 ist für jede Zusatztextart eine Zielgruppe anzugeben. Dadurch ist es Datenempfängern möglich bestimmte Inhalte nur ausgewählten Nutzern anzueigen. Die Zielgruppe ist in ContentAudience bzw. x427 mit Werten aus Codeliste 154 vorzunehmen.
Die nachfolgenden Zusatztextarten werden vom VLB verarbeitet.
Hinweise zum VLB-Mapping
- ONIX 3.0 zu ONIX 2.1: ContentAudience bzw. x427 wird nicht berücksichtigt, insofern in der Tabelle keine explizite Angabe gemacht wird. Z. B. werden Rezensionszitate aller Zielgruppen in ONIX 2.1 exportiert.
- ONIX 2.1 nach ONIX 3.0: ContentAudience bzw. x427 wird mit dem Wert 00 besetzt, insofern in der Tabelle keine explizite Angabe gemacht wird.
- ONIX 3.0 Textarten, die mehr als ein ONIX 2.1 Äquivalent besitzen, werden auf den mit * gekennzeichneten Typ gemappt
Bitte beachten Sie: Die Weitergabe von Rezensionszitaten setzt voraus, dass der Verlag berechtigt ist, die Rezensionen Dritter zu veröffentlichen. Bisher wurden im VLB Rezensionen nicht standardmäßig an den Handel weitergegeben. Für eine Freischaltung konnten sich als Verlag an den Kundenservice wenden. Ab dem 07.02.2023 gibt das VLB neu automatisch alle eingestellten Rezensionen weiter. Auf der Hilfe-Seite finden Sie Beispiele zur ONIX-Meldung von Rezensionszitaten.
Text, Sprache und Formatierung
Der Zusatztext selbst ist in beiden ONIX-Formaten in Text bzw. d104 anzugeben.
Über das XML-Attribut language können Sie durch die Angabe eines Sprachencodes (Codeliste 74) definieren, in welcher Sprache der Text verfasst ist. Falls Ihre Produktbeschreibungen mehrsprachig sind, müssen Sie in ONIX 2.1 noch pro Sprache ein OtherText-Composite anlegen. In ONIX 3.0 ist Text bzw. d104 im TextContent-Composite wiederholbar, weshalb Sie alle Sprachen in einem Composite abbilden können.
Durch die Angabe eines Textformates legen Sie fest, wie Ihr Zusatztext im VLB aber vor allem bei Händlern angezeigt werden soll. Das Textformat ist mit Werten aus Codeliste 34 in ONIX 3.0 im XML-Attribut textformat und in ONIX 2.1 in TextFormat bzw. d103 anzugeben. Die nachfolgenden Textformate können an das VLB gemeldet werden.
(X)HTML-Tags
Das VLB gibt nur eine fest definierte Menge aller (X)HTML-Tags an den Handel weiter, auch werden sämtliche Attribute aus den Tags entfernt. Durch die Prüfung und Bereinigung der (X)HTML-Texte soll sichergestellt werden, dass die Tags von den verschiedenen Datenempfängern korrekt zur Anzeige gebracht und keine unerwünschten Inhalte (Skripte etc.) verbreitet werden. Die folgenden Tags können vom VLB verarbeitet werden:
- b, blockquote, br, cite, code, dd, dl, dt, em, i, li, ol, p, pre, q, small, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, ul
Hinweise zur (X)HTML-Verarbeitung im VLB und zur Weitergabe an den Handel
- Das VLB gibt Zusatztexte aus Gründen der Nachnutzbarkeit ausschließlich als XHTML (Textformat=05) und Text (Textformat=06) an den Handel weiter.
- Als HTML angelieferte Zusatztexte (Textformat=02) werden von VLB-Routinen analysiert und nach Möglichkeit in XHTML überführt. Falls keine automatische Überführung möglich ist, wird der Zusatztext von sämtlichen Tags befreit und als Text an den Handel gegeben.
- Aus Zusatztexten, die nicht als HTML oder XHTML gekennzeichnet sind, entfernt das VLB sämtliche (X)HTML-Tags und gibt diese als Text (06) an den Handel weiter.
- Zusatztexte, die als XHTML oder HTML gekennzeichnet sind, aber keine (X)HTML-Tags enthalten werden vom VLB ebenfalls mit dem Textformat Text gekennzeichnet.
Wie Sie HTML-Markup optimal in ONIX einbinden, erfahren Sie in den Best Practice Guides von EDItEUR.
Embedding HTML Markup in ONIX (26 min)
Hinweise zur Einbettung von (X)HTML in ONIX im Überblick
- Für eine optimale Verarbeitung sollten Sie valides (X)HTML an das VLB senden. Durch die Verwendung der XSD-ONIX-Validierung können Sie dies einfach und bequem sicherstellen.
- Im ONX enthaltenes HTML kann Ihre ONIX-Dateien invalide machen, da in HTML nicht wie in XML durchgängig öffnende und schließende Tags verwendet werden. In diesem Fall ist der HTML-Text im ONX mit CDATA zu umschließen.
- Bitte achten Sie auch darauf, dass die spitzen Klammern Ihrer Tags nicht escaped sind.
Autor und Quelle
Im VLB können Sie in ONIX 3.0 für jeden Zusatztext bis zu drei Autoren (TextAuthor bzw. d107) sowie eine für den Inhalt des Zusatztextes zuständige Organisation (TextSourceCorporate bzw. b374) angeben. Außerdem können Sie die Quelle des Zusatztextes (SourceTitle bzw. x428) hinterlegen.
Veröffentlichung, Gültigkeit und letztes Update
In ONIX 3.0 wie auch in ONIX 2.1 können Sie angeben, wann die Erstveröffentlichung Ihres Zusatztextes stattfand sowie eine Angabe, von wann bis wann ein Zusatztext durch den Handel angezeigt werden soll. Die Gültigkeitsangabe wird vom VLB weitergegeben und ist folglich durch den Händler auszuwerten. In ONIX 3.0 ist es des Weiteren möglich, den Zeitpunkt der letzten Aktualisierung am Zusatztext zu definieren.
Sie können jede der Zeitangaben in ONIX 3.0 in einem ContentDate-Composite hinterlegen. Die Art der Zeitangabe geben Sie in ContentDateRole bzw. x429 mit Werten aus Codeliste 155 und die eigentliche Zeitangabe in Date bzw. b306 an. Das Datumsformat ist als Attribut an der Zeitangabe durch einen Wert aus Codeliste 55 zu definieren.
Nachfolgend finden Sie eine Übersicht, welche Codes in ONIX 3.0 zu verwenden sind und welche ONIX 2.1 Felder diesen entsprechen.
Beispiele
Verkaufshinweise
Um Verkaufshinweise als formatierte Liste auf VLB-TIX anzeigen zu lassen, gibt es zwei Möglichkeiten:
- Jedes Verkaufsargument einzeln als unformatierten Text zu senden. Daraufhin wird die Listendarstellung auf VLB-TIX in der von Ihnen gelieferten Reihenfolge erstellt.
- Eine formatierte HTML-Liste senden, die unverändert angezeigt wird.
Für die beiden Beispiele ist die Anzeige auf VLB-Tix wie folgt.
- Verkaufshinweis 1
- Verkaufshinweis 2
Verkaufshinweise als unformatierter Text
ONIX 2.1 Short
-
<othertext>
<d102>25</d102>
<d103>06</d103>
<d104>Verkaufshinweis 1</d104>
</othertext>
<othertext>
<d102>25</d102>
<d103>06</d103>
<d104>Verkaufshinweis 2</d104>
</othertext> ONIX 2.1 Reference
-
<OtherText>
<TextTypeCode>25</TextTypeCode>
<TextFormat>06</TextFormat>
<Text>Verkaufshinweis 1</Text>
</OtherText>
<OtherText>
<TextTypeCode>25</TextTypeCode>
<TextFormat>06</TextFormat>
<Text>Verkaufshinweis 2</Text>
</OtherText>
ONIX 3.0 Short
-
<textcontent>
<x426>11</x426>
<x427>02</x427>
<d104 textformat="06">Verkaufshinweis 1</d104>
</textcontent>
<textcontent>
<x426>11</x426>
<x427>02</x427>
<d104 textformat="06">Verkaufshinweis 2</d104>
</textcontent>
ONIX 3.0 Reference
-
<TextContent>
<TextType>11</TextType>
<ContentAudience>02</ContentAudience>
<Text textformat="06">Verkaufshinweis 1</Text>
</TextContent>
<TextContent>
<TextType>11</TextType>
<ContentAudience>02</ContentAudience>
<Text textformat="06">Verkaufshinweis 2</Text>
</TextContent>
Verkaufshinweise als HTML-Liste
ONIX 2.1 Short
-
<othertext>
<d102>25</d102>
<d103>05</d103>
<d104>
<ul>
<li>Verkaufshinweis 1</li>
<li>Verkaufshinweis 2</li>
</ul>
</d104>
</othertext> ONIX 2.1 Reference
-
<OtherText>
<TextTypeCode>25</TextTypeCode>
<TextFormat>05</TextFormat>
<Text>
<ul>
<li>Verkaufshinweis 1</li>
<li>Verkaufshinweis 2</li>
</ul>
</Text>
</OtherText>
ONIX 3.0 Short
-
<textcontent>
<x426>11</x426>
<x427>02</x427>
<d104 textformat="02">
<ul>
<li>Verkaufshinweis 1</li>
<li>Verkaufshinweis 2</li>
</ul>
</d104>
</textcontent>
ONIX 3.0 Reference
-
<TextContent>
<TextType>11</TextType>
<ContentAudience>02</ContentAudience>
<Text textformat="05">
<ul>
<li>Verkaufshinweis 1</li>
<li>Verkaufshinweis 2</li>
</ul>
</Text>
</TextContent>
Rezensionszitat
- Bitte beachten Sie, dass Sie beim Publikationsorgan vorab die Zustimmung einholen, dass Sie das Rezensionszitat als Verlag verwenden dürfen. Das VLB übernimmt keine Haftung für eingestellte Rezensionen.
- Bisher wurden im VLB Rezensionen nicht standardmäßig an den Handel weitergegeben. Für eine Freischaltung konnten sich als Verlag an den Kundenservice wenden. Ab dem 07.02.2023 gibt das VLB neu automatisch allen eingestellten Rezensionen weiter.
Ein Rezensionszitat aus dem Spiegel (Zitat in deutscher und englischer Sprache, veröffentlicht am 20.09.2016, verfasst von Martin Doerry, als unformatierter Text) ist wie folgt anzugeben.
ONIX 2.1 Short
-
<othertext>
<d102>08</d102>
<d103>06</d103>
<d104 language="ger">Dieses Buch ist die Essenz des literarischen Schaffens von Bodo Kirchhoff. Und dabei ist es „nur“ eine Novelle. (Martin Doerry, Der Spiegel, 20.09.2016)</d104>
<d109>20160920</d109>
</othertext>
<othertext>
<d102>08</d102>
<d103>06</d103>
<d104 language="eng">This book is the essence of the literary work of Bodo Kirchhoff. And it is "only" a short story. (Martin Doerry, Der Spiegel, 20.09.2016)</d104>
<d109>20160920</d109>
</othertext>
ONIX 2.1 Reference
-
<OtherText>
<TextTypeCode>08</TextTypeCode>
<TextFormat>06</TextFormat>
<Text language="ger">Dieses Buch ist die Essenz des literarischen Schaffens von Bodo Kirchhoff. Und dabei ist es „nur“ eine Novelle. (Martin Doerry, Der Spiegel, 20.09.2016)</Text>
<TextPublicationDate>20160920</TextPublicationDate>
</OtherText>
<OtherText>
<TextTypeCode>08</TextTypeCode>
<TextFormat>06</TextFormat>
<Text language="eng">This book is the essence of the literary work of Bodo Kirchhoff. And it is "only" a short story. (Martin Doerry, Der Spiegel, 20.09.2016)</Text>
<TextPublicationDate>20160920</TextPublicationDate>
</OtherText>
ONIX 3.0 Short
-
<textcontent>
<x426>06</x426>
<x427>00</x427>
<d104 language="ger" textformat="06">Dieses Buch ist die Essenz des literarischen Schaffens von Bodo Kirchhoff. Und dabei ist es „nur“ eine Novelle.</d104>
<d104 language="eng" textformat="06">This book is the essence of the literary work of Bodo Kirchhoff. And it is "only" a short story.</d104>
<d107>Martin Doerry</d107>
<b374>Spiegel-Verlag Rudolf Augstein GmbH & Co. KG</b374>
<x428>Der Spiegel</x428>
<contentdate>
<x429>01</x429>
<b306 dateformat="00">20160920</b306>
</contentdate>
</textcontent>
ONIX 3.0 Reference
-
<TextContent>
<TextType>06</TextType>
<ContentAudience>00</ContentAudience>
<Text language="ger" textformat="06">Dieses Buch ist die Essenz des literarischen Schaffens von Bodo Kirchhoff. Und dabei ist es „nur“ eine Novelle.</Text>
<Text language="eng" textformat="06">This book is the essence of the literary work of Bodo Kirchhoff. And it is "only" a short story.</Text>
<TextAuthor>Martin Doerry</TextAuthor>
<TextSourceCorporate>Spiegel-Verlag Rudolf Augstein GmbH & Co. KG</TextSourceCorporate>
<SourceTitle>Der Spiegel</SourceTitle>
<ContentDate>
<ContentDateRole>01</ContentDateRole>
<Date dateformat="00">20160920</Date>
</ContentDate>
</TextContent>
Falls Sie ein Rezensionszitat aus Ihrem Titel im VLB entfernen möchten, nehmen Sie das Zitat aus der ONIX-Meldung heraus und melden den Titel bitte anschließend erneut ans VLB. Nach erfolgreichem Import der ONIX-Meldung wird der Titel ohne das entsprechende Rezensionszitat angezeigt und an den Handel weitergegeben.
Bitte beachten Sie: In ONIX 3.0 sind umfänglichere Angaben möglich und die ONIX 2.1-Angaben im VLB umfassen deshalb nur einen Ausschnitt der Inhalte: Falls Sie per ONIX 2.1 melden, geben Sie die Quelle des Zitats bitte mit im Zitattext an, d.h. im Feld <d104> bzw. <Text>. Die Felder <d107> bzw. <TextAuthor> und <d108> bzw. <TextSourceCorporate> werden aktuell nicht im VLB ausgelesen. Zukünftig ist es fürs VLB geplant, die ONIX 2.1-Felder <d107> bzw. <TextAuthor> und <d108> bzw. <TextSourceCorporate> aufzunehmen.
Danke für die Rückmeldung