ONIX

Documentation for the ONIX telescope

The ONIX telescope downloads, transforms and loads publisher ONIX feeds into BigQuery. ONIX is a standard format that book publishers use to share information about the books that they have published.

Book publishers with ONIX feeds are given credentials and access to their own upload folder on the OAeBU SFTP server. They then configure ONIX Suite to upload their ONIX feeds to the SFTP server on a weekly basis. The ONIX feeds need to be full dumps every time, not incremental updates.

Dataset Name

onix

Table Name

onix

Table Type

Sharded

Average Runtime

10 min

Average Download Size

10-100 MB

Harvest Type

SFTP Server

Run Schedule

Weekly

Catch-up Missed Runs

Each Run Includes All Data

Telescope Configuration

Airflow connections

NameDescription

sftp_service

The username, password and host name used to connect to the SFTP server

Telescope kwargs

Fields passed as keyword arguments to the telescope upon instantiation.

Date Regular Expression (date_regex)

This field is used to extract the date from the ONIX feed file name. For example, the regex \\d{8} will extract the date from the file name 20220301_CURTINPRESS_ONIX.xml.

kwargs: 
    date_regex: "\\d{8}"

Telescope Tasks

Data Download

Discovers all files in the partner's SFTP server folder that match the supplied date regex pattern. These files are downloaded the the local file system for transforming.

Data Transform

In order to convert from the .xml format into one suitable for loading into BigQuery, the ONIX telescope utilises the the Java ONIX parser. The parser is Java based in order to leverage the Jonix-onix3 library. The output of the parser is a .jsonl file, which makes for simple Pythonic interpretation.

An additional step in the transform task collapses the subjects (Subjects.SubjectHeadingText) into a semicolon-separated string.

BigQuery Load

The transformed data is loaded from the Google Cloud bucket into a date-sharded BigQuery table in the onix dataset, which will be created if it does not yet exist. There will be multiple onix_YYYYMMDD tables.

Table Schema

nametypemodedescription

CountryOfManufacture

STRING

NULLABLE

An ISO code identifying the country of manufacture of a single-item product, or of a multiple-item product when all items are manufactured in the same country. This information is needed in some countries to meet regulatory requirements. Optional and non-repeating.

RecordSourceName

STRING

NULLABLE

The name of the party which issued the record, as free text. Optional and non-repeating, independently of the occurrence of any other field.

RecordSourceType

STRING

NULLABLE

An ONIX description which indicates the type of source which has issued the ONIX record. Optional and non- repeating, independently of the occurrence of any other field.

LCCN

STRING

NULLABLE

Library of Congress Control Number

Collections

RECORD

REPEATED

A bibliographic collection in ONIX 3.0 means a fixed or indefinite number of products, published over a fixed or indefinite time period, which share collective attributes (including a collective title) that are required as part of the bibliographic record of each individual product. In this respect, such a collection is most often thought of as a series. A bibliographic collection may, however, also be traded as a single product (often thought of as a set), but this does not alter the way in which its collective attributes are described in the ONIX records for the individual products.

Collections.TitleDetails

RECORD

REPEATED

A group of data elements which together give the text of a title and specify its type. At least one title detail element is mandatory in each occurrence of the composite, to give the primary form of the product title. The composite is repeatable with different title types.

Collections.TitleDetails.TitleElements

RECORD

REPEATED

A group of data elements which together represent an element of a title. At least one title element is mandatory in each occurrence of the composite. The composite is repeatable with different sequence numbers and/or title element levels, each repeat carrying a different part of the title. An instance of the composite must include at least one of: ; ; , together with , or together with . In other words it must carry either the text of a title or a part or year designation; and it may carry both.

Collections.TitleDetails.TitleElements.PartNumber

RECORD

NULLABLE

When a title element includes a part designation within a larger whole (eg Part I, or Volume 3), this field should be used to carry the number and its ‘caption’ as text. Optional and non-repeating.

Collections.TitleDetails.TitleElements.PartNumber.Value

STRING

NULLABLE

PartNumber value.

Collections.TitleDetails.TitleElements.TitleElementLevel

STRING

NULLABLE

An ONIX description indicating the level of a title element: collection level, subcollection level, or product level. Mandatory in each occurrence of the composite, and non-repeating.

Collections.TitleDetails.TitleElements.TitlePrefix

RECORD

