Sections

Sections divide a form into logical groupings that are visually marked on the window with boxes around the fields in each section. They can be specified in the XML for all policies except application and role provisioning policies. By default, a separate section is created on the provisioning form for each application (each application's provisioning policy form is rendered in its own section). However, fields in a provisioning policy form can be specified with a section attribute that causes them to be displayed in different sections from the defaults. Sections are treated differently on report forms, each section becomes a separate page on the Edit Report window rather than just a separate section on a contiguous form.

Sections are specified in the form object's XML with a <Section> tag and can be modified by the attributes shown in the table below.

 

Section Attributes

Description

name

Internal name for section (might be referenced by field objects in some forms).

label

If non-null, the label is displayed above the section fields in a box on the section border.
For report forms, the label is specified in the Edit Report window's sections list.
Labels can be specified with text, message catalog keys, or variables (specified with $(varName) notation).

type

Rendering type (optional).
When no type is specified, fields in the section are editable fields, displayed one field per row, unless the columns attribute specifies otherwise.
Other type options are:
datatable – makes fields in the section non-editable; generally used to display a read-only informational table to give the form user a context for the form's requested data.
text – indicates the section is a block of informational text; if multiple fields are included in a text section, each field is rendered on a separate line with line breaks between them.

columns

Number of columns contained in the form section; fields are placed in columns left to right, one field per column before moving to the next row.

For example, in a 2 column layout (columns="2"), 4 fields are displayed:
Field 1 Field 2
Field 3 Field 4

These are examples of Section elements in the XML for forms.

Copy 
<Section name="authorizations" label="Authorizations" type="datatable">
<Section columns="2" label="rept_app_section_label" name="customProperties">

Sections contain nested field elements and might contain nested sections when sub-groupings are needed.