Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
stylenone

Changelog

Date

Image of book-cover in production (v2)

.6.

Short description will be added to v2 only.

.5.

Image for book’s back cover will be added to v2

8.5.

Work as subject will be added to v2

.4.

In v2:
City of publication

Accompanying material in TextContent

Changes in text content

New title types

Contributor statement, from language added

Subject from NEO now in v2

Subjects will include language attribute, both for genre/form and subjects

Reintroducing Literary prizes in v2

PriceCondition postponed until further notice.

EUDR, FSC etc. moved to Q3 and v3-endpoint of Onix.

GPSR + Kulturrådet are now done

Introducing v2-endpoint for Onix Export. Most new features will be exclusive to the new v2-endpoint, see also deprecation-notice for v1.

  • Device support

    • released in prod. Both methods supported until end-of-life for old syntax

  • Collection type 11

    • released in stage/test

  • Device support

    • released in stage/test (both export and import)

  • EUDR, FSC, PEFC, carbon emission

    • support for EUDR is postponed, due to delays in the implementation of EUDR

    • support for FSC, PEFC, carbon emission expected in Q2/2025

  • Contributor Unnamed Persons

    • Released in stage/test

    • In prod from

  • EUDR, FSC, PEFC, carbon emission

    • Delayed expected delivery Q2/2025

  • Contributor Role Code

    • Released (except B34)

  • Device support

    • Delayed expected delivery dates

  • Price condition

    • Delayed expected delivery quarter

  • Text and data mining

    • Released

  1. okt. 2024

Subject from NTSF

  • released in addition to proprietary scheme

  • Genre/form from Bokbasen’s proprietary scheme is sent in parallell, but will be deprecated.

  • “Chapters in audio and ebooks” deployed to test/stage

    • “Text and data mining” deployed to test/stage

...

Feature

Available from (endpoint version)

Status

Contributor Unnamed Persons

  • import

Q4 2024

Status
colourGreen
titledone

Contributor Unnamed Persons

  • export

In prod from (only v2)

⚠️ Breaking change

Status
colourGreen
titledone

Subject

  • export

September 2024

Status
colourGreen
titledone

FSC, PEFC, carbon emission, EUDR

  • import

Q3 2025

Status
titlenot started

FSC, PEFC, carbon emission, EUDR

  • export

Q3 2025

Status
titlenot started

Contributor Role Code

  • import

November 2024

Status
colourGreen
titledone

Contributor Role Code

  • export

November 2024

Status
colourGreen
titledone

Chapters in audio/text books

  • export

January 2025 (only v2)

Status
colourGreen
titledone

Device support

  • import

⚠️ End-of-life for old syntax

Status
colourGreen
titledone

Device support

  • export

January 2025 (only v2)

In stage from

⚠️ Breaking change

Status
colourGreen
titledone

Collection (publisher)

  • import

Q4 2024

Status
colourGreen
titledone

Collection (publisher)

  • export

Q4 2024 (only v2)

Status
colourGreen
titledone

Price condition (automatic renewed)

  • import

Q2 2025
Postponed until further notice

Status
colourPurple
titlepostponed

Price condition (automatic renewed)

  • export

Q2 2025
Postponed until further notice

Status
colourPurple
titlepostponed

Text and data mining

  • export

October 2024

Status
colourGreen
titledone

Onix 3.1

  • import

Q2 2025

Status
colourBlue
titleDOING

Onix 3.1

  • export

(only v2)

Status
colourGreen
titledone

GPSR - General Product Safety Regulation (EU)

Q1 2025 (only v2)

Status
colourGreen
titleDone

Kulturrådets innkjøpsordninger

Q1 2025 (only v2)

⚠️ Breaking change

Status
colourGreen
titleDone

Subject from NEO

Q2 (only v2)

Status
colourGreen
titleDone

Literary prizes

April 2025 (only v2)

Status
colourGreen
titleDone

City of publication

April 2025 (only v2)

Status
colourGreen
titleDone

