Metadata 22.1

Metadata 22.1

MediaHaven has a wide variety of metadata fields. This table list various information about these fields.

Legend

  • Key / Sub Key: The name of the field as it appears the metadata XML and JSON

  • Format: extra information about the format of the value, see Metadata Concepts for more information about the used terms

  • Read-only: This field cannot be modified in the user interface or API calls

  • Search: When performing a search query APIs you must use the flattened key, for example +Title:"Breaking News!" +KeywordsKeyword:Politics  

  • Searchable: In the MediaHaven REST API you can search and sort on this field

Descriptive Fields

Descriptive fields are modifiable fields that describe files for purposes such as discovery.

Key

Sub Key

Description

Format

Read-only

Search

Key

Sub Key

Description

Format

Read-only

Search

Title

 

The title of the file

 

 

Description

 

Description about the file

 

 

CreationDate

 

The date and time the file was originally created

yyyy:MM:dd'T'HH:mm:ss.uuuuuuZ

 

RightsOwner

 

The name of the (copyright) owner of the file

 

 

 

Rights

 

A description about how the file can or can not be disseminated.

 

 

 

Keywords

 

Series of keywords about the file

ListField

 

 

Keywords

Keyword

Sub field of Keywords containing an individual keyword

 

 

Categories

 

Series of categories about the file

ListField

 

 

Categories

Category

Sub field of Categories containing an individual category

 

 

Publisher

 

Publisher of the file

 

 

 

Authors

 

A list of various authors of the file

MulitItemField

 

 

AuthorsAuthor

 

Sub field of Authors containing an individual author

 

 

Publications

 

List of locations where the file is published

ListField

 

 

Publications

Comment

Sub field of Publications describing a comment

 

 

 

OriginalFilename

 

The name of the file as it was ingested into MediaHaven

 

 

OriginalPath

 

The relative path of the file to the watchfolder or archive was ingested into MediaHaven

 

 

 

UploadedBy

 

The name of the user that uploaded the file

 

 

KeyframeStart



By default the the field PathToKeyframe refers to the closest keyframe before to time provided by the field FragmentStart. When KeyframeStart is defined it overrides this time.

frames (using a fictitious 25 fps)

 

LimitedCategories

Key

Sub Key
#1

Sub Key #2

Description

Format

Read-only

Search

Key

Sub Key
#1

Sub Key #2

Description

Format

Read-only

Search

LimitedCategories

 

 

List of categories linked with the record

ComplexListField

 

 

LimitedCategories

Category

 

A single category which corresponds with a concept in the thesaurus

ThesaurusField

 

 

LimitedCategories

Category

Uri

ThesaurusUriField

 

LimitedCategories

Category

Nl

Dutch label of the concept

ThesaurusLabelField

 

LimitedCategories

Category

En

English label of the concept

ThesaurusLabelField

 

LimitedCategories

Category

Fr

French label of the concept

ThesaurusLabelField

 

LimitedCategories

Category

De

German label of the concept

ThesaurusLabelField

 

Position

Key

Sub Key

Description

Format / Example

Read-only

Search

Key

Sub Key

Description

Format / Example

Read-only

Search

Position

 

Number of edit units to skip at the start of the source video codec before the logical of start of the essence

 

 

 

Position

Location

  • The geospatial coordinates as used in for example Google Maps

  • Same meaning as the obsolete top field Descriptive.Location in Metadata 21.1

latitude,longitude

51.001139,4.51515

 

Position

Address

  • The translation of the Descriptive.Position.Location into a human address readable using the Google Geocoding API

  • Same meaning as the obsolete field Descriptive.Address.Formatted

Leuvensesteenweg 582, 2812 Mechelen, België

 

 

Position

Country

The country part of the translated Descriptive.Position.Address (auto-generated)

België

 

Position

Area

The area part of the translated Descriptive.Position.Address (auto-generated)

Vlaanderen

 

Position

SubArea

The sub area part of the translated Descriptive.Position.Address (auto-generated)

