External Metadata Basic

Introduction

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 complete reference about the external metadata can be found here: External Metadata Advanced 18.1.

Standard Fields

Sidecar (xpath)ProfileDescriptionFormat
titleTitleThe title of the file
descriptionDescriptionDescription about the file
md5Md5The MD5 checksum of the submitted file. If it mismatches with the calculated MD5 checksum during ingest, the file is rejected.
keywords/keywordKeywordsSeries of categories about the fileMultiItem
MDProperties/CreationDateCreationDateThe date and time the file was originally createdEXIF
MDProperties/RightsOwnerRightsOwnerThe name of the (copyright) owner of the file
MDProperties/PublisherPublisherPublisher of the file
MDProperties/Categories/CategoryCategories
Series of keywords about the fileMultiItem
MDProperties/Authors/Author
AuthorsSeries of authors of the fileMultItem
MDProperties/<any-tag><any-tag>

The user can provide his or her own custom tags as children of the tag MDProperties.

(warning) Namespaced tags are not allowed

(warning) 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.


Example

MediaHAVEN_external_metadata
<?xml version="1.0" encoding="UTF-8"?>
<MediaHAVEN_external_metadata>
   <title>Big Buck Bunny, Sunflower version</title>
   <description />
   <OriginalFilename>video.mp4</OriginalFilename>
   <MDProperties>
      <Authors type="list">
         <Author>Blender Foundation 2008</Author>
         <Author>Janus Bager Kristensen 2013</Author>
      </Authors>
      <RightsOwner>SoundHandler</RightsOwner>
   </MDProperties>
</MediaHAVEN_external_metadata>