Data Aquarium Framework forces you to break down the data fields displayed in form views into categories. At least one category must be present in any form view. A form view is displaying a single record at a time, when users are viewing, editing, or creating a new record. Here is an example of the customer form view in application generated from Northwind database. A single category Customers includes all data fields.
Let's create a few categories to better present the fields and make it easier to work with customer records.
Open ~/Controllers/Customers.xml file, locate view editForm1 and change the data field categories as follows.
<view id="editForm1" type="Form" commandId="command1" label="Review Customers">
<headerText>Please review customers information below. Click Edit to change this record,
click Delete to delete the record, or click Cancel/Close to return back.</headerText>
<category headerText="Customer Code and Name">
<description>Customer number is a five-character long field. Please use upper case
letters only and try to create an abbreviation from the full customer company name.</description>
<dataField fieldName="CustomerID" columns="5" />
<dataField fieldName="CompanyName" columns="40" />
<category headerText="Contact Information">
<description><![CDATA[Contact information including contact name, title, customer
phone number and fax must be entered. Please use our
<a href="http://company/policies" target="_blank">policies and procedures</a>
when verifying phone and fax number. It is <b>your responsibility</b>
to follow the company procedures in all interactions with customers.]]> </description>
<dataField fieldName="ContactName" columns="30" />
<dataField fieldName="ContactTitle" columns="30" />
<dataField fieldName="Phone" columns="24" />
<dataField fieldName="Fax" columns="24" />
<category headerText="Delivery Address">
<description>Customer address, city, region, postal code, and country must be recorded
in this section. Please make sure to verify the customer address with atlas of
<dataField fieldName="Address" />
<dataField fieldName="City" columns="15" />
<dataField fieldName="Region" columns="15" />
<dataField fieldName="PostalCode" columns="10" />
<dataField fieldName="Country" columns="15" />
Select and edit the same record in customer grid view. Your form will look like the one below.
Data field categories provide a convenient tool to organize data fields in a form view and provide rich HTML instructions to application users.