Fill complex article tables automatically

The SAWSConnector suite includes an active job that performs complex article assignments (variants, bundles, etc.). Like any active job, it can be automated to perform these assignments regularly in the background. This article covers how to configure said active job.

Preparation

The active job logic separates the PIM items into the parent product to which other products are assigned to and the assigned products, better known as variant heads and variants. Complex articles can be used for more relations than the variant head to variant relation, but for the sake of simplicity these names will be used for the rest of the article.

The active job uses PIM Favorites to separate variant heads and variants. The search filters of the favorites will vary per system but the search criteria “Folder” and “Main class” are often used for the differentiation. Since the variants of a variant product are the only, real purchasable products often the product number can also be used as a criteria. The root node in which the favorite is created does not matter because the active job logic overwrites it anyway.

Configuration

Head into your active jobs. Create an active job and select “SAWS – Fill complex article tables automatically” in “Script”.

Then configure the following options as needed. The will be listed and explained here.

Search objects via Elasticsearch

Controls whether objects will be searched via the underlying Elasticsearch of your PIM. The Elasticsearch is much faster than the default PIM database search but can be outdated. If you are satisfied with the results, you can turn this on.

PIM root folders

Defines the PIM trees in which the complex article assignment shall be performed.

Filter of the products

Controls the method by which the products shall be searched. Select “Filter of the products by favorites” here. “Filter of the products by classes and stations” is a legacy option for older PIM systems and offers far less flexibility.

Bookmark for complex products

Select your previously created bookmark here that contains the variant heads. The active job will then search with the bookmark set in “Bookmark for simple products / variants” for variants to be assigned. The variants must lie below the head in the product tree.

Bookmark for simple products / variants

Select your previously created bookmark here that contains the variants.

Select the action to be carried out if a product cannot be found as a child in the table anymore

Controls what action to take with existing variants that have become invalid because the favorite does not find them anymore.

Main Variant Maintenance

Controls which variant shall be set as a main variant in the assignment.

Type of the relation (set, bundle, accessories, etc…)

(Since version 1.17.0)

The relation type enables the population of multiple complex article tables for example for bundles and variation relations. The type to set is controlled with this option.

Set the following attribute values fixed for all found complex products

With this option product attribute values can be populated for the found variant heads. Warning: These are permanent changes in the product data! (This option is optional.)

Set the following attribute values fixed for all found simple products

With this option product attribute values can be populated for the found variants. Warning: These are permanent changes in the product data! (This option is optional.)

Execute Checkout & Checkin on the affected Products

By default, the populated product attribute values of the previous two options are set without a checkout & checkin to avoid creating an excessive processing load on your system. The checkout & checkin can be enabled by this option. This causes data quality rules that trigger on checkin to trigger as well.

Job runs in “dry run”

Enables the active job to run in dry run, meaning not executing any real changes in your PIM and just logging the results. This option is intended to be only temporarily enabled since it effectively disables the job.

Was this article helpful?

1 1

How can we improve this article?

Please submit the reason for your vote so that we can improve the article.

Name

Email

Submit