PHP Classes

File: docs/en/user-guide/associations.md

Recommend this page to a friend!
  Classes of alex nov   KennerPIM   docs/en/user-guide/associations.md   Download  
File: docs/en/user-guide/associations.md
Role: Auxiliary data
Content type: text/markdown
Description: Auxiliary data
Class: KennerPIM
Product information management application
Author: By
Last change:
Date: 1 year ago
Size: 7,090 bytes
 

Contents

Class file image Download

Associations

Association ? a type of the relationship between products, where one in some way is dependent on the other one(s), or can influence the other one(s) in accordance with different marketing strategies (e.g cross-sell, up-sell, etc.). Associations can be either one-way (Product A is associated with Product B, but not otherwise), or two-way (if Product A is associated with Product B, then Product B is associated with Product A).

Associations can be activated and deactivated. Deactivated associations cannot be used in the system, i.e. all records of the associated products will not be transferred via any channel.

Association Fields

The association entity comes with the following preconfigured fields; mandatory are marked with *:

| Field Name | Description | |--------------------------|-----------------------------------| | Active | Activity state of the record | | Name (multi-lang) * | Association name, e.g. ?ross-sell | | Backward association | Backward association name | | Description (multi-lang) | The aim of this association usage |

> If the multi-languages settings are activated, but multilingual fields are missing for the association entity, or if you want to make changes to the association entity (e.g. add new fields, or modify association views), please, contact your administrator.

Creating

To create a new association record, click Associations in the navigation menu to get to the association records list view and then click the Create Association button. The common creation window will open:

Associations creation

Here enter the association name and description (optional); activate the new association, if needed. Define its backward association using the corresponding select button. Click the Save button to finish the association record creation or Cancel to abort the process.

Alternatively, use the quick create button on any KennerPim page and fill in the required fields in the association creation pop-up that appears:

Creation pop-up

For more details on backward associations, please, refer to the Associated Products article in this user guide.

Listing

To open the list of association records available in the system, click the Associations option in the navigation menu:

Associations list view page

By default, the following fields are displayed on the list view page for association records: - Name - Backward association - Active

To change the association records order in the list, click any sortable column title; this will sort the column either ascending or descending.

Association records can be searched and filtered according to your needs. For details on these options, refer to the Search and Filtering article in this user guide.

To view some association record details, click the name field value of the corresponding record in the list of associations; the detail view page will open showing the association records and the records of the related entities. Alternatively, use the View option from the single record actions menu to open the quick detail pop-up.

Mass Actions

The following mass actions are available for association records on the list view page: - Remove - Mass update - Export

Associations mass actions

> If any option is missing in your mass actions menu, please, contact your administrator.

For details on these actions, please, see the Mass Actions section of the Views and Panels article in this user guide.

Single Record Actions

The following single record actions are available for association records on the list view page: - View - Edit - Remove

Associations single record actions

> If any option is missing in your single record actions menu, please, contact your administrator.

For details on these actions, please, refer to the Single Record Actions section of the Views and Panels article in this user guide.

Editing

To edit the association, click the Edit button on the detail view page of the currently open association record; the following editing window will open:

Associations editing

Here edit the desired fields and click the Save button to apply your changes.

Besides, you can make changes in the association record via in-line editing on its detail view page.

Alternatively, make changes to the desired association record in the quick edit pop-up that appears when you select the Edit option from the single record actions menu on the associations list view page:

Edit option

Removing

To remove the association record, use the Remove option from the actions menu on its detail view page

Remove1

or from the single record actions menu on the associations list view page:

Remove2

The record removal operation has to be confirmed in the pop-up that appears:

Association removal confirmation

By default, it is not possible to remove the association, if there is any product associated with it. In this case, the following error message appears:

Error msg

Duplicating

Use the Duplicate option from the actions drop-down menu to go to the association creation page and get all the values of the last chosen association record copied in the empty fields of the new association record to be created. Modifying the association code is required, as this value has to be unique.

Working With Associated Products

Associated products are displayed on the ASSOCIATED PRODUCTS panel within the product detail view page and include the following table columns:

- Related product - Association

Associated products panel

KennerPim also offers you the ability to add associations to all the products (or as many as needed) simultaneously via the mass actions menu.