Text content

April 2025 (only v2)

Status
colourGreen
titleDone

Title type

April 2025 (only v2)

Status
colourGreen
titleDone

Dewey

April 2025 (only v2)

⚠️ Breaking change

Status
colourGreen
titleDone

From language

April 2025 (only v2)

Status
colourGreen
titleDone

Contributor statement

April 2025 (only v2)

Status
colourGreen
titleDone

Work as subject

May 2025 (only v2)

Status
colourGreen
titleDone

Image of back cover

Q2, only v2

Status
colourBlueGreen
titleDOINGDone

Original title of collection

Q2, only v2

Status
colourGreen
titleDone

Short description

Q3, only v2

Status
colourBlue
titlenot startedDOING

Features / changes

Contributor Unnamed Persons
Status
colourRed
titleBreaking change

...

Expand
titleGuide

The Norwegian thesaurus on genre and form is identified by code C8 from list 27 in Subject Scheme Identifier.

Terms from the proprietary vocabularies was sent in Subject like this:
<Subject>
<SubjectSchemeIdentifier>24</SubjectSchemeIdentifier>
<SubjectSchemeName>Bokbasen_Form</SubjectSchemeName>
<SubjectHeadingText>Romaner</SubjectHeadingText>
</Subject>

<Subject>
<SubjectSchemeIdentifier>24</SubjectSchemeIdentifier>
<SubjectSchemeName>Bokbasen_Genre</SubjectSchemeName>
<SubjectHeadingText>Krim</SubjectHeadingText>
</Subject>

Expand
titleExamples

<Subject>
<SubjectSchemeIdentifier>24</SubjectSchemeIdentifier>
<SubjectSchemeName>Bokbasen_Form</SubjectSchemeName>
<SubjectHeadingText>Romaner</SubjectHeadingText>
</Subject>

<Subject>
<SubjectSchemeIdentifier>24</SubjectSchemeIdentifier>
<SubjectSchemeName>Bokbasen_Genre</SubjectSchemeName>
<SubjectHeadingText>Krim</SubjectHeadingText>
</Subject>

<Subject>
<SubjectSchemeIdentifier>C8</SubjectSchemeIdentifier>
<SubjectCode>https://id.nb.no/vocabulary/ntsf/25</SubjectCode>
<SubjectHeadingText language=”nob”>Romaner</SubjectHeadingText>
</Subject>

<Subject>
<SubjectSchemeIdentifier>C8</SubjectSchemeIdentifier>
<SubjectCode>https://id.nb.no/vocabulary/ntsf/159</SubjectCode>
<SubjectHeadingText language=”nob”>Krim</SubjectHeadingText>
</Subject>

Subject - Subjects

Bokbasen will deprecate the proprietary vocabulary for subjects, and replace them with terms from the official Norwegian thesaurus for subjects (NEO). The thesaurus is provided by the National Library of Norway, and will (if not delayed) be published 1st of April 2025.

...

Expand
titleExamples

<Subject>
<SubjectSchemeIdentifier>24</SubjectSchemeIdentifier>
<SubjectSchemeName>Bokbasen_Subject</SubjectSchemeName>
<SubjectHeadingText>Naturvitenskap</SubjectHeadingText>
</Subject>

<Subject>
<SubjectSchemeIdentifier>D3</SubjectSchemeIdentifier>
<SubjectCode>https://id.nb.no/vocabulary/neo/1116</SubjectCode>
<SubjectHeadingText language=”nob”>Naturvitenskap</SubjectHeadingText>
</Subject>

<Subject>
<SubjectSchemeIdentifier>D3</SubjectSchemeIdentifier>
<SubjectCode>https://id.nb.no/vocabulary/neo/1116</SubjectCode>
<SubjectHeadingText language=”nno”>Naturvitskap</SubjectHeadingText>
</Subject>

EUDR, FSC, PEFC, carbon emission

...

Expand
titleExamples

Due Diligence Statement

