Individual settings for auto path resolution in master or supplier catalogs.

Master catalog

If you use MasterCatalog.assignmentMode=REFERENCE or you want to perform auto path resolution of post import mode for structure group, consider the following properties; otherwise, these properties will be ignored.

Property

Description

MasterCatalog.referenceAssignment.orderOfResolve

The following 4 types of reference path can appear in the PIM Core system:

/1234/test.jpg -- path includes only slash and starts with slash
\1234\test.jpg -- path includes only backslash and starts with backslash
1234/test.jpg -- path includes only slash and does not start with slash
1234\test.jpg -- path includes only backslash and does not start with backslash

When trying to assign a digital asset to a catalog object, the source file name(from the "AssignDocument" message or from connector API by post import mode) will be taken, and converted in the format of the first number of the orderOfResolve property. Then objects in the catalog which have an assigned multimedia document identifier with this formatted value will be searched for. If none is found for current format, the next format will be tried.

Default value

1;3;4;2

MasterCatalog.referenceAssignment.stopResolveAfterMatch

If you are sure that always the same format is used, you can set stopResolveAfterMatch to true and the system sticks to the first format with which an object is found.

true --> stop further resolve, because one type is matched.
false --> resolve all types which are defined in "orderOfResolve", even if a type is matched.

Default value

true

Supplier catalog

If you use "SupplierCatalog.assignmentMode=REFERENCE", consider following properties. The meaning of the properties is the same as for Master catalog.

SupplierCatalog.referenceAssignment.orderOfResolve=1;3;4;2
SupplierCatalog.referenceAssignment.stopResolveAfterMatch=true

Common settings for auto path resolution

Property

Description

ReferenceAssignment.postImportMode.fetchWholeCatalogPercentage

This property will be considered only for the auto path resolution of post import mode, and only for imported item, product or variant object, NOT for structure group!

This property determines when to ask Media Manager for a full information(= fetch all digital assets of the catalog with the given id) or when to ask for information of digital assets assigned to the given list of filenames.
The value 50 means that in a catalog with 100 catalog data items (not necessarily digital assets!) at least 51 digital assets need to have changed (or be new) to trigger a full fetch. If there are less changed digital assets a list of the changed filenames will be send to the Media Manager.

No research has taken place which value works the most efficient.

Default value

50

ReferenceAssignment.resolveForStructureGroup

This property indicates whether the auto path resolution should be performed also for StructureGroup. Its default value is false, and it must be set as true, If the media asset of StructureGroup should be automatically resolved.

Default value

false

Auto path resolution for StructureGroup

Since PIM 7.0.03.00 the auto path resolution can be also performed for StructureGroup with a limited capacity.

By catalog data first mode

By this mode the corresponding structure group is imported first in PIM, then the asset is uploaded in Media Manager. For that the following conditions(or adjustment) have to be filled:

Set ReferenceAssignment.resolveForStructureGroup as true
And depending on to which catalog the corresponding media asset document belongs, one of the MasterCatalog.assignmentMode and SupplierCatalog.assignmentMode must be set as REFERENCE, then an auto path resolution for StructureGroup will be considered, otherwise it will be ignored.

MasterCatalog.assignmentMode = REFERENCE

or/and

SupplierCatalog.assignmentMode = REFERENCE

The following table indicates the all possible combinations of settings.

MasterCatalog.assignmentMode	SupplierCatalog.assignmentMode	result
REFERENCE	NONSUPPORT	Can be resolved with uploaded asset in master catalog(via PIM Desktop or Media Manager application)
AUTO	NONSUPPORT	x
NONSUPPORTED	NONSUPPORT	x
REFERENCE	REFERENCE	Can be resolved with uploaded asset in master catalog(via PIM Desktop or Media Manager application) or supplier catalog(via Supplier Portal)
AUTO	REFERENCE	Can be resolved with uploaded asset in supplier catalog(via Supplier Portal)
NONSUPPORTED	REFERENCE	Can be resolved with uploaded asset in supplier catalog(via Supplier Portal)
REFERENCE	AUTO	Can be resolved with uploaded asset in master catalog(via PIM Desktop or Media Manager application)
AUTO	AUTO	x
NONSUPPORTED	AUTO	x

By post import mode

By this mode the corresponding structure group is imported in PIM later, after the asset is uploaded firstly in Media Manager. For that the ReferenceAssignment.resolveForStructureGroup should be set as true.

The auto path resolution of post import mode can be performed for StructureGroup without the previous limitation. That mean, the file name(NOT source file name) as reference which is assigned to a SturctureGroup can be resolved to an asset of master catalog from Media Manager, without assigning the same reference to any article(/product/variant) in the same import process. The corresponding connector API will fetch an asset of master catalog from Media Manager database according to file name. If multiple matches for a given file name are found, only the one asset get returned which fulfills the conditions:

It is current version
its creation date is latest