Use Data Hierarchy Modifier builder to group data fields generated by a Data Page builder or one of the builders that rely on Data Page builder, for example, Domino View & Form builder.
Use this builder when you want to create visual grouping of data fields for display in forms.
By grouping fields you can control the displayed presentation of data fields on the page. For example, you might have a Data Entry or a Details page with more fields than you are willing to show in a flat list. You can separate the fields into logical groups. This builder lets you create groups and then use drag-and-drop to put the fields into the groups.
The ability to group fields is especially useful when you have defined a Page Automation HTML template so that the Page Automation tools (Data Page builder and its associated builders) can construct the entire page to look exactly the way that you want. By splitting the fields into groups, you can cause the Page Automation system to use the Display Group or Data Entry Group HTML constructs when displaying the data, even though the data is not logically grouped in the schema.
The builder constructs new container elements within the Page Automation contents, in internal representation of the data as it maps to the page. These new containers have a property that they are data transparent. They do not affect the read or write access to the data. However, the containers are treated normally for rendering the page.
The Data Hierarchy Modifier builder does not affect the structure or layout of the data in the XML variable, bean, or wherever the data source is. Access to the data, both for reading and for writing, is unaffected by this builder.
Visually group data entry or display fields
If you use the Page Automation builders (Data Page and related builders) to create the form, you can achieve the grouping effect while allowing the Page Automation system to generate the page completely.
First, create a Data Hierarchy Modifier builder and select the container which is the parent of your large list of fields. You should see the fields appear in the table below. Next enter the names of the groups in New Group Names
. Separate names by commas and use only valid alphanumeric characters. (You can later enter labels for the display of the group names.) When you tab off of this field, start and end group tags are inserted in the table.
Next, use drag and drop to reorder the fields by placing fields into the groups. You can also hide and show fields, and change their labels. You can also change the labels for the groups, if the alphanumeric characters restriction was too limiting.
When you apply this builder call, the representation of the data is changed to include these new groups. If you are using HTML Templates in your Data Page builder, the new hierarchy is used to create visual groups when the page is constructed.
Parent topic: Builder Reference: wpf7
About using the builder call editor: wpf7
Overview: creating forms: wpf7