Data Version Management

Data Version Management

Introduction

The data version management allows for https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4064772158 the upload of new original https://mediahaven.atlassian.net/wiki/spaces/CS/pages/5124882442 and is available in the REST API.

Business rules

  • Only 1 new original representation can be ingested at the same time for a particular data object

  • The new original representation can still be rejected due to the standard validation rules (deduplication, fixity, virus scan, etc), in which case the old original representation still remains the reference.

Metadata Support

To track whether an original representation is the latest accepted version, the following structural metadata fields are available

Field

Meaning

Field

Meaning

Structural.Versioning.Version

Starts at 1 and increases by 1 each time a new original representation is uploaded

Structural.Versioning.Status

  • Untracked: No additional original representation was ever uploaded; the status becomes Head the instant the second original representation is created

  • Head: This is the latest successfully ingested representation

  • Tail: These are the previously successfully ingested representations

  • Draft: This representation is ingesting (version > 1)

  • Rejected: The new original representation was rejected (version > 1)

Structural.Versioning.Id

  • For original representations, the value is the record ID of the data object

  • For access representations, the value is the record ID of the original representation

Upload Support

The new original representations can be uploaded using the 3 existing mechanisms

  1. Upload directly via the https://mediahaven.atlassian.net/wiki/spaces/CS/pages/2447769640

  2. https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4045602833

  3. https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4555931652