EDItEUR logo

ONIX Serials Online Holdings Message Formats

ONIX Serials Online Holdings A-to-Z

Version 1.1 User Guide

Date issued: October 2007

This User Guide has been prepared for the EDItEUR / NISO Joint Working Party for the Exchange of Serials Online Holdings Information by Katharina Klemperer, David Martin and Francis Cave. It is designed to accompany a machine-readable specification of the formats written in XML Schema, which has been developed by Francis Cave.

Copyright © 2006-2007 EDItEUR Limited. All rights reserved.

The structural diagrams have been produced using XML Spy™ from Altova GmbH.

General guidance on schema use

This schema provides a formal specification of what constitutes valid use of XML to construct ONIX Serials Online Holdings (SOH) messages. As well as specifying the XML tags that may be used and in what sequence, it also specifies valid ranges of data values for data contained in XML elements, i.e. between matching pairs of XML tags.

The schema to which this document refers comprises four files which together form an XML document that conforms to the XML Schema Recommendation of the World Wide Web Consortium (W3C). The two files are:

Filename  Description of content
ONIX_SerialsOnlineHoldings_Vn.n.xsd  definitions of the message-level element and of complex types specific to SOH messages (the number 'n.n' is the version number of this schema)
ONIX_Serials_CodeLists.xsd  definitions of datatypes common to all ONIX Serials schemas.

For further information see XML Schema Part 1: Structures and XML Schema Part 2: Datatypes.

It is intended that this schema be used to guide implementation of systems for either originating or receiving SOH messages. Used in conjunction with a suitable “schema parser” it may also be used to validate the structure and contents of an individual message.

This schema defines how the substance, or “payload”, of SOH messages are to be represented in XML, but is silent on the question of how this message is to be conveyed from originator to recipient. It is likely that supply chain partners will need to adopt different approaches to message transport, packaging and delivery, depending upon the specific business systems in which this message format is being implemented.

Guidance on reading the message format specifications

In this user guide each successive XML element is illustrated by a graphic which shows any “child” elements. Clicking on any “child” element will take you to the description of that element. Clicking “Back” will return you to the “parent”.

If a “child” element is shown with a solid outline, the element is mandatory in any occurrence of the “parent”. If it is shown with a dotted outline, it is conditional in this context. If it is repeatable, the element box has the legend “1..∞” or “0..∞” immediately below it, indicating “mandatory and repeatable” or “conditional and repeatable”.

All data types are based upon built-in primitive data types defined in XML Schema Part 2: Datatypes. The names of all pre-defined data types are prefixed by “xs:” and include:

xs:stringa string of characters
xs:decimala number that may have a decimal part
xs:intan integer between -2147483648 and +2147483647 inclusive

Introduction

The ONIX Serials Online Holdings (SOH) format defines a family of XML messages used for communicating information about the holdings or coverage of online serial resources from a party that holds or supplies the resources to a party that needs this information in its systems. Please see the ONIX Serials Online Holdings Overview for a general introduction to the SOH messages and their applications. There are two messages currently defined:

Some words or phrases are used throughout ONIX for Serials with a very specific meaning. These are defined in the ONIX for Serials Glossary, and there are direct links from their first appearance in this text to the definition in the glossary.

Related Documents

Please refer to the following documents for a more detailed introduction to the SOH format:

