Create Category

1. Defining Categories in UI Design Creating a Dynamic Form

• A screen where a new category is to be added opens.
• The following elements are added to the Dynamic Form element below:
  
  • Text Input → Category Name
  • Text Input → Description - Optional
  • Select Box → Parent Category (ParentId) - Optional
  • Button → ‘Create Category’

2. Add Action

• When the ‘Create Category’ button is clicked:
  
  • + ADD ACTION > OnClick > EAV > Category > Create Category action is added.
  • Parameter matches:

• Name → Symbol Picker > Form Component > Text Input
• Description (Optional) → Symbol Picker > Form Component > Text Input
• ParentId (Optional) → Symbol Picker > Component > Select Box / Fixed Guid

3. Display Success or Error Result

• When the category is successfully created, a toast notification can be displayed to the user.
• Pre-validation can be performed for incorrect or incomplete entries (e.g., display a warning if Name is empty).

In an administrator panel, categories are to be defined for grouping fields in the system. For example:

• Top category: ‘User Information’
• Subcategory: ‘Contact Information’
• Description: ‘Contains fields such as phone and email.’
• ParentId: ID of the ‘User Information’ category

In this scenario, the user first creates the top category, then selects the top category as the ParentId when defining the subcategory.

‍

• Updating the Category List: After a new category is created, the category Select Box on the page can be reloaded.
• Conditional Visibility: The category creation area can be displayed only for administrators.
• Hierarchical Visualisation: Categories can be displayed in a tree structure.

Technical Risks

• Empty or Duplicate Name: The Name parameter must not be left blank, and the system may return an error if a category with the same name already exists.
• Invalid ParentId: The operation may fail if an undefined ParentId is entered.
• Beta Version Risk: The action is in beta, so instability or temporary limitations may occur.

The Create Category action is used to organise attribute groups in a logical, organised, and sustainable manner on the Kuika platform. It ensures that the category system is defined in accordance with a hierarchical structure and can be dynamically expanded. It offers significant convenience and scalability, especially in applications that work with a large number of fields.