<ProductFormFeature>
<ProductFormFeatureType>50</ProductFormFeatureType>
<ProductFormFeatureValue>24FRXVV3VOS991</ProductFormFeatureValue>
</ProductFormFeature>

Provenance of raw material for cover

Example shows single GPS coordinate (latitude and longitude), denoting the centre of a 4Ha plot of land where the trees grew.

<ProductFormFeature>
<ProductFormFeatureType>48</ProductFormFeatureType>
<ProductFormFeatureValue>GB 202401</ProductFormFeatureValue>
<ProductFormFeatureDescription>51.544708 0.061076</ProductFormFeatureDescription>
</ProductFormFeature>

Provenance of raw material for body

Three or more GPS coordinates denotes a polygon outlining the forest where the trees grew.

<ProductFormFeature>
<ProductFormFeatureType>47</ProductFormFeatureType>
<ProductFormFeatureValue>GB 202311</ProductFormFeatureValue>
<ProductFormFeatureDescription>51.549040 -0.120975, 51.556838 -0.127326, 51.555092 -0.108261, 51.549040 -0.120975</ProductFormFeatureDescription>
</ProductFormFeature>

Contributor Role Code

Contributor role code is used to indicate the role played by a person or a corporate body in the creation of the product.

...

Code

Heading

A15

Preface by

A19

Afterword by

A23

Foreword by

A36

Cover design or artwork by (children’s literature only)

A42

Continued by

A43

Interviewer

A44

Interviewee

B34

Sensitivity reader / editor

Expand
titleExample

<Contributor>
<SequenceNumber>1</SequenceNumber>
<ContributorRole>A23</ContributorRole>
<NameType>04</NameType>
<NameIdentifier>
<NameIDType>01</NameIDType>
<IDTypeName>Bokbasen_ProprietaryID</IDTypeName>
<IDValue>90707439</IDValue>
</NameIdentifier>
<PersonNameInverted>Gaugin, Paul René</PersonNameInverted>
</Contributor>

Chapters in audio and ebooks

...

Expand
titleExample (Audio Chapters)

<ContentDetail>
<ContentItem>
<LevelSequenceNumber>1</LevelSequenceNumber>
<AVItem>
<AVItemType>03</AVItemType>
<TimeRun>
<StartTime>0000000</StartTime>
</TimeRun>
<AVDuration>0010343</AVDuration> <!-- 001h, 03m, 43s -->
</AVItem>
<ComponentTypeName>Kapittel</ComponentTypeName>
<ComponentNumber>1</ComponentNumber>
<TitleDetail>
<TitleType>01</TitleType>
<TitleElement>
<TitleElementLevel>04</TitleElementLevel>
<TitleText>The name of the first chapter</TitleText>
</TitleElement>
</TitleDetail>
</ContentItem>

<ContentDetail>

Expand
titleExample (Text Chapters)

<ContentDetail>
<ContentItem>
<LevelSequenceNumber>1</LevelSequenceNumber>
<TextItem>
<TextItemType>03</TextItemType>
<PageRun>
<FirstPageNumber>2</FirstPageNumber>
</PageRun>
<NumberOfPages>22</NumberOfPages>
</TextItem>
<ComponentTypeName>Kapittel</ComponentTypeName>
<ComponentNumber>1</ComponentNumber>
<TitleDetail>
<TitleType>01</TitleType>
<TitleElement>
<TitleElementLevel>04</TitleElementLevel>
<TitleText>The name of the first chapter</TitleText>
</TitleElement>
</TitleDetail>
</ContentItem>

<ContentDetail>

Device support
Status
colourRed
titleBreaking change

...

It will now be present as ProductFormFeatureDescription (code 07 from list 79). to allow the indication of multiple devices supported.

Expand
titleExample

<ProductFormDescription>Smarttelefon</ProductFormDescription>

<ProductFormFeature>
<ProductFormFeatureType>07</ProductFormFeatureType>
<ProductFormFeatureDescription>Smarttelefon</ProductFormFeatureDescription>
</ProductFormFeature>

