Core Concepts
Workflow Overview
DRS3 introduces a new framework for preservation activity. The fundamental elements of that framework are the Workspace and the Archive.
The Workspace acts as a staging area for the Archive. The primary goal of the DRS is preservation, but the advent of the Workspace increases the flexibility and usability of the system. Users can stage digital objects, reorganize files, edit or apply metadata, and preview an extensive array of file types in the browser-based UI. Once satisfied with a digital object, users will push that object to the Archive. Users can choose to remove the Workspace copy of the object or retain it in the Workspace, as suits their workflows. Content in the Workspace does not receive any versioning, meaning that all edits made in the Workspace are immediate and irreversible; you cannot undo edits.
In many cases, users may wish to stage digital objects locally before moving them to the DRS. In such cases, particularly for high-volume depositors, the Workspace to Archive push can be automated, eliminating the need to interact with the objects in the Workspace interface. This is achieved by application of particular metadata values (see Required Global Metadata Elements for more details).
Once in the Archive, the object metadata is viewable and the files are downloadable, but no edits can be made. If edits are needed, users may reinstate a copy of the object to the Workspace, update it as necessary, and resubmit the object to the Archive, thereby replacing the old version of the object with the new version.
Pushing objects to the Archive will also initiate delivery functionality for the object, if desired. When an object moves to the Archive, DRS tooling will examine the metadata, looking for specific elements that will indicate that delivery is desired (again, see Required Global Metadata Elements for details). If those indicators are present, a delivery file and a copy of the associated metadata will be sent on to the appropriate delivery service (see the Delivery Services Guide for details; see also delivery information for specific resource types).
IMPORTANT It is critical to note that in the DRS3 Initial Release (April 28, 2026) is a partial release only. This initial release will not have full Archive functionality implemented. This means that instead of pushing objects from the Workspace to the Archive, users will instead flag objects as ready for the Archive. This action will initiate delivery in the same way as pushing objects to the Archive will in later releases, but the object will remain in the Workspace. Once the Archive is fully implemented (in a later release), all objects in the Workspace which are flagged as ready for the Archive will be pushed to the Archive automatically. This has two meaningful consequences:
Edits that impact delivery will not take effect until:
the object is again flagged as ready for the Archive, or
the Archive is implemented and the object is automatically pushed to the Archive.
Because the Workspace has no versioning, edits made after the object has been flagged will persist in the Archive regardless of whether or not the object has been flagged again.
During this interim period before the Archive is implemented, deletions from the Workspace will be restricted. This is to avoid any accidental deletion of objects which have been flagged as ready for the Archive. If deletion is necessary, users are encouraged to create a “Trash” folder within their container(s), which can be cleaned up and removed after the Archive is in place. Once the Archive is implemented, users will be more freely able to delete from the Workspace, enhancing its usefulness as a pre-deposit staging area.
Object Structure
Within the DRS system, the primary unit of preservation management is an Object, a content item which consists of one or more digital Files and which is documented with administrative, technical, and descriptive metadata.1 The DRS data model for digital Objects makes use of two entity types: Object and File. An Object is represented by a top-level folder, within which are the preservation content Files and any (optional) accompanying Files. Within the Object, Files can be organized into subfolders if desired by the depositor, but internal structure will have no impact on preservation outcomes and is for depositor convenience only. The capitalization of the terms “Object” and “File” aligns with the terminology used to define the structure of digital content in the LIBSAFE Advanced platform.
Each Object must contain a minimum of one primary data File. Primary data Files are the digital content being preserved. Objects may include a single primary data File (such as a still image File) or a group of primary data Files (such as a group of still image Files which make up a Page-turned Object). Objects may also include additional Files that accompany the primary data File(s) (such as the Optical Character Recognition, or OCR, text file for a page of a book) or Sidecar Metadata Files, which include metadata that is not otherwise captured in the DRS metadata schema. The metadata within Sidecar Files is not processed by the DRS, meaning that it is not indexed or available for fielded searching, but the content of Sidecar Files is included in free text searching.
The complexity of each Object and the degree to which it is described are subject to curatorial discretion and depositor implementation. Object structure may be as simple as an Object folder containing a single File or as complex as an Object folder containing nested subfolders and Files.
File pathnames should not exceed 300 characters. The pathname is the file name plus the full location of the file within its hierarchical folder structure (such as “/MyObj/SubfolderA/SubfolderB/MyFile.pdf”). For this reason, depositors are advised to limit their use of hierarchical folder structure within Objects.
Depositors are encouraged to use the following ASCII characters in file names, if possible (although the system can accept any character from the full Unicode character set):
Upper case Latin alphabetical characters (U+0041 – U+005A)
Lower case Latin alphabetical characters (U+0061 – U+007A)
Numerals zero through nine (U+0030 – U+0039)
Hyphens “-” (U+002D) and underscores “_” (U+005F)
Use of the period “.” (U+002E) should be restricted to marking the boundary between the file name and the file extension (such as in “MyPhoto.jpg”) or marking component parts of the file extension (such as in “MyContainer.tar.gz”).
Resource Types
The DRS3 can provide bit-level preservation for Files of any format. However, to optimize preservation outcomes and to facilitate delivery, depositors should categorize Objects by their technical form, or Resource Type. Resource Type classification is concerned with what a digital Object is (its form), not what it is about (its subject).2 This manner of classification is necessary because it provides the means to identify groups of like Objects for various purposes, such as:
Mode of expression - the form of the Object, such as audio or still image, which informs risk analysis and remediation by DPS
Mode of retrieval - the means of delivering the Object for reuse via HL delivery services
Intellectual nature - the purpose of the Object, which enables summary categorization and reporting
Resource Type is quintessential to a digital Object and in turn defines the rest of the mandatory and recommended metadata elements for an Object and its File(s). The possible types are:
Resource type | Type purpose | Example |
Audio | Time-based sound, whether music, spoken word, or other | Ethnographic audio field recording |
Collection | Group of Files, optionally hierarchically nested in folders | Contents of a SharePoint document library |
Container | Group of Files, optionally hierarchically nested in folders, encapsulated into a single container File | Contents of a SharePoint document library encapsulated into a ZIP file |
Database | Structured data primarily accessed through a query language | Relational database table export |
Dataset | Structured data that can be accessed without use of a query language | Data in tabular form |
Disk image | Capture of the readable area of a storage device or digital physical media object replicating the content and structure of the device/object | Disk image of a laptop hard drive |
Document | Page-oriented formatted text and/or images in a single File | A journal article in PDF or Word format |
One or more email messages, either in separate files or in a single container file | Multiple EML or MBX files; a PST file | |
Executable | Executable instructions controlling state and output of computational infrastructure | Software application |
Moving image | Time-based images with (optional) synchronized sound | Recorded class lecture |
Page-turned | Page-oriented formatted text and/or image Files in a multi-page structure | Digitized monograph |
Page-turned list | Aggregation of individual Page-turned Objects | Multiple volumes of a newsletter |
Plaintext | Unformatted text | ASCII or UTF-8 encoded text |
Spatial image | Image explicitly correlated with real- or virtual-world cartesian coordinates | Georeferenced map |
Still image | Image uncorrelated with real- or virtual-world cartesian coordinates | Digital camera photograph |
Unspecified | Any unspecified representation (default) |
|
Virtual reality | Simulated immersive experience | 3D architectural walk-through |
Web | Group of arbitrary web-addressable resources encapsulated in a single container | Departmental website |
An Object submitted without a Resource Type explicitly specified will automatically be assigned the value “Unspecified.” Although use of the Unspecified type does not disqualify an Object for preservation in the DRS system, and although it will receive, at minimum, the same bit-level preservation as any other Object, it is highly recommended that depositors assign Resource Type with intention. As noted in the DRS Policy Guide, preservation outcomes depend directly on the nature of the preserved Object, including not only the format(s) of the File(s) in the Object but also the purpose of the Object. Selection of an appropriate Resource Type and alignment with type-specific structure and metadata guidance will maximize opportunities for the highest level of preservation assurance.3
For information about the mapping of DRS2 Content Models to DRS3 Resource Types, please see the Content Model to Resource Type Mapping.
Required & Recommended Global Metadata Elements
Efficient and effective preservation management, analysis, and remediation rely upon metadata to document preserved digital content. Two distinct forms of metadata are supported by the DRS:
Indexed metadata. Defined metadata elements are indexed for fielded search in DRS3.1
Indexed metadata is classified into two categories:O-metadata. Object- and File-level metadata supplied by depositors or generated by the DRS system (including administrative, descriptive, structural, rights, and technical metadata). The full set of O-metadata elements is defined and described in the DRS3 Data Dictionary.
E-metadata. File-level technical metadata automatically generated by the DRS system through examination of data embedded in the Files themselves.
Sidecar metadata. Any additional metadata beyond the indexed elements can be included as component Files of an Object. The metadata within these files is not further processed by the DRS, which means it is not indexed and is not searchable on a fielded basis. However, the content of these files is included in free-text search results.
Although metadata requirements and recommendations are largely influenced by the Resource Type of an Object, some elements are mandatory for all Objects or Files. The number of mandatory, depositor-supplied metadata elements is intentionally limited (to facilitate ease of deposit), while the majority of elements are recommended or optional.
PLEASE NOTE Required metadata elements have default values that will be automatically applied unless explicitly supplied by the depositor (defaults noted below).
For Resource Type-specific guidance, see Guidelines by Resource Type.
For information about how DRS2 metadata was mapped to the DRS3 metadata schema, please see the DRS2-to-DRS3 Metadata Crosswalk.
Resource Type REQUIRED
Obligation: Required
IECode: ObjResType
Applies to: Objects
Metadata category: Object
Data type: ENUM
Repeatability: Not repeatable
UI Mode: Edit
Description: The technical form of the Object
Usage: See Resource Types for full explanation.
Possible values:
Value Description | |
|---|---|
Audio | Time-based sound, whether music, spoken word, or other |
Collection | Group of Files, optionally hierarchically nested in folders |
Container | Group of Files, optionally hierarchically nested in folders, encapsulated into a single container File |
Database | Structured data primarily accessed through a query language |
Dataset | Structured data that can be accessed without use of a query language |
Disk image | Capture of the readable area of a storage device or digital physical media object replicating the content and structure of the device/object |
Document | Page-oriented formatted text and/or images in a single File |
One or more email messages, either in separate files or in a single container file | |
Executable | Executable instructions controlling state and output of computational infrastructure |
Moving image | Time-based images with (optional) synchronized sound |
Page-turned | Page-oriented formatted text and/or image Files in a multi-page structure |
Page-turned list | Aggregation of individual Page-turned Objects |
Plaintext | Unformatted text |
Spatial image | Image explicitly correlated with real- or virtual-world cartesian coordinates |
Still image | Image uncorrelated with real- or virtual-world cartesian coordinates |
Unspecified [default] | Any unspecified representation |
Virtual reality | Simulated immersive experience |
Web | Group of arbitrary web-addressable resources encapsulated in a single container |
Object Purpose REQUIRED
Obligation: Required
IECode: ObjPurpose
Applies to: Objects
Metadata category: Object
Data type: ENUM
Repeatability: Not repeatable
UI Mode: Edit
Description: The significance of the Object
Usage: Although there are two possible values for Object Purpose, use cases for the value “System” have not yet been identified. Depositors should use “Curatorial,” which is the default. In practice, this means the ObjPurpose column can be eliminated from submission control files. Note that as a result of this, Object Purpose has been eliminated from the Resource Type-specific guidelines.
Possible values:
Object Role
Obligation: Recommended
IECode: ObjRole
Applies to: Objects
Metadata category: Object
Data type: ENUM
Repeatability: Repeatable
UI Mode: Edit
Description: Function the object serves
Usage: If any of the possible values apply to an object, this metadata element should be supplied and the applicable value populated. If no value applies, do not populate this metadata element.
Possible values:
<ObjRole> Possible Value | Value Description |
|---|---|
AUDIO_DECISION_LIST | Audio editing decisions |
CLOSED_CAPTION_DATA | Synchronized captions for moving image |
COLOR_PROFILE | Color calibration data |
DOCUMENTATION | General documentation |
DONOR_AGREEMENT | Donor agreement |
EMBARGO_DOCUMENTATION | Embargo documentation |
FINDING_AID | Archival finding aid |
GOOGLE_1 | DRS2 Google document container 1 |
GOOGLE_2 | DRS2 Google document container 2 |
GOOGLE_3 | DRS2 Google document container 3 |
HARVARD_POLICY | Harvard policy statement |
LICENSE | License terms |
LOG | Web crawl log |
PRESENTATION | Audio/video playlist |
PROCESS_FILES | Ancillary data resulting from processing |
PROCESS_HISTORY | Process history documentation |
RISK_ASSESSMENT | Preservation risk assessment |
SCHEMA | Metadata schema |
STATUTE | Legal statute |
TARGET_DESCRIPTION | Target image description |
TARGET_IMAGE | Target image |
THESIS | Academic thesis or dissertation |
THESIS_CERTIFICATE | Thesis or dissertation certificate |
THESIS_SUPPLEMENT | Supplement material for thesis or dissertation |
WORLD_REFERENCE_DATA | Georeferencing data for image |
Archive Mode REQUIRED
Obligation: Required
IECode: ProcArchMode
Applies to: Objects
Metadata category: Processing
Data type: ENUM
Repeatability: Not repeatable
UI Mode: View (value can only be changed using a control file)
Description: The way an Object is pushed to the Archive
Usage: This field dictates the workflow for pushing an object from Workspace to Archive. The behavior of this field (and the user behaviors related to it) will change between the initial release (April 2026) and the final release (Fall 2026).
In the initial release:
If set to Manual (the default value), a user must select each object individually in the Workspace and click the Archive button. The Object will be marked as ready for the Archive (and will be pushed to delivery services, if appropriate). The Object will remain in the Workspace until the Archive is implemented, at which time it will be sent to the Archive. A copy will remain in the Workspace.
If set to Auto, the object will be marked as ready for the Archive (and will be pushed to delivery services, if appropriate) as soon as a control file is applied. The Object will remain in the Workspace until the Archive is implemented, at which time it will be automatically sent to the Archive. A copy will remain in the Workspace.
If set to AutoClean, the object will be marked as ready for the Archive (and will be pushed to delivery services, if appropriate) as soon as a control file is applied. The Object will remain in the Workspace until the Archive is implemented, at which time it will be automatically sent to the Archive and the Workspace copy will be deleted.
In the final release:
If set to Manual (the default value), a user must select each object individually in the Workspace and click the Archive button. The Object will be pushed to the Archive (and to delivery services, if appropriate). A copy will remain in the Workspace; the user may delete or retain the Workspace copy in accordance with their workflows.
If set to Auto, the object will be pushed to the Archive (and to delivery services, if appropriate) as soon as a control file is applied. A copy will remain in the Workspace; the user may delete or retain the Workspace copy in accordance with their workflows.
If set to AutoClean, the object will be pushed to the Archive (and to delivery services, if appropriate) and the Workspace copy will be deleted as soon as a control file is applied.
Possible values:
Value Description | |
|---|---|
Manual [default] | Object is pushed to Archive only when initiated by depositor. |
Auto | Object is pushed to Archive automatically when control file is parsed; copy remains in Workspace. |
AutoClean | Object is pushed to Archive automatically when control file is parsed; copy is removed from Workspace. |
Submission Name
Obligation: Recommended
IECode: D3SubName
Applies to: Objects; Files
Metadata category: General
Data type: STRING
Repeatability: Not repeatable
UI Mode: Edit
Description: Descriptive name of group of objects submitted together
Usage: If users wish to be able to retrieve groups of objects deposited together, they should supply a Submission Name. There can be only one Submission Name per control file. Note that if a Submission Name is provided in any row of a control file, it will be applied to all rows. However, it is best practice to include it in every row. The Submission Name should be unique within a Libsafe container; consider appending “submission [#]” or the date.
Value Format: Descriptive unique batch name
Value Example: Smith papers batch 1 20260324