Events

Events

Structure

The event names are structured in three parts

CONCEPT.TYPE.SUB-TYPE

Example

RECORDS.UPDATE.PUBLISH

Currently, the only available concept is “RECORDS”. In the future other concepts such as users, and profiles could be added → https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4400775176.

API versus Monitoring

In the https://mediahaven.atlassian.net/wiki/spaces/CS/pages/64258058 the events are shown using the “Legacy Name” while in the https://mediahaven.atlassian.net/wiki/spaces/CS/pages/2447769640 it is always shown using the fully qualified name.

Overview

The column difference indicates if a https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4058742786 is included for events of this type or subtype.

Family

Name

Legacy Name

Since

Metadata

Update

Diff

Description

Family

Name

Legacy Name

Since

Metadata

Update

Diff

Description

FLOW

RECORDS.FLOW.TRANSCODE

TRANSCODE

 

 

 

Transcode job is created

FLOW

RECORDS.FLOW.TRANSCODED

TRANSCODED

 

 

 

Transcode job is finished

FLOW

RECORDS.FLOW.RETRANSCODE

RETRANSCODE

 

 

 

Retranscode job is created

FLOW

RECORDS.FLOW.CUSTOM_KEYFRAME

CUSTOM_KEYFRAME

 

 

 

Custom keyframe job is created

FLOW

RECORDS.FLOW.EXPORT

EXPORT

 

 

 

Export job is created

FLOW

RECORDS.FLOW.EXPORTED

EXPORTED

 

 

 

Export job is finished

FLOW

RECORDS.FLOW.ARCHIVED

ARCHIVED

 

File has successfully acquired the Administative.ArchiveStatus on_disk or on_tape

FLOW

RECORDS.FLOW.SIP_ALREADY_ARCHIVED

SIP_ALREADY_ARCHIVED

 

 

 

SIP was resubmitted while it is already archived based on the ExternalId

FLOW

RECORDS.FLOW.SIP_ALREADY_PROCESSING

SIP_ALREADY_PROCESSING

 

 

 

SIP was resubmitted while it is already processing based on the ExternalId

FLOW

RECORDS.FLOW.SIP_DETECTED

SIP_DETECTED

 

 

 

TO DO

FLOW

RECORDS.FLOW.DUPLICATE_MD5_DELETE_POOLS

 

23.3

 

 

Because the MD5 was unknown when creating the record (when using ExternalSourceUrl), the MD5 duplicate is only detected after downloading the URL. To prevent using unneeded storage, the original storage is immediately reclaimed.

FLOW

RECORDS.FLOW.TRANSFERRED_COPY

 

 

 

 

TO DO

FLOW

RECORDS.FLOW.UPLOAD.COMPLETED

 

 

 

 

TO DO

CREATE

RECORDS.CREATE

CREATE

 

 

Record is created

UPDATE

RECORDS.UPDATE

UPDATE

 

Metadata of record is updated

UPDATE

RECORDS.UPDATE.PUBLISH

PUBLISH

 

Record has been published from the ingest space or auto-published

UPDATE

RECORDS.UPDATE.DESTRUCTION

 

 

Record has followed its https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4137254971 to its end

UPDATE

RECORDS.UPDATE.HARVESTED

 

 

Technical metadata has been extracted

UPDATE

RECORDS.UPDATE.TRANSCODED

 

24.1

Technical metadata and preview path are updated when the transcoding completes

UPDATE

RECORDS.UPDATE.INGESTED

 

24.3

The ingest of the record is now fully completed and now has record status Draft.Valid/Invalid

UPDATE

RECORDS.UPDATE.REJECTED

 

24.3

The record has been permanently rejected

UPDATE

RECORDS.UPDATE.FRAGMENT_METADATA_INHERITANCE

 

25.4

Contains the updates to the non-descriptive and non-dynamic fields that are shared with all pure fragments --> https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4668391481/Fragments#Metadata-Inheritance.

UPDATE

RECORDS.UPDATE.VERSION_MANAGEMENT.PROMOTE

 

25.4