Price condition (automatic renewed)

...

Expand
titleGuide

Code 07 from list 167 is used in PriceConditionType to indicate that the rental or subscription will automatically renewed at the end of the period unless actively cancelled.

Code 01 from list 168 is used in PriceConditionQuantityType to indicate that the renewal time period is 12 months (09).

Expand
titleExamples

<PriceCondition>
<PriceConditionType>07</PriceConditionType
<PriceConditionQuantity>
<PriceConditionQuantityType>01</PriceConditionQuantityType
<Quantity>12</Quantity>
<QuantityUnit>09</QuantityUnit>
</PriceConditionQuantity>
</PriceCondition>

Collection (Norw. forlagsserie)

...

Expand
titleExamples

Collection Type 11 (publisher’s collection)

<Collection>
<CollectionType>11</CollectionType>
<CollectionIdentifier>
<CollectionIDType>01</CollectionIDType>
<IDTypeName>Bokbasen_ProprietaryID</IDTypeName>
<IDValue>150140617</IDValue>
</CollectionIdentifier>
<TitleDetail>
<TitleType>01</TitleType>
<TitleElement>
<TitleElementLevel>02</TitleElementLevel>
<TitleText>Bestselger Schibsted</TitleText>
</TitleElement>
</TitleDetail>
</Collection>

Collection Type 10, with part number element

<Collection>
<CollectionType>10</CollectionType>
<CollectionIdentifier>
<CollectionIDType>01</CollectionIDType>
<IDTypeName>Bokbasen_ProprietaryID</IDTypeName>
<IDValue>20090529101912_rine</IDValue>
</CollectionIdentifier>
<TitleDetail>
<TitleType>01</TitleType>
<TitleElement>
<TitleElementLevel>02</TitleElementLevel>
<TitleText>Percy Jackson</TitleText>
</TitleElement>
<TitleElement>
<TitleElementLevel>01</TitleElementLevel>
<PartNumber>1</PartNumber>
</TitleElement>
</TitleDetail>
</Collection>

Text and data mining

In all Bokbasen’s customer contracts, use of the product for extraction, automated computer analaysis or AI-training is regulated and forbidden.

...

Expand
titleGuide

EpubUsageType will include information indicating that use of the content of the product by artificial intelligence systems is forbidden.

Usage type 11 is used in combination with code 03 in EpubUsageStatus, to state that text and data mining is prohibited.

Expand
titleExample

<EpubUsageConstraint>
<EpubUsageType>11</EpubUsageType>
<EpubUsageStatus>03</EpubUsageStatus>
</EpubUsageConstraint>

GPSR - General Product Safety Regulation (EU)

...

ProductContact will be added to metadata for all physical products.

Expand
titleExample

<ProductContact>
<ProductContactRole>10</ProductContactRole>
<ProductContactName>{PUBLISHER_NAME}</ProductContactName>
<EmailAddress>{PUBLIC_EMAIL}</EmailAddress>
<StreetAddress>{POSTAL_ADDRESS}</StreetAddress>
<LocationName>{CITY}</LocationName>
<PostalCode>{POSTAL_CODE}</PostalCode>
<CountryCode>{COUNTRY_CODE_ONIX_91}</CountryCode>
</ProductContact>

Kulturrådets innkjøpsordninger (K-fond)
Status
colourRed
titleBreaking change

...

Expand
titleGuide

ProductClassification will include information identifying four statuses in the acquisition scheme, in contrast to v1, which only states the values NKR_JA or NKR_NEI.

ProductClassification is used for multiple classification schemes, for information about K-fond, ProductClassificationName is “BOKBASEN_KULTURRÅD”

New values are:

Påmeldt
Innkjøpt
Avslått
Avvist

Expand
titleExample

<ProductClassification>
<ProductClassificationType>07</ProductClassificationType>
<ProductClassificationTypeName>BOKBASEN_KULTURRAD</ProductClassificationTypeName>
<ProductClassificationCode>Innkjøpt</ProductClassificationCode>
</ProductClassification>

