Using Rules and Record Layout

When the element you create is structured (displayed in a table-like format, also referred to as a "grid" or "gridable"), except for Document elements, options appear during mobile application creation (or editing) that allow you to isolate specific pieces of element content on which you can perform these postprocessing options:

Defining record layout – allows you to define the record layout and specify a record header.
Adding split rules – allows you to split columns or rows using commas, spaces, and so on.
Adding filter rules – allows you to add rules to filter the records so only the specified data displays.
Adding and editing records and fields – allows you to add and modify records and fields.

Defining record layout

The Define Record Layout options include:

Row or Column – specify record orientation; column- or row-based.
Records Contain Labels – select if the records do or will contain field labels.
Labels Are Displayed in Record – displays when you select Records Contain Labels. Enter the record number in which the labels display.
Transpose Rows and Columns – select to display the rows as columns and the columns as rows.
Click Preview to see the result of defining the record layout.

Adding split rules

Split rules allow you to add parameters by which to split the columns or rows in the table. To add a split rule, click Add. Or highlight an existing split rule and select Edit. Add and modify split rules and filter rules from the same screen. The Add Split Rules options are:

Split – split the table by All Rows, a specific Row No. (enter the row number in the text box after the Split drop-down list), All Columns, or a specific Column No. (enter the column number in the text box).
By – split the rows or columns by Line Feed, Space, Comma, or Other. When you select Other, specify the delimiter to use in the text box to the right of the delimiter drop-down list.
Personalize – select this option to enable the retrieval of values from external systems or databases and automatically submit them to the mobile application. Personalization adapters must be registered with Unwired Accelerator before they appear in the Personalization drop-down. See the Unwired Accelerator Developer's Guide for more Information.

To remove a split rule, select the rule in the Rules section and click Remove.

Adding filter rules

The Include/Exclude rule options are:

Include/Exclude – select the type of Filter Rule to create:
- Include Records
- Exclude Records
- Include Fields
- Exclude Fields
Record(s) Number – to specify the position of the record to filter. Enter the numbers or ranges of numbers for the filter rule.
Record(s) Where – to specify a condition for the filter rule. Select the field where the condition should be met.
Select the Boolean argument for the filter rule.
Enter the value for the filter rule in the last input field.
Click Add to add the filter rule. The preview highlights any records or fields that match the filter rules.
Field(s) Number – to specify the position of the field.
Field(s) Label – to include or exclude a field specifically by the contents of its label.

Inserting a Record

Select Insert Record and select Before or After from the drop-down.
Enter a number in the Number field to identify where the record is to be inserted. When you click Preview, the inserted record displays in the preview.

Inserting a Field

Select Insert Field and select Before or After from the drop-down. (There are two ways to create an insert field rule: besides “entering a number in the number field,” you can also “select the label from the label drop-down”).
Enter a number in the Number field to identify where the field is to be inserted. When you click Preview, the inserted field displays in the preview.

Edit Record Number

Select Edit Record Number and enter the number of the record and the number or name of the field you want to edit in the corresponding fields.
Select Value (indicates that you are replacing the existing value with a numeric value or text string) or Image (indicates that you are replacing the existing value with a graphic image)from the drop down list to indicate with what the existing cell is to be replaced.
In the next field enter:
- For Value – specify ranges of existing cells and perform functions on those cells. Syntax should be in the form of
```
<command> (args[,...])
```
- For Image – enter the image name and the full path of the image. The image must exist in the OnePage images directory, located at web_app_root\onepage\images, where web_app_root is the root of all Web applications on the application server.