11.9 Creating catalog attributes

Creating a new catalog structure

You can read more about creating a catalog here.

By default, the catalog structure is empty and looks as follows: 

To create a catalog, the user needs to fill in its structure. The structure of the catalog is created by creating and customizing attributes in a tabular form.

To create a catalog structure it is necessary to:

• open a catalog card 
  • opening takes place when creating a catalog
  • opening is performed by clicking on the text (link) in the Structure column on the Catalog page, which will take you to the catalog card.
    

In order to fill the catalog structure with attributes you should click on the Edit button

Next, the user is shown the structure of the catalog in the editing mode

The user in edit mode can change the name of the catalog and its description.

The user can add attributes to the catalog using the Create attribute button.

Attribute creation

The user clicks on the Create attribute button.

Clicking on the Create attribute button opens the Attribute creation modal window, ready to create/add attributes to the catalog card.

Hovering over a question mark on checkboxes displays a tooltip. 

The filled in modal window looks as follows: 

The description of catalog card elements is given in the table:

Element name	Description	Default value/Available values	Template/Example	Mandatory
No.	Has a unique number within the current catalog	Inserted automatically in sequence, numbering starts from 1.		-
Attribute name	Field for entering the name of the attribute. It has a unique name within the current catalog.	-		Yes
Description	Attribute description input field. The maximum text length is 500 characters.	-		No
Type	Dropdown list Only one attribute type can be selected. If the attribute type changes, the additional fields of the selected type are changed to match the newly selected type or disappear.	Available values: String  Number Boolean Catalog User group		Yes
User group	Dropdown list Selectable only if the User group type is selected Only one user group can be selected. This field is mandatory.	Available values: displays a list of user groups that are available to the user.		Yes
Catalog	Dropdown list Selection is possible only if the Catalog type is selected Only one catalog can be selected. The catalog that is in the editing mode (in the attribute card or in the data card of the catalog) is not displayed in the list of available catalogs. This field is mandatory.	Available values: displays a list of catalogs existing on the Catalogs tab that are available to the user		Yes
Line length	Input field for the number of characters Selection is possible only if the String type is selected The entered number sets a limit on the number of characters in the String field record Valid input values: 1 or more	Default value: the number of characters is unlimited		No
Uniqueness	Checkbox The value of each record of this attribute must be unique in the catalog The checkbox is inactive when attribute type Boolean is selected	-		No
Mandatory	Checkbox The value of each record of this attribute must be mandatory in the catalog	-		No
String representation	Checkbox The value of each record of this attribute will have a string representation in the system (for example, selecting an existing catalog record should reflect a set of only those catalog attributes that have a string representation) The checkbox is inactive when the attribute type Boolean is selected.	-		No
Create	Button When clicked: The Attribute creation window closes, the user returns to the card in edit mode. The system adds the attribute to the Catalog table	-
Cancel	Button When clicked: The Attribute creation window closes, the user returns to the card in edit mode. The system does not add the attribute to the Catalog table	-

For each column of the catalog structure, attributes sequentially set the parameters of new catalog columns. Attributes within the current catalog have unique names.

The User creates other attributes in the catalog in the same way.

Within the framework of attributes creation the User performs operations:

1. Fills in the fields:
   • Attribute name
   • Description
   • Type
   • Uniqueness
   • Mandatory
   • String representation
2. If the type is selected:
   • String, then the String length field is added, where the user specifies the maximum number of characters for the record.
   • User group, then the User group field is added, where the user selects an available user group.
   • Catalog field is added, where the user selects an available catalog.
3. The user clicks a button:
   
   • Create, the next step is executed.
   • Cancel, the Attribute creation modal window closes, the system does not add the attribute to the catalog card table, the user remains in the catalog card in the editing mode.
4. The system checks if the mandatory fields and attribute names are filled with the existing catalog attributes.
5. If mandatory fields are filled correctly, the Attribute creation modal window closes and the system adds the attribute to the catalog card table.
6. The system displays the following notification:
   Attribute <Attribute name> was successfully created.
   
7. The user remains in the catalog card in edit mode. 

8. All changes made to the catalog card (adding attributes, changing editable fields) are saved using the Save button.

9. The catalog card is saved with the changes made and enters the reading mode, the system displays the following notification:
   The structure of the catalog <Catalog name> has been successfully updated.
   
   
   

10. All changes made to the catalog card (adding attributes, changing editable fields) are canceled using the Cancel button.
11. The system opens a window with confirmation of canceling the changes made:
    Are you sure you want to cancel the changes made?
    
    
12. When confirming the cancellation, the User clicks the Yes button and the System cancels the changes made, the User remains in the catalog card in read mode.