---
description: >-
  The Create New Entity window captures mandatory entity details (Name, Parent)
  and optional fields, with save and cancel options.
---

# Create New Entity

The **Create New Entity** window allows users to add entities with mandatory fields for **Entity Name** and **Entity Parent**, and optional fields for **Entity Tag** and **Asset Class** (e.g., Building, Road, Site). It includes dropdowns for hierarchical selection and asset classification. Action buttons, **Create** and **Cancel**, enable saving or discarding changes, ensuring efficient entity creation.

<figure><img src="https://3041611997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfCYTTMdizqTrgCRWgKD%2Fuploads%2F64qMOmUqmbz6nwHTAjUH%2FCreate_New_Entity.png?alt=media&#x26;token=4d250e08-5f5e-4d04-9ccb-697be93fa20e" alt=""><figcaption><p>Create New Entity View</p></figcaption></figure>

### **Window Heading**

* **Title:** The window is titled **"Create New Entity"**, clearly indicating its purpose.
* **Asterisk Mark:** Mandatory fields are marked with an asterisk `*` to denote required input.

### **Form Fields**

The form consists of four input fields. Two fields are mandatory, and two are optional. Here's a detailed breakdown.

| Field Name          | Type             | Mandatory/Optional | Description                                                                                        |
| ------------------- | ---------------- | ------------------ | -------------------------------------------------------------------------------------------------- |
| **Entity Name**\*   | Text Input Field | Mandatory          | Requires the user to provide a unique name for the new entity, ensuring proper identification.     |
| **Entity Tag**      | Text Input Field | Optional           | Allows users to add a tag or label for the entity for better classification or quick reference.    |
| **Entity Parent**\* | Dropdown Menu    | Mandatory          | Lets users select the parent entity from a predefined list, establishing a hierarchical structure. |
| **Asset Class**     | Dropdown Menu    | Optional           | Allows selection of the type of asset the entity belongs to, such as Building, Road, or Site.      |

### **Field Descriptions**

1. **Entity Name**
   * A required field where users enter the name of the entity, such as "Regional Office" or "Solar Plant A."
2. **Entity Tag**
   * An optional field where a tag, such as "TAG-001" or "LOC-002," can be added for quick identification or categorization.
3. **Entity Parent**
   * A dropdown to select the parent entity. Examples include,
     * "Corporate Headquarters" for organizational hierarchies.
     * "City Infrastructure" for regional divisions.
4. **Asset Class**
   * A dropdown menu with options to classify the asset type. Example options:
     * **Building**: Represents buildings such as offices, factories, or warehouses.
     * **Road**: Includes roads or transportation-related assets.
     * **Site**: Represents physical sites or facilities.
     * **Group**: Denotes groups of related entities.
     * **Machine**: Represents machinery or equipment.
     * **Floor/Room**: For entities within a building.

### **Action Buttons**

Two action buttons are located in the bottom-right corner of the window, allowing users to complete or cancel the process.

<table><thead><tr><th width="162">Button Name</th><th>Function</th></tr></thead><tbody><tr><td><strong>Cancel</strong></td><td>Closes the form and discards all entered data without saving.</td></tr><tr><td><strong>Create</strong></td><td>Saves the entered entity details and adds the new entity to the system. Requires mandatory fields to be completed.</td></tr></tbody></table>

### **Button Descriptions**

1. **Cancel**
   * Allows users to exit the form without making any changes.
   * Useful if the user decides not to proceed with creating a new entity.
2. **Create**
   * Validates the inputs in the form and creates the entity when all mandatory fields are correctly filled.

### **Additional Features**

<table><thead><tr><th width="174">Feature</th><th>Description</th></tr></thead><tbody><tr><td><strong>Close Icon (X)</strong></td><td>Located in the top-right corner of the window. Clicking it closes the form without saving changes.</td></tr></tbody></table>

### Conclusion

The **Create New Entity** window is a simple yet powerful interface for adding new entities. It includes mandatory fields for **Entity Name** and **Entity Parent**, optional fields for **Entity Tag** and **Asset Class**, and action buttons for saving or cancelling the process. Dropdown menus and validations ensure data accuracy and consistency within the system hierarchy.