Literary prizes

Information about literary prizes will be reintroduced to records from Bokbasen.

...

Expand
titleExample

Prize awarded a work:

<Prize>
<SequenceNumber>01</SequenceNumber>
<PrizeName>Nynorsk barnelitteraturpris</PrizeName>
<PrizeYear>2024</PrizeYear>
<AwardingBody>Noregs Mållag</AwardingBody>
</Prize>

Prize awarded an author:
<Prize>
<SequenceNumber>01</SequenceNumber>
<PrizeName>Nobelprisen</PrizeName>
<PrizeYear>2024</PrizeYear>
<AwardingBody>Svenska Adademien</AwardingBody>
</Prize>

City of publication

Information about the city associated with the publisher.
Mainly used by library users of Onix records.

Expand
titleGuide

The name of the city associated with the publisher will be included as a standardized textelement in City of publication in Block 4.

Expand
titleExample

<PublishingDetail>

<Publisher>
<PublishingRole>01</PublishingRole>
<PublisherIdentifier>
<PublisherIDType>01</PublisherIDType>
<IDTypeName>Bokbasen_Kundenummer</IDTypeName>
<IDValue>4285</IDValue>
</PublisherIdentifier>
<PublisherIdentifier>
<PublisherIDType>06</PublisherIDType>
<IDValue>7080004117402</IDValue>
</PublisherIdentifier>
<PublisherName>Bonnier Norsk Forlag AS</PublisherName>
</Publisher>
<CityOfPublication>Oslo</CityOfPublication>

</PublishingDetail>

Text content

Accompanying material

...

Expand
titleGuide

Accompanying material is supplied in addition to the publication itself, and can f.i. be a loose map supplied with a travel guide or a pattern sheet supplied with a book about sewing.

Expand
titleExample

<TextContent>
<TextType>11</TextType>
<ContentAudience>00</ContentAudience>
<Text>1 løst kart</Text>
</TextContent>

General notes

Text content with type 01 is used for additional information in text format not supplied elsewhere.

...

Expand
titleExample

Changed from:

TextSourceCorporate>Bokbasen_Note</TextSourceCorporate>

To:

<TextContent>
<TextType>01</TextType>
<ContentAudience>00</ContentAudience>
<Text>1. e-bokutgave tilsvarer 2. trykte utgave 2025</Text>
<TextSourceCorporate>Bokbasen</TextSourceCorporate>
</TextContent>

Title type

Added support for new Title type codes to specify type of alternative titles in Title detail.

...

Expand
titleExample

Translated into Norwegian from the English edition (type 16)

<TitleDetail>
<TitleType>16</TitleType>
<TitleElement>
<SequenceNumber>2</SequenceNumber>
<TitleElementLevel>01</TitleElementLevel>
<TitleText>A wild sheep chase</TitleText>
</TitleElement>
</TitleDetail>

From language

Translated into Norwegian from another language than the original language. From language added to the Contributor composite and used with Contributor role B06 (translated by).

Expand
titleExample

<Contributor>
<SequenceNumber>2</SequenceNumber>
<ContributorRole>B06</ContributorRole>
<FromLanguage>eng</FromLanguage>

<PersonNameInverted>Risvik, Kjell</PersonNameInverted>

</Contributor>


<Language>
<LanguageRole>01</LanguageRole>
<LanguageCode>nob</LanguageCode>
</Language>
<Language>
<LanguageRole>02</LanguageRole>
<LanguageCode>jap</LanguageCode>
</Language>

Contributor statement

Free text showing how the authorship is described in the publication.
Mainly used by library users of Onix records. For display use only.

Expand
titleExample

<ContributorStatement>Solvej Balle ; oversatt av Trude Marstein</ContributorStatement>

Dewey
Status
colourRed
titleBreaking change

...

Expand
titleGuide

Added support for multiple codes in Subject scheme identifier; 01, 02 and 46

