Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 16.3.

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/rights_ownerRights_OwnerThe name of the (copyright) owner of the file 
MDProperties/PublisherPublisherPublisher of the file 
MDProperties/categories/categoryCategories
Series of keywords about the fileMultiItem
MDProperties/Authors/auteur
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

Code Block
languagexml
titleMediaHAVEN_external_metadata
linenumberstrue
collapsetrue
<?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>
</MediaHAVEN_external_metadata>