PHP Classes

File: docs/en/user-guide/attribute-groups.md

Recommend this page to a friend!
  Classes of alex nov   KennerPIM   docs/en/user-guide/attribute-groups.md   Download  
File: docs/en/user-guide/attribute-groups.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: 9,177 bytes
 

Contents

Class file image Download

Attribute Groups

Attribute Group ? a collection of attributes of a certain kind combined together to make it easier for the customer to understand the product and its features better. As an example, the "screen" attribute group for smartphones may combine such attributes as "screen diagonal", "resolution", "type of matrix", "number of touch points", etc. Each attribute may belong to only one attribute group, which is optional.

Attribute Group Fields

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

| Field Name | Description | |--------------------------|--------------------------------------------| | Group name (multi-lang)* | Name of the attribute group (e.g. technical) | | Code * | Unique value used to identify the attribute group. It can only consist of lowercase letters, digits and underscore symbols | | Sort order | Sorting order of the attribute group. With this parameter, attribute groups will be arranged in the appropriate order on the product detail view page | | Description (multi-lang) | Description of the attribute group purpose |

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

Creating

To create a new attribute group record, click Attribute Groups in the navigation menu to get to the attribute groups list view, and then click the Create Attribute Group button. The common creation window will open:

AG creation

Here enter the desired name for the attribute group record being created and its sort order number. its code is automatically generated based on the entered name, but you can change it via the keyboard. The attribute group description is an optional field and can be left empty. Click the Save button to finish the attribute group creation or Cancel to abort the process.

If the attribute group code is not unique, the error message will appear notifying you about it.

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

Creation pop-up

Listing

To open the list of attribute group records available in the system, click the Attribute groups option in the navigation menu:

AP list view page

By default, the following fields are displayed on the list view page for attribute group records: - Group name - Code - Sort order

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

Attribute group 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 attribute group record details, click the name field value of the corresponding record in the list of attribute groups; the detail view page will open. 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 attribute group records: - Remove - Mass update - Export - Add relation - Remove relation

AG 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 attribute group records: - View - Edit - Remove

AG 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 attribute group, click the Edit button on the detail view page of the currently open attribute group record; the following editing window will open:

AG editing

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

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

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

Editing pop-up

Removing

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

Remove1

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

Remove2

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

AG removal confirmation

If you are removing the attribute group that contains related attributes, these attributes will be unlinked from this attribute group.

Duplicating

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

Working With Attributes Related to the Attribute Group

Attributes that are linked to the attribute group record are displayed on its detail view page on the ATTRIBUTES panel and include the following table columns: - Attribute name - Code - Attribute type

Attributes panel

> If this panel is missing, please, contact your administrator as to your access rights configuration. Also, to be able to relate more entities to attribute groups, please, contact your administrator.

It is possible to link attribute records to the attribute group by selecting the existing ones or creating new attributes.

To create a new attribute record, ?lick the + button located on the ATTRIBUTES panel and fill in the fields in the attribute creation pop-up that appears:

AG create attribute

To link the already existing attribute(s) with the open attribute group record, use the Select option from the actions menu located in the upper right corner of the ATTRIBUTES panel. In the pop-up that appears, select one or several attribute records that are not linked to any attribute group and click the Select button to complete the action:

Selecting attributes

To see all attribute records linked to the given attribute group, use the Show full list option:

Show full option

Then the "Attributes" list view page opens, where all attribute records filtered by the given attribute group are displayed:

Attributes full list

Attributes linked to the given attribute group record can be viewed, edited, unlinked, or removed via the corresponding options from the single record actions menu on the ATTRIBUTES panel:

Attributes menu

On this panel, you can also define attribute records order within the given attribute group record via their drag-and-drop:

Attributes order change

The changes are saved on the fly.

To view the attribute record from the ATTRIBUTES panel, click its name in the attributes list. The detail view page of the given attribute will open, where you can perform further actions according to your access rights, configured by the administrator.