NULLABLE

Text at the beginning of a title element which is to be ignored for alphabetical sorting. Optional and non- repeating; can only be used when is omitted, and if the element is also present. These two elements may be used in combination in applications where it is necessary to distinguish an initial word or character string which is to be ignored for filing purposes, eg in library systems and in some bookshop databases.

Collections.TitleDetails.TitleElements.TitlePrefix.Value

STRING

NULLABLE

TitlePrefix value.

Collections.TitleDetails.TitleElements.TitleWithoutPrefix

STRING

NULLABLE

The text of a title element without the title prefix; and excluding any subtitle. Optional and non-repeating; can only be used if one of the or elements is also present.

Collections.TitleDetails.TitleElements.SequenceNumber

INTEGER

NULLABLE

A number which specifies a single overall sequence of title elements, which is the preferred order for display of the various title elements when constructing a complete title. Optional and non-repeating. It is strongly recommended that where there are multiple title elements within a composite, each occurrence of the composite should carry a .

Collections.TitleDetails.TitleElements.TitleText

STRING

NULLABLE

The text of a title element, excluding any subtitle. Optional and non-repeating, may only be used where , and are not used.

Collections.TitleDetails.TitleElements.Subtitle

STRING

NULLABLE

The text of a subtitle, if any. ‘Subtitle‘ means any added words which appear with the title element given in an occurrence of the composite, and which amplify and explain the title element, but which are not considered to be part of the title element itself. Optional and non-repeating.

Collections.TitleDetails.TitleType

STRING

NULLABLE

An ONIX description indicating the type of a title. Mandatory in each occurrence of the composite, and non-repeating.

Collections.CollectionIdentifers

RECORD

REPEATED

A repeatable group of data elements which together specify an identifier of a bibliographic collection. The composite is optional, and may only repeat if two or more identifiers of different types are sent for the same collection. It is not permissible to have two identifiers of the same type.

Collections.CollectionIdentifers.CollectionIdType

STRING

NULLABLE

An ONIX description identifying a scheme from which an identifier in the element is taken. Mandatory in each occurrence of the composite, and non-repeating.

Collections.CollectionIdentifers.IDValue

STRING

NULLABLE

An identifier of the type specified in the field. Mandatory in each occurrence of the composite, and non-repeating.

Collections.CollectionIdentifers.IDTypeName

STRING

NULLABLE

A name which identifies a proprietary identifier scheme (ie a scheme which is not a standard and for which there is no individual ID type code). Must be used when, and only when, the code in indicates a proprietary scheme, eg a publisher’s own code. Optional and non-repeating.

Collections.CollectionType

STRING

NULLABLE

An ONIX description indicating the type of a collection: publisher collection, ascribed collection, or unspecified. Mandatory in each occurrence of the composite, and non-repeating.

EditionNumber

INTEGER

NULLABLE

The number of a numbered edition. Optional and non-repeating. Normally sent only for the second and subsequent editions of a work, but by agreement between parties to an ONIX exchange a first edition may be explicitly numbered.

RecordRef

STRING

NULLABLE

Two mandatory data elements must be included at the beginning of every product record or update. The first, , is a string of text which uniquely identifies the record. The second, , is a code which specifies the type of notification or update.

RelatedWorks

RECORD

REPEATED

A group of data elements which together describe a work which has a specified relationship to a content item. Optional and repeatable.

RelatedWorks.WorkRelationCode

STRING

NULLABLE

An ONIX description which identifies the nature of the relationship between a product and a work. Mandatory in each occurrence of the composite, and non-repeating.

RelatedWorks.WorkIdentifiers

RECORD

REPEATED

A group of data elements which together define an identifier of a work in accordance with a specified scheme. Mandatory in each occurrence of the composite, and repeatable only if two or more identifiers for the same work are sent using different identifier schemes (eg ISTC and DOI).

RelatedWorks.WorkIdentifiers.WorkIDType

STRING

NULLABLE

An ONIX description identifying the scheme from which the identifier in the element is taken. Mandatory in each occurrence of the composite, and non-repeating.

RelatedWorks.WorkIdentifiers.IDValue

STRING

NULLABLE

An identifier of the type specified in the element. Mandatory in each occurrence of the composite, and non-repeating.

RelatedWorks.WorkIdentifiers.IDTypeName

STRING

NULLABLE

