Dynamic Jotblock Properties S through Z
The following is a list of the properties that can be altered when using Dyanmic Jotblocks.

SignatoryEmail does not need to be specified if the JotBlock has been previously assigned in the workflow. For new JotBlocks one of SignatoryEmail, SignatoryEmailParameterName, SignatoryMobilePhone or SignatoryMobilePhoneParameterName must be specified. If SignatoryEmail is specified, it must match a signatory email being passed in the document submission XML.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String(128) | If provided, must be case-sensitive match to existing signatory | Submission will error if new JotBlock and SignatoryEmailParameterName not specified |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | yes |
Typed | yes |

SignatoryEmailParameterName does not need to be specified if the JotBlock has been previously assigned in the workflow. For new JotBlocks one of SignatoryEmail, SignatoryEmailParameterName, SignatoryMobilePhone or SignatoryMobilePhoneParameterName must be specified. This must match the parameter name of a valid parameter for this document. If a value is provided for the SignatoryEmail attribute this attribute will be ignored.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String(50) | If provided, must be case-sensitive match to user-defined name or SystemName of existing signatory parameter | Submission will error if new JotBlock and SignatoryEmail not sent |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | yes |
Typed | yes |

SignatoryMobilePhone does not need to be specified if the JotBlock has been previously assigned in the workflow. For new JotBlocks one of SignatoryEmail, SignatoryEmailParameterName, SignatoryMobilePhone or SignatoryMobilePhoneParameterName must be specified. If SignatoryMobilePhone is specified, it must match a signatory mobile phone being passed in the document submission XML. This should be used only when SMS messages are configured.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String(128) | If provided, must be case-sensitive match to existing signatory | Submission will error if new JotBlock, and SMS is used, and SignatoryMobilePhoneParameterName not specified |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | yes |
Typed | yes |

SignatoryMobilePhoneParameterName does not need to be specified if the JotBlock has been previously assigned in the workflow. For new JotBlocks one of SignatoryEmail, SignatoryEmailParameterName, SignatoryMobilePhone or SignatoryMobilePhoneParameterName must be specified. This must match the parameter name of a valid parameter for this document. If a value is provided for the SignatoryMobilePhone attribute this attribute will be ignored. This should be used only when SMS messages are configured.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String(50) | If provided, must be case-sensitive match to user-defined name or SystemName of existing signatory parameter | Submission will error if new JotBlock, and SMS is used, and SignatoryMobilePhone not sent |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | yes |
Typed | yes |

