Each mapping has a set of attributes that determine how the mapping behaves. 

Mapping direction

Determines if Picturepark writes XMP values from a file to a metadata field in Picturepark, from Picturepark to an XMP field or in both directions. 

You cannot select fields for mapping without selecting the direction first.

XMP to Metadata will only write to Picturepark on upload. Updates in Picturepark will not be written back to the XMP field. This may be useful for technical information about the file (EXIF), usage, as well as information that is managed and administered in the files. 

Metadata to XMP will only write to the file on download. Updates to the XMP values in the file followed by a file update in Picturepark will not be updated in Picturepark. This may be useful for automatic AI tagging, product keywords and other metadata values that are much better managed and administered in Picturepark. 

Both will write from the file to Picturepark on upload and from Picturepark to the file on download. This is the most common direction for metadata management as all XMP values from the file are available in Picturepark where they are administered and updated. 

XMP field

The supported XMP or EXIF field of the standard, available in the file that holds the value. 

We are using exiftool.org which supports the following file types. The supported namespaces include schemas like Dublin Core (dc)Photoshop Camera Raw Schema (crs), PDF (pdf), XMP Dynamic Media (xmpDM), xmp Media Managementment (xmpMM), Plus (plus), Exif (EXIF) and various others. Please consult with your Picturepark responsible for the validation of your requirements. 

Example: 

  • XmpMetadata.dc.subject is the property "Subject" from Dublin Core within XMP. 

  • XmpMetadata.xmpMM.derivedFrom.manager is the property "Manager" as part of the section "derivedFrom" from XMP Media Management within XMP. 

Metadata field

A Metadata Field in Picturepark is field added to Schemas or availalbe on File Types (Content Schemas) which hold metadata values. The fields are displayed as fieldpath which has the syntax layerId.fieldId. For File Types the syntax is fileType.fieldId. 

The fields on File Types (e.g. DocumentMetadata.publisher) are only available for the direction "Metadata to XMP" as the file-specific fields of images, audio, vectors, documents, or videos are read-only in Picturepark and cannot be updated. 

* If you select a tagbox additional tagbox lookup settings are required, listed below.

Tagbox lookup configuration*

(tagbox only)

The tagbox lookup configuration allows selecting the connected List field of the tagbox that Picturepark will check. If the XMP value is found in the List the tag will be assigned on import. The matching is done based on the key field. 

Example: 

  • Picturepark will consider tagbox mappings with some additional logic.

  • For mappings to tagboxes, Picturepark splits the XMP values "Metadata, XMP Mapping" by comma and space into single terms.

  • Picturepark will then search those terms in the set of tags available for the tagbox (filters will be respected). 

  • If the terms are found in the key field the tags will be assigned. 

On export, the Display Pattern Name of the List is written into the XMP field (for direction Both). 

When several tags are written from Picturepark into an XMP field in the file the tags are concatenated with comma and space. 

Key fields*

(tagbox only)

The field of the List that is connected to the selected tagbox. Picturepark will generate a cache from the values of this field and compare XMP values to it. 

You can concatenate lookup fields by adding multiple fields as key fields. When you configure two key fields e.g. "product code" and "product name" the XMP value must contain both values e.g. CODE456-PRODUCT. 

When you want to lookup different translations each translation is one field, so for a lookup in German and English you must create two mappings. If you try to add name.de and name.en both as key fields you will get the concatenated value e.g. name.en:Apple and name.de:Apfel will become “AppleApfel” which you will probably not find in your List.

Case sensitive*

(tagbox only)

Checkbox determines if the terms of XMP value and tagbox values that are matched should be considered as case sensitive. 

Example: 

  • Case sensitive true: summer in XMP will not match Summer in Tagbox

  • Case sensitive false: summer in XMP will match Summer in Tagbox

Include all child schemas*

(tagbox only)

This allows us to include all child schemas of a List e.g. Products to map to the child "Merchandise Products". 

Priority

If you have more than one mapping defined for a field the Priority determines in which order the values are written. 

You can map two values to the same field without setting a priority. Then the order of mappings is not defined and any value could come first.

When mapping two values to the same field provide a priority!

Stop

If you have more than one mapping defined for a field Stop determines whether Picturepark should only write the first value or continue to write all values, concatenating them with comma.