A name which identifies a proprietary identifier scheme (ie a scheme which is not a standard and for which there is no individual ID type code). Must be used when, and only when, the code in the element indicates a proprietary scheme. Optional and non-repeating.

TextContent

RECORD

REPEATED

An optional group of data elements which together carry text related to the product, repeatable in order to deliver multiple texts (often of different types, though for some text types, there may be multiple instances of that type).

TextContent.TextType

STRING

NULLABLE

An ONIX description which identifies the type of text which is sent in the element. Mandatory in each occurrence of the composite, and non-repeating.

TextContent.Text

STRING

REPEATED

The text specified in the element. Mandatory in each occurrence of the composite, and repeatable when essentially identical text is supplied in multiple languages. The language attribute is optional for a single instance of , but must be included in each instance if is repeated.

CityOfPublications

STRING

REPEATED

The name of a city or town associated with the imprint or publisher. Optional, and repeatable if parallel names for a single location appear on the title page in multiple languages, or if the imprint carries two or more cities of publication.

DOI

STRING

NULLABLE

The product's Digital object identifier.

EditionType

STRING

REPEATED

An ONIX description, indicating the type of a version or edition. Optional, and repeatable if the product has characteristics of two or more types (eg ‘revised’ and ‘annotated’).

Imprints

RECORD

REPEATED

An optional group of data elements which together identify an imprint or brand under which the product is marketed. The composite must carry either a name identifier or a name or both, and is repeatable to specify multiple imprints or brands.

Imprints.ImprintIdentifiers

RECORD

REPEATED

A group of data elements which together define the identifier of an imprint name. Optional, but mandatory if the composite does not carry an . The composite is repeatable in order to specify multiple identifiers for the same imprint or brand.

Imprints.ImprintIdentifiers.ImprintIDType

STRING

NULLABLE

An ONIX description which identifies the scheme from which the value in the element is taken. Mandatory in each occurrence of the composite.

Imprints.ImprintIdentifiers.IDValue

STRING

NULLABLE

A code value taken from the scheme specified in the element. Mandatory in each occurrence of the composite, and non-repeating..

Imprints.ImprintIdentifiers.IDTypeName

STRING

NULLABLE

A name which identifies a proprietary identifier scheme (ie a scheme which is not a standard and for which there is no individual ID type code). Must be used when, and only when, the code in the element indicates a proprietary scheme. Optional and non-repeating.

Imprints.ImprintName

STRING

NULLABLE

The name of an imprint or brand under which the product is issued, as it appears on the product. Mandatory if there is no imprint identifier in an occurrence of the composite, and optional if an imprint identifier is included. Non-repeating.

Publishers

RECORD

REPEATED

An optional group of data elements which together identify an entity which is associated with the publishing of a product. The composite allows additional publishing roles to be introduced without adding new fields. Each occurrence of the composite must carry a publishing role code and either a name identifier or a name or both, and the composite is repeatable in order to identify multiple entities.

Publishers.PublisherName

STRING

NULLABLE

The name of an entity associated with the publishing of a product. Mandatory if there is no publisher identifier in an occurrence of the composite, and optional if a publisher identifier is included. Non-repeating.

Publishers.Websites

RECORD

REPEATED

An optional group of data elements which together identify and provide a pointer to a website which is related to the publisher identified in an occurrence of the composite. Repeatable in order to provide links to multiple websites.

Publishers.Websites.WebsiteDescriptions

STRING

REPEATED

Free text describing the nature of the website which is linked through the element. Optional, and repeatable to provide parallel descriptive text in multiple languages. The language attribute is optional for a single instance of , but must be included in each instance if is repeated.

Publishers.Websites.WebsiteRole

STRING

NULLABLE

An ONIX description which identifies the role or purpose of the website which is linked through the element. Optional and non-repeating.

Publishers.Websites.WebsiteLinks

STRING

REPEATED

The URL for the website. Mandatory in each occurrence of the composite, and repeatable to provide multiple URLs where the website content is available in multiple languages. The language attribute is optional for a single instance of , but must be included in each instance if is repeated.

Publishers.PublishingRole

STRING

NULLABLE

An ONIX description which identifies a role played by an entity in the publishing of a product. Mandatory in each occurrence of the composite, and non-repeating.

RelatedProducts

RECORD

REPEATED