Added element Subject scheme version for Dewey edition.

Dewey number sent in Subject code (previously subject heading text), with datestamp attribute.

Expand
titleExample

<Subject>
<SubjectSchemeIdentifier>01</SubjectSchemeIdentifier>
<SubjectSchemeVersion>23/nor</SubjectSchemeVersion>
<SubjectCodedatestamp="20250423">741.5/69481</SubjectCode>
</Subject>

Work as subject

If a work is about another work, a link to the mentioned work will be added to the Onix record.

...

Expand
titleGuide

SubjectSchemeIdentifier is 24 and SubjectSchemeName is ‘Bokbasen_Work_As_Subject’

SubjectCode contains an identifier, and SubjectHeadingText the preferred title of the work.

Expand
titleExample

<Subject>
<SubjectSchemeIdentifier>24</SubjectSchemeIdentifier>
<SubjectSchemeName>Bokbasen_Work_As_Subject</SubjectSchemeVersion>
<SubjectCode>bb:work:V2Z7N0YTZH7T5CXKK01CH00S201</SubjectCode>
<SubjectHeadingText>Kongs-emnerne</SubjectHeadingText>
</Subject>

Supporting resource - image of book’s back cover

...

Expand
titleGuide

Code for back cover is ‘02’ from codelist 158 in issue 70 of the codelists.

Bokbasen will implement this as a part of Supporting resource, in the element ResourceContentType. Link to the image will be included in ResourceLink.

Expand
titleExample

<SupportingResource>
<ResourceContentType>02</ResourceContentType>
<ContentAudience>00</ContentAudience>
<ResourceMode>03</ResourceMode>
<ResourceLink><https://api.boknett.no/metadata/export/object/download</ResourceLink>>
<ResourceVersion>
<ContentDate>
<ContentDateRole>17</ContentDateRole>
<Date dateformat=14>20251104T120000</Date>
</ContentDate>
</ResourceVersion>
</SupportingResource>

Collection: original title

...

Expand
titleGuide

The series title is included in a TitleDetail composite in Collection, where the TitleType is set to ‘01’.

For the original title of series, TitleDetail will be repeated, and TitleType is set to ‘03’.

Expand
titleExample

<Collection>
<CollectionType>10</CollectionType>
<CollectionIdentifier>
<CollectionIDType>01</CollectionIDType>
<IDTypeName>Bokbasen_ProprietaryID</IDTypeName>
<IDValue>150118922</IDValue>
</CollectionIdentifier>
<TitleDetail>
<TitleType>01</TitleType>
<TitleElement>
<TitleElementLevel>02</TitleElementLevel>
<TitleText>En pingles dagbok</TitleText>
</TitleElement>
<TitleElement>
<TitleElementLevel>01</TitleElementLevel>
<PartNumber>1</PartNumber>
</TitleElement>
</TitleDetail>
<TitleDetail>
<TitleType>03</TitleType>
<TitleElement>
<TitleElementLevel>02</TitleElementLevel>
<TitleText>Diary of a wimpy kid</TitleText>
</TitleElement>
<TitleElement>
<TitleElementLevel>01</TitleElementLevel>
<PartNumber>1</PartNumber>
</TitleElement>
</TitleDetail>

TextContent: short description

...

Expand
titleGuide

Short description is identified by code 02 in TextType.

The Text-element will include attributes for language and textformat.

The short description may be available in multiple languages. It is important to consider the language attribute, and choose the prefereed language of the text.

Short description may be available in HTML-format, and will always be available as plain text.

Expand
titleExample

<TextContent>
<TextType>02</TextType>
<ContentAudience>00</ContentAudience>
<Text language="nob" textformat="02"><![CDATA[ <p>Text with HTML</p>]]></Text>
</TextContent>

Onix 3.1

In February 2023 the Onix Steering Committee agreed that in addition to adding new features to Onix, various data elements that were deprecated, plus the <Gender> tag were to be removed. This necessitated the labelling of the revision as release 3.1.

...