View Source

Design

An advanced feature is the use of the XML attribute strategy on a top level metadata field for example Title, Description, Authors, RightsOwner.

We have four possible values for the attribute

KEEP → Don't overwrite the old value for this field if it was not empty
OVERWRITE →
- Overwrite the old value for this field
- This is the default strategy for simple fields which are fields that contain a textual value such as Title and Description.
MERGE →
- Only allowed for complex fields which are fields that contain sub fields, such as Authors, Keywords and Categories.
- Merge the new sub fields with the existing sub fields
- This is the default strategy for complex fields
SUBTRACT →
- Only allowed for complex fields
- Removes the values from the existing values.

SUBTRACT is only available in versions 21.1 and up.

Strategies are only available on top level metadata fields

Structure

In JSON the strategies are provided as follows

{
  "MergeStrategies": {
    "Title": "KEEP",
    "Description": "OVERWRITE",
    "Keywords": "MERGE",
    "Categories": "SUBTRACT"
  },
  "Descriptive": {
     "Title": "Lore Ipsum",
     ...
  },
  "Structural": {...}
}

In XML the strategies are provided as follows

<?xml version="1.0" encoding="UTF-8"?>
<mhs:Sidecar xmlns:mhs="https://zeticon.mediahaven.com/metadata/18.4/mhs/" xmlns:mh="https://zeticon.mediahaven.com/metadata/18.4/mh/">
   <mhs:Descriptive>
      <mh:Title strategy="KEEP">...</mh:Title>
   </mhs:Descriptive>
</mhs:Sidecar>

Examples

Input Metadata

<?xml version="1.0" encoding="UTF-8"?>
<mhs:Sidecar xmlns:mhs="https://zeticon.mediahaven.com/metadata/18.4/mhs/" xmlns:mh="https://zeticon.mediahaven.com/metadata/18.4/mh/">
   <mhs:Descriptive>
      <mh:Title strategy="KEEP">Nouveau dinosaure en Argentine</mh:Title>
      <mh:Description strategy="OVERWRITE">Un nouveau dinosaure a été découvert en Argentine ! Des chercheurs ont trouvé, sur un site archéologique, des ossements appartenant à une nouvelle espèce. Espèce qui aurait vécu il y a plus de 200 millions d'années.</mh:Description>
      <mh:Keywords strategy="MERGE">
         <mh:Keyword>Argentine</mh:Keyword>
         <mh:Keyword>RTL</mh:Keyword>
      </mh:Keywords>
      <mh:Categories strategy="SUBTRACT">
         <mh:Category>dinosaure</mh:Category>
      </mh:Categories>
   </mhs:Descriptive>
</mhs:Sidecar>

Existing Metadata

<?xml version="1.0" encoding="UTF-8"?>
<mhs:Sidecar xmlns:mhs="https://zeticon.mediahaven.com/metadata/18.4/mhs/" xmlns:mh="https://zeticon.mediahaven.com/metadata/18.4/mh/">
   <mhs:Descriptive>
      <mh:Title>[BREAKING] Nouveau dinosaure en Argentine!</mh:Title>
      <mh:Description>Un nouveau dinosaure a été découvert en Argentine.</mh:Description>
      <mh:Keywords>
         <mh:Keyword>News</mh:Keyword>
         <mh:Keyword>Paléontologie</mh:Keyword>
         <mh:Keyword>RTL</mh:Keyword>
      </mh:Keywords>
      <mh:Categories>
         <mh:Category>dinosaure</mh:Category>
         <mh:Category>archéologique</mh:Category>
      </mh:Categories>
   </mhs:Descriptive>
</mhs:Sidecar>

Resulting Metadata

<?xml version="1.0" encoding="UTF-8"?>
<mhs:Sidecar xmlns:mhs="https://zeticon.mediahaven.com/metadata/18.4/mhs/" xmlns:mh="https://zeticon.mediahaven.com/metadata/18.4/mh/">
   <mhs:Descriptive>
      <mh:Title>[BREAKING] Nouveau dinosaure en Argentine!</mh:Title>
      <mh:Description>Un nouveau dinosaure a été découvert en Argentine ! Des chercheurs ont trouvé, sur un site archéologique, des ossements appartenant à une nouvelle espèce. Espèce qui aurait vécu il y a plus de 200 millions d'années.</mh:Description>
      <mh:Keywords>
         <mh:Keyword>Argentine</mh:Keyword>
         <mh:Keyword>News</mh:Keyword>
         <mh:Keyword>Paléontologie</mh:Keyword>
         <mh:Keyword>RTL</mh:Keyword>
      </mh:Keywords>
      <mh:Categories>
         <mh:Category>archéologique</mh:Category>
      </mh:Categories>
   </mhs:Descriptive>
</mhs:Sidecar>