Field Setup

After loading the database, the database objects (tables, views, custom views and reports) will be shown in the left pane (the database pane). Click on any database object to go to the Field Setup Page for that object at any time.

ASP.NET Maker support all commonly used ADO data type. If ASP.NET Maker finds an unsupported field in a table, an "Unsupported Fields" tab will appear. You can click on the tab to view the list of fields that are not supported.

The Field Setup pages consists of two section. The upper section is a grid showing available options of all fields. The lower section contain two panels, the [Edit tag] panel and the [View tag] panel for the selected field.

 

The grid consists of the following sections:

 

General

Properties

Field Name Field Name (read only)
Data Type Data Type (read only)
Size Maximum field length (read only)
Caption Caption to be displayed
Primary Key

Primary Key of the table

Important Note:

  1. You should never change this field unless you are absolutely sure that this field is unique. Otherwise a particular record cannot be located and unexpected results may occur.
  2. From v2.0, composite key is supported, and primary key is uneditable in the edit page.
Page

Page number of the field.

From v3.0+, multi-page Add/Edit is supported. By default all the fields are in page 1 and multi-page is disabled. If you set any page to larger than 1, multi-page feature will be enabled automatically.

Custom field display order by drag-and-drop

You can change the field order defined in the database by simple drag-and-drop. Simply click the Field Name column to select the field, then drag it to where you want. ASP.NET Maker will generate ASP.NET and display records according to this order.

Custom field order by drag-and-drop

 

List Page

Properties

List Show field in list page
Aggregate Enable Field Aggregation. Aggregated values will be shown at Page Footer. Not applicable in multi-column view. Aggregate options include:
- TOTAL (sum of all field values in current page)
- COUNT (count of records in current page)
- AVERAGE (average field value in current page)
Width Specify field column width
Wrap Enable/Disable wrapping of field text
Quick Search

Include this field when performing quick search.
Note: Only text fields and numeric fields are supported in Quick Search. By default only text fields are enabled.

Ext. Search

Use this field in Extended Quick Search (ASP.NET Maker 3+)

Extended Quick Search is enhancement of Quick Search. It is sort of a combination of Quick Search and Advanced Search. If a field is checked for Ext. Search, a form element for the field will be shown in the Quick(Basic) Search form and the user input criteria for this field will be included when performing Quick(Basic) Search.

Extended Quick Search will use the same search operators specified under the "Advanced Search Page" section (see below).

 

View Page

Properties

View Show field in view page
View Tag HTML tag to display the field. Used in List/View pages.

You can either click the [View Tag] column and select a View Tag from the drop down box or click the icon on the View Tag panel toolbar to select. After selecting the View Tag, you can further setup its properties in the View tag panel.

View As tags

There are two types of View tag, Formatted Text and Image.

Formatted Text - View Tag to display the field value as formatted text with optional hyperlink. Properties:

Style
Bold Display as Bold (enclosed with <b> </b> tags)
Italic Display as Italic (enclosed with <i> </i> tags)
Align Left/Center/Right/Justify. Align the data (enclosed with <div> </div> tags)
Format
None No formatting
Currency Display in currency format (VBScript FormatCurrency function)
Date/Time Display in date format (ASP.NET Maker formatdatetime function)
Number Display in number format (VBScript FormatNumber function)
Percent Display in percent format (VBScript FormatPercent function)
String Format the field value with specified VBScript string function or custom function
Max Length (List page)

Truncate the field value at specified max. length and append "..." to the end.

Note: This setting only applied to memo fields in list page and must be larger than 0 to take effect.

Hyperlink
HREF field Display the field as hyperlink with the href attribute set to the value of this field. Can be the field itself.
Target _top/_parent/_self/_blank
Prefix

- None (no prefix, relative path of url)
- http:// (prefix http:// added, absolute path of url)
- mailto: (prefix mailto: added, email link)
- ftp:// (prefix ftp:// added, ftp link)
- file:// (prefix file:// added, file link)
- news:// (prefix news:// added, newsgroup link)

Suffix Append the input string to the URL

 

Image - View Tag to display as Image using <img> tag. The field should be a BLOB field or a field storing the path of the image.

IMG Tag attributes
Width Specify the width of the image
Height Specify the height of the image
Hyperlink (same as above)

 

 

Edit Page

fieldsetup4

Properties

Edit Show field in edit page
Read Only Make the field read only in edit page
Edit Tag Form element for the field. Use in Add/Copy/Edit/Search pages.

You can either click the [Edit Tag] column and select a Edit Tag from the drop down box or click the icon on the Edit Tag panel toolbar to select. After selecting the Edit Tag, you can further setup its properties in the Edit Tag panel:

Edit tag

Edit Tags

ASP.NET Maker supports all HTML form elements:

Text

<input type="text"> tag

Display the field as a textbox.

Size - size of the textbox

