Form View Configuration Guide

The Form View Configuration module is an administration builder screen—NOT a normal record creation form. When a Feature is created with Engine = Form View, its configuration entry is generated automatically. Administrators click "Configure" to open this builder and customize the 6 operational layout sections.

Overview

Form View Configuration controls how data entry forms are rendered and validated for end users. Key administrative responsibilities include:

  • Inspecting pre-populated feature engine details and base table references
  • Setting live web navigation links for target form view pages
  • Viewing relational table schema reference keys
  • Configuring 9 field-level parameters (Table, Column, PK, Label, Input Type, Remove/Required/Disabled/Readonly, Dependency, Grid Column)
  • Designing custom page layout content (Full, Left Partition, or Right Partition Grid & Help Video URLs)
  • Configuring dynamic breadcrumb navigation link titles and routing

Automatic Availability Lifecycle

Form View Configuration entries are generated automatically as part of Feature creation:

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

1. FORM VIEW ENGINE DETAILS

Pre-populated, read-only operational metadata displaying details fetched from the parent feature definition:

FieldDescription
Application NameParent application grouping associated with the feature.
Module NameParent module grouping associated with the feature.
Feature NameDisplay title of the target feature being configured.
Feature SlugUnique URL identifier segment used for routing and access control.
Base TablePrimary database table backing the feature.

2. FORM VIEW LINK

Defines the live navigation link route (e.g. feature/{featureSlug}) that opens or redirects to the rendered Form View page.

3. REFERENCE TABLES

Displays relational schema reference keys (fetched from nm_app_schema_reference_key) between the base table and related tables to assist in configuring foreign table dependencies.

4. FORM CONFIGURATION

Field-level options table configuring 9 properties for each database column:

Configuration ParameterDescription & Operational Meaning
Table NameBase database table name.
Column NameDatabase column being configured.
PK (Primary Key)Designates whether the column is a primary key identifier.
LabelHuman-readable display text label shown next to the form input control.
Input TypeSupported controls: Text, Select, Textarea, Number, Hidden, Password, Date, Datetime, File, Email, Checkbox, Radio.
Remove RowToggle flag (1 = Excluded/Removed from form view, 0 = Displayed).
Is RequiredMandatory validation flag (1 = Required entry, 0 = Optional).
Is DisabledForm control attribute flag (1 = Disabled from editing).
Is ReadonlyForm control attribute flag (1 = Locked as read-only text).
Dependency TableForeign database table used to populate dynamic dropdown select options.
Dependency ValueJSON object specifying value column, label column, status column, and status value for foreign reference tables.
Grid ColumnBootstrap column layout width class (e.g. col-md-6, col-lg-12).

5. LAYOUT CONFIGURATION

Layout content blocks and page structure options allowing administrators to customize appearance:

  • YouTube Video ID: YouTube URL enabling the help video tour popup modal (nm_youtube_link).
  • Select Layout: 1 = Full Grid, 2 = Left Partition Grid, 3 = Right Partition Grid.
  • Partition Grid Column: CSS class for form partition width (e.g. col-lg-5, col-lg-6).
  • Top Content: Custom HTML content banner rendered directly above form inputs.
  • Left / Right Content: Custom HTML blocks rendered on side layout containers.
  • Bottom Content: Custom HTML footer text or quick link cards rendered below form inputs.

6. BREADCRUMBS

Dynamic breadcrumb navigation builder allowing administrators to define page breadcrumb link titles, target URLs, and display hierarchy order (nm_breadcrumbs JSON array).

Best Practices

  • Use clear, uppercase display labels for all form fields.
  • Set mandatory validation on essential business fields.
  • Map foreign dependencies correctly to display human-readable reference names in select dropdowns.
  • Use col-md-6 or col-lg-12 grid classes to format multi-column form layouts cleanly.
  • Test form submissions after updating configuration settings.