A group of data elements which together describe a product which has a specified relationship to a content item. Optional and repeatable.

RelatedProducts.ISBN13

STRING

NULLABLE

The related product's 13-digit International Standard Book Number.

RelatedProducts.ProductForm

STRING

NULLABLE

An ONIX description which indicates the primary form of a related product. Optional in an occurrence of , and non-repeating. If supplied, should be identical to the element supplied in the block of the full ONIX record describing the related product itself.

RelatedProducts.DOI

STRING

NULLABLE

The related product's digital object identifier.

RelatedProducts.GTIN_13

STRING

NULLABLE

The related product's 13-digit global trade item number.

RelatedProducts.ProductRelationCodes

STRING

REPEATED

An ONIX description which identifies the nature of the relationship between two products, eg ‘replaced-by’. Mandatory in each occurrence of the composite, and repeatable where the related product has multiple types of relationship to the product described.

RelatedProducts.PID_Proprietary

STRING

NULLABLE

The related product's proprietary product ID.

PID_Proprietary

STRING

NULLABLE

The product's proprietary product identifier.

ISBN10

STRING

NULLABLE

The product's 10-digit International Standard Book Number.

ISBN13

STRING

NULLABLE

The product's 13-digit International Standard Book Number.

TitleDetails

RECORD

REPEATED

A group of data elements which together give the text of a title and specify its type. At least one title detail element is mandatory in each occurrence of the composite, to give the primary form of the product title. The composite is repeatable with different title types.

TitleDetails.TitleElements

RECORD

REPEATED

A group of data elements which together represent an element of a title. At least one title element is mandatory in each occurrence of the composite. The composite is repeatable with different sequence numbers and/or title element levels, each repeat carrying a different part of the title. An instance of the composite must include at least one of: ; ; , together with , or together with . In other words it must carry either the text of a title or a part or year designation; and it may carry both.

TitleDetails.TitleElements.TitleWithoutPrefix_TextCaseFlags

STRING

NULLABLE

TitleWithoutPrefix textcase attribute.

TitleDetails.TitleElements.TitleText_TextCaseFlags

STRING

NULLABLE

TitleText textcase attribute.

TitleDetails.TitleElements.Subtitle_TextCaseFlags

STRING

NULLABLE

Subtitle textcase attribute.

TitleDetails.TitleElements.TitleText

STRING

NULLABLE

The text of a title element, excluding any subtitle. Optional and non-repeating, may only be used where , and are not used.

TitleDetails.TitleElements.TitleText_Language

STRING

NULLABLE

TitleText language attribute.

TitleDetails.TitleElements.TitleElementLevel

STRING

NULLABLE

An ONIX description indicating the level of a title element: collection level, subcollection level, or product level. Mandatory in each occurrence of the composite, and non-repeating.

TitleDetails.TitleElements.Subtitle

STRING

NULLABLE

The text of a subtitle, if any. ‘Subtitle’ means any added words which appear with the title element given in an occurrence of the composite, and which amplify and explain the title element, but which are not considered to be part of the title element itself. Optional and non-repeating.

TitleDetails.TitleElements.SequenceNumber

INTEGER

NULLABLE

A number which specifies a single overall sequence of title elements, which is the preferred order for display of the various title elements when constructing a complete title. Optional and non-repeating. It is strongly recommended that where there are multiple title elements within a composite, each occurrence of the composite should carry a .

TitleDetails.TitleElements.TitleWithoutPrefix

STRING

NULLABLE

The text of a title element without the title prefix; and excluding any subtitle. Optional and non-repeating; can only be used if one of the or element is also present.

TitleDetails.TitleElements.Subtitle_Language

STRING

NULLABLE

Language attribute.

TitleDetails.TitleElements.TitlePrefix

RECORD

NULLABLE

Text at the beginning of a title element which is to be ignored for alphabetical sorting. Optional and non- repeating; can only be used when is omitted, and if the element is also present. These two elements may be used in combination in applications where it is necessary to distinguish an initial word or character string which is to be ignored for filing purposes, eg in library systems and in some bookshop databases.

TitleDetails.TitleElements.TitlePrefix.Value

STRING

NULLABLE

TitlePrefix value.

TitleDetails.TitleType

STRING

NULLABLE

An ONIX description indicating the type of a title. Mandatory in each occurrence of the composite, and non-repeating.

TitleDetails.TitleStatement