Antwerpen

 

Position

Postal

The postal code part of the translated Descriptive.Position.Address (auto-generated)

2812

 

Position

Locality

The locality / city / council part of the translated Descriptive.Position.Address (auto-generated)

Mechelen

 

Position

SubLocality

The sub locality / city / council part of the translated Descriptive.Position.Address (auto-generated)

Muizen

 

Position

Street

The street part of the translated Descriptive.Position.Address (auto-generated)

Leuvensesteenweg

 

Position

Number

The house number part of the translated Descriptive.Position.Address (auto-generated)

582

 

Administrative Fields

Administrative Fields are human readable read-only fields which are used for managing and preserving files in MediaHaven.

Key

Description

Format

Read-only

Search

Key

Description

Format

Read-only

Search

OrganisationName

The name of the organisation to which the file belongs

 

LastModifiedDate

The date and time when the file was last modified by any user, including by the system under the hood

yyyy:MM:dd'T'HH:mm:ss.uuuuuuZ

UserLastModifiedDate

The date and time when the file was last edited by non system user. System users are used by process and customer support users.

yyyy:MM:dd'T'HH:mm:ss.uuuuuuZ

ExternalId

The ID of the file in an external platform. This field is only for advanced installations.

 

ArchiveDate

The date and time the file was ingested

yyyy:MM:dd'T'HH:mm:ss.uuuuuuZ

Type

The type of the file (e.g. image, document, page, image, layer, newspaperpage, article, video, videofragment, audio, audiofragment, set, collection, newspaper, metadataonly)

 

DepartmentName

The name of the department that published the file

 

Workflow

Describes through which workflow a file was ingested (if applicable)

 

IngestTape

Describes on which ingest tape the file was provided (if applicable)

 

IsSynchronized

Indicates whether or not this file or fragment has been synchronized from another MediaHaven.

0 or 1

ExternalUrl

When this file has been sychronized from another MediaHaven, this URL refers to file in the web site of the original MediaHaven.

URL

 

IsOriginal

Indicates if the file is an original file

0 or 1

IsPreservation

Indicates if the file is valid for preservation means

0 or 1

IsAccess

Indicates if the file is valid for access means

0 or 1

RecordType

The type of the record. 

 

RecordStatus

The status of the record (e.g. but not limited to New or Published)

 

OrganisationExternalId

External id of the organisation to which the file belongs.

 

 

OrganisationLongName

The full name of an organisation including white space and punctuation 

 

PublicationDate

The date and time the file was published

yyyy:MM:dd'T'HH:mm:ss.uuuuuuZ

DeleteStatus

Indicates if the record is deleted, and if so whether it’s been deleted logically or permanently.

  • NotDeleted

  • LogicallyDeleted

  • PermanentlyDeleted

LogicalDeletionDate

The time the record was logically deleted.

yyyy:MM:dd'T'HH:mm:ss.uuuuuuZ

RejectionDate

The date and time the record was rejected.

yyyy:MM:dd'T'HH:mm:ss.uuuuuuZ

ChildOrderFields

Key

Sub Key
#1

Sub Key #2

Description

Format

Read-only

Search

Key

Sub Key
#1

Sub Key #2

Description

Format

Read-only

Search

ChildOrderFields

 

 

The sort order the children of the record should be retrieved in.

ComplexListField

 

ChildOrderFields

Field

 

A single sort field.

MapField

 

ChildOrderFields

Field

DottedKey

The dotted key of a sortable field definition.

SimpleField

 

ChildOrderFields

Field

Direction

The direction to sort the fields in.

Possible values are:

  • Asc

  • Desc

EnumField

 

Technical Fields

Technical fields are predominantly read-only fields whose values are inherent to data file itself. (Re)-ingesting the file, possibly in a different MediaHaven, will result in exactly the same values.

Common

Key

Description

Format

Read-only

Search

Since

Key

Description

Format

Read-only

Search

Since

OriginalExtension

The extension of the file as it was ingested into MediaHaven