Metadata 18.4

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

Legend

• Profile: If you fill this value out in a MediaHaven Profile this metadata will appear in the user interface
• Search / Searchable / Sortable: In the MediaHaven REST API you can search for it using this value if it is searchable and optionally sort the results (sortable).
• Read-only: This field cannot be modified in the user interface or API calls

Descriptive Fields

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

Key	Sub Key	Description	Format	Search	Read-only	Searchable	Sortable	Harvested
Title		The title of the file		MediaObjectFragmentTitle
Description		Description about the file		MediaObjectFragmentScriptDescription
CreationDate		The date and time the file was originally created	yyyy:MM:dd HH:mm:ss	MediaObjectFragmentCreationDate
RightsOwner		The name of the (copyright) owner of the file		MediaObjectFragmentrightsowner
Rights		A description about how the file can or can not be disseminated.
Keywords		Series of keywords about the file	ListField	search using the sub field
Keywords	Keyword	Sub field of Keywords containing an individual keyword		MediaObjectFragmentKeywordsKeyword
Categories		Series of categories about the file	ListField	search using the sub field
Categories	Category	Sub field of Categories containing an individual category		MediaObjectFragmentCategoriesCategory
Publisher		Publisher of the file
Authors		A list of various authors of the file	MulitItemField	search using the sub fields
AuthorsAuthor		Sub field of Authors containing an individual author		MediaObjectFragmentAuthorsAuthor
Address		Address of corresponding with the Location	MulitItemField	search using the sub field
Address	Formatted	Sub field of Address describing the full address in a single line, e.g. Trump Tower, 725 5th Ave, New York, NY 10022, Verenigde Staten		MediaObjectFragmentaddress
Location		GPS coordinates corresponding with the Address		MediaObjectFragmentlocation
Publications		List of locations where the file is published	ListField	search using the sub field
Publications	Comment	Sub field of Publications describing a comme		MediaObjectFragmentPublicationsComment
OriginalFilename		The name of the file as it was ingested into MediaHaven		MediaObjectOriginalFilename
UploadedBy		The name of the user that uploaded the file		MediaObjectUploadedBy

Administrative Fields

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

Key	Description	Format	Search	Read-only	Searchable	Sortable
OrganisationName	The name of the organisation to which the file belongs		MediaObjectOwnerName
LastModifiedDate	The date and time when the file was last edited	ISO-8601	MediaObjectFragmentLastModifiedTime
ExternalId	The ID of the file in an external platform. This field is only for advanced installations.		MediaObjectExternalId
ArchiveDate	The date and time the file was ingested	yyyy:MM:dd HH:mm:ss	MediaObjectArchiveDate
Type	The type of the file (e.g. image, document, page, image, layer, newspaperpage, article, video, videofragment, audio, audiofragment, set, collection, newspaper, metadataonly)		MediaObjectType
DepartmentName	The name of the department that published the file		MediaObjectFragmentDepartmentName
Workflow	Describes through which workflow a file was ingested (if applicable)		MediaObjectWorkflow
IngestTape	Describes on which ingest tape the file was provided (if applicable)		MediaObjectIngestTape
IsSynchronized	Indicates whether or not this file or fragment has been synchronized from another MediaHaven.	0 or 1	MediaObjectFragmentIsSynchronized
ExternalUrl	When this file has been sychronized from another MediaHaven, this URL refers to file in the web site of the original MediaHaven.	URL	MediaObjectFragmentExternalUrl

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	Search	Sidecar (xpath)	Read-only	Searchable	Sortable
OriginalExtension	The extension of the file as it was ingested into MediaHaven		MediaObjectOriginalExtension	Technical/OriginalExtension
FileSize	The size of the file in bytes		MediaObjectFileSize	Technical/FileSize			yes, but lexicographically
Md5	The MD5 checksum of the file		MediaObjectMd5	Technical/Md5
MimeType	The mime type of the file, e.g. image/jpg		MediaObjectMimeType	Technical/MimeType
Width	The width of the file	pixels	ImageWidth	Technical/Width			yes, but lexicographically
Height	The height of the file	pixels	ImageHeight	Technical/Height			yes, but lexicographically
ImageSize	Width times height, e.g 1920x1080	pixels times pixels	ImageSize	Technical/ImageSize
ImageQuality	The quality of the image	high (image: 1920x1200, video: 1280x720) medium (image: 1024x768, video: 720x540) low	ImageQuality	Technical/ImageQuality
ImageOrientation	The orientation of the image	panorama (aspect >= 2) landscape (2 > aspect >= 1.1) square (1.1 >= aspect > 0.9) portrait (0.9 >= aspect > 0.5) strip (aspect < 0.5)	ImageOrientation	Technical/ImageOrientation

