Click on Images to Expand Them
A field group is an area on the page that contains several fields, which are in some way related to each other. Field groups can be copied and pasted in their entirety. Also, they can be made Repeatable – so, that the user can choose how many times the same set of fields needs to be filled out. This is often the case with having several joint owners of an account – the same information must be filled in by each joint owner, or in case of several contact phones, or several previous residence addresses, etc.
Field Groups can also be nested within each other with or without the Repeatable option.
Meta Field Names for field group fields are concatenated from the prefix specified in the group’s Meta field pattern and the short Meta Field Name specified for each field. In the case of a repeatable group, add an index counter to the pattern
. To access values of fields from within the Field Group use model.parent.value["Local Meta Field Name"] .
Pattern | Meta Fields | Result |
|---|
Entity1.Home
|
AddrLine1
AddrCity
Country
| Entity1.HomeAddrLine1
Entity1.HomeAddrCity
Entity1.HomeCountry
|
PriorEmployerOffice{{$index+1}}
| AddrLine1
AddrCity
Country
| PriorEmployerOffice1AddrLine1
PriorEmployerOffice1AddrCity
PriorEmployerOffice1Country
|
PriorEmployerOffice2AddrLine1
PriorEmployerOffice2AddrCity
PriorEmployerOffice2Country
|
Beneficiary{{$index+1}}.
| FirstName
LastName
| Beneficiary1.FirstName
Beneficiary1.LastName
|
Beneficiary2.FirstName
Beneficiary2.LastName
|
Trustee{{$index+1}}.BirthPlaceAddr
| Line1
City
State
| Trustee1.BirthPlaceAddrLine1
Trustee1.BirthPlaceAddrCity
Trustee1.BirthPlaceAddrState
|
Trustee2.BirthPlaceAddrLine1
Trustee2.BirthPlaceAddrCity
Trustee2.BirthPlaceAddrState
|
model.parent.value["Local Meta Field Name"] .Example Field Group
The example below
shows how to create one field group for a Mailing Address and then copy it for a Legal Address.
Step
Result | 11: Adding a Field Group to the Page
| Rw ui steps macro |
|---|
Open Add Field panel. Add a |
Field Group to the page. Enter the following valuesfor the field settings: |
Image Removed
Adding a Field Group 2 |
|---|
Field Label | <h2>Mailing Address</h2>
This is the label of the Field Group that will be visible to the user. |
|
3 | Name | EntityMailingAddress
This is the name of the Field Group as it appears in the Page Tree and as it is referenced in JSON. |
|
| Meta field pattern | Entity1.Mailing
This is the prefix that will be added to Meta Field Names of fields contained in the group. |
|
at the bottom of the screen to close the Widget Design Screen and apply changes. |
at the top of the Widget Details Screen to save these changes. Return to the Docupace Start window and you will see the new Field Group in the page tree. |
| 7 
Image Added Step 2: Add Fields to the Group
| Rw ui steps macro |
|---|
Open the field Group in one of two ways: |
|
The field group opens in edit mode |
|
| 8 | Add several fields to the group, for example: - Address Line 1
- Address Line 2
- City
- Country – US or Other
- Zip/Postal Code
- State (visible if Country = US)
- Home Country (visible if Country = Other)
|  Image Removed
Adding fields to a Field Group |
Field Type | Settings | 9 | Single Text | . Initially, it looks like an empty page. |
|
 Image Removed
Opening a Field Group in edit mode | Single Text Image Added |
Add a single text field for Address Line 1 and enter the following values: |  Image Added |
Setting | Value |
|---|
Field Label | Address Line 1
| Meta Field Name | AddrLine1
| Meta Field Name | AddrLine1
| Max Input Length | 50
|
|
10 | Add a single text field for Address Line 2 and enter the following values: Setting | Value |
|---|
Field Label | Address Line 2
| Meta Field Name | AddrLine2
| Max Input Length | 50
|
|
Add a Single Text field for City and enter the following values: Setting | Value |
|---|
Field Label | City
| Max Input Length | 50
| Meta Field Name | AddrCity
|
|
Max Input Length | 50 | New Line | Selected | Size by content | Selected |
|
Add a Single Selection field for Country (US or Other) and enter the following values: Setting | Value |
|---|
Field Label | Country
| Meta Field Name | countrySwitch1
| Display Type | Radio List | Layout | Horizontal | Choices | Value = 0 Label = US | Choices | Value = 1 Label = Other | Size by content | Selected |
|
Add a Single Text field for Zip/Postal Code and enter the following values: Setting | Value |
|---|
Field Label | Zip/Postal Code
| Meta Field Name | AddrZip
| Max Input Length | 10
| New Line | Selected | Size by content | Selected |
|
Add a Domain Single Selection field for State (visible if Country = US) and enter the following values: Setting | Value |
|---|
Field Label | State
| Meta Field Name | AddrState
| Data Attribute | 100801
| Display Attributes | 100801
| Domain | States | Display Type | Select | Visibility Condition | model.parent.value[“countrySwitch1”]==0
| Size by content | Selected |
|
Create a Single Value Form Dropdown |
for Home Country (visible if Country = Other). Alternatively, you can add a Domain Single-Selection field, if you have a Countries |
. Enter the following values: Setting | Value |
|---|
Field Label | Home Country
| Meta Field Name | Country
| Dropdown # | Countries
| Display Type | Select | Visibility Condition | model.parent.value[“countrySwitch1”]==1
| Size by content | Selected |
|
Exit the Field Group editing mode by clicking on the page name in the Page Tree. |
Step 3: Copy the Field Group to the Clipboard
| Rw ui steps macro |
|---|
To copy the Field Group to the clipboard, hover over it |
 Image Removed
Pasting a copy of a Field Group | 18icon. Click the Paste After icon. |
Image Added Step 4: Update the Field Values
| Rw ui steps macro |
|---|
Select the identical pasted field group and change the following field values: |
Image RemovedChanging the settings of a pasted GroupField19<h2>Legal Address</h2> | This is the label of the Field Group that will be visible to the user. |
|
<h2>Legal Address</h2>
| Name |
|
EntityLegalAddress
This is the name of the Field Group as it appears in the Page Tree and as it is referenced in JSON. |
|
EntityLegalAddress
| Meta field pattern |
|
Entity1.Legal | This is the prefix that will be added to Meta Field Names of fields contained in the group. |
|
at the bottom of the screen to close the Widget Design Screen and apply changes. |
at the top of the Widget Details Screen to save these changes. |
Image AddedTest the widget by opening it. There should be two field groups – Mailing Address and Legal Address. The Country switch (US or Other) should work independently for each group.
Image Removed
A wizard with two Field Groups
