Metadata Mapping Schemas

Reading time ~6 minutes

Note
 This functionality is obsolete and should not be used for the new installations.

The metadata mapping editor allows user to map the metadata fields of external media files onto equivalent metadata fields of the Cinegy Archive objects such as master clips and Rolls. The data mapper establishes an individual superset of metadata fields for each particular plug-in type used for import/export. Use the "Metadata mapping schemas" command to launch the corresponding tab:

mapping schemas command
Metadata_mapper_editor

Mappings

All the available metadata mapping types are listed in the "Mapping Types" list.

edit_button

To edit an existing mapping type, choose the required one from the list and press the "Edit" button. The following dialog box appears:
editing type

In the "Type name" field enter a new name for the metadata mapping type via the keyboard.

The Globally Unique Identifier (GUID) is automatically generated by the system and cannot be changed. Press "OK" to apply your changes.

Schemas

Different metadata mapping schemas with the preconfigured superset of metadata fields can be created individually for each import/export plug-in type.

The metadata parameters of the schema are specified in the XML file and associated with the "Descriptors, presets" link on the "Descriptors, presets" tab.

descriptor_with_xml_ready1
Important
 Refer to the Descriptors, Presets article to learn how to create and manage descriptors.

Adding a New Schema

Button_new

To add a new mapping schema, press the "New…" button. The following dialog box appears:
new_mapping_underfined

Here choose the appropriate mapping schema type from the drop-down list.

Note
 The MT_EXPORT and MT_IMPORT metadata mapping types are currently available for the metadata export and import operations correspondingly.

IMPORT

Press the "Import" button to import the XML file. If the selected XML file is not valid for the metadata mapping, the following error message appears:
Error_XML_must_be_set

Press "OK" and choose the valid XML file.

Export button

To save the XML file used for the current metadata mapping schema, press the "Export" button.

A sample of the XML metadata mapping file structure for audio import is shown below:

<?xml version="1.0" encoding="utf-8"?>
<root>
  <object type="30" subtype="30">
    <descriptor name="pd_clip_name" separator="/">
      <field name="Title">
    </field></descriptor>
    <descriptor name="mat_title" separator="/">
      <field name="Title">
    </field></descriptor>
    <descriptor name="mat_duration" separator="/">
      <field name="Duration">
    </field></descriptor>
    <descriptor name="mat_artist" separator="/">
      <field name="Artist">
    </field></descriptor>
    <descriptor name="mat_album" separator="/">
      <field name="Album">
      <field name="Artist">
      <field name="Year">
    </field></field></field></descriptor>
    <descriptor name="mat_year" separator="/">
      <field name="Year">
    </field></descriptor>
    <descriptor name="mat_albumduration" separator="/">
      <field name="AlbumDuration">
    </field></descriptor>
    <descriptor name="mat_isrc" separator="/">
      <field name="ISRC">
    </field></descriptor>
    <descriptor name="mat_genre" separator="/">
      <field name="Genre">
    </field></descriptor>
    <descriptor name="mat_iswc" separator="/">
      <field name="ISWC">
    </field></descriptor>
    <descriptor name="mat_origin" separator="/">
      <field name="Origin">
    </field></descriptor>
    <descriptor name="mat_linenumber" separator="/">
      <field name="LineNumber">
    </field></descriptor>
    <descriptor name="mat_productcatno" separator="/">
      <field name="ProductCatNo">
    </field></descriptor>
    <descriptor name="mat_productid" separator="/">
      <field name="ProductId">
    </field></descriptor>
    <descriptor name="mat_productlabel" separator="/">
      <field name="ProductLabel">
    </field></descriptor>
    <descriptor name="mat_producttitle" separator="/">
      <field name="ProductTitle">
    </field></descriptor>
    <descriptor name="mat_recordingid" separator="/">
      <field name="RecordingId">
    </field></descriptor>
    <descriptor name="mat_trackposition" separator="/">
      <field name="TrackPosition">
    </field></descriptor>
    <descriptor name="mat_tunecode" separator="/">
      <field name="TuneCode">
    </field></descriptor>
    <descriptor name="mat_workpublishers" separator="/">
      <field name="WorkPublishers">
    </field></descriptor>
    <descriptor name="mat_worktitle" separator="/">
      <field name="WorkTitle">
    </field></descriptor>
    <descriptor name="mat_workwriter" separator="/">
      <field name="WorkWriter">
    </field></descriptor>
    <descriptor name="mat_writers" separator="/">
      <field name="Writers">
    </field></descriptor>

