Page Comparison

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

...

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

Key	Sub Key	Description	Format
`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)

...

Key	Description	Format	Since
`OriginalExtension`	The extension of the file as it was ingested into MediaHaven
`FileSize`	The size of the file in bytes
`Md5`	The MD5 checksum of the file
`MimeType`	The mime type of the file, e.g. image/jpg
`PronomId`	The Pronom ID is a file identification mechanism developed by the National Archives
`Width`	The width of the file	pixels
`Height`	The height of the file	pixels
`ImageSize`	Width times height, e.g 1920x1080	pixels times pixels
`ImageQuality`	The quality of the image	high image: 1920x1200 video: 1280x720) medium image: 1024x768 video: 720x540) low
`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)
`Exif`	Contains all EXIF metadata extracted from the file, see Metadata Mining for a non exhaustive list of extracted properties	`MapField`	`21.3`

...

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
`RecordId`	Successor of the `MediaObjectId` field containing exactly the same value with `MediaObjectId` remaining in place for backwards compatibility.	64 characters
`MediaObjectId`	The unique identifier of the file	64 characters
`FragmentId`	The unique identifier of the fragment of the file	96 characters
`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
`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
`ArchiveStatus`	The possible values are documented here: Ingest Monitoring
`OrganisationId`	The ID of the organisation to which the file belongs to. The administrative field `OrganisationName` provides the human readable name.
`IngestSpaceId`	The ID of the ingest space the file belongs or belonged to	UUID
`IsInIngestSpace`	Whether the file still belongs to an ingest space	0 or 1
`UploadedById`	The user ID of the user that uploaded the file, the administrative field `UploadedBy` provides the human readable name.	UUID
`DepartmentId`	uuid of the department the file was published with, the administrative field `DepartmentName` provides the human readable name.	UUID
`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
`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
`ContainsGeoData`	Indicates whether or not the file has geolocation data associated to it	0 or 1
`Profiles`	A list of profiles linked to this record, sorted by record type. Note that Mediahaven 1.0 profiles will not be added to this field.	`MulitItemField`

ProfilesAll


`Profiles.All`	Profiles that can be used for records of any record type.
`ExternalSourceUrl`	Source URL of the file. Only filled out when `POST` ing the record with the `fileUrl` parameter.	URL	`22.4`

Previews

Key	Description	Remark
`PathToKeyframe`	Public accessible URI to the high resolution keyframe of the record.	URI
`PathToKeyframeThumb`	Public accessible URI to the low resolution keyframe of the record.	URI
`PathToPreview`	Public accessible URI to the access representation file.	URI
`PathToVideo`	Public accessible URI to the browse mp4 for videos. Obsolete, use `PathToPreview` instead.	URI
`PathToOriginal`	Public accessible URI to the original representation file. By default this is not available because the original storage is only made public upon request → Direct Downloads.	URI

Browses

Key	Sub Key #1	Sub Key #2	Description	Remark
`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 (P`athToKeyframe)`	pixels
`Browses`	`Browse`	`Height`	Height of the preview (P`athToKeyframe)`	pixels
`Browses`	`Browse`	...	All keys available under the item #Video on this same page

...

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.

Record Tree

Key	Sub Key	Description	Remark	Since
`ReferenceCodes`		Contains the full line of ancestors. More info Record Tree	`ComplexField`
`ReferenceCodes`	`Record`		`SimpleField`
`ReferenceTitles`		Contains the titles of the full line of ancestors.	`ComplexField`
`ReferenceTitles`	`Record`		`SimpleField`
`ParentRecordId`		If the record has a parent record, this value contains the `RecordId` of that parent.	`SimpleField`
`HasChildren`		If record has or had children in at least one point in time this will field be forever `true`	`BooleanField`
`OriginalRecordId`		Refers to the original representation, see https://mediahaven.atlassian.net/wiki/spaces/CS/pages/3400007723/Record+Tree+Glossary#Terms%3A-Representation-Forms.	`SimpleField`	`22.4`
`PreviewRecordId`		For data objects and original representations, is refers to the primary access representation. See Record Tree Glossary. If filled out, the paths `PathToPreview` `PathToKeyframe PathToKeyframeThumb` will refer to the previews of the referred other record.	`SimpleField`

Fragments

Key	Sub Key	Description	Remark
`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`
`Fragments`	`Fragment`	Sub field of `Fragments` giving the `FragmentId` of each fragment this file contains	`FragmentId`
`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)
`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)
`FragmentDurationFrames`		The duration of a fragment, expressed in frames against a fictitious 25 frames per second	frames (using a fictitious 25 fps)
`FragmentStartTimeCode`		The start time of a fragment, relative to the start of the media file	`HH:mm:ss.SSS`
`FragmentEndTimeCode`		The end time of a fragment, relative to the start of the media file	`HH:mm:ss.SSS`
`FragmentDurationTimeCode`		The duration of a fragment	`HH:mm:ss.SSS`

Versioning

Key	Sub Key	Description	Remark
`Versioning`		Provides structural information about the chain versions of the same logical file. Each record in the chain is a separate record itself with its own MediaObjectId / FragmentId. All records in the chain have the same Versioning > Id.	`MapField`
`Versioning`	`Status`	Untracked for records without versioning, otherwise possible values are Draft, Head, Rejected, Tail.	`EnumField`
`Versioning`	`Id`	Has the same value for an entire versioning chain; its value is the MediaObjectId of the first record in the chain (with Version = 1).	`SimpleField`
`Versioning`	`Version`	Positional index in the chain of versions, starting from Version 1.	`LongField`

Ensembles

Key	Sub Key	Description	Remark
`Collections`		Series of collections the file belongs to	`ListField`
`Collections`	`Collection`	Sub field of `Collections` providing the ID of an individual the collection the file belongs to
`Sets`		Series of sets the file belongs to	`ListField`
`Sets`	`Set`	Sub field of `Sets` providing the ID of an individual set the file belongs to
`Newspapers`		Series of newspapers the file belongs to	`ListField`
`Newspapers`	`Newspaper`	Sub field of `Newspapers` providing the ID of an individual newspaper the file belongs to

Relations

Key	Sub Key	Description	Remark
`Relations`		Series of files related with this file. Depending on your installation different sub fields of `Relations` might be defined.	`MultiItemField`
`Relations`	`PreviousVersion`	Sub field of `Relations` providing the `FragmentId` of an individual file which is the previous version of this file	`FragmentId`
`Relations`	`NextVersion`	Sub field of `Relations` providing the `FragmentId` of an individual file which is the next version of this file	`FragmentId`
`Relations`	`Contains`	Sub field of `Relations` providing the `FragmentId` of an individual file which this file contains	`FragmentId`
`Relations`	`ContainedBy`	Sub field of `Relations` providing the `FragmentId` of an individual file that contains this file	`FragmentId`
`Relations`	`Associated`	Sub field of `Relations` providing the `FragmentId` of an individual file which is associated with this file	`FragmentId`
`Relations`	`IsSuggestedFor`	Points to a record for which a suggestion is made	`FragmentId`
`Relations`	`HasAsSuggestion`	Points to a suggestion which is made for this record	`FragmentId`

...

Versions Compared

Old Version 4

New Version Current

Key