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).

An administrator wants to create a category and subcategory structure to group the fields in the system in a more organised manner.

• The administrator logs into the administrator panel.
• They click the ‘Add Category’ button.
• They enter the following information as the parent category:
  
  • Category Name: User Information
  • Description: Contains basic information about the user.
  • ParentId: Blank (because it is the parent category)
• Saves and the system automatically assigns an ID to this category (for example: 123).
• The administrator clicks the ‘Add Category’ button again.
• Entering the following information as a subcategory:
  
  • Category Name: Contact Information
  • Description: Contains contact fields such as phone and email.
  • ParentId: 123 (ID of the parent category)
• The administrator adds another subcategory in the same way:
  
  • Category Name: Address Information
  • Description: Contains fields such as home and work addresses.
  • ParentId: 123
• The system organises the categories hierarchically according to this structure.

• 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.