Time codes

Key	Description	Format	Search	Read-only	Searchable	Sortable
DurationTimeCode	The duration of the media file	HH:mm:ss.SSS	MediaObjectDurationTimeCode
StartTimeCode	The start time of the media file	HH:mm:ss.SSS	MediaObjectStartTimeCode
EndTimeCode	The end time of the media file	HH:mm:ss.SSS	MediaObjectEndTimeCode
DurationFrames	The duration of the media file, expressed in frames against a fictitious 25 frames per second	frames (using a fictitious 25 fps)	MediaObjectDurationFrames
StartFrames	The start time of the media file, expressed in frames against a fictitious 25 frames per second	frames (using a fictitious 25 fps)	MediaObjectStartFrames
EndFrames	The end time of the media file, expressed in frames against a fictitious 25 frames per second	frames (using a fictitious 25 fps)	MediaObjectEndFrames

Video 

Key	Description	Format	Search	Read-only	Searchable	Sortable
VideoCodec	Description about the video encoding of the file		VideoCodec
VideoFps	Frames per second of the video in the file	frames per second (fps)	VideoCodec
VideoBitRate	Average bit rate of the video in the file	bits per second (bps)	VideoBitRate
AudioCodec	Description about the audio encoding of the file		AudioCodec
AudioChannels	Total number of audio channels in the flle		AudioChannels
AudioSampleRate	Sample rate of the audio tracks in the file	Hz	AudioSampleRate
AudioBitRate	Total average bit rate of all audio tracks	bits per second (bps)	AudioBitRate
BitRate	Total average bit rate of the container (includes video and audio)	bits per second (bps)	BitRate

MXF Video

Key	Description	Format	Search	Read-only	Searchable	Sortable
Origin	Number of edit units to skip at the start of the source video codec before the logical of start of the essence	frames	Origin
EssenceOffset	File offset to the first partition containing essence	bytes	EssenceOffset
EditUnitByteSize	> 0: Constant Bit Rate (CBR) MXF: Each edit unit has this fixed size 0: Variable Bit Rate (VBR) MXF: Edit units have a variable size -1: Unrecognized edit unit structure	bytes	EditUnitByteSize
RunIn	File offset to the first KLV in the file, typically 0	bytes	RunIn
FramesPerEditUnit	Number of frames per edit unit	frames	FramesPerEditUnit
EditRate	Number of edit units per second, if FramesPerEditUnit is 1 this equals the VideoFps	fraction	EditRate
IndexEditRate	Advanced MXF feature, stored for future usage	fraction	IndexEditRate

Internal Fields

Internal fields are read-only metadata fields proper to MediaHaven and often not a human readable format opposed to the administrative fields.