SignatoryInputType indicates the type of method of input the signer will be prompted to use for this JotBlock. If not specified this value defaults to Auto. Possible values are:
-
Auto – the application will attempt to determine the appropriate signatory input type based on other provided information. The Timestamp type must be explicitly set, however.
-
FreeText – for typed JotBlocks for which there is no ValidationType specified.
-
Prefill – for typed JotBlocks for which a ValidationType is specified.
-
Timestamp – will render a Timestamp based on the detected client machine date and time at the conclusion of the assigned signatory's signing step.
-
CustomValidation – for typed JotBlocks that will be validated using a user-defined Regex and ValidationMessage (both properties are required in order for to use this option.
-
MultipleChoiceCheckbox – for JotBlocks for which one or more selections will be made from a list of checkboxes and where the specified text or graphic will be applied to the region of the document associated with each selected option. An Options element must be specified and each TypedJotBlockOption must have a FieldRegion set.
-
MultipleChoiceGraphic – for JotBlocks for which a selection will be made from a dropdown list and where the applied information will be a graphic. An Options element must be specified and each TypedJotBlockOption must have a GraphicRenderType set.
-
MultipleChoiceRadio – for JotBlocks for which a single selection will be made from a list of radio-buttons and where the specified text or graphic will be applied to the region of the document associated with the selected option. An Options element must be specified and each TypedJotBlockOption must have a FieldRegion set.
-
MultipleChoiceText – for JotBlocks for which a selection will be made from a dropdown list and where the applied information will be text. An Options element must be specified.
A GraphicRenderType is required for 'MultipleChoiceGraphic' JotBlocks, optional for 'MultipleChoiceRadio' and 'MultipleChoiceCheckbox' JotBlocks, and not supported for 'MultipleChoiceText' JotBlocks. Valid enumerations 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 value for the selected item
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String (TypedJotBlockSignatoryInputType) | Auto, FreeText,Prefill, MultipleChoiceText, MultipleChoiceGraphic, MultipleChoiceRadio, MultipleChoiceCheckbox, Timestamp, CustomValidation | Auto |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | no |
Typed | yes |

SignatureFontSize must be one of the enumeration Six, Eight, Ten, Twelve, Fourteen. If not specified, the font of JotBlocks of FieldType Typed will be rendered as size Ten. This is only applicable to a written signature JotBlock that allows for typing of the signature or initials.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String (TypedJotBlockFontSizeType) | Six, Eight, Ten, Twelve, Fourteen | Ten |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | yes |
Typed | no |

SigningOrder should be populated with an integer value. This may be important if numerous JotBlocks are being added dynamically that will not be signed in the top-down/left-right order they appear on their pages; else, the application will present JotBlocks for signature in the reading order they appear in the document.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
Number | Attempt to determine based on page and position |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | yes |
Typed | yes |

SigningStep should be populated with an integer value that matches the number of an existing step previously defined in the workflow. In single-signatory documents, or cases where the signatory to whom the JotBlock will be presented only appears in one step, this property is irrelevant.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
Number | Must match the number of an existing step in the workflow | Attempt to add to first signing step signatory is assigned to |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | yes |
Typed | yes |

SourceGroup may be assigned a text value on multiple JotBlocks that may share input entered in the first JotBlock tagged with the SourceGroup value.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String(255) | JotBlocks sharing a SourceGroup must be of the same type |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | yes |
Typed | yes |

If ValidationMessage provided in conjunction with a Regex, this specifies the validation text displayed to the signatory if the regular expression check fails on the provided JotBlock input text. If this property is specified, a Regex must also be provided
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String(255) | Regex must also be present if specified. |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | no |
Typed | yes |

ValidationType may only be specified when FieldType is set to Typed. Possible values are:
-
None
-
Date_CurrentDatePrefill – the JotBlock contents entered by the signatory must be a date, and it will be initially populated with the current date.
-
DateDDMMYYYY_CurrentDatePrefill – the JotBlock contents entered by the signatory must be a date in the order day,month, year; and it will be initially populated with the current date in that form.
-
Date – the JotBlock contents must be a date.
-
Alphanumeric_FirstNamePrefill – the JotBlock contents must be alphanumeric, and it will be initially populated with the first name of the signatory.
-
Alphanumeric_LastNamePrefill – the JotBlock contents must be alphanumeric, and it will be initially populated with the last name of the signatory.
-
Alphanumeric_FullNamePrefill – the JotBlock contents must be alphanumeric, and it will be initially populated with the full name of the signatory.
-
Alphanumeric_EmailPrefill – the JotBlock contents must be a valid email address, and it will be initially populated with the email of the signatory.
-
Numeric – the JotBlock contents must be numeric.
-
DateShort_CurrentDatePrefill – the JotBlock contents entered by the signatory must be a date, and it will be initially populated with the current date in the form MM/DD/YYYY.
-
DateLong_CurrentDatePrefill – the JotBlock contents entered by the signatory must be a date, and it will be initially populated with the current date in the form MMMM DD. YYYY.
-
TenDigitPhoneNumber – the JotBlock contents must be a valid 10 digit phone number.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String (TypedJotBlockValidationType) | None, Date_CurrentDatePrefill, DateDDMMYYYY_CurrentDatePrefill, Date, Alphanumeric_FirstNamePrefill, Alphanumeric_LastNamePrefill, Alphanumeric_FullNamePrefill, Alphanumeric_EmailPrefill, Numeric, DateShort_CurrentDatePrefill, DateLong_CurrentDatePrefill, TenDigitPhoneNumber | None |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | no |
Typed | yes |

If InputType = Fixed then Value must be specified. The contents of Value will be written to the document at the specified location. This may also contain merge field elements enclosed in brackets.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String(8192) | If InputType = 'Fixed', this is required | If not provided and InputType = 'Fixed', throws error |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | no |
Typed | yes |

VerticalAlignment must be one of Top, Center, Bottom. If not specified, JotBlocks of FieldType Typed will be rendered with VerticalAlignment Bottom.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
String (TypedJotBlockVertAlignmentType) | Top, Center, Bottom | Bottom |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | no |
Typed | yes |

Width must be a value between 0 and 1. This is calculated as the ratio of the width of the JotBlock to the overall width of the visible portion of the page in pixels:
Width = [JotBlock Width] / [Page Width]
Note that the Nintex eSignapplication will enforce a minimum height and width to ensure that all elements render correctly to the document.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
Decimal Number | If provided, between 0 and 1 | Minimum field width (taking 'Certified' into account) |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | yes |
Typed | yes |

If WordWrap is true will wrap the contents of JotBlocks of FieldType Typed within the JotBlock frame.
Data Type | Restrictions (Case sensitive) | Default if Not Specific (New Jotblocks) |
Boolean | false |
Jotblock Type | Supported |
Text Tag | yes |
XML | yes |
Written | no |
Typed | yes |