Änderungen an der VLB-API (vlbapi.dll, XML-API)

Dezember 2008 | August 2008 | Januar 2008 | Oktober 2007 | Januar 2007 | September 2006

Dezember 2008

Sehr geehrte Damen und Herren,

wir möchten Sie über eine Ergänzung der VLB-Datenbank informieren. Das Feld 3016 ist neu hinzugekommen. Es ist ausschließlich bei den Titeln vorhanden, die zum Redaktionsschluss der jeweiligen CD-ROM-Ausgabe nicht von den Verlagen an die VLB-Redaktion gemeldet wurden, aber bei den Barsortimenten Umbreit und/oder Könemann erhältlich sind. Diese Originaldaten sind nicht von der VLB-Redaktion bearbeitet worden. Sie werden als Ergänzungs-Datensätze dem jeweiligen CD-ROM-Datenbestand hinzugefügt. Mit diesen Titeln sind auch keine Verlagsinformationen (Adresse, Kommunikationsdaten) verknüpft. Die Titelsätze mit einem Feld 3016 enthalten als Auslieferungsinformation die Umbreit-Bestellnummer (Feld 1007) und/oder das Könemann-Sigel “KÖ” (Feld 1005). Der Inhalt des Feldes 3016 (“U” oder “K”) dient nur internen Zwecken.

Wir bitten Sie, diese Ergänzungs-Datensätze mit folgendem Text auszugeben: “Quelle: BARSORTIMENTSDATEN (D)/keine redaktionelle Bearbeitung durch das VLB”.

Des Weiteren möchten wir Sie auf das schon seit längerem vorhandene Feld 1239 hinweisen. Über dieses Feld werden Titel von Verlagen gekennzeichnet, die gänzlich oder mit Teilen ihrer Produktion

· nur an den Endverbraucher liefern (Kennbuchstabe E)

· in Ausnahmefällen ohne Rabatt an das Sortiment liefern (Kennbuchstabe R)

· nur gegen Vorkasse oder per Nachnahme liefern (Kennbuchstabe N).

Diese Kennungen (aus der “Gelben Liste” des Sortimenter-Ausschusses des Börsenvereins des Deutschen Buchhandels) finden sich auch bei den entsprechenden Verlagssätzen im Feld 2685.

Wir empfehlen Ihnen im Interesse Ihrer Kunden, diese Informationen in Ihren Software-Produkten darzustellen.

Bitte beachten Sie:
Ein Update der VLB-C++-Dll ist nicht erforderlich. Die Version VLB-API 4.02-3.00a vom 17.1.2007 kann weiterhin verwendet werden. Auch den Nutzern der Online-XML-Schnittstelle stehen die Änderungen sofort zur Verfügung.

August 2008

VLB-XML-API

  • Ab sofort bietet die API zusätzlich die Funktionen getSeries und getHierarchy zur Abfrage von Reihen- und Hierarchie-Informationen.
  • Die Funktion VLB_GetCover erfährt eine Erweiterung: Cover können nun durch Angabe eines zusätzlichen Parameters in drei verschiedenen Größen abgerufen werden.

VLB C++-DLL (keine neue DLL notwendig!)

Zur Anpassung Ihrer Produkte an die veränderte VLB-Datenbank ist keine neue Version der vlbapi.dll notwendig.

Die Funktion GetCover erfährt jedoch eine Erweiterung: Cover können in Zukunft durch Angabe eines zusätzlichen Parameters in drei verschiedenen Größen abgerufen werden.

Januar 2008

Umstellung des “fPr”-Akronyms auf “UVP” in den VLB-Produkten

Ab sofort wird das Akronym “fPr” (für “freier Preis”) in der Anzeige der VLB-Produkte im VLB-Kontext auf das gängigere Kürzel “UVP” (für “unverbindliche Preisempfehlung”) umgestellt. Die Umstellung erfolgt, um eine rechtliche Eindeutigkeit bezüglich der Preisangabe zu gewährleisten. Der VLB Online Katalog und die VLB-CD-ROM werden im Februar umgestellt und um eine entsprechende Legende ergänzt.

