Back to Documentation
What is a Form?
The first thing you will see after logging into nuBuilder Forte (as a user and not a globeadmin) is a nuBuilder Launch Form containing Button Objects that will take you to other Forms.
This is also referred to as a Home Page (User Home).
There are 5 types of Forms.
- Browse - A selectable list of records from a database table used by Lookup Objects.
- Edit - An area displaying editable fields from a record in a database table.
- Browse and Edit - A Form to select and then edit a record in a database table.
- Subform - An Edit Form that is repeated inside a Subform Object.
- Launch - A Form not associated with a database table.
A Browse is used by a Lookup Object to select a record from another table.
- Temporary tables are just used to display data in a Browse Form and is deleted again after it has loaded. They generally are prefixes and suffixed by two underscores with a random string in between like ___nu16019b9e97b815___.
Building a Form
You can build a Form (and create a Button to Access that Form) the easy way using the Form Builder.
You can create a new Form the long way by...
- Clicking the Form Button on the Setup Tab of the Home Page.
- Clicking the Add Button at the top of a Browse Form.
- Filling out your new Form's properties (see below). We suggest you make your first Form a Browse and Edit.
- Clicking the Save Button at the top of its Edit Form.
- You will need to add a Button to the Home Page so users can open it.
- And then you'll want to add some Objects to your new Edit Form, for displaying and editing fields.
- To open a Launch Form, the Record Id has to be -1 , otherwise the Form won't open properly.
- This is not necessarily intuitive, therefore it has been changed in v4.5 so that the Launch form also opens correctly even if the Record ID is left blank.
- For backward compatibility, -1 is still accepted in v4.5.
- Filter Form Screenshot
Choose 1 of the following.
- Browse - Used by a Lookup Object.
- Edit - Used to display editable fields from a record in a database table.
- Browse and Edit - Used to find a record and then display it.
- Subform - Used inside a Subform Object.
- Launch Used...
- As a Home Page
- A Form to display other nuBuilder Objects
- For adding criteria to a Report.
A unique code of alphanumeric characters.
A short description of the purpose of this Form.
If left blank, the Breadcrumb that appears on the Form will be the same as the Description.
If filled in, it can customise the breadcrumb using Hash Cookies and a '|'.
The Hash Cookies can be valid field names from the Table on this Form and anything after the '|' will appear for New records.
#com_code# - #com_name#|New Company
Would return something like this for current records...
AP - Apex Cleaners
Or if was a new record it would return this...
The database table containing records and fields to display.
This is not required for Launch Forms.
The Primary Key that belongs to the selected Table.
This is not required for Launch Forms.
If enabled, a Form is rendered in a mobile device-friendly view.
This mobile-friendly view positions all Objects on a Form in one long row grouped by the Tab Titles, with each Object having its Object Title above it.
This makes it easier to navigate on a mobile device
Please note : The global switch nuMobileView in either nuconfig.php or Setup-> Settings has to be set to true.
All Form types, apart from Browse Forms, require at least one Tab.
Tabs are arranged horizontally above the editable area of an Edit Form.
Tabs allow users to navigate (what seems like) different layers on the same Form.
Displayed order of the Tabs. - Every time the Form is saved these records this will be reordered and renumbered in multiples of 10.
If you want any help building SQL, the SQL Button will direct you to nuBuilder's SQL Builder.
This SQL is used to display records on a Browse Form from either...
An normal SQL Statement eg...
SELECT * FROM customer
Or an SQL statement that can reference a complicated temporary table created with PHP using a Hash Cookie...
SELECT * FROM #TABLE_ID#
Used by Subform Objects to order records inside the Subform.
The title of this column, which will appear at the head of the column.
The column of the database that is to be displayed in this column.
SQL formatting functions can be applied to the column as shown in Example 2.
How the text within the column are aligned. The choices are: Left, Right or Center
Used for formatting dates and numbers - The Formatted part of results are not searchable. (Don't search for a $ if it's not in the actual record.)
The width of the Column in pixels.
Order of column. - Every time the Form is saved these records this will be reordered and renumbered in multiples of 10.
Height in pixels of each of the Rows in the Browse Form. If left blank this will default to 18px.
Rows Per Page
The maximum number of rows that are displayed on a Browse Page. The remaining rows are displayed on a separate page.
(If left blank this will default to 25 rows)
Redirects the choice made this a Browse Form to another Edit Form.
PHP code can be added at the following places on a Form.
- BB - Before Browse
- BE - Before Edit - not available in Subform Forms.
- BS - Before Save - not available in Subform or Launch Forms.
- AS - After Save - not available in Subform or Launch Forms.
- BD - Before Delete - not available in Subform or Launch Forms.
- AD - After Delete - not available in Subform or Launch Forms.
These sections are explained in the flowchart below.
To edit this, double click on the Textarea and you will open Ace Editor in a full screen.