Application Form Guide
The Application Form allows administrators to create new business applications and update existing application details within the Ojoo Business OS Platform. Applications serve as top-level operational containers that organize modules, features, workflows, permissions, and business processes.
Overview
The Application Form screen is used for creating new applications and maintaining existing application records. Administrators can define display titles, routing web slugs, visual menu icons, and display ordering sequence.
- Create top-level business applications.
- Define auto-generated or custom routing web slugs.
- Assign FontAwesome visual icons for main navigation menus.
- Set application menu order numbers.
- Structure child modules and features under business domains.
Application Form Fields
The following fields are available in the Application Form:
| Field Label | Input Type | Required | Purpose & Description |
|---|---|---|---|
| APPLICATION NAME | Text Box | Yes | Enter a unique and meaningful application title (e.g. Engine, CRM, DMS). |
| APPLICATION SLUG | Text Box | Yes | Auto-generated as you type Application Name. Can be edited manually using lowercase letters and hyphens. Must be unique. |
| APPLICATION ICON | Text Box | No | Enter a FontAwesome CSS icon class (e.g. fa-solid fa-cogs) associated with the application. |
| APPLICATION ORDER | Number Box | Yes | Specify an integer sequence position (e.g. 1, 2, 3) to determine menu display order. |
Form Behavior & Validation Rules
The system enforces validation rules to maintain data integrity and prevent routing conflicts:
- Mandatory Fields: Application Name, Application Slug, and Application Order are mandatory.
- Auto-Generated Slug: Typing the Application Name automatically generates a lowercase routing slug. You can modify this slug manually if required.
- Duplicate Slug Protection (Create): Workflow 6 checks slug uniqueness. If a duplicate slug is submitted, saving halts with a red error alert: "Application Slug Already Exists!".
- Duplicate Slug Protection (Update): Workflow 190 checks slug uniqueness excluding the current record. If a duplicate exists, update halts with: "Application Slug Already Exists!".
- Save / Submit Process: Clicking Submit or Save Application validates inputs, updates the database, and returns to the Applications List with a success message.
- Cancel / Back Process: Clicking Back returns to the Applications List screen without saving changes.
Action Buttons & Toolbar Options
The Application Form provides toolbar buttons for managing form data and references:
| Button Label | Operational Description |
|---|---|
| Submit | Validates form inputs and saves the application record. |
| Import | Imports application configuration data from external sources. |
| API's | Accesses application API documentation and integration endpoints. |
| Back | Returns to the Applications List screen. |
Application Form Help Guide Panel
The right-side Help Guide panel provides instant contextual field assistance:
- Application Name: Guidelines for clear display titles.
- Application Slug: Rules for lowercase web slug formatting.
- Application Icon: FontAwesome icon class recommendations.
- Application Order: Menu display sequence numbering guidance.
Quick Links
Quick links provide direct navigation to related platform configuration screens:
| Configuration Link | Operational Description |
|---|---|
| Applications | Manage top-level business applications. |
| Modules | Configure and organize application modules. |
| Features | Create and manage application features and permissions. |
Best Practices
- Use clear, meaningful application names for easy identification.
- Maintain consistent lowercase web slugs using hyphens instead of spaces.
- Assign standard FontAwesome visual icons for menu display.
- Configure application order sequence numbers (10, 20, 30) carefully.
- Organize child modules and features logically under appropriate applications.
- Review all inputs before clicking Submit.