OLE Instance Document-V9.1
During OLE 1.5, the Instance Wrapper was removed. Please find more current information about the Holdings and Items schemata at Schema and samples for Docstore Documents.
JIRA#
(Proposed new recommendations for Instance Schema per Instance team, August 2012 to replace version 8.1 instead of going to 9.x)
(DocStore Schema Refactor for 1.5)
(Schema, Data model management for 2.0)
Instance 9.1 documentation
1. Description
The OLE Instance document is a container for recording holdings and item information for a bibliographic record. Even though there is a standard for MARC Holdings (which has often been loosely followed), there isn't one for items and depending on the vendor systems, these are stored in different ways. OLE Instance defines a standard for storing holdings/item information in three main sections as described below.
2. Main Sections of the OLE Instance Document
For a given bibliographic record, only one of either oleHoldings or sourceHoldings can be used as the main holdings record. OLE will not support usage of both for a given record as that leads to overhead of managing data consistencies between the two sections. If an OLE Instance is initially created using oleHoldings, a staff user will be able to click a button in order to convert the oleHoldings to sourceHoldings via a mapping from one to the other.
- oleHoldings: This section records "general" holdings information in a format specific to OLE.
- sourceHoldings: This section represents "specific" holdings information entered according to some standard external to OLE. Examples are MARC holdings, MODS holdings or any other format specific holdings.
items: This section records information about 1 or more items.
Information such as location, callNumbers etc are captured at the holdings level and linked items inherit those. Further the data is only recorded once and not copied at individual item levels unless applicable for a particular item.
3. Business requirements/Workflows
More of business rules etc.. or links to google docs. Coming soon!
4.
Detailed information about the OLE Instance schema and the various parts.
5. Sample XMLs - (Books, Serials, Mutli-Part etc..)
6. Validation of Instance XML with the Schema
Visit W3C XML Schema (XSD) Validation online and paste the XML and the schema (from section 4 and 5 above) into text areas and click the 'Validate XML against XSD' button.
7. Individual Data Elements - Details
8. Revised Editor
9. Storage
The OLE Instance document will be stored in ole-docstore in three separate documents namely, instance, holdings and items. Each of the documents gets a unique identifier generated by ole-docstore (Apache Jackrabbit).
Operated as a Community Resource by the Open Library Foundation