STRING

NULLABLE

Free text showing how the overall title (including any collection level title, if the collection title is treated as part of the product title and included in P.6) should be presented in any display, particularly when a standard concatenation of individual title elements from Group P.6 (in the order specified by the data elements) would not give a satisfactory result. Optional and non-repeating. When this field is sent, the recipient should use it to replace all title detail sent in Group P.6 for display purposes only. The individual title element detail must also be sent, for indexing and retrieval purposes.

PublishingDates

RECORD

REPEATED

A group of data elements which together specify a date associated with the publishing of the product. Optional, but where known, at least a date of publication must be specified either here (as a ‘global’ pub date) or in (P.25). Other dates related to the publishing of a product can be sent in further repeats of the composite

PublishingDates.PublishingDateRole

STRING

NULLABLE

An ONIX description indicating the significance of the date, eg publication date, announcement date, latest reprint date. Mandatory in each occurrence of the composite, and non-repeating.

PublishingDates.Date

INTEGER

NULLABLE

The date specified in the field. Mandatory in each occurrence of the composite, and non-repeating. may carry a dateformat attribute: if the attribute is missing, then indicates the format of the date; if both dateformat attribute and element are missing, the default format is YYYYMMDD.

GTIN_13

STRING

NULLABLE

The product's 13-digit global trade item number.

Languages

RECORD

REPEATED

A group of data elements which together represent a language, and specify its role and, where required, whether it is a country variant. Optional, and repeatable to specify multiple languages and their various roles.

Languages.CountryCode

STRING

NULLABLE

A code identifying the country when this specifies a variant of the language, eg US English. Optional and non-repeating.

Languages.LanguageRole

STRING

NULLABLE

An ONIX description indicating the ‘role’ of a language in the context of the ONIX record. Mandatory in each occurrence of the composite, and non-repeating.

Languages.LanguageCode

STRING

NULLABLE

An ISO code indicating a language. Mandatory in each occurrence of the composite, and non- repeating.

ProductForm

STRING

NULLABLE

An ONIX description which indicates the primary form of a related product. Optional in an occurrence of , and non-repeating. If supplied, should be identical to the element supplied in the block of the full ONIX record describing the related product itself.

Contributors

RECORD

REPEATED

A group of data elements which together describe a personal or corporate contributor to the product. Optional, and repeatable to describe multiple contributors.

Contributors.LettersAfterNames

STRING

NULLABLE

The seventh part of a structured name of a person who contributed to the creation of the product: qualifications and honors following a person’s names, eg ‘CBE FRS’. Optional and non-repeating.

Contributors.Gender

STRING

NULLABLE

An optional ONIX code specifying the gender of a personal contributor. Not repeatable. Note that this indicates the gender of the contributor’s public identity (which may be pseudonymous) based on designations used in ISO 5218, rather than the gender identity, biological sex or sexuality of a natural person.

Contributors.Proprietary

INTEGER

NULLABLE

The contributor's proprietary identifier.

Contributors.NameType

STRING

NULLABLE

An ONIX description indicating the type of a primary name. Optional, and non-repeating. If omitted, the default is ‘unspecified’.

Contributors.ProfessionalAffiliations

RECORD

REPEATED

An optional group of data elements which together identify a contributor’s professional position and/or affiliation, repeatable to allow multiple positions and affiliations to be specified.

Contributors.ProfessionalAffiliations.Positions

STRING

REPEATED

A professional position held by a contributor to the product at the time of its creation. Optional, and repeatable to provide parallel text in multiple languages. The language attribute is optional for a single instance of , but must be included in each instance if is repeated.

Contributors.ProfessionalAffiliations.Affiliations

STRING

NULLABLE

An organization to which a contributor to the product was affiliated at the time of its creation, and – if the element is also present – where s/he held that position. Optional and non-repeating.

Contributors.ORCID

STRING

NULLABLE

A 16-digit ORCID ID that uniquely identifies the author.

Contributors.BiographicalNotes

RECORD

REPEATED

A biographical note about a contributor to the product. (See the composite in Group P.14 for a biographical note covering all contributors to a product in a single text.) Optional, and repeatable to provide parallel biographical notes in multiple languages. The language attribute is optional for a single instance of , but must be included in each instance if is repeated. May occur with a person name or with a corporate name. A biographical note in ONIX should always contain the name of the person or body concerned, and it should always be presented as a piece of continuous text consisting of full sentences. Some recipients of ONIX data feeds will not accept text which has embedded URLs. A contributor website link can be sent using the composite below.

