Installation, configuration and execution

Contents

Create the workflows in Media Manager

The corresponding workflows have to be firstly created in the Media Manager. You can import the sample workflows which are located in [plugins]\com.heiler.ppm.mediaasset.server.opasg\exampleworkflows.

To deal with the Media Manager workflow manager please reference the coresponding chapter of the user manaual of the Media Manager. In short, you must open the application "Workflow Manager - Informatica Media Manager", then select "Master data" -> " Management of WorkFlows", then click at the icon images/download/attachments/29818969/HMM_WM_ImportIcon.JPG which allows you to import a workflow definition(e.g. the sample workflow "AssignDocs.xml").

Configurations at PIM Server

Currently the global configurations are defined in the com.heiler.ppm.configuration.server\conf\hmm.properties

General

Define individual assignment mode for master and supplier catalogs

Property

Description

MasterCatalog.assignmentMode

Define the assignment mode for master catalog.

Default value

AUTO

SupplierCatalog.assignmentMode

Define the assignment mode for supplier catalog.

Default value

REFERENCE

An assignment mode must be chosen for the master catalog and for (all) supplier catalogs. Possible values are(attention: written in capitals!):

  1. NONSUPPORT: supports neither automatic assignment nor resolving the imported file path

  2. AUTO: supports automatic assignment via the encoded file name (Auto Assignment)

  3. REFERENCE: supports resolving the imported file path (Auto Path resolution by Reference)

If the assginment mode is supported(AUTO or REFERENCE), then please visit the corresponding sub chapter for detailed configurations of selected assignment mode: Configuration for Auto Assignment or Configuration for Auto path resolution by reference.

Common configuration for assignment

Following properties are available not only for auto assignment but also for auto path resolution.

Property

Description

Assignment.postImportMode.activated

This property indicates whether the assignment should be also performed by post import mode.

If you are sure that in your workflow the catalog data is always imported first, you can set this property as "false" to turn off the post import step which fetchs the association information form the Media Manager to perform the auto assignment or auto path resolution.

Default value

true

Configuration for Auto Assignment

Configuration for Auto path resolution by reference

Completed examples for configuration

How to perform the assignment

The following table provides an overview to perform the auto assignment by different modes which are officially supported in PIM.

Assignment mode

Master catalog

Supplier catalog(only supported with Supplier Portal)

Structure Group

Auto Assignment

  1. configuration in hmm.properties

    1. set MasterCatalog.assignmentMode = AUTO

    2. adjust other properties as in Configuration for Auto Assignment

  2. restart the PIM Server

  3. perform the actions with supported sequence, then assignment will be created or updated
    Supported sequence for this automatic assignment:

  1. create master catalog PIM object (item/product/variant)

  2. add or modify media asset (depending on configured workflows) not via Supplier Portal

Unsupported sequence(post import mode):

  1. add or modify media asset

  2. create master catalog PIM object

  1. configuration in hmm.properties

    1. set SupplierCatalog.assignmentMode = AUTO

    2. adjust other properties as in Configuration for Auto Assignment

    3. only for post imprt mode: set Assignment.postImportMode.activated = true

  2. restart the PIM Server

  3. perform the actions with supported sequence, then assignment will be created or updated

Supported sequence for this automatic assignment:

  1. create supplier catalog PIM object (item)

  2. upload asset via Supplier Portal (hint: Media Manager hotfolder)

Supported sequence for this automatic assign ment (post import mode):

  1. upload asset via Supplier Portal.

  2. import supplier catalog PIM object (item) via PIM Core or Supplier Portal.

Unsupported

Auto path resolution

  1. configuration in hmm.properties

    1. set MasterCatalog.assignmentMode = REFERENCE

    2. adjust other properties as in Configuration for Auto path resolution by reference

    3. only for post imprt mode: set Assignment.postImportMode.activated = true

  2. restart the PIM Server

  3. perform the actions with the following supported sequence, then the reference will be resolved to a media asset

    reference contains only the asset file name. A reference includes relative path can't be resolved.

    Supported sequence for this automatic assignment:

    1. create master catalog PIM object(item/product/variant) with reference

    2. add or modify media asset (depending on configured workflows) not via Supplier Portal

    Supported sequence for this automa tic assign ment (post import mode):

    1. upload media asset for master catalog in Media Manager

    2. import master catalog PIM object (item/product/variant) with reference via PIM Core

  1. configuration in hmm.properties

    1. set SupplierCatalog.assignmentMode = REFERENCE

    2. adjust other properties as in Configuration for Auto path resolution by reference

    3. only for post import mode: set Assignment.postImportMode.activated = true

  2. restart the PIM Server

  3. perform the actions with the following supported sequence, then the reference will be resolved to a media asset

    reference can contain the asset file name or file name plus relative path.

    Supported sequence for this automatic assignment:

    1. create supplier catalog PIM object (item) with reference.

    2. upload asset via Supplier Portal.

  2. Supported sequence for this automa tic assign ment (post import mode):

  1. upload asset via Supplier Portal.

  2. import supplier catalog PIM object (item) with reference via PIM Core or Supplier Portal.

For first supported sequence for this automatic assignment:

  1. configuration in hmm.properties

    1. set MasterCatalog.assignmentMode or SupplierCatalog.assignmentMode as REFERENCE

    2. adjust other properties for master or supplier catalog as in Configuration for Auto path resolution by reference

    3. set ReferenceAssignment.resolveForStructureGroup = true

  2. restart the PIM Server

  3. perform the actions with the following supported sequence, the reference will be resolved to a media asset

The reference could be different according to the catalog to which the resolved asset belongs:

Master catalog: reference contains only the asset file name. A reference includes relative path can't be resolved.

Supplier catalog: reference can contain the asset file name or file name plus relative path.

  1. create structure group with reference

  2. send JMS message with one of the following actions according to the corresponding catalog to which the resolved asset belongs:

    1. master catalog: add or modify media asset (depending on configured workflows) not via Supplier Portal

    2. supplier catalog: upload asset via Supplier Portal.

For second supported sequence for this automa tic assign ment (post import mode):

  1. configuration in hmm.properties

    1. adjust the corresponding properties for Master catalog as in Configuration for Auto path resolution by reference

    2. set ReferenceAssignment.resolveForStructureGroup = true

    3. set Assignment.postImportMode.activated = true

  2. restart the PIM Server

  3. perform the actions with the following supported sequence, then the reference will be resolved to a media asset of master catalog

    reference contains only the asset file name. A reference includes relative path can't be resolved.

    1. upload media asset for master catalog in Media Manager

    2. import structure group with reference via PIM Core