Using mutually exclusive checkboxes

Mutually exclusive checkboxes

What are mutually exclusive checkboxes? If presented with two or more checkboxes or option buttons (commonly referred to as "radio buttons"), you may only select one. Checkboxes are mutually exclusive in that if one box is checked the borrower cannot check another related check box.

Group ID's

The GroupID element aggregates related checkboxes and option buttons together. The GroupID allows you to specify a string of letters and numbers which groups two fields with the same GroupID together when the PDF is produced by the engine.

Scenarios and FAQ's

Yes and No question: there is a Yes and No checkbox on a document - these checkboxes are setup with the same GroupID, and the customer should ONLY be able to check ONE of those boxes (must make the choice between Yes or No). How is it communicated in the Expere Response file that only 1 box can be checked in that GroupID. The fillable checkbox elements for Yes and No share the same GroupID element; this means that you can ony select one checkbox.

Using either a checking or savings account: if the user has an option to use either a checking or savings account as a way to draw funds for a reoccurring payment, two option buttons would exist: checking, and savings. User can only select one option, then enter information pertaining to that account.

Using either a credit card or check to pay a bill: if the user has an option to use a credit card or attach a blank check in order to pay a bill, two checkboxes would exist: CREDIT CARD, and CHECK. User can only select one option.

Sample response file - code snippet

Mutually exclusive checkboxes/radio buttons share the same GroupID element. In the example below, we have a Yes and No option that shares the same GroupID.

<r:FillableFieldSet>
             <r:FillableCheckbox>
                 <r:Id>BorrID</r:Id>
                 <r:EmailAddress>test@email.com</r:EmailAddress>
                 <r:FieldName>yes</r:FieldName>
                 <r:ToolTip>yes</r:ToolTip>
                 <r:Checked>true</r:Checked>
                 <r:PageNumber>1</r:PageNumber>
                 <r:XCoordinate>154.29</r:XCoordinate>
                 <r:YCoordinate>661.22</r:YCoordinate>
                 <r:GroupID>Group1</r:GroupID>
                 <r:Mandatory>No</r:Mandatory>
            </r:FillableCheckbox>
            <r:FillableCheckbox>
                 <r:Id>BorrID</r:Id>
                 <r:EmailAddress>test@email.com</r:EmailAddress>
                 <r:FieldName>no</r:FieldName>
                 <r:ToolTip>no</r:ToolTip>
                 <r:Checked>false</r:Checked>
                 <r:PageNumber>1</r:PageNumber>
                 <r:XCoordinate>263.5</r:XCoordinate>
                 <r:YCoordinate>661.22</r:YCoordinate>
                 <r:GroupID>Group1</r:GroupID>
                 <r:Mandatory>No</r:Mandatory>
        </r:FillableFieldSet>