Metadata can be provided to MediaHaven in the form of a metadata XML. The XML can be provided as a sidecar XML file or provided in a MediaHaven REST API. The basic version of the external metadata format can be found here: External Metadata Basic.
The following XSD validates the metadata:
| Sidecar (xpath) | Profile | Description | Format |
|---|
title | Title | The title of the file |
|
description | Description | Description about the file |
|
md5 | Md5 | The MD5 checksum of the submitted file. If it mismatches with the calculated MD5 checksum during ingest, the file is rejected. |
|
keywords/keyword | Keywords | Series of categories about the file | MultiItem |
MDProperties/CreationDate | CreationDate | The date and time the file was originally created | EXIF |
MDProperties/rights_owner | Rights_Owner | The name of the (copyright) owner of the file |
|
MDProperties/Publisher | Publisher | Publisher of the file |
|
MDProperties/categories/category | Categories
| Series of keywords about the file | MultiItem |
MDProperties/Authors/auteur
| Authors | Series of authors of the file | MultItem |
MDProperties/<any-tag> | <any-tag> | The user can provide his or her own custom tags as children of the tag MDProperties.  Namespaced tags are not allowed
It is forbidden to use MediaHaven reserved tags names inside MDProperties. The reserved fields include the following tags: type, title, description. The full list of the reserved fields in MediaHaven: Metadata Fields. |
|
| Sidecar (xpath) | Description |
|---|
Relations/<relation-type>/ExternalId | Define relations with this file as subject and the provided references as object by means of an ExternalId. The object of the relation must already exist in MediaHaven with the provided ExternalId. The provided relation type must have been configured in MediaHaven beforehand Namespaced relation types are not allowed |
fragments/fragment | To create fragments of videos or documents, you can provide a list of fragment children under the element fragments. The fields below allow for providing some basic metadata fields to the created fragments. |
fragments/fragment/original_start_z | The start position of the fragment in the file - In the case of video or audio: expressed in frames. Calculate the seconds relative to the start of the video, multiply by 25 and round to an integer. For example: 10.40s => 252
- In the case of images or documents: the layer or page number, counted from 0.
|
fragments/fragment/original_end_z
| The end position of the fragment in the file - In the case of video or audio: expressed in frames. Calculate the seconds relative to the start of the video, multiply by 25 and round to an integer. For example: 10.40s => 252
- In the case of images or documents: no meaning
|
fragments/fragment/title | The title of the new fragment |
fragments/fragment/description
| The description of the new fragment |
fragments/fragment/keywords/keyword | A list of keywords about the new fragment |
Technical | All the technical fields defined in Metadata 17.1#Technical appear under the tag Technical. |
Internal | All the internal fields defined in Metadata 17.1#Internal appear under the tag Internal. With the exception of the tags IsInIngestSpace and IngestSpaceId which currently reside in MDProperties. |
<?xml version="1.0" encoding="UTF-8"?>
<MediaHAVEN_external_metadata name="example" version="1.0">
<title>provided title</title>
<description>provided description</description>
<keywords>
<keyword>k1</keyword>
<keyword>k2</keyword>
<keyword>k3</keyword>
</keywords>
<md5>58e6cd8c4df7132f6ea146c4828fbd96</md5>
<MDProperties>
<Authors type="list">
<auteur>Name of the author 1</auteur>
<auteur>Name of the author 2</auteur>
</Authors>
<CreationDate>2012:11:10 13:14:15</CreationDate>
<Categories type="list">
<category>x</category>
<category>y</category>
<category>z</category>
</Categories>
<publisher></publisher>
<!-- Customer extra metadata fields -->
<intellectualEntity_localID>nieuws 19-09-94a</intellectualEntity_localID>
<rights_RightsHolder>nieuws 19-09-94a</rights_RightsHolder>
</MDProperties>
<!-- Advanced Fields-->
<Relations>
<CroppedBy>
<ExternalId>8g8ff4372</ExternalId>
</CroppedBy>
<IsPartOf>
<ExternalId>8g8ff3qh45</ExternalId>
</IsPartOf>
</Relations>
<fragments type="list">
<fragment>
<title>Interview Jan Bosmans</title>
<description>JAN BOSMAN ONTMOET xxxx IN LONDEN</description>
<original_start_z>1855</original_start_z>
<original_end_z>8355</original_end_z>
<keywords>
<keyword>BOSMAN JAN</keyword>
<keyword>INTERVIEW</keyword>
</keywords>
</fragment>
<fragment>
...
</fragment>
</fragments>
<!-- Internal -->
<Internal>
<Browses>
<Browse>
<PathToKeyframe>http://dev-storage-virtual.mediahaven.com/DEV/83f25591d76a4a1c89394c579bb85e1614fcf186c5e34c2ca9f0c5547f43067e/keyframes/keyframes_1_1/keyframe1.jpg</PathToKeyframe>
<PathToKeyframeThumb>http://dev-storage-virtual.mediahaven.com/DEV/83f25591d76a4a1c89394c579bb85e1614fcf186c5e34c2ca9f0c5547f43067e/keyframes-thumb/keyframes_1_1/keyframe1.jpg</tPathToKeyframeThumb>
<PathToVideo>http://dev-storage-virtual.mediahaven.com/DEV/83f25591d76a4a1c89394c579bb85e1614fcf186c5e34c2ca9f0c5547f43067e/browse.mp4</PathToVideo>
</Browse>
</Browses>
<MediaObjectId>83f25591d76a4a1c89394c579bb85e1614fcf186c5e34c2ca9f0c5547f43067e</MediaObjectId>
<FragmentId>8527f72a6d6e49cbb3cbdb1fec8257acc4cbf05d4cde4fd08e432660579b4d677f91cafb07164874b03a7fac703196de</FragmentId>
<OrganisationId>106</OrganisationId>
<TransferStatus>FINISHED</TransferStatus>
</Internal>
<!-- Technical -->
<Technical>
<Width>1920</Width>
<Height>1080</Width>
<ImageSize>1920x1080</ImageSize>
...
</Technical>
</MediaHAVEN_external_metadata>