MaxLength - maximum input length of the textbox

Validation - see section below

Use Lookup Table - enable auto suggest feature by Ajax. With a lookup table, when the user type in the textbox, a dynamic dropdown list populated with data from the lookup table matching the user input will appear for user to select. If the data already exists, the user can easily select without typing the full text. If not, the user can still input as usual. To enable this feature, check this option and enter the lookup table info in the [Lookup Table] panel next to the [Edit Tag] panel. (See section below)

Password

<input type="password"> tag

Display the field as a masked textbox.

Size - size of the textbox

MaxLength - maximum input length of the textbox

Validation - see section below

Radio

<input type="radio"> tag

Display the field as an option of a radio button list. You can enter the options manually in the [User Value] panel next to the [Edit Tag] panel.

Use lookup table - use an existing lookup table instead of user input value/label pairs for the radio buttons. To enable this feature, check this option and enter the lookup table info in the [Lookup Table] panel next to the [Edit Tag] panel. (See section below)

Repeat columns - specifies the no. of radio buttons per row

Validation - see section below

Checkbox

<input type="checkbox"> tag

Display the field as one or more option(s) of a checkbox list. You can enter the options manually in the [User Value] panel next to the [Edit Tag] panel.

Use lookup table - use an existing lookup table instead of user input value/label pairs for the checkboxes. To enable this feature, check this option and enter the lookup table info in the [Lookup Table] panel next to the [Edit Tag] panel. (See section below)

Repeat columns - specifies the no. of checkboxes per row

Validation - see section below

Note: The submitted values of the multi-selected checkboxes is a comma-separated string. Therefore you must use a string field for checkbox list.

Select

<select> tag

Display the field as a combobox (dropdown list) or a listbox. You can enter the options manually in the [User Value] panel next to the [Edit Tag] panel.

Size - no. of options to show. If more that 1, the selection list is shown as a listbox, otherwise it is shown as a combobox.

Multiple: Check to enable multiple selection (for listbox only)

Note: The submitted values of the multi-selected listbox is a comma-separated string. Therefore you must use a string field for checkbox list.

Use lookup table - use an existing lookup table instead of user input value/label pairs for the checkboxes. To enable this feature, check this option and enter the lookup table info in the [Lookup Table] panel next to the [Edit Tag] panel. (See section below)

Validation - see section below

TextArea

<textarea> tag

Display the field as a textarea.

Cols - no. of columns of the textarea.

Rows - no. of rows of the textarea.

Use DHTML Editor - replace the textarea with a DHTML editor for editing the data as HTML.

Note: The DHTML Editor(s) requires newer version of browsers such as IE6+, NS7+ or FF1+. It is not developed by the author of ASP.NET Maker and no technical support will be provided. (See Third-party Tools.)

Validation - see section below

File

<input type="file"> tag

Display the field as a file upload control. For BLOB fields or string fields only.

Size - size of the input tag (NOT file size)

If the field is of BLOB (binary) data type, file is uploaded to the database. You can also store the information of the uploaded file in the following fields:

File type field - Recommended. Useful when you want to response to user browser the exact content type of the data.

File name field - Optional. Useful if you want to use the original filename.

Note: Do not specify file name field if you want IE to open the file automatically. (IE may fail to open non-image files retrieved from database properly.) Use file name field if you want IE to popup a File Download dialog for user to save the file with the filename specified in the file name field.

File size field - Optional. Stores the uploaded file size.

Image width field - Optional. For use with images only. Stores the width of the uploaded image.

Image height field - Optional. For use with images only. Stores the height of the uploaded image.

If the field of string type, file is uploaded to a subfolder relative to the application root.

Upload folder - the folder where the uploaded file will reside. If you do not enter a specific folder, all the uploaded files will be put in the global upload folder specified in the ASP.NET tab (see ASP.NET Setup).

Notes:

  1. Make sure that the Web server user have read/write access to the folder. You can right-click the folder in Windows Explorer and add read/write access for IUSR_<MachineName> on the Security tab.

  2. The path is relative to application root. Use slashes "/" as path delimiter, no leading slash. e.g. If the application root of your website is C:\Inetpub\wwwroot\demo and you enter "uploads/folder1" in this textbox, the folder for the uploaded files will be C:\Inetpub\wwwroot\demo\uploads\folder1. If you are not sure which folder is application root, please read Creating Virtual Directories in IIS.

Validation - see section below

Hidden

<input type="hidden"> tag

Hide the field with a hidden form element.

Note: This is different from de-selecting the field in the [Edit] column. If a field is de-selected, no code will be generated for the field in the Edit page and the field will not be updated. With a hidden form element the field is not seen but it may still get updated.

Custom value - by default the 'value' attribute contains the field value, custom value is used to update the field with an other value, for example, Date(), when a record is updated using the edit page.

