The default function in STEP is that attributes shown in the editor of a product are displayed in alphabetical order. However, if a Display Sequence Attribute has been set up, the attributes shown in the editor are sorted according to the value of the Display Sequence attribute.
Important: The Display Sequence Attribute has no impact on the order in which attributes are exported.
Display Sequence Attribute Setup
This section describes how you can set up the STEP Workbench so that the attributes shown in the product editor display according to the order set in the Display Sequence Attribute.
Before using a display sequence attribute, you must verify that 'Manual Sorting' is not selected on the attribute groups in which the relevant attributes are contained. If enabled on an attribute group, the Manual Sort option will overwrite any attribute sequences you configure. To check if the manual sorting is enabled, select the relevant attribute group in System Setup as shown below.
Set Up Display Sequence Attribute
A Display Sequence Attribute is a description attribute that dictates how other attributes will be ordered in an object editor. To configure a Display Sequence Attribute, it must:
- be a Description attribute.
- be a single-valued attribute. Refer to the Single and Multi-Valued Attributes topic here.
- have a Validation Base Type of either number or integer.
- be valid for the link type Product attribute validation and/or valid for the object type Attribute.
To create this type of attribute, refer to the Creating Attributes topic here.
Select the display sequence attribute in System Setup > Users & Groups > System Settings tab > Product Information Manager Default Settings flipper > Default Attribute to use as Attribute Display Sequence Attribute.
Similarly, select the display sequence for the product variant object types in System Setup> Users & Groups > System Settings tab > Product Information Manager Default Settings flipper > Attribute indicating the Priority of Product Variant Attributes.
View Menu: Choose Display Sequence Attribute
By default, users are able to select a display sequence attribute. However, if admin users want to prevent specific users from making this selection, they may disable this privilege by making a change to the user group that contains the relevant users as follows:
- In System Setup, expand Users & Groups, then select the relevant User Group.
-
Select the GUI Set-Up tab, and under the Menu Contents flipper locate the Choose User Display Sequence Attribute option.
- Set the Choose User Display Sequence Attribute radio button to Off'. By default it is set to 'On'.
For more information on how to use the Display Sequence Attribute, refer to the Default Attribute to use as Display Sequence Attribute heading within the Product Information Manager Default Settings topic of the System Setup documentation here.
Sorting Attributes
Once the display sequence attribute has been set up, a user can establish the sorting. The attributes shown in the product editor are sorted according to the order set in the display sequence attribute. This can be done in two ways:
- Set a number in the Display Sequence field of the attribute itself
- Set a number in the Display Sequence column under Linked Attributes
Setting a display sequence number on the attribute
-
In System Setup, expand Attribute Groups, then click the relevant attribute. An Attribute editor displays.
- In the Display Sequence field, type the desired number for each attribute in an attribute group. The lower the value, the higher priority it will have compared to other attributes. For example, an attribute with the value of 10 will always have priority over an attribute with the value of 20. Attributes without a display sequence value will display alphabetically after the prioritized attributes.
Note: If you do not know which attribute on your system is set up as the display sequence attribute, go to System Setup > Users & Groups > and verify the name of the attribute under Default Attribute to use as Attribute Display Sequence Attribute. Alternatively, in Tree, view a product, click the References tab. Under Linked Attributes, the first column shows the display sequence attribute on your system.
Setting a display sequence number under Linked Attributes
- In the Tree, expand the Product Hierarchy and then click the relevant product folder or product.
- Click the References tab.
-
Open the Linked Attributes from Product Hierarchy flipper, type a number in the cell related to the display sequence attribute column in front of the relevant attribute, as shown below.
Note: The display sequence attribute column can only be edited if the attribute is linked in at the product hierarchy level you have selected. The Inherited from column shows where the attribute is linked in. An attribute can be linked in to one or more attribute groups. In the Attribute Groups column, you can identify to which attribute group(s) the attribute belongs.
- Optionally, if you want to override the display sequence displayed at the level you have selected, right-click the relevant row and click Create Local link. You are now able to type a local value in the display sequence column.
The symbol will change in the inherited column and also the background color of the row will change from yellow to white. You are now able to type a local value in the Display Sequence column.
Attributes that have no sequence number, are alphabetically sorted and will be placed last on the list.
Important: Information about the display sequence of attributes is exported in an XML file. If the display sequence number is set on the attribute itself, the XML export will contain the attributes with display sequence attribute value. If the display sequence number is set on the attribute link, the XML export will contain the display sequence information on the attribute links. A combination of the two is possible.
Selecting a Personal Display Sequence Attribute
If you are interested in sorting attributes in the product editor on a different display sequence attribute than the one set in System Setup >Users and Groups> Default Attribute to use as Display Sequence Attribute, do the following:
- Go to View > Choose User Display Sequence Attribute.
A Select User Display Sequence Attribute dialog box displays.
- Select an attribute and click OK.
In Tree, select a product object and select the References tab. The first column under Linked Attributes displays your personal display sequence attribute.
Display Sequence Attribute and the Product Editor Display
In the product editor, within an Attribute Group, the attributes are sorted on the display sequence attribute. If no display sequence attribute is set, the attributes are shown in alphabetical order.
- Hover over the attribute name and a tool tip displays.
- The Attribute ID and the display sequence attribute is shown.
Note: When selecting two or more products, the product editor will show the attributes in alphabetical order since it is possible to select two or more products with the same attributes but with different values for the display sequence attribute.
Display Sequence Attribute and Classifications
Your system can be set up to display the display sequence attribute at the classification level.
- In the Tree, navigate to a classification and select a folder.
- Click the References tab.
A display sequence attribute column is shown in the Attributes flipper.
Important: Maintaining attribute display sequence in this area as no effect in either the classification editor or an export.
Setting the Priority of a Product Variant Attribute
- In the Tree, select the parent containing the product variants.
- Click the References tab.
- Under Linked Attributes, type a number in the column for the Attribute indicating the Priority of Product Variant Attributes attribute specified in the User and Groups under the Product Information Manager Default Settings flipper.
- Enter the display sequence values in the column related to the respective attributes.
Display Sequence Attribute and Tables
You can use the display sequence attribute to sort attributes within attribute groups in tables. For more information, refer to the Tables documentation here.
Shown in the screenshot below, in the Sort On parameter, select the display sequence attribute that will determine the order in which the attributes within an attribute group will show in a table.
Setting the Attribute Display Sequence on Publication (Green) Hierarchy Objects
Metadata (or description) attributes on publication hierarchy objects (publication groups, publications, sections, and planned pages) may also be sequenced using a display sequence attribute.
Because publication hierarchy objects do not use reference types, attribute sequencing cannot be set from a 'Linked Attributes' flipper on the References tab. Instead, metadata attribute sequencing must be set up at the attribute level. However, attributes may be multi-selected to allow sequencing from a single location.