A sample of the XML metadata mapping file structure for Canon XF import is shown below:

<?xml version="1.0" encoding="utf-8"?>
<root>
  <object type="30" subtype="30">
    <descriptor name="ingest_clip_no" separator="/">
      <field name="EntireNumber">
    </field></descriptor>
    <descriptor name="pd_clip_name" separator="/">
      <field name="ClipName">
    </field></descriptor>
    <descriptor name="xdcam_srcfile" separator="/">
      <field name="SourceFile">
    </field></descriptor>
    <descriptor name="title" separator="/">
      <field name="//VideoClip/Title">
    </field></descriptor>
    <descriptor name="creator" separator="/">
      <field name="//VideoClip/Creator">
    </field></descriptor>
    <descriptor name="clip_description" separator="/">
      <field name="//VideoClip/Description">
    </field></descriptor>
    <descriptor name="device_manufacturer" separator="/">
      <field name="//VideoClip/Device/Manufacturer">
    </field></descriptor>
    <descriptor name="device_serialno" separator="/">
      <field name="//VideoClip/Device/SerialNo">
    </field></descriptor>
    <descriptor name="device_modelname" separator="/">
      <field name="//VideoClip/Device/ModelName">
    </field></descriptor>
    <descriptor name="device_firmversion" separator="/">
      <field name="//VideoClip/Device/FirmVersion">
    </field></descriptor>
    <descriptor name="location_altitude" separator="/">
      <field name="//VideoClip/Location/Altitude">
    </field></descriptor>
    <descriptor name="location_longitude" separator="/">
      <field name="//VideoClip/Location/Longitude">
    </field></descriptor>
    <descriptor name="location_latitude" separator="/">
      <field name="//VideoClip/Location/Latitude">
    </field></descriptor>
    <descriptor name="location_source" separator="/">
      <field name="//VideoClip/Location/Source">
    </field></descriptor>
    <descriptor name="location_placename" separator="/">
      <field name="//VideoClip/Location/PlaceName">
    </field></descriptor>
  </object>
</root>

A sample of the XML metadata mapping file structure for Panasonic P2 card import is shown below:

<?xml version="1.0" encoding="utf-8" ?>
<root>
  <object type="30" subtype="30">
    <descriptor name="pd_clip_name" separator="/">
      <field name="ClipName">
    </field></descriptor>
    <descriptor name="p2c_clipname" separator="/">
      <field name="ClipName">
    </field></descriptor>
    <descriptor name="p2c_globalclipid" separator="/">
      <field name="GlobalClipID">
    </field></descriptor>
    <descriptor name="p2c_duration" separator="/">
      <field name="Duration">
    </field></descriptor>
    <descriptor name="p2c_editunit" separator="/">
      <field name="EditUnit">
    </field></descriptor>
    <descriptor name="p2c_videoformat" separator="/">
      <field name="EssenceList/Video/VideoFormat">
    </field></descriptor>
    <descriptor name="p2c_codec" separator="/">
      <field name="EssenceList/Video/Codec">
    </field></descriptor>
    <descriptor name="p2c_framerate" separator="/">
      <field name="EssenceList/Video/FrameRate">
    </field></descriptor>
    <descriptor name="p2c_starttimecode" separator="/">
      <field name="EssenceList/Video/StartTimecode">
    </field></descriptor>
    <descriptor name="p2c_startbinarygroup" separator="/">
      <field name="EssenceList/Video/StartBinaryGroup">
    </field></descriptor>
    <descriptor name="p2c_aspectratio" separator="/">
      <field name="EssenceList/Video/AspectRatio">
    </field></descriptor>
    <descriptor name="p2c_userclipname" separator="/">
      <field name="ClipMetadata/UserClipName">
    </field></descriptor>
    <descriptor name="p2c_datasource" separator="/">
      <field name="ClipMetadata/DataSource">
    </field></descriptor>
    <descriptor name="p2c_creationdate" separator="/">
      <field name="ClipMetadata/Access/CreationDate">
    </field></descriptor>
    <descriptor name="p2c_lastupdatedate" separator="/">
      <field name="ClipMetadata/Access/LastUpdateDate">
    </field></descriptor>
    <descriptor name="p2c_startdate" separator="/">
      <field name="ClipMetadata/Shoot/StartDate">
    </field></descriptor>
    <descriptor name="p2c_enddate" separator="/">
      <field name="ClipMetadata/Shoot/EndDate">
    </field></descriptor>
    <descriptor name="p2c_manufacturer" separator="/">
      <field name="ClipMetadata/Device/Manufacturer">
    </field></descriptor>
    <descriptor name="p2c_serialno" separator="/">
      <field name="ClipMetadata/Device/SerialNo.">
    </field></descriptor>
    <descriptor name="p2c_modelname" separator="/">
      <field name="ClipMetadata/Device/ModelName">
    </field></descriptor>
  </object>
</root>

A sample of the XML metadata mapping file structure for MXF import is shown below:

<?xml version="1.0" encoding="utf-8"?>
<root>
  <object type="30" subtype="30">
    <descriptor name="ingest_clip_no" separator="/">
      <field name="EntireNumber">
    </field></descriptor>
    <descriptor name="pd_clip_name" separator="/">
      <field name="ClipId">
    </field></descriptor><descriptor name="xdcam_srcfile" separator="/">
      <field name="SourceFile">
    </field></descriptor>
  </object>
</root>

A sample of the XML metadata mapping file structure for document import is shown below:

<?xml version="1.0" encoding="utf-8"?>
<root>
  <object type="30" subtype="30">
    <descriptor name="poc_assetid" separator="/">
      <field name="asset/assetId">
    </field></descriptor>
    <descriptor name="poc_assettype" separator="/">
      <field name="asset/assetType">
    </field></descriptor>
    <descriptor name="poc_filename" separator="/">
      <field name="asset/fileName">
    </field></descriptor>
    <descriptor name="poc_category" separator="/">
      <field name="asset/category">
    </field></descriptor>
    <descriptor name="poc_season" separator="/">
      <field name="asset/season">
    </field></descriptor>
    <descriptor name="poc_productinfo" separator="/">
      <field name="asset/productInfo">
    </field></descriptor>
    <descriptor name="poc_priority" separator="/">
      <field name="asset/priority">
    </field></descriptor>
  </object>
</root>

A sample of the XML metadata mapping file structure for AVC HD import is shown below:

<?xml version="1.0" encoding="utf-8"?>
<root>
   <object type="30" subtype="30">
     <descriptor name="ingest_clip_no" separator="/">
       <field name="EntireNumber">
     </field></descriptor>
     <descriptor name="pd_clip_name" separator="/">
       <field name="ClipName">
     </field></descriptor>
     <descriptor name="xdcam_srcfile" separator="/">
       <field name="SourceFile">
     </field></descriptor>
     <descriptor name="title" separator="/">
       <field name="//VideoClip/Title">
     </field></descriptor>
     <descriptor name="creator" separator="/">
       <field name="//VideoClip/Creator">
     </field></descriptor>
     <descriptor name="clip_description" separator="/">
       <field name="//VideoClip/Description">
     </field></descriptor>
     <descriptor name="device_manufacturer" separator="/">
       <field name="//VideoClip/Device/Manufacturer">
     </field></descriptor>
     <descriptor name="device_serialno" separator="/">
       <field name="//VideoClip/Device/SerialNo">
     </field></descriptor>
     <descriptor name="device_modelname" separator="/">
       <field name="//VideoClip/Device/ModelName">
     </field></descriptor>
     <descriptor name="device_firmversion" separator="/">
       <field name="//VideoClip/Device/FirmVersion">
     </field></descriptor>
     <descriptor name="location_altitude" separator="/">
       <field name="//VideoClip/Location/Altitude">
     </field></descriptor>
     <descriptor name="location_longitude" separator="/">
       <field name="//VideoClip/Location/Longitude">
     </field></descriptor>
     <descriptor name="location_latitude" separator="/">
       <field name="//VideoClip/Location/Latitude">
     </field></descriptor>
     <descriptor name="location_source" separator="/">
       <field name="//VideoClip/Location/Source">
     </field></descriptor>
     <descriptor name="location_placename" separator="/">
       <field name="//VideoClip/Location/PlaceName">
     </field></descriptor>
   </object>