Wir empfehlen, es der MVB Marketings- und Verlagsservice des Buchhandels GmbH gleich zu tun und aus rechtlichen Gründen in den Produkten in Zukunft nicht nur das Kürzel “UVP” für “fPr” auszugeben, sondern auch einen entsprechenden Hinweistext, der die Abkürzung erläutert.

Beispiel: UVP = unverbindliche Preisempfehlung

BITTE BEACHTEN SIE:
In der Datenbank und den VLB-APIs wird noch nicht sofort von “fPr” auf “UVP” umgestellt. Dies ist jedoch bis Ende des Jahres geplant. Wir möchten Sie schon heute darauf hinweisen, damit Sie sich technisch auf diese Umstellung einstellen und die damit verbundenen Aufwände frühzeitig planen können.

Wir bitten Sie, bei den Suchfunktionen Ihrer Applikation und der Darstellung der VLB-Daten zu berücksichtigen, dass alle drei Preisfelder (1263, 1264, 1270) das Kürzel “Pr” beinhalten können und somit ausgewertet werden sollten.

Non-Book-(EAN-)Produkte

Wie bereits Anfang Dezember angekündigt, wird die VLB-CD-/DVD-Datenbank ab Januar 2008 auch Non-Book-Produkte mit EAN als alleinigem Identifier enthalten. Der VLB Online Katalog wurde bereits im Dezember um die EAN-Produkte erweitert.

Aus der Integration der Non-Books in die VLB-Datenbank ergeben sich die folgenden Änderungen für die unterschiedlichen Produktkomponenten der VLB-CD-/DVD:

VLB-CD-/DVD-Datenbank: Neue Felder

Das Datenmodell der VLB-CD-/DVD-Datenbank wird um die zusätzlichen Felder EAN (PCF 3001) und Non-Book-Flag (PCF 3015 mit Wert Y, wenn Non-Book mit EAN) erweitert.

VLB-API: Keine neue Version notwendig

Zur Anpassung Ihrer Produkte an die veränderte VLB-Datenbank ist keine neue Version der vlbapi.dll notwendig. Die Version VLB-API 4.02-3.00a-Jan 17 2007
bleibt weiterhin aktuell. EAN-Produkte können zukünftig in der VLB-Datenbank über den bereits vorhandenen Index EA gesucht werden, der bisher nur für die SBZ-Datenbank (VLB-DVD) genutzt wurde.
Die XML-API wird Anfang Januar angepasst.

VLB-CD-/DVD-Oberfläche: Änderungen

Die Suchmaske der VLB-Retrieval-Software wird um einen Non-Book-Index ergänzt. In der Boole'schen Suche können EAN-Produkte mit dem Suchkürzel EA gesucht werden.
Die Titeldatenexporte und der Bestelldatenexport werden um die EAN ergänzt.

Oktober 2007

Beginnend mit der November-Version der VLB-CD/DVD werden alle Schweizer Preise in der VLB-Datenbank mit dem Kürzel “fPr” gekennzeichnet. Dasselbe gilt für die Datenbank des VLB Online Katalogs. Mit dieser Maßnahme wird der Freigabe der Buchpreise in der Schweiz Rechnung getragen.

Wir bitten Sie, bei den Suchfunktionen Ihrer Applikation und der Darstellung der VLB-Daten zu berücksichtigen, dass alle drei Preisfelder (1263, 1264, 1270) das Kürzel “fPr” beinhalten können.

V.4.02-3.00a – Januar 2007

Mit der kommenden Januar-Ausgabe der VLB-CD/DVD erfolgt eine Umstellung der Warengruppen von der bis dato gültigen Systematik auf die neue Warengruppen-Klassifikation (WGSneu). Von dieser Umstellung sind sowohl die VLB- als auch die SBZ-Datenbank betroffen. Zum Erscheinen der Januar -Ausgabe der VLB-CD/DVD werden auch die Warengruppen im VLB online Katalog umgestellt.