Contributors.BiographicalNotes.TextFormat

STRING

NULLABLE

The textformat attribute.

Contributors.BiographicalNotes.Note

STRING

NULLABLE

The biographical note.

Contributors.TitlesBeforeNames

STRING

NULLABLE

The first part of a structured name of a person who contributed to the creation of the product: qualifications and/or titles preceding a person’s names, eg ‘Professor’ or ‘HRH Prince’ or ‘Saint’. Optional and non- repeating: see Group P.7 introductory text for valid options.

Contributors.Roles

STRING

REPEATED

An ONIX description indicating the role played by a person or corporate body in the creation of the product. Mandatory in each occurrence of a composite, and may be repeated if the same person or corporate body has more than one role in relation to the product.

Contributors.Websites

RECORD

REPEATED

An optional group of data elements which together identify and provide a pointer to a website which is related to the person or organization identified in an occurrence of the composite. Repeatable to provide links to multiple websites.

Contributors.Websites.WebsiteDescriptions

STRING

REPEATED

Free text describing the nature of the website which is linked through the element. Optional, and repeatable to provide parallel descriptive text in multiple languages. The language attribute is optional for a single instance of , but must be included in each instance if is repeated.

Contributors.Websites.WebsiteRole

STRING

NULLABLE

An ONIX description which identifies the role or purpose of the website which is linked through the element. Optional and non-repeating.

Contributors.Websites.WebsiteLinks

STRING

REPEATED

The URL for the website. Mandatory in each occurrence of the composite, and repeatable to provide multiple URLs where the website content is available in multiple languages. The language attribute is optional for a single instance of , but must be included in each instance if is repeated.

Contributors.PersonNameInverted

STRING

NULLABLE

The name of a person who contributed to the creation of the product, presented with the element used for alphabetical sorting placed first (‘inverted order’). Optional and non-repeating: see Group P.7 introductory text for valid options.

Contributors.Dates

RECORD

REPEATED

A group of data elements which together specify a date associated with the person or organization identified in an occurrence of the composite, eg birth or death. Optional, and repeatable to allow multiple dates to be specified.

Contributors.Dates.Date

INTEGER

NULLABLE

The date specified in the field. Mandatory in each occurrence of the composite, and non-repeating. may carry a dateformat attribute: if the attribute is missing, then indicates the format of the date; if both dateformat attribute and element are missing, the default format is YYYYMMDD.

Contributors.Dates.Role

STRING

NULLABLE

An ONIX description indicating the significance of the date in relation to the contributor name. Mandatory in each occurrence of the composite, and non-repeating.

Contributors.SequenceNumber

INTEGER

NULLABLE

A number which specifies a single overall sequence of title elements, which is the preferred order for display of the various title elements when constructing a complete title. Optional and non-repeating. It is strongly recommended that where there are multiple title elements within a composite, each occurrence of the composite should carry a .

Contributors.PrefixToKey

STRING

NULLABLE

The third part of a structured name of a person who contributed to the creation of the product: a prefix which precedes the key name(s) but which is not to be treated as part of the key name, eg ‘van’ in Ludwig van Beethoven. This element may also be used for titles that appear after given names and before key names, eg ‘Lord’ in Alfred, Lord Tennyson. Optional and non-repeating.

Contributors.KeyNames

STRING

NULLABLE

The fourth part of a structured name of a person who contributed to the creation of the product: key name(s), ie the name elements normally used to open an entry in an alphabetical list, eg ‘Smith’ or ‘Garcia Marquez’ or ‘Madonna’ or ‘Francis de Sales’ (in Saint Francis de Sales). Non-repeating. Required if name part elements P.7.11 to P.7.18 are used.

Contributors.TitlesAfterNames

STRING

NULLABLE

The eighth part of a structured name of a person who contributed to the creation of the product: titles following a person’s names, eg ‘Duke of Edinburgh’. Optional and non-repeating.

Contributors.AlternativeNames

STRING

REPEATED

A group of data elements which together represent an alternative name of a contributor, and specify its type. The composite is optional, and is repeatable to provide multiple alternative names for the contributor.

Contributors.NamesBeforeKey

