Form View List Guide

The Form View List module in Ojoo Business OS is a central management interface that presents all configured Form View entries across the ERP platform. It allows administrators to inspect, manage, and launch the Form View Configuration builder for business features.

Overview

Form View configurations control how data entry forms are presented and validated across Ojoo Business OS. Key operational capabilities include:

  • Centralized listing of all business features configured with Form View Engine
  • Direct access to the Form View Configuration builder via the "Configure" action link
  • Instant global text search filtering across configured columns
  • Click-to-sort column ordering (Ascending / Descending)
  • Flexible pagination with configurable entries per page (10, 25, 50, 100 rows)
  • Utility export options (Excel, CSV, PDF, Clipboard Copy, Print)
  • Column visibility customization and layout resets
  • Role-based access permission controls for secure administration

Automatic Availability Lifecycle

Form View Configuration entries are generated automatically as part of Feature creation—there is NO manual "Create Form View Configuration" button:

1. Feature Creation (Engine = Form View) 2. Automatic Entry in nm_app_features_form_view 3. Appears in Form View List 4. Click "Configure" Link

Displayed List Columns

The Form View List presents records using structured table columns:

List Column Header Description & Operational Meaning
Actions Row-level action column containing operational icons (View, Edit, Delete, Restore, Configure).
Form View ID Unique primary key identifier for the configuration record (nm_form_view_id).
Feature Name Human-readable display name of the associated feature.
Feature Slug URL-friendly unique string identifier used for routing and permissions checks.
Base Table Primary database table providing underlying records.
Config Name / Status Configuration profile name or active status indicator badge.

Row-Level Action Buttons

Depending on administrator configuration and user role rights, table rows display the following action buttons:

Action Button Description & Functional Behavior
View Opens detailed read-only modal or page for the selected record.
Edit Opens form view to update existing record details.
Delete Prompts user confirmation and soft-deletes the configuration.
Restore Restores a soft-deleted record back to active state.
Configure Opens the Form View Configuration builder (studio-engine/form-view-configure/{featureSlug}) for system administrators.

Top Toolbar Options

+ Create

Opens blank form view to add a new record to the base table.

APIs

Opens feature API reference and endpoint documentation.

Help Guide

Opens interactive YouTube tutorial video modal for training.

Export & Utility Options

The utility bar provides high-performance data export and grid controls:

  • Copy Data: Copies displayed table rows directly to clipboard.
  • Export to Excel: Generates formatted .xlsx spreadsheet file.
  • Export to CSV: Downloads raw comma-separated values for data analysis.
  • Export to PDF: Compiles print-ready PDF document.
  • Print Table: Launches native browser print dialog for current table view.
  • Column Visibility: Displays dynamic dropdown allowing users to show/hide table columns.
  • Restore Default Columns: Resets table layout to administrator default column arrangement.

Search & Pagination Controls

  • Instant Global Search: Typing text into top search bar filters rows in real time across columns.
  • Records Per Page Selection: Choose 10, 25, 50, or 100 entries displayed per page.
  • Pagination Controls: Navigate cleanly between pages using Previous, Page Numbers, and Next buttons.

Role-Based Access Permissions

Access to Form View List and action buttons is strictly controlled by Ojoo Business OS permission service (service('permission')->has($featureSlug)). Users without authorized permissions receive an Access Denied message or are redirected to /no-access.

Best Practices

  • Keep list view columns focused on essential feature identifiers.
  • Use the Configure link to customize form field labels and validation rules.
  • Regularly verify dynamic dropdown dependencies for seamless data entry.