General guidance on schema use
This schema provides a formal specification of what constitutes valid use of XML to construct an ONIX Serials Products and Subscriptions (SPS) message of type Product List Unpriced. A complete list of schemas in the SPS family is given below.
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 two 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:
Description of content
definitions of the message-level element and of complex types specific to this type of message (the number 'n.n' is the version number of this schema)
definitions of datatypes common to all ONIX Serials schemas.
It is intended that this schema be used to guide implementation of systems for either originating or receiving SPS 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 SPS 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.
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:
a string of characters
a number that may have a decimal part
an integer between -2147483648 and +2147483647 inclusive
The ONIX Serials Products and Subscriptions (SPS) format defines a family of messages used for transmitting information about Serial Subscription Products, with or without price information, and with or without subscription information relating to a particular subscriber. The four messages currently defined are:
Product List Unpriced. A list of subscription products offered by a publisher, subscription agent, online publisher, or content hosting service, without price information.
Product List Priced. A list of subscription products offered by a publisher, subscription agent, online publisher, or content hosting service, including price information.
Product Subscription List. A list of products subscribed to by a particular subscriber or group of subscribers. It may or may not include prices.
Product Subscriptions Quote. A list of subscription products with a price quote offered to a particular subscriber.
Typically, the sending organisation will be a publisher or subscription agent. Recipients can include university or corporate libraries, agents, consortia, or indeed a “broadcast” customer base for priced product lists.
Release 0.92 is the version which is currently being piloted. On completion of the pilots, and the incorporation of any consequent changes, EDItEUR will issue a first full Release, to be numbered 1.0, after which every effort will be made to maintain upwards compatibility in future revisions.
Please refer to the following documents for a more detailed introduction to the SPS format:
- SPS Overview 0.92
- ONIX Serials Glossary