This event is added on an original representation when the version status changes to head.

See https://mediahaven.atlassian.net/wiki/spaces/CS/pages/5124980740 for details.

UPDATE

RECORDS.UPDATE.VERSION_MANAGEMENT.DEMOTE

 

25.4

This event is added on an original representation when the version status changes to tail.

See https://mediahaven.atlassian.net/wiki/spaces/CS/pages/5124980740 for details.

UPDATE

RECORDS.UPDATE.VERSION_MANAGEMENT.NEW_ORIGINAL_REPRESENTATION

 

25.4

This event is added on a data object when a new version of the original representation is created

See https://mediahaven.atlassian.net/wiki/spaces/CS/pages/5124980740 for details.

UPDATE

RECORDS.UPDATE.VERSION_MANAGEMENT.VERSION_MANAGEMENT.REJECTED_ORIGINAL_REPRESENTATION

 

25.4

This event is added on a data object when a new version of the original representation is rejected.

See https://mediahaven.atlassian.net/wiki/spaces/CS/pages/5124980740 for details.

UPDATE

RECORDS.UPDATE.MD5_CHECK

 

 

 

 

TO DO

UPDATE

RECORDS.UPDATE.CHANGE_EMBEDDINGS

 

 

 

 

TO DO

UPDATE

RECORDS.UPDATE.EMBEDDINGS

 

 

 

 

TO DO

DELETE

RECORDS.DELETE

DELETE

 

Record is logically deleted

DELETE

RECORDS.DELETE.UNDELETE

UNDELETE

 

Logically deletion of record is undone

DELETE

RECORDS.DELETE.PERMANENTLY_DELETED

 

21.2

 

 

Record is permanently deleted and this delete can no longer be undone, all storage is reclaimed shortly afterwards

VALIDATION

RECORDS.VALIDATION.VIRUS_CHECK

VIRUS_CHECK

 

 

 

Virus check is performed

VALIDATION

RECORDS.VALIDATION.MD5_CHECK

MD5_CHECK

 

 

 

MD5 generated from file is compared with the reference

VALIDATION

RECORDS.VALIDATION.JHOVE

 

25.3

 

 

Format validation of the ingested TIFF image is performed using JHOVE

VALIDATION

RECORDS.VALIDATION.VERA-PDF

 

25.3

 

 

Conformance level of ingested PDF file is analyzed using veraPDF and compared with the configured reference profile

VALIDATION

RECORDS.VALIDATION.VERIFY

VERIFY

 

 

 

Fixity of the file will be checked by exporting it

VALIDATION

RECORDS.VALIDATION.VERIFIED

VERIFIED

 

 

 

Fixity check is finished

VALIDATION

RECORDS.VALIDATION.FILE_FORMAT_CHECK

 

25.4

 

 

Specifies which tool determined the format and whether it is allowed --> https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4340187164

DIRECT_DOWNLOAD

RECORDS.DIRECT_DOWNLOAD.ORIGINAL

 

22.4

 

 

Generated when a https://mediahaven.atlassian.net/wiki/spaces/CS/pages/3708682241 is done for the original (representation)

DIRECT_DOWNLOAD

RECORDS.DIRECT_DOWNLOAD.ACCESS

 

22.4

 

 

Generated when a https://mediahaven.atlassian.net/wiki/spaces/CS/pages/3708682241 is done for the access representation or browse

SHARE

RECORDS.SHARE.CREATE

 

25.4

 

 

Share is created

Properties

The properties of events are structured according to the https://www.loc.gov/standards/premis/v3/ Premis event standard.

Property

Description

Type

Example

Property

Description

Type

Example

Identifier

A monotonically increasing number, unique for each event

Long

9212604

IdentifierType

Unless the event has been provided externally, it will always have the value MEDIAHAVEN_EVENT.

String

MEDIAHAVEN_EVENT

Concept, Type, Subtype

The event name has 3 constituents: <CONCEPT>.<TYPE>.<SUB-TYPE>

String

RECORDS.UPDATE.PUBLISH

Date

When the event occurred