Metadata 21.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:PoliticsSearchable: 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 | Searchable |
|---|---|---|---|---|---|
|
| The title of the file |
|
| |
|
| Description about the file |
|
| |
|
| The date and time the file was originally created |
|
| |
|
| The name of the (copyright) owner of the file |
|
|
|
|
| A description about how the file can or can not be disseminated. |
|
|
|
|
| Series of keywords about the file |
|
|
|
|
| Sub field of |
|
| |
|
| Series of categories about the file |
|
|
|
|
| Sub field of |
|
| |
|
| Publisher of the file |
|
|
|
|
| A list of various authors of the file |
|
|
|
|
| Sub field of |
|
| |
|
| Address of corresponding with the Location |
|
|
|
|
| Sub field of |
| ||
|
| GPS coordinates corresponding with the |
|
|
|
|
| List of locations where the file is published |
|
|
|
|
| Sub field of |
|
|
|
|
| The name of the file as it was ingested into MediaHaven |
|
| |
|
| The name of the user that uploaded the file |
|
| |
| By default the the field | frames (using a fictitious 25 fps) |
|
Administrative Fields
Administrative Fields are human readable read-only fields which are used for managing and preserving files in MediaHaven.
Key | DigiHaven / MediaHaven 2.0 | Description | Format | Read-only | Searchable |
|---|---|---|---|---|---|
|
| The name of the organisation to which the file belongs |
| ||
|
| The date and time when the file was last edited |
| ||
|
| The ID of the file in an external platform. This field is only for advanced installations. |
| ||
|
| The date and time the file was ingested |
| ||
|
| The type of the file (e.g. image, document, page, image, layer, newspaperpage, article, video, videofragment, audio, audiofragment, set, collection, newspaper, metadataonly) |
| ||
|
| The name of the department that published the file |
| ||
|
| Describes through which workflow a file was ingested (if applicable) |
| ||
|
| Describes on which ingest tape the file was provided (if applicable) |
| ||
|
| Indicates whether or not this file or fragment has been synchronized from another MediaHaven. | 0 or 1 | ||
|
| When this file has been sychronized from another MediaHaven, this URL refers to file in the web site of the original MediaHaven. | URL |
| |
|
| Indicates if the file is an original file | 0 or 1 | ||
| Yes | Indicates if the file is valid for preservation means | 0 or 1 | ||
| Yes | Indicates if the file is valid for access means | 0 or 1 | ||
| Yes | The type of the record. |
| ||
| Yes | The status of the record (e.g. but not limited to New or Published) |
| ||
|
| External id of the organisation to which the file belongs. |
|
| |
|
| The full name of an organisation including white space and punctuation |
| ||
| Yes | The date and time the file was published |
|
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 | Searchable |
|---|---|---|---|---|
| The extension of the file as it was ingested into MediaHaven |
| ||
| The size of the file in bytes |
| ||
| The MD5 checksum of the file |
| ||
| The mime type of the file, e.g. image/jpg |
| ||
| The Pronom ID is a file identification mechanism developed by the National Archives |
| ||
| The width of the file | pixels | ||
| The height of the file | pixels | ||
| Width times height, e.g 1920x1080 | pixels times pixels | ||
| The quality of the image |
| ||
| The orientation of the image |
|
Time codes
Key | Description | Format | Read-only | Searchable |
|---|---|---|---|---|
| The duration of the media file |
|
| |
| The start time of the media file |
|
| |
| The end time of the media file |
|
| |
| The duration of the media file, expressed in frames against a fictitious 25 frames per second, e.g. | frames (using a fictitious 25 fps) |
| |
| The start time of the media file, expressed in frames against a fictitious 25 frames per second, e.g. | frames (using a fictitious 25 fps) |
| |
| The end time of the media file, expressed in frames against a fictitious 25 frames per second, e.g. | frames (using a fictitious 25 fps) |
|
Video
Key | Description | Format | Read-only | Searchable |
|---|---|---|---|---|
| Description about the video encoding of the file |
|
| |
| Frames per second of the video in the file | frames per second (fps) |
| |
| Average bit rate of the video in the file | bits per second (bps) |
| |
| Description about the audio encoding of the file |
|
| |
| Total number of audio channels in the file, if the file has multiple audio tracks, this is the cumulative sum over all tracks |
|
| |
| Sample rate of the first audio track in the file | Hz |
| |
| Total average bitrate of all audio tracks | bits per second (bps) |
| |
| The amount of audio tracks in the file |
|
| |
| Total average bit rate of the container (includes video and audio) | bits per second (bps) |
|
MXF Video
Key | Description | Format | Read-only | Searchable |
|---|---|---|---|---|
| Number of edit units to skip at the start of the source video codec before the logical of start of the essence | frames |
| |
| File offset to the first partition containing essence | bytes |
| |
|
|