Core Concepts

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:

  1. Edits that impact delivery will not take effect until:

    1. the object is again flagged as ready for the Archive, or

    2. the Archive is implemented and the object is automatically pushed to the Archive.

  2. 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

Email

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:

  1. Indexed metadata. Defined metadata elements are indexed for fielded search in DRS3.1
    Indexed metadata is classified into two categories:

    1. 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.

    2. E-metadata. File-level technical metadata automatically generated by the DRS system through examination of data embedded in the Files themselves.

  2. 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:

<ObjResType> Possible Value

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

Email

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:

<ObjPurpose> Possible Value

Value Description

Curatorial [default]

Object of curatorial significance

System

Object of operational significance

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:

<ProcArchMode> Possible Value

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


We don't have a way to export this macro.