Attributes

The Attributes page allows you to create and manage the structure of your Quable PIM content:

The attributes that will contain the majority of the data
The visual organization of these attributes for your users

Quable PIM - Gestion du modèle de données et des attributs de vos produits — Interface de gestion des attributs

The page is divided into three panels:

Le bloc de sélection de l'objet à modifier : Asset, Classification, Document, Variant ou Liaison — The object selection block to modify: Asset, Classification, Document, Variant, or Links

Le bloc de gestion des attributs et de leur affichage dans le PIM — The attribute management block and their display in the PIM

Le bloc de définition de votre type de document ou de vos attribut — The definition block for your document type or attributes

The information displayed in the panels depends on the Object Type selected in the dropdown list at the top of the page.

When you make a selection of an object and optionally a document type or link type, the left block updates and presents you with the structure of your object and its attributes.

👍
Very useful if you have a lot of attributes!
At the top of the attribute listing block, a search space allows you to easily find one of your attributes.

📘
Hold on! Are you talking to me about objects and attributes...
Before you can manage your objects and attributes, it is essential to properly understand what they are and how they are used. You will find a detailed description of these two concepts in the following sections.

Introduction to Objects

Objects are the templates for your product information in Quable PIM. They are used as blueprints to organize and define how your product information is displayed.

A simple way to understand these templates is to think of objects as an Excel spreadsheet describing your products, and attributes are the column headers.

Object Type

To build a solid structure, you need a framework. This is where objects come into play. They define how and where information about your products is displayed.

Quable PIM provides five distinct types of objects:

Object	Description
Classification	Defines the layout for the display of your categories and subcategories.
Documents	Main object type Defines the layout for the display of your product information.
Variants	Defines the attributes displayed for variations of your documents.
Assets	Defines the attributes displayed for your digital asset files (photos, videos, music, etc.).
Links	Defines the kinds of relationships available for your objects.

The different object types work together to form the structure of your data model:

Attribute Organization

Each type of object has its own organization.
To visualize the hierarchy levels of a type of object:

Select a type of object from the Object Type dropdown list.
Click on a level in the tree structure.
The properties of the selected element will be displayed in the right panel

Affichage de la structure d'un type de document et sélection d'un élément de la hiérarchie. — Structure of a document type and selecting an element from the hierarchy.

The displayed hierarchical levels change depending on the organization of your product information. By default, at least four levels are automatically generated when creating your objects in Quable PIM.

👍
The properties for each hierarchy level can be modified to suit your preferences.
Note: Quable PIM does not recommend changing the Code attribute.

The overall process for managing the hierarchy of objects is the same for each object type, but there are some differences. The following sections describe how to manage the hierarchy for each object type.

Presentation of Attributes

As described previously in the Object Overview, objects store information about your products in attributes.

Attributes are the names, descriptions, and any other information contained in your objects that describe your content. You can define different attributes based on the different types of objects.

Attribute Types

Quable PIM provides the following attribute types:

Type	Description
Simple text not localized	A text input field that accepts text that is never translated. Attention: When you fill in the attribute in any language of the PIM, it is automatically copied to all other languages.
Simple text localized	A text input field that accepts a single line of text.
Text area localized	A text input field that accepts multiple lines of text.
HTML code	A text input field that accepts HTML content.
JSON code	A text input field that accepts JSON content.
Integer	A text input field that only accepts numeric content (integer numbers only).
Decimal	A text input field that only accepts numeric content (decimal numbers only).
Date	A text input field that only accepts date content in the format DD/MM/YYYY.
Time	A text input field that only accepts time content in the format HH:MM.
Checkbox	A boolean checkbox (Yes / No).
Simple select of predefined values	A selection field that accepts only one choice from a predefined list.
Select of multiple predefined values	A selection field that accepts multiple choices from a predefined list.

Adding Attributes

Attributes always constitute the last (lowest) level of a hierarchy.

To add an attribute, select an object from the Object Type dropdown menu.
Then click on the last level of the hierarchy where you want to create the new attribute.
Finally, click the Add an Attribute button in the attribute management block.

The Add an attribute form allows you to define specific properties and behaviors for each attribute.

The following properties are available:

Information

Description

Mandatory

Name

Enter a name for the attribute

Yes

Code

Click in the entry area to initiate an auto-generated code for the new attribute.

This can be changed manually. However, in order to avoid conflicts with system keywords and values, the Code value cannot:

1. begin with:
- completeness
- status
- workflow

2. be any of the following:

