Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Skisse til offentlig dokumentasjon / plan

  • Vi skriver ALT på engelsk.

  • Følg rett hierarki så TOC blir bra

  • Når den er klar for offentligheten, så flyttes den til det offentlige space (under ONIX3)

Table of Contents
stylenone

General note about compatibility

All changes are compatible with Onix 3.0 (covered by existing schema), and should therefore not break anything. We expect that customers will always handle that more and more fields are populated (as long as they are in the schema.

Schedule / Status

  • Innfasing av hver <hva> (ca. mnd som forfines etterhvert)

  • Klar status på om hver <hva> er deployet (test/stage + prod)

  • Eventuelle utfasinger (f.eks. når Onix 3.0 forsvinner)

...

Feature

...

Available from

...

Status
titleNot started
Status
colourBlue
titleIn progress
Status
colourGreen
titleDone

...

Contributor Unamed Persons

  • import

  • export

...

Status
titleNot started

...

Subject

  • export

...

EUDR, FSC, PEFC, carbon emission

  • import

  • eport

...

Contributor Role Code

  • import

  • export

...

Chapters in audio books

  • export

...

Device support

  • import

  • export

...

Collection (publisher)

...

Price condition

...

Text and data mining

  • export

...

Onix 3.1

Features / changes

Contributor Unamed Persons

Unnamed Persons allows positive indication of content generated by AI or where synthesised voices are used for audio content.

Unnamed Persons is part of the Contributor composite.

Unnamed Persons will be supported both for metadata to and from Bokbasen.

Technical details

Expand
titleGuide

Unnamed Persons uses codes from List 19, combined with the element ContributorRole and codes from list 17.

Supported codes will be:

02 Anonymous (real person)
05 Synthesised voice - male
06 Synthesised voice - female
07 Synthesised voice - unspecified
08 Synthesised voice - based on real voice actor
09 AI (artificial intelligence)

Expand
titleExamples

<Contributor>
<SequenceNumber>1</SequenceNumber>
<ContributorRole>A01</ContributorRole>
<PersonNameInverted>Nordmann, Kari</PersonNameInverted>
</Contributor>
<Contributor>
<SequenceNumber>2</SequenceNumber>
<ContributorRole>A12</ContributorRole>
<!-- UnnamedPersons instead of PersonNameInverted -->
<UnnamedPersons>09</UnnamedPersons>
</Contributor>
<Contributor>
<SequenceNumber>3</SequenceNumber>
<ContributorRole>E07</ContributorRole>
<!-- UnnamedPersons instead of PersonNameInverted -->
<UnnamedPersons>05</UnnamedPersons>
</Contributor>

Subject

The Subject element contains classification from several different schemes.

Bokbasen will deprecate two proprietary vocabularies for literary form and genres, and replace them with terms from the official Norwegian thesaurus on genre and form (NTSF). The thesaurus is provided by the National Library of Norway.

All records will be updated with terms and URIs from NTSF.

Terms from NTSF will be supported in records from Bokbasen only.

Terms from proprietary vocabularies and NTSF will be included in records from Bokbasen in parallell to facilitate this transitio

Technical details

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>Romaner</SubjectHeadingText>
</Subject>

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

EUDR, FSC, PEFC, carbon emission

ProductFormFeature and ProductFormFeatureType is used to indicate if a product is in compliance with EU deforestation regulations (EUDR), is FSC or PEFC certified, or information about a carbon emission scheme.

According to EUDR, provenance of raw material source plot must be stated using GPS coordinates. Publishers are expected to add both an identifier for a Due Diligence Record in the EU registry (DDS) and details of provenance of raw material for cover and body of the product.

...

titleGuide

Codes from list 79 Product form feature type identifies what type of information is sent in other subfields of ProductFormFeature.

Codes for FSC and PEFC certification: 30-36

Codes for carbon emission: 41-46

Codes for EUDR: 47-50

...

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.

Support will be added for new codes from List 17 for both records to and from Bokbasen.

...

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>

Device support
Status
colourRed
titleBreaking change

We will move away from using ProductFormDescription.

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

Technical details

Expand
titleExample

<ProductFormDescription>Smarttelefon</ProductFormDescription>

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

Epub usage constraint

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

This constraint will be added to the Onix-records.

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.

...

titleExample

...

Skisse til offentlig dokumentasjon / plan

  • Vi skriver ALT på engelsk.

  • Følg rett hierarki så TOC blir bra

  • Når den er klar for offentligheten, så flyttes den til det offentlige space (under ONIX3)

Table of Contents
stylenone

General note about compatibility

All changes are compatible with Onix 3.0 (covered by existing schema), and should therefore not break anything. We expect that customers will always handle that more and more fields are populated (as long as they are in the schema.

Schedule / Status

  • Innfasing av hver <hva> (ca. mnd som forfines etterhvert)

  • Klar status på om hver <hva> er deployet (test/stage + prod)

  • Eventuelle utfasinger (f.eks. når Onix 3.0 forsvinner)

Feature

Available from

Dokument ferdig
(sett(tick) når ferdig dokumentert)

Status

Status
titleNot started

Status
colourBlue
titleIn progress

Status
colourGreen
titleDone

Contributor Unamed Persons

  • import

  • export

Status
titleNot started

Subject

  • export

EUDR, FSC, PEFC, carbon emission

  • import

  • eport

Contributor Role Code

  • import

  • export

Chapters in audio books

  • export

Device support

  • import

  • export

Collection (publisher)

Price condition

Text and data mining

  • export

Onix 3.1

Features / changes

Contributor Unamed Persons

Unnamed Persons allows positive indication of content generated by AI or where synthesised voices are used for audio content.

Unnamed Persons is part of the Contributor composite.

Unnamed Persons will be supported both for metadata to and from Bokbasen.

Technical details

Expand
titleGuide

Unnamed Persons uses codes from List 19, combined with the element ContributorRole and codes from list 17.

Supported codes will be:

02 Anonymous (real person)
05 Synthesised voice - male
06 Synthesised voice - female
07 Synthesised voice - unspecified
08 Synthesised voice - based on real voice actor
09 AI (artificial intelligence)

Expand
titleExamples

<Contributor>
<SequenceNumber>1</SequenceNumber>
<ContributorRole>A01</ContributorRole>
<PersonNameInverted>Nordmann, Kari</PersonNameInverted>
</Contributor>
<Contributor>
<SequenceNumber>2</SequenceNumber>
<ContributorRole>A12</ContributorRole>
<!-- UnnamedPersons instead of PersonNameInverted -->
<UnnamedPersons>09</UnnamedPersons>
</Contributor>
<Contributor>
<SequenceNumber>3</SequenceNumber>
<ContributorRole>E07</ContributorRole>
<!-- UnnamedPersons instead of PersonNameInverted -->
<UnnamedPersons>05</UnnamedPersons>
</Contributor>

Subject

The Subject element contains classification from several different schemes.

Bokbasen will deprecate two proprietary vocabularies for literary form and genres, and replace them with terms from the official Norwegian thesaurus on genre and form (NTSF). The thesaurus is provided by the National Library of Norway.

All records will be updated with terms and URIs from NTSF.

Terms from NTSF will be supported in records from Bokbasen only.

Terms from proprietary vocabularies and NTSF will be included in records from Bokbasen in parallell to facilitate this transitio

Technical details

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>Romaner</SubjectHeadingText>
</Subject>

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

EUDR, FSC, PEFC, carbon emission

ProductFormFeature and ProductFormFeatureType is used to indicate if a product is in compliance with EU deforestation regulations (EUDR), is FSC or PEFC certified, or information about a carbon emission scheme.

According to EUDR, provenance of raw material source plot must be stated using GPS coordinates. Publishers are expected to add both an identifier for a Due Diligence Record in the EU registry (DDS) and details of provenance of raw material for cover and body of the product.

Expand
titleGuide

Codes from list 79 Product form feature type identifies what type of information is sent in other subfields of ProductFormFeature.

Codes for FSC and PEFC certification: 30-36

Codes for carbon emission: 41-46

Codes for EUDR: 47-50

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.

Support will be added for new codes from List 17 for both records to and from Bokbasen.

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>

Device support
Status
colourRed
titleBreaking change

We will move away from using ProductFormDescription.

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

Technical details

Expand
titleExample

<ProductFormDescription>Smarttelefon</ProductFormDescription>

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

Epub usage constraint

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

This constraint will be added to the Onix-records.

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>

Price condition

Price condition is used to indicate when the subscription of a product is automatically renewed. Typically used for digital learning resources.

The duration of the license period is specified in PriceConditionQuantity/EpubConstraint?.

Expand
titleClick here to expand...Code

Code 12 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.

Expand

<PriceCondition>
<PriceConditionType>07</PriceConditionType
<PriceConditionQuantity>
<PriceConditionQuantityType>02</PriceConditionQuantityType
<Quantity>12</Quantity>
<QuantityUnit>09</QuantityUnit>
</PriceConditionQuantity>
<ProductIdentifier>
<ProductIDType>15</ProductIDType>
<IDValue>9788205399815</IDValue>
</ProductIdentifier>
</PriceCondition>

Publisher collection (Norw. forlagsserie)

CollectionType is used to indicate what type of collection is described in the metadata.

Support for code 11 for identifiyng publisher’s collections will be added.

Publisher’s collections are bibliograhpic collections defined and identified by a publisher, often used for marketing purposes, and often with a distinct design style. The books in the collection does not necessarily have a specific order, shared subject or autorship.

Collections where the books in the collection have a shared subject, narrative or authorship, are identified by collection type 10. This collection type is independent of the publisher, and will be added as matadata to all editions of a book.

Expand

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>

Onix 3.1