Die Umstellung führt zu Änderungen an der VLB-Datenbank, den VLB-Programm-Oberflächen sowie den VLB-APIs. Um eine saubere Trennung zwischen alten und neuen Warengruppen zu gewährleisten, sind zwei neue PCF-Felder eingeführt worden: PCF 3908 für den Index der neuen Warengruppe sowie PCF 3909 für den Schlüssel der neuen Warengruppe. Für eine Übergangszeit bis Ende Juni 2007 werden auch die alten Warengruppen in PCF 1908 und PCF 1909 in der VLB-Datenbank mitgeführt und können über die VLB-APIS ausgelesen werden. Diese alten Warengruppen werden allerdings nicht mehr indiziert und können somit nicht mehr in den Suchfunktionalitäten verwendet werden.

Damit Sie Ihre Produkte an die Änderungen der VLB-CD/DVD anpassen können, stellen wir Ihnen auf Anfrage eine neue Version der vlbapi.dll samt überarbeiteter Dokumentation zur Verfügung.

Weitere Änderungen an Ihrer Software, etwa im Zusammenhang mit der ISBN-13-Umstellung, sind nicht notwendig. Die in den Daten vorhandenen ISBN-10 werden in den VLB- und SBZ-Daten auch in Zukunft mitgeführt und können im Zusammenhang mit den VLB-APIs wie gehabt genutzt werden.

V.4.02-3.00a – September 2006

Aus aktuellem Anlass bitten wir Sie, folgende Informationen zur ISBN-13-Fähigkeit der aktuellen vlbapi.dll zu beachten. Außerdem möchten wir Sie über Änderungen an der kommenden Version der VLB CD-ROM-Software (September) und über ein anstehendes Update der vlbapi.dll informieren.

1. Aktuelle vlbapi.dll und ISBN-13

Wir freuen uns, Ihnen mitteilen zu dürfen, dass die VLB-Software-API (vlbapi.dll), die Sie bereits im Einsatz haben, vollständig ISBN-13 fähig ist. Der ISBN-Index beinhaltet sowohl die ISBN-10 als auch die ISBN-13. Zurückgeliefert wird die ISBN-13 im Feld “3012”.

2. VLB CD-ROM September: API-relevante Software-Änderungen

Außerdem sind an der VLB-Software und der VLB-Datenbank die folgenden Änderungen vorgenommen worden, die auch Auswirkungen auf den Zugriff über die vlbapi.dll haben. Die Änderungen im Überblick:

Neue Suchkriterien

Mit der September-Ausgabe werden die folgenden neuen Suchkriterien eingeführt:

  • Warengruppen (WG),
  • Produktsprache (LA, SP),
  • DDC – Dewey Decimal Classification (DW) ,
  • Zugangsdatum (ZD),
  • Änderungsdatum (AD).
  • Auslieferung (AS)

Bitte beachten: Um Inkonsistenzen zwischen der VLB und SBZ-Datenbank zu beheben, wurde das Boole'sche Suchkriterium für Auslieferung in AS geändert.

Hinweis zur Schweizer Ausgabe bzw. SBZ-Datenbank: Die Suche mit dem Suchkriterium “WG” wird ab September die eigentliche Warengruppe zurückliefern und nicht mehr nur den Warengruppen-Index. Dieser ist ohnehin in Form der Produktform-Filter (HC, TB, etc.) vorhanden.

Neue Datenfelder

Beginnend mit der September-Ausgabe werden zusätzlich zu den bisherigen Daten Zielgruppeninformationen (Felder “1710”, “1720”, “1740”) angezeigt. Die Warengruppen und Produktsprachen, die vorher nur kodiert dargestellt wurden, werden künftig textuell aufgelöst.

Zusatztexte nur noch online

Aufgrund von Platzproblemen auf der CD-ROM sind die Zusatztexte (Annotationen) nur noch online abrufbar.