Key	Description	Remark	Search	Read-only	Searchable	Sortable
MediaObjectId	The unique identifier of the file	64 characters	MediaObjectId
FragmentId	The unique identifier of the fragment of the file	96 characters	MediaObjectFragmentId
OriginalStatus	Status of the validation and ingest of the file	in_progress: file is being processed completed: file is successfully stored on storage failed: ingest failed and the file is not succesfully stored on storage	MediaObjectOriginalStatus
BrowseStatus	Status of the creation of the preview of the file	in_progress: browse is being generated completed: browse is successfully created no_browse: no browse is created for this file type cancelled: ingest failed before a browse was created failed: browse could not be created	MediaObjectBrowseStatus
ArchiveStatus	The possible values are documented here: Ingest Monitoring		MediaObjectArchiveStatus
OrganisationId	The ID of the organisation to which the file belongs to. The administrative field OrganisationName provides the human readable name.		MediaObjectOwner
IngestSpaceId	The ID of the ingest space the file belongs or belonged to	UUID	MediaObjectFragmentingestspacename
IsInIngestSpace	Whether the file still belongs to an ingest space	0 or 1	MediaObjectFragmentisiningestspace
UploadedById	The user ID of the user that uploaded the file, the administrative field UploadedBy provides the human readable name.	UUID	MediaObjectUploadedById
DepartmentId	uuid of the department the file was published with, the administrative field DepartmentName provides the human readable name.	UUID	MediaObjectDepartmentId
IsFragment	Indicates whether or not the file is the main fragment or non-main fragment (i.e. page of a document, videofragment of a video)	0 or 1	MediaObjectFragmentisfragment
HasKeyframes	Indicates whether or not the the file has a series of keyframes (applicable to documents, multi-page images, video and audio)	0 or 1	MediaObjectHasKeyframes
ContainsGeoData	Indicates whether or not the file has geolocation data associated to it	0 or 1	MediaObjectFragmentContainsGeoData

Browses 

Key	Sub Key #1	Sub Key #2	Description	Remark	Search	Read-only
Browses			List of browse formats generated for the file	ComplexField
Browses	Browse		Description of a single browse format of the file	MapField
Browses	Browse	Label	Unique label of this browse format
Browses	Browse	Container	Extension of the container of this browse, e.g. jpg, mp4
Browses	Browse	BaseUrl	URL to the path containing the files associated with this browse format
Browses	Browse	PathToKeyframe	Relative path to the main still image of the file. Prefix with BaseUrl to obtain the complete URL.
Browses	Browse	PathToKeyframeThumb	Relative path to the main still image of the file (thumb version). Prefix with BaseUrl to obtain the complete URL.
Browses	Browse	PathToVideo	Relative path to the video preview of the file. Prefix with BaseUrl to obtain the complete URL.
Browses	Browse	FileSize	File size of the PathToVideo for audio / video or PathToKeyframe for other content.	bytes
Browses	Browse	Width	Width of the preview (PathToKeyframe)	pixels
Browses	Browse	Height	Height of the preview (PathToKeyframe)	pixels
Browses	Browse	...	All keys available under the item #Video on this same page

Distributions 

Key	Sub Key	Description	Remark	Search	Read-only	Searchable
Distributions		List of distribution channels where the file has been distributed to	ListField
Distributions	Distribution	Provides information about a single channel in the form of <protocol>:<ID>, e.g. jwplayer:bZZVWxol	protocol:id	DistributionsDistribution

Structural Fields 

Structural fields provide how compound files such as collections are put together or how files are related between each other. Three categories exist: Fragments, Ensembles and Relations.

Fragments

Key	Sub Key	Description	Remark	Search	Read-only	Searchable	Sortable
Fragments		Series of fragments belonging to this file. The main fragment which corresponds to the file itself (i.e. the entire video) is non contained in this series, hence this list is empty if the file contains no pure (= non main) fragments.	ListField	search using the sub field
Fragments	Fragment	Sub field of Fragments giving the FragmentId of each fragment this file contains	FragmentId	FragmentsFragment
MainFragment		For a pure fragment, this refers the FragmentId of main fragment. For the main fragment this field is empty.	SimpleField
FragmentStartFrames		The start time of a fragment, relative to the start of the media file, expressed in frames against a fictitious 25 frames per second	frames (using a fictitious 25 fps)	MediaObjectFragmentStart
FragmentEndFrames		The end time of a fragment, relative to the start of the media file, expressed in frames against a fictitious 25 frames per second	frames (using a fictitious 25 fps)	MediaObjectFragmentEnd
FragmentDurationFrames		The duration of a fragment, expressed in frames against a fictitious 25 frames per second	frames (using a fictitious 25 fps)	MediaObjectFragmentDuration
FragmentStartTimeCode		The start time of a fragment, relative to the start of the media file	HH:mm:ss.SSS	MediaObjectFragmentStartTimeCode
FragmentEndTimeCode		The end time of a fragment, relative to the start of the media file	HH:mm:ss.SSS	MediaObjectFragmentEndTimeCode
FragmentDurationTimeCode		The duration of a fragment	HH:mm:ss.SSS	MediaObjectFragmentDurationTimeCode