- active
- attribute_code
- attribute_set_code
- catalog
- checksum
- classification_code
- classification_parent_code
- completeness
- date_created
- date_modified
- document_code"
- external
- asset_classification_code
- asset_code
- asset_name

- mime_type
- original_filename
- sequence
- source_code
- status
- target_code
- thumbnail_url
- tree_left
- tree_right
- sku_code
- url
- value_code
- value_label
- workflow

3. Contain or end with special characters or spaces.

4. Allowed characters in the code can only be of the following types:
- Lowercase letters (a-z)
- Uppercase letters (A-Z)
- Digits (0-9)- Underscore (_)
- Hyphen (-)
- Space ( ) (Note: Codes may contain spaces, but not at the beginning or end of the string.)
- Dots (.)
- Plus (+)

Yes

Description

Enter a definition or an explanation of the attribute.

Help Text

Enter additional text to be displayed when the attribute is hovered over in the object.

Type

Select the attribute type from the dropdown list.

Yes

Attribute Sets

If the attribute is assigned to one or more attribute sets, the attribute is only visible on objects with the designated attribute set(s).

Maximum number of characters accepted

Available for the following attribute type

- Simple text not localized
- Simple text localized
- Text area localized
- HTML code

Define the maximum number of characters allowed in a text area.

Main data

Select the checkbox to display the value of this attribute in the header of the object.

Mandatory

Select the checkbox to specify that the object cannot be saved until this attribute is completed.

If not selected, the attribute is optional and the object can be saved without it.

Filterable (search)

Select the checkbox to specify that the attribute can be used as a filter in an advanced search.

If not selected, the attribute is not available as a filter for an advanced search.

Visible (internal)

