- FieldSet{}: LayOut, Order, Appearance, and Customize

FieldSet{}

For information on the FieldSet{} property group, see Laying Out Details Screen below.

Laying Out Details Screens From Operation Properties

Laying out Detail Screens from Operation properties covers the following topics:

• Field Set Order

• Field Set Appearance

• Customizing Fields

• Changing Column and Row Spans

• Adding Empty Cells

• Adding Text

Field set order

Typically WOW will order field sets based on the Display Order of the fields contained in each field set (specifically the field with the lowest display order). However, you can override this order by using the field sets property of the DetailDisplay property group:

DetailDisplay {

field sets: Name, Contact Info, Account;

}

This property group would display the Name, Contact Info and Account field sets in that order, regardless of the display order of their fields.

The special name "_blank" can be used to refer to a field set whose name is an empty String.

If the field sets property is present, then any field sets in the Row which are not listed in the property will not be shown in the details screen.

Field set appearance

The FieldSet property group can be used to control the layout of fields within a field set. Here is an example of the FieldSet property group:

FieldSet {

name: General Info;

line1: name, birthdate;

line2: telephone, cellphone;

line3: address;

line4: city, state, zip;

}

This property group tells WOW which fields to place on which lines of the details screen (in this example "name", "birthdate", "telephone", etc are all names of fields in the Row). When a FieldSet is defined it will override WOW's normal screen layout. Regardless of what display order the fields in the field set would normally have, they are displayed in the positions specified in the property group. Even if the fields would otherwise be in a different field set, they will appear in the field set specified by the property group.

Customizing fields

When a field is listed in the FieldSet property group you can also specify additional properties which apply to that field. For example:

FieldSet {

name: General Info;

line1: name[label:Customer name; Association Operation:1234; Updateable: false], birthdate;

line2: telephone, cellphone;

line3: address;

line4: city[label:_blank], state[label:_none], zip[label:_none];

}

This property group sets additional properties on the name, city, state, and zip fields. The label on the name field is set to "Customer name", and its association operation is set to operation 1234. The labels on the city, state and zip fields are all hidden from view. The keyword _blank will set the label to an empty string, however there will still be an empty HTML table cell containing the blank label. When the label is set to the keyword _none, then WOW will not render the table cell for the label at all.

Any setting available when editing a field descriptor can be set from the property group. For more information on setting properties on field descriptors, see the documentation for “Field Descriptor Properties”. Setting properties of a field descriptor works the same way regardless of whether they are being set in a separate FieldDescriptor property group, or if they are being set inside of a FieldSet property group, as described on this page.

In the above example, the name field has the update-able property set to false. This will cause it to be rendered as text, as opposed to an input field. There is also the read only property; when read only is set to false the field will be rendered inside of an input but the user will not be allowed to change its value.