</root>

A sample of the XML metadata mapping file structure for XDCAM import is shown below:

<?xml version="1.0" encoding="utf-8" ?>
<root>
  <object type="30" subtype="30">
    <descriptor name="ingest_clip_no" separator="/">
      <field name="EntireNumber">
    </field></descriptor>
    <descriptor name="xdcam_clipid" separator="/">
     <field name="ClipId">
    </field></descriptor>
    <descriptor name="xdcam_umid" separator="/">
     <field name="UmId">
    </field></descriptor>
    <descriptor name="xdcam_title" separator="/">
     <field name="NonRealTimeMeta/Title^usAscii">
    </field></descriptor>
    <descriptor name="xdcam_lastupdate" separator="/">
     <field name="NonRealTimeMeta^lastUpdate">
    </field></descriptor>
    <descriptor name="xdcam_duration" separator="/">
     <field name="NonRealTimeMeta/Duration^value">
    </field></descriptor>
    <descriptor name="xdcam_creationdate" separator="/">
     <field name="NonRealTimeMeta/CreationDate^value">
    </field></descriptor>
    <descriptor name="xdcam_videocodec" separator="/">
     <field name="NonRealTimeMeta/VideoFormat/VideoFrame^videoCodec">
    </field></descriptor>
    <descriptor name="xdcam_formatfps" separator="/">
     <field name="NonRealTimeMeta/VideoFormat/VideoFrame^formatFps">
    </field></descriptor>
    <descriptor name="xdcam_aspectratio" separator="/">
     <field name="NonRealTimeMeta/VideoFormat/VideoLayout^aspectRatio">
    </field></descriptor>
    <descriptor name="xdcam_manufacturer" separator="/">
     <field name="NonRealTimeMeta/Device^manufacturer">
    </field></descriptor>
    <descriptor name="xdcam_modelname" separator="/">
     <field name="NonRealTimeMeta/Device^modelName">
    </field></descriptor>
    <descriptor name="xdcam_serialno" separator="/">
     <field name="NonRealTimeMeta/Device^serialNo">
    </field></descriptor>
    <descriptor name="xdcam_creator" separator="/">
     <field name="NonRealTimeMeta/Creator^name">
    </field></descriptor>
    <descriptor name="xdcam_description" separator="/">
     <field name="NonRealTimeMeta/Description">
    </field></descriptor>
  </object>
</root>

Having set up all the parameters, press "OK" to create the new mapping schema. If the selected XML file is not valid for the metadata mapping, the following error message appears:

Error_XML_must_be_set

Editing a Schema

edit_button

To edit the existing mapping schema type select the required one and press the "Edit…" button. The following dialog box appears:
Schema editing_xml

In the "Descriptor relations" field you can manually edit relations represented as the XML formatted text.

Export button

Having set up all the relations, press the "Export…" button to save the XML file in the desired location.

Import button

It is also possible to import the existing XML file using the "Import…" button.

Deleting a Schema

delete_button

To delete an existing mapping schema type press the "Delete" button; the following confirmation window appears:
Delete_schema_type