STRING

NULLABLE

The second part of a structured name of a person who contributed to the creation of the product: name(s) and/or initial(s) preceding a person’s key name(s), eg James J. Optional and non-repeating.

Contributors.Places

RECORD

REPEATED

An optional group of data elements which together identify a geographical location with which a contributor is associated, used to support ‘local interest’ promotions. Repeatable to identify multiple geographical locations, each usually with a different relationship to the contributor.

Contributors.Places.CountryCode

STRING

NULLABLE

A code identifying a country with which a contributor is particularly associated. Optional and non-repeatable. There must be an occurrence of either the or the elements in each occurrence of .

Contributors.Places.Locations

STRING

REPEATED

The name of a city or town location within the specified country or region with which a contributor is particularly associated. Optional, and repeatable to provide parallel names for a single location in multiple languages (eg Baile Átha Cliath and Dublin, or Bruxelles and Brussel). The language attribute is optional for a single instance of , but must be included in each instance if is repeated.

Contributors.Places.Relation

STRING

NULLABLE

An ONIX description identifying the relationship between a contributor and a geographical location. Mandatory in each occurrence of and non-repeating.

Contributors.PersonName

STRING

NULLABLE

The name of a person who contributed to the creation of the product, unstructured, and presented in normal order. Optional and non-repeating: see Group P.7 introductory text for valid options.

Contributors.ISNI

STRING

NULLABLE

16-digit International Standard Name Identifier number.

Contributors.CorprorateName

STRING

NULLABLE

The name of a corporate body which contributed to the creation of the product, unstructured. Optional and non-repeating: see Group P.7 introductory text for valid options.

COKI_ID

STRING

NULLABLE

The product's internal COKI identifier.

Subjects

RECORD

REPEATED

An optional and repeatable group of data elements which together specify a subject classification or subject heading.

Subjects.SubjectHeadingText

STRING

REPEATED

The text of a subject heading taken from the scheme specified in the element, or of free language keywords if the scheme is specified as ‘keywords’; or the text equivalent to the value, if both code and text are sent. Either or or both must be present in each occurrence of the composite.

Subjects.SubjectSchemeIdentifier

STRING

NULLABLE

A number which identifies a version or edition of the subject scheme specified in the associated element. Optional and non-repeating.

Subjects.SubjectSchemeVersion

FLOAT

NULLABLE

A number which identifies a version or edition of the subject scheme specified in the associated element. Optional and non-repeating.

Subjects.SubjectSchemeName

STRING

NULLABLE

A name identifying a proprietary subject scheme (ie a scheme which is not a standard and for which there is no individual identifier code) when is coded ‘24’. Optional and non-repeating.

Subjects.SubjectCode

STRING

NULLABLE

A subject class or category code from the scheme specified in the element. Either or or both must be present in each occurrence of the composite. Non-repeating.

Subjects.MainSubject

BOOLEAN

NULLABLE

An empty element that identifies an instance of the composite as representing the main subject category for the product. The main category may be expressed in more than one subject scheme, ie there may be two or more instances of the composite, using different schemes, each carrying the flag, so long as there is only one main category per scheme. Optional and non-repeating in each occurrence of the composite.

Extent

RECORD

REPEATED

A group of data elements which together describe an extent pertaining to the product. Optional, but in practice required for most products, eg to give the number of pages in a printed book or paginated e-book, or to give the running time of an audiobook. Repeatable to specify different extent types or units.

Extent.ExtentType

STRING

NULLABLE

An ONIX description which identifies the type of extent carried in the composite, eg running time for an audio or video product. Mandatory in each occurrence of the composite, and non-repeating. From Issue 9 of the code lists, an extended set of values for has been defined to allow more accurate description of pagination.

Extent.ExtentValue

INTEGER

NULLABLE

The numeric value of the extent specified in . Optional, and non-repeating. However, either or must be present in each occurrence of the composite; and it is very strongly recommended that should always be included, even when the original product uses Roman numerals.

Extent.ExtentUnit

STRING

NULLABLE

An ONIX description indicating the unit used for the and the format in which the value is presented. Mandatory in each occurrence of the composite, and non-repeating.

Extent.ExtentValueRoman

STRING

NULLABLE

The value of the extent expressed in Roman numerals. Optional, and non-repeating. Used only for page runs which are numbered in Roman.

Last updated