Check the box to specify that the attribute is visible in the PIM, by default.
This behavior can be overridden at the
"h-1": "Description",(doc:attribute-access level.

Editable (internal)

Check the box to specify that the attribute is editable in the PIM, by default.
This behavior can be overridden at the
"h-1": "Description",(doc:attribute-access level.

Once you have entered the attribute's property values, click the Apply button to save the attribute or the Delete button to cancel the creation of a new attribute.

Find out the Quick Look tutorial video:

Quick Look - Add an attribute in a document

Attribute Localization

You can locate the properties of your attributes in all PIM interface languages. This translation allows you to adapt the labels of attribute properties according to the different PIM interface languages. To localize attributes, click on the globe icon to the right of the input field.

A pop-up appears, allowing you to enter values in all the interface languages of the PIM:

Once you have entered the attribute property translations, click the Apply button to save or the Cancel button to discard the creation.

Editing Attributes

You can modify the attributes of an object at any time. To modify an attribute:

Select an object from the Object Type dropdown list.
Then, in the left-hand management block, select the attribute you want to modify.
In the right-hand block, modify the properties of the attribute.

To manually add a value to a single-choice or multiple-choice attribute:

Select the attribute to be modified as previously indicated.
In the Predefined Values section, click the Manage values for this attribute button, a pop-up will appear. Fill in the fields:
- Enter the unique code for the value.
- Click the + Add a value button.
- In the Name field, enter the label for the value that will be visible on the product sheet for each location of your data languages.
- In the Description field(s), you can provide a descriptive text (optional) only visible in the back office for each location of your data languages.
- Click Close, the changes will be automatically saved.

Click on the Launch Indexing button above the attributes section, then click on Continue.

Find out our Quick Look tutorial:

Moving Attributes

To change the position of an attribute in your data model, select the attribute, hold down the key, and move it to the desired location.

Find out the Quick Look tutorial video:

Quick Look - Move an attribute in a document

Deleting Attributes

To delete an attribute, select an object from the Object Type dropdown list.

Choose the attribute to be deleted in the left-hand management block.
Click on the three small vertically aligned dots at the top of the attributes section.
Click on the Delete the Attribute button.

A dialog box will appear to confirm that you want to delete the attribute.

Enter the attribute code and click the Remove button to delete the attribute or click the Cancel button to abort the deletion.

Find out the Quick Look tutorial video:

Quick Look - Delete an attribute in a document

Classification

To avoid confusion, it's important to understand the difference:

Classification Object	Classification
A template that specifies how to display the attributes that describe your classifications. No matter the number of classifications you may have for categorizing your product information, there is only one Classification object.	Classifications are the categories and subcategories used to organize your documents or assets. There are no standard rules for defining classifications for your documents. You are free to decide what works best for your content. Classifications can be defined from categories: already existing in an Enterprise Resource Planning (ERP) solution, within another source (e.g., .xlsx, .csv, etc. ), or created within Quable PIM. Note: While there is is no limit on the number of classifications you can have to organize your content, Quable PIM strongly recommends having a maximum of three levels of classifications.

Classification Object

Classification

A template that specifies how to display the attributes that describe your classifications.

No matter the number of classifications you may have for categorizing your product information, there is only one Classification object.

Classifications are the categories and subcategories used to organize your documents or assets.

There are no standard rules for defining classifications for your documents. You are free to decide what works best for your content. Classifications can be defined from categories:

already existing in an Enterprise Resource Planning (ERP) solution,
within another source (e.g., .xlsx, .csv, etc. ), or
created within Quable PIM.

Note: While there is is no limit on the number of classifications you can have to organize your content, Quable PIM strongly recommends having a maximum of three levels of classifications.

The information in this section describes how to manage the Classification object.

Classification Hierarchy

All classifications belong to a master classification list in Quable PIM.

❗️
Because classifications belong to a master classification object, any actions on this object must be performed at the third level (or lower) of the Classification hierarchy (the second level is an internal Quable PIM placeholder).
This does not impact the hierarchy of your product classifications, it only affects the display of classification information.

For example, to create this classification (shown from Advanced Search):

The hierarchy looks like:

📘
Classifications are visible from:

the Advanced Search page,

theData menu when creating a new document, or

the breadcrumbs at the top of documents.

The hierarchy levels for the Classification object type define how your classification information is displayed.

	Hierarchy Level	Description
1	First level	This level defines the master classification. Its properties are not visible or editable.
2	Second level	This level defines the first tab when viewing a classification. Its properties are automatically generated by Quable PIM. They contain the Name of the hierarchy level and the Code (with additional information defining its position). To ensure proper functioning of Quable PIM, we strongly advise against modifying these properties.
3	Third level	This level defines the first section when viewing a classification from the Advanced Search or Data menus. All content for the first tab of a classification is within this level. Its properties are automatically generated by Quable PIM. They contain the Name of the hierarchy level and the Code (with additional information defining its position).
4	Fourth level	This level defines an attribute group in the first section when viewing a classification from the Advanced Search or Data menus. Its properties are automatically generated by Quable PIM. They contain the Name of the hierarchy level and the Code (with additional information defining its position).
5	Fifth level	This level contains all of the attributes of the attribute group. The Name and Description attributes are mandatory. The properties for each attribute in this level are displayed in the Right panel.

Adding Levels

While there is only one Classification object, you can add, edit, and delete the levels (3^rd, 4^th, or 5^th) to customize the display of your classification information. The following sections describe the steps to take.

Second Level - Tabs

By default, classifications are limited to two tabs: Editing and Assets. Any additions at the second hierarchy level are ignored.

Third Level - Sections

To add a new section (third hierarchy level), select Classification from the Object Type dropdown list.

Perform the following actions in order:

Select the 2^nd hierarchical level.
Click on the Add Section button.
Enter the property values for the new section:
- Enter a Name (here: My new section).
- Click in the Code field for automatically generated code. Note: This value cannot be modified after the creation of the new section.
- Click on:
- the Add button to save the new section or
- outside the input window to cancel the creation of the new section.
  The new section will be displayed in the hierarchy (at the third level of the hierarchy).

🚧
The new section will not be visible until it contains at least one attribute group and one attribute with the Visible property enabled.

Fourth Level - Attribute Groups

To add a new attribute group (fourth hierarchy level), select Classification from the Object Type dropdown list.

Perform the following actions in the following order:

Select the 3rd hierarchical level.
Click on the Add a section button.
Enter the property values for the new section:
- Enter a Name (here: My new attribute group).
- Click in Code for automatically generated code. Note: This value cannot be modified after the new section is created.
- Click on:
  - the Add button to save the new section or
  - outside the input window to abandon creating a new section.

The new section will be displayed in the hierarchy (at the fourth level of the hierarchy).

🚧
The new attribute group will not be visible until it contains at least one attribute with the Visible property enabled.

Fifth Level - Attributes

To add attributes to a section, select Classification from the Object Type dropdown list.

Perform the following actions in the following order:

Select the 4th hierarchical level.
Click on the Add an attribute button.
Enter the property values for the new attribute:
- Enter a Name (here: My new attribute).
- Define all the attribute values in the New Attribute form.
- Click:
  - on the Add button to save the new attribute, or
  - outside the input window to abandon the creation of the attribute.

The new attribute will be displayed in the hierarchy (at the fifth level of the hierarchy).

❗️
Attention
Don't confuse classification object properties with attributes!

Properties describe an object (the classification type)

Attributes are the information displayed in classifications

Editing Levels

At any time, you can modify the properties that describe a hierarchy level (third level or lower).

To edit a hierarchy level, select Classification from the Object Type dropdown list.

Perform the following actions in the following order:

Select a hierarchical level to modify (3^rd, 4^th, or 5^th level).
Modify the properties displayed on the right screen.
Click the Modify button or
outside of the right screen to discard the changes.

Deleting Levels

🚧
A hierarchy level can only be deleted if:

no objects are associated with it (documents, variants, assets, links) and

it has no sections/attribute groups/attributes.

The Remove button is disabled if a hierarchy level is associated with an object or is not empty.

To delete a hierarchy level (3^rd, 4^th, or 5^th), select Classification from the Object Type dropdown list.

Perform the following actions in the following order:

Select a hierarchical level to modify (3rd, 4th, or 5th level).
Click on the three dots in the right screen.
Click on Delete this group.

A dialog box will appear to confirm the deletion:

Click on the Delete button or
On the Cancel button or the X close button at the top right of the popup or outside the popup to cancel the deletion.

❗️
Attention
This action is irreversible. Once a hierarchy level has been deleted, it can't be recovered.

Documents

To avoid confusion, it's important to understand the difference:

Document Object	Document
A template that specifies how to display the attributes in your documents. Document objects define the tabs, sections, attributes, and attribute groups displayed on your documents. You can specify different hierarchies and attributes to characterize each different type of document object.	Documents display all of the attributes that describe your products ... and more! They can describe a wide range of information such as: products, collections, specific departments, scheduling, technical information, pricing, etc. The only limit is your imagination!

Document Object

Document

A template that specifies how to display the attributes in your documents.

Document objects define the tabs, sections, attributes, and attribute groups displayed on your documents. You can specify different hierarchies and attributes to characterize each different type of document object.

Documents display all of the attributes that describe your products ... and more!

They can describe a wide range of information such as:

products,
collections,
specific departments,
scheduling,
technical information,
pricing,
etc.

The only limit is your imagination!

The information in this section describes how to manage the Document object.

Document Hierarchy

Document object hierarchy defines the presentation of your Quable PIM content (product sheets, collections, etc.).

For example, to create this product document:

The hierarchy looks like:

📘
Documents are visible from:

the Advanced Search page and

the Data menu.

The hierarchy levels for a Document object define how your information is displayed in tabs, sections, and groups within a document.

	Hierarchy Level	Description
1	First level	This level defines the object type. In this example, a Product document. Its properties are the information entered on the New Document Type dialog when when creating a new document type.
2	Second level	This level defines the first tab when viewing a document from the Advanced Search or Data menus. All of the content (sections, groups, etc.) for a tab in a document descends from this level. Its properties are automatically generated by Quable PIM. They contain: the Name of the hierarchy level the Code (with additional information defining its position) from the New Document Type dialog
3	Third level	This level defines the first section on the first tab when viewing a document from the Advanced Search or Data menus. Its properties are automatically generated by Quable PIM. They contain: the Name of the hierarchy level the Code (with additional information defining its position) from the New Document Type dialog If you have two or more sections, they will be displayed in a gray panel on the left side of the document.
4	Fourth level	This level defines an attribute group for the first section in a document. Its properties are automatically generated by Quable PIM. They contain: the Name of the hierarchy level the Code (with additional information defining its position) from the New Document Type dialog
5	Fifth level	This level contains all of the attributes of the attribute group. The properties for each attribute in this level are displayed in the Right panel.

Adding Documents

To add a new document type, select Document from the Object Type dropdown list.

Perform the following actions in the following order:

Click on the Add Document Type button in the top right corner.

A New Document Type dialog box will appear:

Set the following properties for the new document type:

Information	Description
Label	Enter a descriptive name for the document type.
Code	You can either: click in the entry area for an automatically generated value or enter an alphanumeric value Note: This value cannot be changed after the new document type has been created.
Abbreviation	Enter a two-character alphanumeric value to identify the document. This is displayed in the document when the Minimal icon with abbreviation option is selected as the Model.
Description	Enter text to describe the purpose of the document type.
Uses Variants	Specify if documents of this type will use variants.

Once you have entered the values for the document properties, click the Add button to save the new document type, or click the Cancel button (or the Xin the upper right corner) to abandon the creation of a new document type.

The new document type will be displayed in the Document Type dropdown menu in the top block.

❗️
Attention
Don't confuse document object properties with attributes!

Properties describe an object (the document type)

Attributes are the information displayed in documents