Ensembles

Key	Sub Key	Description	Remark	Search	Read-only	Searchable	Sortable
Collections		Series of collections the file belongs to	ListField	search using the sub field
Collections	Collection	Sub field of Collections providing the ID of an individual the collection the file belongs to		Collection
Sets		Series of sets the file belongs to	ListField	search using the sub field
Sets	Set	Sub field of Sets providing the ID of an individual set the file belongs to		Set
Newspapers		Series of newspapers the file belongs to	ListField	search using the sub field
Newspapers	Newspaper	Sub field of Newspapers providing the ID of an individual newspaper the file belongs to		Newspaper

Relations

Key	Sub Key	Description	Remark	Search	Read-only	Searchable	Sortable
Relations		Series of files related with this file. Depending on your installation different sub fields of Relations might be defined.	MultiItemField	search using the sub fields
Relations	PreviousVersion	Sub field of Relations providing the FragmentId of an individual file which is the previous version of this file	FragmentId	RelationsPreviousVersion
Relations	NextVersion	Sub field of Relations providing the FragmentId of an individual file which is the next version of this file	FragmentId	RelationsNextVersion
Relations	Contains	Sub field of Relations providing the FragmentId of an individual file which this file contains	FragmentId	RelationsContains
Relations	ContainedBy	Sub field of Relations providing the FragmentId of an individual file that contains this file	FragmentId	RelationsContainedBy
Relations	Associated	Sub field of Relations providing the FragmentId of an individual file which is associated with this file	FragmentId	RelationsAssociated

Rights Management Fields 

Rights management fields provide information about who can access, edit or export files.

Key	Sub Key	Description	Remark	Search	Read-only	Searchable	Sortable
Permissions		The different permissions associated with the file	MultiItemField	search using the sub fields
Permissions	Read	Sub field of Permissions providing ID of a user group with read rights	UUID	PermissionsRead
Permissions	Write	Sub field of Permissions providing ID of a user group with write rights	UUID	PermissionsWrite
Permissions	Export	Sub field of Permissions providing ID of the user groups with export rights	UUID	PermissionsExport
ExpiryDate		The date the file will expire (at this date the file will be assigned new rights). This field is only for advanced installations.	yyyy:MM:dd HH:mm:ss	MediaObjectExpiryDate
ExpiryStatus		Whether or not the file is expired. This field is only for advanced installations.		MediaObjectFragmentExpiryStatus

Changelog

Changes versus Metadata 18.3:

1. The column Sidecar (xpath) is no longer shown in this documentation because from 18.4 there is a one-on-one correspondence between fields and families in the Metadata Sidecar.
2. Moved some fields to a different family: rationale is that only the following families contain changeable fields for the customer: Descriptive, Structural, RightsManagement and Dynamic
   1. UploadedBy: Administrative → Descriptive
   2. OriginalFilename: Technical → Descriptive
   3. ExpiryDate / ExpiryStatus: Administrative → RightsManagement
   4. FragmentStartFrames and related technical fields for fragments: Technical → Structural
3. The field UploadedBy is no longer read-only
4. Added sub field Label to the field Browses > Browse
5. New Structural fields for fragments
   1. List field Fragments which sub field Fragment
   2. Field MainFragment