Notes:

  1. Custom value is used in Edit page only. It cannot be used with Read-only fields, User ID fields and Detail fields(Foreign key fields)

  2. In Add page, if a default value is specified (see section below), hidden form element will also be used but the 'value' attribute will contain the default value. If default value is not specified, the field will be displayed as a normal textbox.

 

Using User Values for Edit Tag (Radio/Checkbox/Select)

For Radio/Checkbox/Select Edit Tags, the default option values are user input values, you can enter as many value/label pairs as you want in the [User Values] panel next to the [Edit Tag] panel.

Using Lookup Table for Edit Tag (Radio/Checkbox/Select)

In real world applications, the option values usually come from a (lookup) table in the database. ASP.NET Maker make it very simple to use lookup values for key field values, simple click [Use Table], the [Lookup Table] panel will replace the [User Values] panel, select the following properties:

Lookup Table tag setup

Table name The table to be linked to
Link field The field to be used as the value of an option (for Radio/Checkbox/Select only). This field is usually the primary key of the lookup table.
Display field #1 The field in lookup table to be used as the label of an option. (If auto suggest textbox, only string fields will be selectable.)
Display field #2 Optional. Another field in lookup table to be included in the label of an option. (If auto suggest textbox, only string fields will be selectable.)
Order By Optional. Used to sort the options
Asc/Desc Optional. Sorting order.
Distinct Optional. Unique records only. (for Radio/Checkbox/Select only)
Filter WHERE clause to filter options from the table
Parent combobox

Optional. For used with the Dynamic Selection List feature. Available for <select> tag only. Specify the parent combobox of this combobox. When the parent combobox changes, the available options in this combobox will be changed accordingly.

Note: Dynamic Selection List does not support multiple selection.

Filter Field

Optional. For used with the Dynamic Selection List feature. Available for <select> tag only. If this <select> tag is setup as the Second Combobox (see below), the options in this <select> tag will be changed with the selected option of the first combobox. It is done by filtering the linked table records by this field. Only records with a Filter Field value matching the selected value of the first combobox will be shown.

Note: Dynamic Selection List does not support multiple selection.

Allow Add

Optional. If enabled, the user will be allowed to add an option to the selection list.

Notes:

  1. Review your lookup table design before using this option. The option works best if you there is only one display field and the link field (primary key) is an autoincrement field. In that case the user only need to fill in a textbox and the option is added. But if the link field (primary key) is not an auto-increment field, the user will need to enter the link field value which the user may not know.

  2. The user will be asked to enter the link field and the display field(s) only. If the lookup table has other NOT NULL fields other than the link field and display field(s), the new option cannot be added. However, you can define default values for these fields in the database (not in ASP.NET Maker).

  3. Currently this feature is supported in Add/Edit page only, it is not available in Inline-Edit.

  4. This feature is implemented using Ajax, IE6+/NS7+/FF1+ is required.

 

JavaScript Validation (for add/copy/edit/search pages)

The data input for each field can be validated using client-side JavaScript.

Validate

Supported data type are:
Integer, Float, Range, Date(yyyy/mm/dd), Date(mm/dd/yyyy), Date(dd/mm/yyyy), Time(hh:mm:ss), Email, Credit card, GUID, US phone numner, US zip code, US social security number

Note: Other than "/", the date separator of the validation format can also be "-" or ".", depending on the default date format setting in ASP.NET Settings page.

Use popup calendar

If Validate is one of the date formats, check this option to use a visual date picker instead of manual input.

Note: The popup calendar is not developed by the author of ASP.NET Maker and no technical support will be provided. (See Third-party Tools.)

Required Check this checkbox if the field is mandatory
Error Message Enter the error message to popup if error occurs
Check Duplicate

Specify whether to check duplicated values for the field.

If the field is an unique indexed field, ASP.NET Maker will generate server side codes to check duplicate values automatically even this option is not selected. This option is useful when you want to check a non unique indexed fields for duplicated values in the Add page.

Notes: The validation is done on server side in Add page only.

 

 

Add Page

Properties

Add Show field in add page
Default Value Default value for field (for adding new record only) . Must be a valid VB.NET / C# expression. (If it is a string, must be double quoted.)

 

Advanced Search Page

Properties

Search Show field in Advanced Search page (Note: NOT related to Quick Search)
Search Opr 1 Search operator #1 for the field. Used in Advanced Search or Extended Quick Search.
Search Opr 2

Search operator #2 for the field. Used in Advanced Search or Extended Quick Search.

Notes:

  1. This second search operators will be useful when you may have 2 criteria for the field when searching. You can also select AND/OR to relate the 2 criteria.
  2. ASP.NET Maker (3+) supports "BETWEEN" search operator. If you want to use it, select "BETWEEN" in the first search operator. When "BETWEEN" is used, the 2 search criteria will be used up and the second search operator will be ignored.

 

 

 ©2004-2007 e.World Technology Ltd. All rights reserved.