Individual settings for auto assignment in master or supplier catalogs.

Master catalog

If you choose AUTO for the Master catalog the following properties must be set (otherwise they are ignored):

Property	Description
MasterCatalog.autoAssignment.separator	The character which is used to separate components of information (identifier, language, ... )of file name. Not allowed: the ".", the file's suffix and all forbidden charactors of filename: "\", "/", ":", "*", "?", """, "<", ">", "\|". Default value _
MasterCatalog.autoAssignment.defaultValue.objectType	ObjectType is the type of repository object the identifier refers to. In the master catalog of the standard PIM Core this could be "Product", "Article" or "Variant". Example Article
MasterCatalog.autoAssignment.index.objectType	It will be ignored, if the property "MasterCatalog.autoAssignment.defaultValue.objectType" is already set with a value. If no default value is defined to "MasterCatalog.autoAssignment.defaultValue.objectType", then this property must be set as the index which is 1-based and tells where the object type is encoded in the filename. Example 1
MasterCatalog.autoAssignment.index.objectIdentifier	The ObjectIdentifier is the alphanumeric, unique identifier of the object the document should be assigned to. The identifier has to always be a part of the filename, so you have to predefine the index. The index is 1-based. Example 2
MasterCatalog.autoAssignment.defaultValue.mediaAssetType	Media asset type is used to qualify the Media Asset linked with the object specified ( for example: "normal", "thumbnail", ...) Example normal
MasterCatalog.autoAssignment.index.mediaAssetType	It will be ignored, if the property "MasterCatalog.autoAssignment.defaultValue.mediaAssetType" is already set with a value. If no default value is defined to "MasterCatalog.autoAssignment.defaultValue.mediaAssetType", then this property must be set as the index which is 1-based and tells where the media asset type is encoded in the filename. Example 3
MasterCatalog.autoAssignment.defaultValue.mediaAssetLanguage	Media Asset Language is used to qualify the Media Asset linked with the object specified. (values in case of german: "de", "deu", "ger" or "7") Example de
MasterCatalog.autoAssignment.index.mediaAssetLanguage	It will be ignored, if the property "MasterCatalog.autoAssignment.defaultValue.mediaAssetLanguage" is already set with a value. If no default value is defined to "MasterCatalog.autoAssignment.defaultValue.mediaAssetLanguage", then this property must be set as the index which is 1-based and tells where the media asset language is encoded in the filename. Example 4
`MasterCatalog.autoAssignment.defaultValue.mediaAssetPriority`	This parameter should be set only if the Field MediaAsset.Priority and the corresponding logical key are activated, otherweis it will be ignored. If it should be considered, a default value must be predefined and only a numerical value is allowed. Media Asset Priority is used to qualify the Media Asset linked with the object specified. Example 1

Since all currently known PIM Core <-> Media Manager installations work with the generation of derivatives, the quality is not configurable and not encoded in the filename of the digital asset. OriginalImage is implicitly used as value.

Following examples show you how to set the corresponding properties according to the different image file name. The property for mediaAssetPriority is in examples not considered, since it is default deactivated, but you can use it similar to the property defaultValue.mediaAssetType, if it is activated.

Example1:

MasterCatalog.autoAssignment.separator=_ 
MasterCatalog.autoAssignment.defaultValue.objectType=Article
MasterCatalog.autoAssignment.index.objectIdentifier=2
MasterCatalog.autoAssignment.index.mediaAssetType=1
MasterCatalog.autoAssignment.index.mediaAssetLanguage=3

With the configuration shown above, the corresponding items will be assigned with the images which might differ in their type (e.g. normal and thumbnails) and language.

normal_KK12345_de.jpg

normal_KK12345_en.jpg

thumbnail_KK12345_de.jpg

thumbnail_KK12345_en.jpg

normal_TT333_de.jpg

Example2:

The most simple configuration would be that one where the name of the image (exclusing the '.' and the suffix) represents the item number:

MasterCatalog.autoAssignment.separator=_
MasterCatalog.autoAssignment.defaultValue.objectType=Article 
MasterCatalog.autoAssignment.index.objectIdentifier=1
MasterCatalog.autoAssignment.defaultValue.mediaAssetType=normal 
MasterCatalog.autoAssignment.defaultValue.mediaAssetLanguage=de

With the configuration shown above, the corresponding items will be assigned with the images for the "normal" media asset type and the "german" language.

AA12345.jpg

AA99999.jpg

Supplier catalog

If you choose AUTO for supplier catalogs the following properties must be set. The meaning of the properties is the same as for Master catalog.

SupplierCatalog.autoAssignment.separator=_
 
SupplierCatalog.autoAssignment.defaultValue.objectType=
SupplierCatalog.autoAssignment.index.objectType=1
 
SupplierCatalog.autoAssignment.index.objectIdentifier=2
 
SupplierCatalog.autoAssignment.defaultValue.mediaAssetType=
SupplierCatalog.autoAssignment.index.mediaAssetType=3
 
SupplierCatalog.autoAssignment.defaultValue.mediaAssetLanguage=
SupplierCatalog.autoAssignment.index.mediaAssetLanguage=4
 
SupplierCatalog.autoAssignment.defaultValue.mediaAssetPriority= 1

Common settings for auto assignment

Since the PIM 7.0.04.00 the following new configurations are added in hmm.properties, which specify the ID of the corresponding extension point contribution for ObjectFinder and Assigner to perform the auto assignment with desired implement. If the contribution could not be found, server start is aborted.

Property

Description

AutoAssignment.objectFinder

This property defines the objectFinder which will find the corresponding PIM object(s) to be assigned with the media asset. The identifier of desired objectFinder is defined in its plugin.xml, see the Extension point com.heiler.ppm.mediaasset.server.opasg.objectFinder.

Default value

standardCaseInsensitiveObjectFinder

AutoAssignment.assigner

This property defines the assigner which will be used to perform the auto assignment to the found PIM object(s). The identifier of desired assigner is defined in its plugin.xml, see the Extension point com.heiler.ppm.mediaasset.server.opasg.assigner.

Default value

standardAssigner