Originally Published: 12/23/2015
Last Published: 2/27/2016
3.2.1 Resource Serialization
3.2.2 Domain Objects
3.2.3 Resource Manifest
220.127.116.11 Resource Manifest Model
18.104.22.168 Resource Manifest Discovery
4. Package URIs
4.1 Bag URIs
A Data Conservancy Package is a format (described by this document) for encapsulating digital content (i.e., a payload) with defined semantics, and metadata used to describe technical aspects of the package as a whole.
The meaning of “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” are defined in RFC 2119.
Custodial Content: The novel information contained within a package according to this specification, and described accordingly (i.e. via Domain Objects). Also known as the package payload.
Domain Object: A package resource, modeled using RDF, describing the payload.
Domain Object Manifest: A package resource, modeled as an OAI-ORE Resource Map, enumerating the domain objects in the package.
Package: A logical unit of digital content conforming to this specification. It contains a payload, Domain Objects describing the payload, a manifest of Domain Objects, and additional package level metadata.
Payload: equivalent to the custodial content of the package
Serialized Package: A concrete form of a package expressed as files and directories on a file system.
Serialized packages MUST conform to the Data Conservancy BagIt profile version 1.0 as specified here.
RDF resources specified below SHOULD be serialized using the same serialization format. One of the following serialization formats are RECOMMENDED: JSON-LD, RDF/XML, or Turtle.
Serialization format for specified RDF resources MUST be reflected in filename extensions. Specifically, files serialized in JSON-LD, RDF/XML, and Turtle formats must have .jsonld, .rdf, and .ttl extensions respectively.
Domain objects MUST be modeled as RDF resources, and are used to provide semantics for the package payload.
Serialized domain object resources MUST use a file extension that indicates their serialization format.
The Resource Manifest MUST be modeled as a single ORE Resource Map containing exactly one ORE Aggregation. The ORE Aggregation MUST enumerate the resources in the package payload that contain serializations of domain objects. These resources MUST be referenced using a compliant URI (see §4).
The serialized ORE-ReM MUST use a file extension that indicates its serialization format, per §3.2.1.
The BagIt metadata keyword Resource-Manifest MUST be present in bag-info.txt, and its value MUST be the location of the Resource Manifest serialization, referenced using a compliant URI (§4).
This specification RECOMMENDS the use of the /META-INF/org.dataconservancy.packaging/PKG-INFO/ORE-REM/ORE-REM.[ext] bag resource for the location of the Resource Manifest, where [ext] indicates the extension of the serialization, per §3.2.1.
It is RECOMMENDED that the package contain all ontologies necessary to interpret RDF resources in the package. The serialized ontologies MUST use a file extension that indicates their serialization format, per §3.2.1.
This specification RECOMMENDS the use of the /META-INF/org.dataconservancy.packaging/ONT bag resource for containing ontology serializations.
Package URIs have the following characteristics:
Package URIs MUST use one of the supported schemes below:
This specification proposes a URI scheme for referencing bag resources, allowing resources in a specified bag to be addressed using URIs. This scheme complies with the characteristics of a package URI, and MAY be used when the serialized package conforms to the Data Conservancy BagIt Profile. The form of a bag URI is:
A file containing multiple resources may reference individual resources using hash URIs (i.e. fragments):
The bag URI scheme allows bag resources to be addressed independent of its location on the filesystem, independent of the platform being used and independent of the bag’s serialized form.
Statements contained within domain objects or the resource manifest MAY have bag URIs as a subject or object. A bag URI is resolvable within a bag, and signifies the bag creator’s intent that a given URI is intended to resolve to a specific resource. Outside of the context of a specific bag, bag URIs are not meaningful.
The following clauses capture the semantics of bag URIs in RDF documents specified herein: