Kuika's Create Entity action is used to define a new Entity within the EAV (Entity-Attribute-Value) data model. Entities enable the grouping of attributes used in dynamic forms and their logical collection under an entity. This action is used in applications that want to create a new entity type in the system.

This action is currently available in beta version and is still under development. It is recommended to test it carefully before using it in a production environment.

The entity defined with this action forms the basis of dynamic forms by working together with attributes. Each entity can belong to a category and can be supported with a description.

Technical Specifications

Entity Definition (EAV Panel): The Create Entity action works with the following parameters:
- Name (String - Required): The unique name of the entity to be created in the system. Cannot be left blank.
- Description (String - Optional): A field for providing information about the entity. Provides guidance to the developer or end user.
- CategoryId (Guid - Optional): The category ID to which the entity belongs. Entities can be grouped using the Category system to achieve a more organised structure.
Data Source Compatibility: All parameters can be obtained from the following sources using the Kuika Symbol Picker interface:
- Form Component
- Fixed (fixed text or guid)
- Screen Input / Current / Action Result
Web & Mobile Support: The Create Entity action works in both web and mobile applications.

Create Entity Action Application Steps

1. Form Definition in the User Interface

A form is prepared for the entity information to be obtained from the user.
- Entity Name (Text Input)
- Description (Optional - Text Input)
- Category Selection (Select Box or Text Input - Guid)

2. Action Definition

A button named ‘Create Entity’ is created.

The following action is added to the button:
- + ADD ACTION > OnClick > EAV > Entity > Create Entity

The parameters are configured as follows:

Name: Symbol Picker > Form Component > Text Input
Description: Symbol Picker > Form Component (optional)
CategoryId: Symbol Picker > Fixed or Component

3. Using the Action Result

The created entity can be associated with attribute definitions in the form.
A notification can be displayed to the user after the action or the user can be redirected to another page.

Usage Scenario: Defining a Dynamic Application Process

In an HR application, you want to create custom forms for each application type. Each form has its own entity:

The user fills out the ‘Create New Application Type’ form.
When the “Save” button is clicked, the Create Entity action runs.
The system defines new entities such as ‘job application’ and ‘internship application’.
Attributes (e.g., ‘graduation year’, ‘number of references’) are then added to these entities.

Create Entity Action Advanced Customisations

Conditional Creation: Duplicate records can be prevented by checking whether an entity with the same name already exists (If, Get Entities, Filter, etc.).
Automatic Assignment by Category: The CategoryId parameter can be automatically determined based on the screen.
Save Result: The ID information of the created entity can be used in another action (via Action Result).

The Create Entity action enables entities, which are the building blocks of Kuika's EAV infrastructure, to be dynamically defined in the system. This makes it possible to create user-specific data structures, customisable forms, and advanced data organisation.