Data Controllers / Actions / Select

  Multiple Edit Forms

Data Controllers / Actions / SelectPrint||
Multiple Edit Forms

Different edit forms can be used depending on the field values of a record. For example, the Customers table has a Postal Code column.

Customers edit form with Postal Code label.

Customers in the United States refer to the Postal Code as a “ZIP Code”. Let’s create another edit form for customers from USA that uses the “ZIP Code” label for Postal Code, and is rendered in two columns.

Start the Project Designer. In the Project Explorer, switch to the Controllers tab. Right-click on Customers / Views node, and select New View option.

Create New View for Customers controller.

Give this view the following settings:

Property Value
Id editFormUSA
Type Form
Command command1
Label Edit Customer from USA
Header Text Edit the fields of this customer from USA.

Press OK to save the view. In the Project Explorer, right-click on Customers / Views / editFormUSA view node, and select New Category.

Create New Category in editFormUSA view.

Assign the following settings:

Property Value
Header Text Customer Information
Description This is information about the customer.

Press OK to save the category. In the Project Explorer, right-click on Customers / Views / editFormUSA / c100 – Customer Information category node, and select New Data Field.

New Data Field in Customer Information category.

Assign the data field these properties:

Property Value
Field Name CustomerID
Columns 5

Save the data field. Create several more data fields with the following settings:

Field Name Columns
CompanyName 20
ContactName 20
ContactTitle 5
Phone 12

Right-click on Customers / Views / EditFormUSA view node, and select New Category.

Create New Category for editFormUSA view.

Give the category these settings:

Property Value
Header Text Shipping Information
Description This is the shipping information for the customer.
New Column Yes

Press OK to save. Add the following data fields to this category:

Field Name Columns Header Text
Address 20  
City 12  
Region 5  
PostalCode 12 ZIP Code
Country 12  

Now that the new edit form has been configured, let’s change the action state machine to direct USA  customers to the correct form.

In the Project Explorer, right-click on Customers / Actions / ag1 (Grid) action group node, and select New Action.

New Action in action group 'ag1'.

Give this action the following settings:

Property Value
Command Name Select
Command Argument editFormUSA
When Client Script [Country] == 'USA'

Press OK to save the action. In the Project Explorer, move the action into second place, after ag1 – Select.

Action a100 in action group 'ag1'.

Double-click on Customers / Actions / ag1 (Grid) / a1 – Select action node.

Action 'a1' in action group 'ag1'.

Change the When Client Script property:

Property Value
When Client Script [Country] != 'USA'

Press OK to save the action. On the toolbar, press Browse to generate the web application.

Navigate to the Customers page. Select a customer that is not from the United States. The standard edit form will be displayed.

Standard editForm1 view of Customers.

Select a different customer with Country of “USA”. The new two-column edit form will be displayed. “Postal Code” is replaced by “ZIP Code”.

Custom 'editFormUSA' view of Customers from USA.

Table of Contents