Blog Viewer

Details Tab:

Form Name (ID)

• What it does: Programmatic ID of the form. It is always prefixed with htx.
• How to use it: This is a read-only property.
• Other Notes: This is not editable from the details window. You can edit it in the source, but best practice is to keep the ID and title the same. You can't create multiple forms with the same ID. 

Form Title

• What it does: Displays at the top of the form; what the form is "called".
• How to use it: Enter the title.
• Other notes: Keep it synced with the ID.

HTML Template File

• What it does: Path where the HTML template file is stored.
• How to use it: This is read-only.

Resource

• What it does: Framework security table ID that controls who can access the form.
• How to use it: Enter the ID.
• Other notes: -1 means all users can access the form.

Active checkbox

• What it does: If checked, the form is available in the application.
• How to use it: Click to check or uncheck.

Website

• What it does: Element of the WebForm based architecture.
• How to use it: Select the available web client from the drop down (value comes from the web client project in the .NET solution.
• Other Notes: This is not used for MVVM architecture.

Max Count

• What it does: The form displays this number of search results unless a search returns fewer results. 
• How to use it: Enter a number.
• Other Notes: The default value for lookup screens is defined in the web.config file. If the setting is not there, it defaults to 100. If left blank, the application uses the value of 100 for the form. If the app settings GetMaxSearch property is false, this control is not usable.

Main Query

• What it does: Query the application executes when the user clicks the Search button.
• How to use it: Enter the query.
• Other notes: By default, the Main Query is blank (uses the default query). The default query selects all the columns from the main table of the entity associated with the form.

Browse button

• What it does: Opens the Browse for Query window.
• How to use it: Click the button and search for the desired main query.
• Other notes: The desired query must already be configured in the entity.

Sub Query

• What it does: Query that adds an exist clause in the where condition of the main query.
• How to use it: Add, remove, or replace sub queries; or change their order of execution.
• Other notes: The system executes the sub query only when the search criteria associated with the sub query is entered for searching.

Sub Query plus icon

• What it does: Adds a sub query
• How to use it: Click the plus icon and browse for the desired query.
• Other notes: The desired query must already be configured in the entity.

Sub Query minus icon

• What it does: Removes a sub query.
• How to use it: Select the desired query and click the minus icon.

Sub Query Replace icon

• What it does: Replaces the existing sub query.
• How to use it: Select the query to be replaced and click the Replace icon, then browse for the desired query.
• Other notes: The desired query must already be configured in the entity.

Sub Query up arrow icon

• What it does: Moves the query up in execution order.
• How to use it: Select the desired query and click the arrow.

Sub Query down arrow icon

• What it does: Moves the query down in execution order.
• How to use it: Select the desired query and click the arrow.

Entity Tab:

Entity

• What it does: Displays the name of the entity the form is based on.
• How to use it: Select from the drop down.

Method Type

• What it does: Method that executes when the user clicks the button.
• How to use it: Click to check or uncheck.
• Other notes: This control is provided to support backward compatible forms.

Remote Object

• What it does: Displays the server object the business tier uses to call the logic in the hosted C# database objects.
• How to use it: Select from the drop down.
• Other notes: This control is provided to support backward compatible forms.

This post is part of the HTML Forms topic. Click here to open the HTML Forms Overview.