SOH Outline Specification Release 1.1
(http://www.editeur.org/onixserials/ONIX_SOH_Overview_1.1.pdf)
ONIX Serials Glossary
(http://www.editeur.org/onixserials/ONIX_Serials_glossary.pdf)

ONIX Serials Online Holdings A-to-Z

<ONIXSerialsOnlineHoldingsAtoZ>

 

<ONIXSerialsOnlineHoldingsAtoZ> is the first and mandatory element in the opening “wrapper” of the message, specifying an ONIX SOH format applied to a “flat” AtoZ holdings list. The element carries a version number as an XML attribute “version”. This release of the User Guide describes version number 1.1, which is expressed as:

 

<ONIXSerialsOnlineHoldingsAtoZ version=”1.1”>

 

 

<ONIXSerialsOnlineHoldingsAtoZ>
<Header>

Mandatory in each SOH message

Not repeatable

 

The <Header> composite identifies and provides administrative information about the message as a whole. It can also be used to declare various defaults that will be assumed throughout, unless specifically overridden within the body of the message.

 

This composite identifies senders and receivers, including provision for coded <SenderIdentifier> and <AddresseeIdentifier> information, if business partners agree to follow this approach. It also carries a sequence number to enable tracking of exchanges, a date and time stamp, and an indication of whether the message conveys a complete replacement file or an incremental update list.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header>
<Sender>

Mandatory within <Header>

Not repeatable

 

The <Sender> composite identifies the sender of the message and provides basic contact details.

 

Example:

<Sender>

     <SenderIdentifier>

          <SenderIDType>07</SenderIDType>     07 = “SAN”

          <IDValue>1234567</IDValue>

     </SenderIdentifier>

     <SenderName>Oxford University Press</SenderName>

     <SenderContact>Subscriptions Department</SenderContact>

     <SenderEmail>subscriptions@oupjournals.org</SenderEmail>

</Sender>

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Sender>
<SenderIdentifier>

Optional within <Sender>

Not repeatable

 

The <SenderIdentifier> composite specifies a coded identifier for the sender organization. It is optional and non-repeating in any occurrence of the <Sender> composite, but either <SenderIdentifier> or <SenderName> (see below) orboth must be present.

 

The composite allows business partners to use standard or proprietary identifier schemes where these exist.

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Sender> <SenderIdentifier>
<SenderIDType>

Mandatory within <SenderIdentifier>

Not repeatable

 

<SenderIDType> is a code indicating the scheme or standard from which the sender identifier is taken. If <SenderIDType> is 01 (proprietary), then the name of the scheme should appear in <IDTypeName>.

 

 

Permissible code values:

01 Proprietary

06 EAN-UCC GLN

07 SAN

08 MARC21 organizations code

09 ISIL

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Sender> <SenderIdentifier>
<IDTypeName>

Optional within <SenderIdentifier>

Not repeatable

 

The name of the identification scheme from which the <IDValue> is taken, used only when <SenderIDType> is “01” (proprietary).

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Sender> <SenderIdentifier>
<IDValue>

Mandatory within <SenderIdentifier>

Not repeatable

 

An identifier of the type specified in <SenderIDType>

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Sender>
<SenderName>

Optional within <Sender>

Not repeatable

 

The text name of the sending organization.

 

<Sender> must contain either <SenderIdentifier> or <SenderName> or both.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Sender>
<SenderContact>

Optional within <Sender>

Not repeatable

 

The name of a contact person or group at the sending organization.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Sender>
<SenderEmail>

Optional within <Sender>

Not repeatable

 

An email address that may be used to contact the sending organization.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header>
<Addressee>

Optional within <Header>

Repeatable

 

Identification of the intended recipient organization(s) for the message.

 

May be omitted from broadcast messages or those intended for general distribution.

May be repeated if the same message is sent to multiple recipients

Must contain either <AddresseeIdentifier> or <AddresseeName> or both.

 

Example:

<Addressee>

     <AddresseeIdentifier>

          <AddresseeIDType>07</AddresseeIDType>     07 = “SAN”

          <IDValue>1234567</IDValue>

     </AddresseeIdentifier>

     <AddresseeName>Sample University Library</AddresseeName>

     <AddresseeContact>John Q. Librarian</AddresseeContact>

     <AddresseeEmail>jlibrarian@sampleuniv.edu</AddresseeEmail>
</Addressee>

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Addressee>
<AddresseeIdentifier>

Optional within <Addressee>

Repeatable for identifiers with different AddresseeIDTypes

 

Identification of an Addressee using a value from a standard or proprietary identification scheme.

Must contain either <AddresseeIdentifier> or <AddresseeName> or both.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Addressee> <AddresseeIdentifier>
<AddresseeIDType>

Mandatory within <AddresseeIdentifier>

Not repeatable

 

A code indicating the scheme or standard from which the Addressee identifier is taken. If <AddresseeIDType> is “01” (proprietary), then the name of the scheme should appear in <IDTypeName>.

 

 

Permissible code values:

01 Proprietary

06 EAN-UCC GLN

07 SAN

08 MARC21 organizations code

09 ISIL

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Addressee> <AddresseeIdentifier>
<IDTypeName>

Optional within <AddresseeIdentifier>

Not repeatable

 

The name of the identification scheme from which <IDValue> is taken, used only when <AddresseeIDType> is “01” (proprietary).

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Addressee> <AddresseeIdentifier>
<IDValue>

Mandatory within <AddresseeIdentifier>

Not repeatable

 

An identifier of the type specified in <AddresseeIDType>.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Addressee>
<AddresseeName>

Optional within <Addressee>

Not repeatable

 

The text name of the sending organization.

<Addressee> must contain either <AddresseeIdentifier> or <AddresseeName> or both.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Addressee>
<AddresseeContact>

Optional within <Addressee>

Not repeatable

 

The name of a contact person or group at the recipient organization.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Addressee>
<AddresseeEmail>

Optional within <Addressee>

Not repeatable

 

An email address that may be used to contact the recipient organization.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header>
<MessageNumber>

Optional within <Header>

Not repeatable

 

<MessageNumber> carries a sequence number for ONIX messages of this type sent as part of a series of such messages. The element is optional and non-repeating, but its use is recommended to underpin process integrity and to act as a check against missed or repeated messages.

 

Example:

<MessageNumber>1</MessageNumber>

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header>
<MessageRepeat>

Optional within <Header>

Not repeatable

 

A sequence number showing how many times this particular message has been sent, starting with “1” for the first transmission of the message.

 

Example:

<MessageRepeat>1</MessageRepeat>

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header>
<SentDateTime>

Mandatory within <Header>

Not repeatable

 

A date/time stamp, showing when the message was sent. The following formats may be used:

 

YYYYMMDD

YYYYMMDDTHHMM

YYYYMMDDTHHMMZ (universal time)

YYYYMMDDTHHMM±HHMM (time zone)

 

where “T” and "Z" are constants; that is, the letters T and Z. The recommended form is YYYYMMDDTHHMMZ, using universal time (UTC/GMT).

 

Example:

<SentDateTime>20051020T1550Z</SentDateTime>

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header>
<MessageNote>

Optional within <Header>

Not repeatable

 

A free-text note about the message.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header>
<Subscriber>

Optional within <Header>

Not repeatable

 

The organization (which may be a single institution or a consortium) whose holdings are listed in the message. <Subscriber> should be included if the message lists the holdings to which a particular organization has access, and that organization is not the sole addressee.

 

<Subscriber> must contain either <SubscriberIdentifier> or <SubscriberName> or both.

 

 

Example:

<Subscriber>

     <SubscriberIdentifier>

          <SubscriberIDType>01</SubscriberIDType>     01 = proprietary

          <IDTypeName>Sender’s customer ID</IDTypeName>

          <IDValue>ABC123</IDValue>

     </SubscriberIdentifier>

     <SubscriberName>Sample subscriber</SubscriberName>

</Subscriber>

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Subscriber>
<SubscriberIdentifier>

Optional within <Subscriber>

Repeatable if there are multiple identifiers with different SubscriberIDTypes.

 

Identification of a Subscriber using a value from a standard or proprietary identification scheme.

<Subscriber> must contain either <SubscriberIdentifier> or <SubscriberName> or both.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Subscriber> <SubscriberIdentifier>
<SubscriberIDType>

Mandatory within <SubscriberIdentifier>

Not repeatable

 

A code indicating the scheme or standard from which the Subscriber identifier is taken. If <SubscriberIDType> is “01” (proprietary), then the name of the scheme should appear in <IDTypeName>.

 

 

Permissible code values:

01 Proprietary

06 EAN-UCC GLN

07 SAN

08 MARC21 organizations code

09 ISIL

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Subscriber> <SubscriberIdentifier>
<IDTypeName>

Optional within <SubscriberIdentifier>

Not repeatable

 

The name of the identification scheme from which the <IDValue> is taken, used only when <SubscriberIDType> is “01” (proprietary).

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Subscriber> <SubscriberIdentifier>
<IDValue>

Mandatory within <SubscriberIdentifier>

Not repeatable

 

An identifier of the type specified in <SubscriberIDType>.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header> <Subscriber>
<SubscriberName>

Optional within <Subscriber>

Not repeatable

 

The text name of the Subscriber.

 

<Subscriber> must contain either <SubscriberIdentifier> or <SubscriberName> or both.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header>
<CompleteFile/>

Optional within <Header>

Not repeatable

 

An empty element indicating that this message is a complete replacement list.

 

Each message must contain either <CompleteFile/> or <DeltaFile/> but not both.

 

Example:

<CompleteFile/>

 

<ONIXSerialsOnlineHoldingsAtoZ> <Header>
<DeltaFile/>

Optional within <Header>

Not repeatable

 

An empty element indicating that the message carries an incremental update list, consisting of new, updated and deleted holdings records, as indicated in <HoldingsRecord> <NotificationType>. Note, however, that all <HoldingsRecord> composites carried within a given delta file must themselves be complete, since updating at individual element level is not supported.

 

Each message must contain either <CompleteFile/> or <DeltaFile/> but not both.

 

Example:

<DeltaFile/>

 

<ONIXSerialsOnlineHoldingsAtoZ>
<HoldingsList>

Mandatory within <ONIXSerialsOnlineHoldingsAtoZ>

Not repeatable

 

In the ONIX SOH AtoZ listing, there is only one occurrence of the <HoldingsList> composite, since the message constitutes a single “flat” list. The <HoldingsList> consists of a group of hosted collections, each in an <OnlineService> composite, followed by a group of holdings records, each representing the holdings of an online resource.

 

 

Example:

This skeletal example illustrates the construction of the <HoldingsList> in an SOH AtoZ message:

There is one <HoldingsList> in an SOH AtoZ message.

At the top of the <HoldingsList> there is a list of <OnlineService> composites, representing the hosted collections to which the subsequent Serial Versions may belong.

There is one <HoldingsRecord> for each Serial Version.

Within <SerialVersion>, the <OnlinePackage> identifies the hosted collection in which the Serial Version is found, and shows coverage information for the Serial Version as found in that hosted collection.

If a Serial Version is found in more than one hosted collection, <OnlinePackage> is repeated.

 

Examples of <OnlineService>, <SerialVersion>, and <OnlinePackage> are found elsewhere in this document.

 

<HoldingsList>

     <OnlineService>description of first hosted collection</OnlineService>

     <OnlineService>description of second hosted collection</OnlineService>

     <OnlineService>description of third hosted collection</OnlineService>

     More Online Service composites could appear here.

     <HoldingsRecord>     

          <SerialVersion>                    first Serial Version in the message

               <SerialVersionIdentifier>composite</SerialVersionIdentifier>

               <Title>composite: serial version title</Title>

               <Publisher>composite: publisher of serial version</Publisher>

               <OnlinePackage>

                    Pointer to an <OnlineService> at the top of the holdings list, plus coverage

                    information for the Serial Version as found in that hosted collection.

               </OnlinePackage>

               <OnlinePackage>

                    Pointer to another <OnlineService> at the top of the holdings list, plus coverage

                    information for the Serial Version as found in that hosted collection, if the Serial

                    Version is found in more than one hosted collection.

               </OnlinePackage>

          </SerialVersion>

          <SerialVersion>                    next Serial Version in the message

               <SerialVersionIdentifier>composite</SerialVersionIdentifier>

               <Title>composite: serial version title</Title>

               <Publisher>composite: publisher of serial version</Publisher>

               <OnlinePackage>

                    Pointer to an <OnlineService> at the top of the holdings list, plus coverage

                    information for the Serial Version as found in that hosted collection.

               </OnlinePackage>

               <OnlinePackage>

                    Pointer to another <OnlineService> at the top of the holdings list, plus coverage

                    information for the Serial Version as found in that hosted collection, if the Serial

                    Version is found in more than one hosted collection.

               </OnlinePackage>

          </SerialVersion>

          More Serial Versions would appear here.

     </HoldingsRecord>

</HoldingsList>

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList>
<OnlineService>

Mandatory within <HoldingsList>

Repeatable

 

The <HoldingsList> in an ONIX SOH AtoZ listing begins with a list of <OnlineService> composites that are subsequently referenced in individual <HoldingsRecord> composites, by name and/or identifier. Each <OnlineService> composite identifies, describes and provides URLs for one hosted collection.

 

 

Example:

<OnlineService>

     <OnlineServiceName>Project Muse Standard Collection</OnlineServiceName>

     <Publisher>

          <PublishingRole>05</PublishingRole>          05 = Host/distributor of electronic content

          <PublisherIdentifier>

               <PublisherIDType>07<PublisherIDType>     07 = SAN

               <IDValue>1234567<IDValue>

          <PublisherName>Johns Hopkins University Press</PublisherName>

     </Publisher>

     <Website>

          <WebsiteRole>03</WebsiteRole>     03 = Online hosting service home page

          <WebsiteLink>http://muse.jhu.edu/</WebsiteLink>

          <MirrorSite>

               <WebsiteDescription>Australian mirror site<WebsiteDescription>

               <WebsiteLink>http://muse.uq.edu.au/</WebsiteLink>

          </MirrorSite>

     </Website>

</OnlineService>

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService>
<OnlineServiceIdentifier>

Optional within <OnlineService>

Repeatable if there are identifiers with different IDTypes

 

Identification of a hosted collection, using a value from a standard or proprietary identification scheme.

 

<OnlineService> must contain either <OnlineServiceIdentifier> or <OnlineServiceName> or both.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <OnlineServiceIdentifier>
<OnlineServiceIDType>

Mandatory within <OnlineServiceIdentifier>

Not repeatable

 

A code indicating the scheme or standard from which the Online Service identifier is taken. If <OnlineServiceIDType> is “01” (proprietary), then the name of the scheme should appear in <IDTypeName>.

 

 

Permissible code values:

01 Proprietary

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <OnlineServiceIdentifier>
<IDTypeName>

Optional within <OnlineServiceIdentifier>

Not repeatable

 

The name of the identification scheme from which the <IDValue> is taken, used only when <OnlineServiceIDType> is “01” (proprietary).

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <OnlineServiceIdentifier>
<IDValue>

Mandatory within <OnlineServiceIdentifier>

Not repeatable

 

An identifier of the type indicated in <IDTypeName>

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService>
<OnlineServiceName>

Optional within <OnlineService>

Not repeatable

 

The name of the hosted collection.

 

<OnlineService> must contain either <OnlineServiceIdentifier> or <OnlineServiceName> or both.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService>
<Publisher>

Optional within <OnlineService>

Repeatable

 

The vendor of a hosted collection, identified either by code or by name

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Publisher>
<PublishingRole>

Mandatory within <Publisher>

Not repeatable

 

The role of the publisher; in this context, always “05” (host/disributor on electronic content)

 

Permissible code values:

05 Host/distributor of electronic content

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Publisher>
<PublisherIdentifier>

Optional within <Publisher>

Repeatable if there are multiple identifiers with different PublisherIDTypes.

 

Identification of a publisher using a value from a standard or proprietary identification scheme.

 

<Publisher> must contain either <PublisherIdentifier> or <PublisherName> or both.

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Publisher> <PublisherIdentifier>
<PublisherIDType>

Mandatory within <PublisherIdentifier>

Not repeatable

 

A code indicating the scheme or standard from which the publisher identifier is taken. If <PublisherIDType> is “01” (proprietary), then the name of the scheme should appear in <IDTypeName>.

 

 

Permissible code values:

01 Proprietary

06 EAN-UCC GLN

07 SAN

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Publisher> <PublisherIdentifier>
<IDTypeName>

Optional within <PublisherIdentifier>

Not repeatable

 

The name of the identification scheme from which the <IDValue> is taken, used only when <PublisherIDType> is “01” (proprietary).

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Publisher> <PublisherIdentifier>
<IDValue>

Mandatory within <PublisherIdentifier>

Not repeatable

 

An identifier of the type specified in <PublisherIDType>.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Publisher>
<PublisherName>

Optional within <Publisher>

Not repeatable

 

<Publisher> must contain either <PublisherIdentifier> or <PublisherName> or both.

 

The name of the publisher; that is, the vendor of the online service.

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService>
<Website>

Optional within <OnlineService>

Repeatable if there is more than one website that can be used to access a content hosting system, other than mirror sites

 

Details of a website that is used to access a content hosting system.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Website>
<WebsiteRole>

Mandatory within <Website>

Not repeatable

 

The role of a website.

 

Permissible code values:

00 Unspecified, see website description

03 Online hosting service home page

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Website>
<WebsiteDescription>

Optional within <Website>

Not repeatable

 

A free-text description of the nature or function of a website.

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Website>
<MirrorSite>

Optional within <Website>

Repeatable for multiple mirror sites

 

Details of a site that mirrors a <Website>.

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <OnlineService> <Website> <MirrorSite>
<WebsiteDescription>

 

Optional within <Website>

Not repeatable

 

A free-text description of the nature or function of a website.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList>
<HoldingsRecord>

Mandatory within <HoldingsList>

Repeatable

 

Details of the holdings for one serial version. There will be one occurrence for each distinct serial version in the Holdings List.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord>
<NotificationType>

Mandatory within <HoldingsRecord>

Not repeatable

 

Indicates whether this <HoldingsRecord> is a new record, a deletion, or an update.

 

If <CompleteFile/> is present in the message header (that is, this is a complete replacement file), then <NotificationType> will always be “00”.

 

If <DeltaFile/> is present in the message header (that is, this message is an update file), then <NotificationType> will be either “05” to indicate that the holdings record is to be deleted; “06” to indicate that this is a new holdings record, or “07” to indicate that this holdings record is a replacement of a previously transmitted subscription holdings record.

 

Note that each holdings record must itself be complete, since there is no provision for updating at the element level.

 

 

Permissible code values:

00 Unspecified

05 Delete

06 New

07 Update (complete replacement)

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord>
<SerialVersion>

Mandatory with <HoldingsRecord>

Not repeatable

 

Identification and description of the serial version whose holdings are represented in the <HoldingsRecord>. There will be at one and only one serial version in each holdings record.

 

It is important to understand that, in ONIX, a <SerialVersion> relates to a particular manifestation of a serial work, for example the online version of a named journal. Relative to this example, the printed version of the same journal would correspond to a different <SerialVersion>, as would another online version containing only the text of the journal articles but not the associated images. A print-plus-online combination for the same journal could well be a subscription product; but it is not itself a <Serial Version> though it may contain two or more serial versions.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion>
<SerialVersionIdentifier>

Mandatory within <SerialVersion>

Repeatable for identifiers with different IDTypes

 

A coded identifier of a serial version.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <SerialVersionIdentifier>
<SerialVersionIDType>

Mandatory within <SerialVersionIdentifier>

Not repeatable

 

A code indicating the scheme or standard from which the serial version identifier is taken. If <SerialVersionIDType> is “01” (proprietary), then the name of the scheme should appear in <IDTypeName>.

 

ISSN (IDType = “07) should be used only if it identifies a serial version uniquely. That is, ISSN should not be used if the same ISSN has been assigned to all manifestations of a work (e.g. to both the print and online versions).

 

ISSNs are always sent in their unhyphenated form in ONIX.

 

 

Permissible code values:

01 Proprietary

06 DOI

07 ISSN

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <SerialVersionIdentifier>
<IDTypeName>

Optional within <SerialVersionIdentifier>

Not repeatable

 

The name of the identification scheme from which the <IDValue> is taken, used only when <SerialVersionIdentifier> is “01” (proprietary).

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <SerialVersionIdentifier>
<IDValue>

Mandatory within <SerialVersionIdentifier>

Not repeatable

 

An identifier of the type specified in <SerialVersionIDType>.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion>
<Title>

Optional within <SerialVersion>

Repeatable for different types of the title

Has “language” attribute.

 

The title of the work of which the serial version is a manifestation.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <Title>
<TitleType>

Optional within <Title>

Not repeatable.

 

A code showing the type of title. If omitted, the title type defaults to “00” (undefined).

 

 

Permissible code values:

00 Undefined

01 Distinctive title(book); cover title (serial)

02 ISSN key title of serial

03 Title in original language

04 Title acronym

05 Abbreviated title

06 Title in other language

09 Sender's catalog title

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <Title>
<TitleText>

Mandatory within <Title>

Not repeatable.

Has “language” attribute.

 

The text of the title, excluding subtitle. If multiple types of title are sent, the entire <Title> composite is repeated.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <Title>
<Subtitle>

Optional within <Title>

Not repeatable.

Has “Language” attribute.

 

The text of the subtitle, if there is one.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion>
<Publisher>

Optional within <SerialVersion>

Repeatable for co-publishers or different Publisher Roles.

 

Publisher of the intellectual content of the work; repeatable if there are co-publishers or if there are different Publisher Roles.

 

Must contain either <PublisherIdentifier> or <PublisherName>.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <Publisher>
<PublishingRole>

Mandatory within <Publisher>

Not repeatable.

 

The role of the publisher. If a Serial Version has multiple co-publishers, then there will be multiple occurrences of <Publisher>, each with a Publishing Role of “02” (co-publisher). If a Serial Version has multiple publishers with different roles; e.g., published by one organization on behalf of another, then there will be multiple occurrences of <Publisher> with different Publishing Roles.

 

Permissible code values:

01 Publisher

02 Co-publisher

06 Published for/on behalf of

07 Published in association with

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <Publisher>
<PublisherIdentifier>

 

Optional within <Publisher>

Repeatable if there are multiple identifiers with different PublisherIDTypes.

 

Identification of a publisher using a value from a standard or proprietary identification scheme.

 

<Publisher> must contain either <PublisherIdentifier> or <PublisherName> or both.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <Publisher> <PublisherIdentifier>
<PublisherIDType>

 

Mandatory within <PublisherIdentifier>

Not repeatable

 

A code indicating the scheme or standard from which the publisher identifier is taken. If <PublisherIDType> is “01” (proprietary), then the name of the scheme should appear in <IDTypeName>.

 

 

 

Permissible code values:

01 Proprietary

06 EAN-UCC GLN

07 SAN

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <Publisher> <PublisherIdentifier>
<IDTypeName>

 

Optional within <PublisherIdentifier>

Not repeatable

 

The name of the identification scheme from which the <IDValue> is taken, used only when <PublisherIDType> is “01” (proprietary).

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <Publisher> <PublisherIdentifier>
<IDValue>

 

Mandatory within <PublisherIdentifier>

Not repeatable

 

An identifier of the type specified in <PublisherIDType>.

 

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <Publisher>
<PublisherName>

Optional within <Publisher>

Not repeatable

 

The text name of the publisher of the serial version.

 

<Publisher> must contain either <PublisherIdentifier> or <PublisherName> or both.

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion>
<OnlinePackage>

Mandatory within <SerialVersion>

Repeatable if the serial version is available through multiple content hosting systems or from multiple online publishers.

 

Details of online content for the specified serial version from a specified content hosting system or online publisher.

 

 

Example:

The OnlineServiceName refers to a hosted collection that has been named at the beginning of the HoldingsList. The Website composite gives the URL of the journal contents page for this serial version as delivered in this hosted collection. If the serial version were available through another hosted collection, then there would be another <OnlinePackage> to describe it.

Examples of <PackageDetail> and <Embargo> appear elsewhere in this document.

 

<OnlinePackage>

     <OnlineServiceName>Project Muse Standard Collection</OnlineServiceName>

     <Website>

          <WebsiteRole>05</WebsiteRole>     05 = Online journal 'available contents' page

          <WebsiteLink>http://muse.jhu.edu/journals/asian_music/</WebsiteLink>

          <MirrorSite>

               <WebsiteDescription>Australian mirror site<WebsiteDescription>

               <WebsiteLink>http://muse.uq.edu.au/journals/asian_music/</WebsiteLink>

          </MirrorSite>

     </Website>

     <PackageDetail>

          [<PackageDetail> information, if any, would appear here.]

     </PackageDetail>

     <Embargo>

          [<Embargo> information, if any, would appear here.]

     </Embargo>

     <LicenseTermsDescription>

          [<LicenseTermsDescription> information, if any, would appear here.]

     </LicenseTermsDescription>

</OnlinePackage>

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage>
<OnlineServiceIdentifier>

Optional within <OnlinePackage>

Not repeatable

 

Either <OnlineServiceIdentifier> or <OnlineServiceName> is used in an <ONIXSerialsOnlineHoldingsAtoZ> message to identify the hosted collection through which a serial version is available: either <OnlineServiceIdentifier> or <OnlineServiceName> or both should be present for a title that is available through a hosted collection. Details of the online service are found at the beginning of the holdings list.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage> <OnlineServiceIdentifier>
<OnlineServiceIDType>

 

Mandatory within <OnlineServiceIdentifier>

Not repeatable

 

A code indicating the scheme or standard from which the Online Service identifier is taken. If <OnlineServiceIDType> is “01” (proprietary), then the name of the scheme should appear in <IDTypeName>.

 

 

 

Permissible code values:

01 Proprietary

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage> <OnlineServiceIdentifier>
<IDTypeName>

 

Optional within <OnlineServiceIdentifier>

Not repeatable

 

The name of the identification scheme from which the <IDValue> is taken, used only when <OnlineServiceIDType> is “01” (proprietary).

 

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage> <OnlineServiceIdentifier>
<IDValue>

 

Mandatory within <OnlineServiceIdentifier>

Not repeatable

 

An identifier of the type indicated in <IDTypeName>

 

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage>
<OnlineServiceName>

Optional within <OnlinePackage>

Not repeatable

 

Either <OnlineServiceIdentifier> or <OnlineServiceName> is used in an <ONIXSerialsOnlineHoldingsAtoZ> message to identify the hosted collection through which a serial version is available: either <OnlineServiceIdentifier> or <OnlineServiceName> or both should be present for a title that is available through a hosted collection. Details of the online service are found at the beginning of the holdings list.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage>
<Website>

Optional within <OnlinePackage>

Repeatable if there is more than one website that can be used to access a serial version from a particular content hosting system or online publisher, other than mirror sites.

 

Details of a website that can be used to access a serial version from a particular content hosting system or online publisher; that is, the serial’s “’available contents’ page.”

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage> <Website>
<WebsiteRole>

Mandatory within <Website>

Not repeatable

 

The role of a website. In this context, always “05” (Online journal 'available contents' page).

 

In some cases, the 'available contents' page may be identical to the serial’s home page, but it should be identified here as the 'available contents' page.

 

Permissible code values:

05 Online journal 'available contents' page

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage> <Website>
<WebsiteDescription>

 

Optional within <Website>

Not repeatable

 

A free-text description of the nature or function of a website.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage> <Website>
<MirrorSite>

 

Optional within <Website>

Repeatable for multiple mirror sites

 

Details of a site that mirrors a <Website>.

 

 

<ONIXSerialsOnlineHoldingsAtoZ> <HoldingsList> <HoldingsRecord> <SerialVersion> <OnlinePackage> <Website> <MirrorSite>
<WebsiteDescription>

 

Optional within <Website>

Not repeatable

 

A free-text description of the nature or function of a website.