Defining Dynamic Multiple Choice JotBlocks in XML
The following are some examples of specifying complex multiple choice JotBlocks; these examples are not exhaustive.
In order to specify the contents of a dropdown list via XML where the acceptable choices are “Yes” and “No” and where yes applies a checkmark graphic, the following XML could be specified:
<JotBlocks>
<JotBlock … >
<TypedProperties SignatoryInputType="MultipleChoiceGraphic">
<Options>
<TypedJotBlockOption Text="Yes" TextValue="true" GraphicRenderType="Check"/>
<TypedJotBlockOption Text="No" TextValue="false" GraphicRenderType="Empty"/>
</Options>
</TypedProperties>
</JotBlock>
</JotBlocks>
While the choices presented to the signatory will be “Yes” and “No”, the recorded data based on this configuration will be “true” and “false” and a checkmark with an outline will be applied for a “Yes”.
In order to specify a radio-button selection JotBlock where options are associated with different areas on the document via XML, the following XML could be specified:
<JotBlocks>
<JotBlock … >
<TypedProperties SignatoryInputType="MultipleChoiceRadio">
<Options>
<TypedJotBlockOption Text="Yes" TextValue="true" GraphicRenderType="Check">
<FieldRegion Page="1" PositionX=".25" PositionY=".3" Height=".02" Width=".05" />
</TypedJotBlockOption>
<TypedJotBlockOption Text="No" TextValue="false" GraphicRenderType="X">
<FieldRegion Page="1" PositionX=".25" PositionY=".3" Height=".02" Width=".05" />
</TypedJotBlockOption>
</Options>
</TypedProperties>
</JotBlock>
</JotBlocks>
In this case while the choices presented to the signatory will be “Yes” and “No”, the recorded data based on this configuration will be “true” and “false” and a checkmark or an x with an outline will be applied to the corresponding location on the document depending on the selection made by the signatory.
Valid GraphicRenderType enumerated values are:
-
None - will render nothing
-
Empty - will render an empty square box
-
Check - will render a check mark graphic in a box
-
X - will render an X graphic in a box
-
NoBoxEmpty
-
NoBoxCheck - will render a check mark graphic
-
NoBoxX - will render an X graphic
-
Text - will render the Text for the selected item
-
Value - will render the TextValue for the selected item