Definition: A 'group name' is simply a keyword typed between exclamation marks that is used to tie two or more related multiple choice values (either options or variable text) together so that the value assigned to the first appearance of the choices carries forward to the remaining members of the same group.
Usage: The value assigned to one multiple choice variable frequently suggests the answer to a subsequent multiple choice variable. For example, if “he” is selected as the value for multiple choice variable [he/she/it]. then, “he” (or “him” or “his”) likely will be the selection for another multiple choice variable further down in the document for the same ‘actor.’
But unless the program has some way of knowing what selections go 'together', you are forced to make choices from multiple choices one at a time. That's where !groups! come into play. Simply insert a !groupname! at the proper location and magic happens. For variables, you would insert the !groupname! immediately after the variable boundary, between exclamation marks. The !groupname! can be a single letter, a word or phrase: [!groupname!variablename].
From now own, when a selection is made for the first member of the group the remaining members of the group will assume the same positional value.
NOTES: 1. The processing of groups is 'positional'. So make sure that the order of the choices in one group is the same order for all other members of the group.
2. The green color used in the above and below samples to indicate a !groupname! is used for emphasis and illustration only. Color is NOT required.
Number and gender matching.
[!client!He/She/They] . . . . [!client!wants/wants/want] . . . [!client!is/is/are] . . . (etc.)
The first selection of the first member of the group leads to the selection of the first selection from the second appearance of the group.
The astute observer will note that the same can be accomplished by simply combining the verb and noun variables as a single variable. E.g.,
"[He wants/She wants/They want]".
And that is the preferred setup when the text is as simple as the example. But in many cases, the text you want to pair up are in disparate locations, involve different verbs and or settings. Ultimately you will decide on the best setups.
Here is an example illustrating the use of !groupnames! in the signature block of a standard Will where the groupname !willmaker! is used in many locations:
IN WITNESS WHEREOF, I have set my hand and affixed my seal unto this, my Last Will and Testament, on the ________ day of ____________, 20_____.
[Testator Name], [!willmaker!Testator/Testatrix]
STATE OF VIRGINIA
County of York, to-wit:
Before me, the undersigned authority, on this day personally appeared [TESTATOR NAME], known to me to be the [!willmaker!Testator/Testatrix] whose name is signed to the attached or foregoing instrument and being by me first duly sworn, declared to me that said instrument is [!willmaker!his/her] Last Will and Testament and that [!willmaker!he/she] willingly signed the same as [!willmaker!his/her] free and voluntary act.
Still more examples:
Attorneys, their bar numbers and addresses, with email:
[!atty!Alice Attorney/Barney Barrister/Clarence Counselor]
123 Main Street Anytown, USA 22345
[!Owner!He/she] went with [!owner!his/her] dog to the pet store because [!owner!he/she] wanted to buy [!dog!him/her] a new collar. Blue is [!owner!his/her] favorite color.
(Perhaps the last group name is supposed to be “[!dog!his/her]”?)
!Groups! are not limited to variables. They can be used for Optional and Options text (both simple and robust.). See this page in the main manual.