Texte
unter Texte können Sie u.a. 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 Texten gehören Angaben wie die Produktbeschreibung, Klappentexte, Verkaufshinweise oder Rezensionen.
Bitte beachten Sie: Texte sind in Ihrer ONIX-Datei als Text einzutragen. Falls Sie Texte 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.
Jeder Text ist in einem TextContent- Composite anzugeben.
Art des Textes und Zielgruppe
I TextType bzw. x426 legen Sie mit Werten aus Codeliste 153 fest, um welche Art von Text es sich handelt.
Für jede Textart ist eine Zielgruppe anzugeben. Dadurch ist es Datenempfängern möglich bestimmte Inhalte nur ausgewählten Nutzern anzuzeigen. Die Zielgruppe ist in ContentAudience bzw. x427 mit Werten aus Codeliste 154 zu hinterlegen.
Text, Sprache und Formatierung
Der Text selbst ist 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. Wenn Sie für dieselbe Textart Texte in mehreren Sprachen angeben möchten, können Sie Text bzw. d104 im selben TextContent-Composite mit Angabe der jeweiligen Sprache wiederholen.
Durch die Angabe eines Textformates legen Sie fest, wie Ihr Text im VLB aber vor allem bei Händlern angezeigt werden soll. Das Textformat ist mit Werten aus Codeliste 34 im XML-Attribut textformat anzugeben. Die nachfolgenden Textformate können an das VLB gemeldet werden.
| Code | Textformat | Hinweis |
|---|---|---|
| 02 | HTML | wird in XHTML oder Default-Text gewandelt |
| 05 | XHTML | |
| 06 | Default-Textformat | |
| 07 | ASCII-Textformat | wird in Default-Text gewandelt |
(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 Texte aus Gründen der Nachnutzbarkeit ausschließlich als XHTML (Textformat=05) und Text (Textformat=06) an den Handel weiter.
- Als HTML angelieferte Texte (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 Text von sämtlichen Tags befreit und als Text an den Handel gegeben.
- Aus Texten, 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.
- Texte, 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 für jeden Text bis zu drei Autoren (TextAuthor bzw. d107) sowie eine für den Inhalt des Textes zuständige Organisation (TextSourceCorporate bzw. b374) angeben. Außerdem können Sie die Quelle des Textes (SourceTitle bzw. x428) hinterlegen.
Besonders interessant sind diese Angaben für Rezensionen.
Veröffentlichung, Gültigkeit und letztes Update
Außerdem können Sie angeben, wann die Erstveröffentlichung Ihres Textes stattfand sowie eine Angabe, von wann bis wann ein Text durch den Handel angezeigt werden soll. Die Gültigkeitsangabe wird vom VLB weitergegeben und ist folglich durch den Händler auszuwerten. Des Weiteren ist es möglich, den Zeitpunkt der letzten Aktualisierung am Text zu definieren.
Sie können jede der Zeitangaben 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 zu verwenden sind.
| Code | Zeitangabe | Datumsformat |
|---|---|---|
| 01 | veröffentlicht am | JJJJ JJJJMM JJJJMMTT |
| 14 | gültig ab | JJJJMMTT |
| 15 | gültig bis | JJJJMMTT |
| 17 | zuletzt aktualisiert | JJJJMMTT |
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 3 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 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 3 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 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 das Rezensionszitat als Verlag in einer Ihnen gestatteten Form weitergeben. Das VLB übernimmt keine Haftung für eingestellte Rezensionen.
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 3 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 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>