Skip to content

Hand Signature

HandSignature captures a handwritten signature in a 300 × 180 canvas and uploads it as a PNG through the file upload service. The bound node stores the file identifier and receives file metadata, including the uploaded URL. If the existing value is a revisioned file, a new revision can be linked instead of replacing the identifier.

XML Fields

  • XPath identifies the form-data element that receives the uploaded signature file reference and its metadata.
  • Hints supplies guidance next to the widget, such as the purpose of the signature.
  • Rules contains any form rules that control this widget. Use a validation rule for mandatory signatures; HandSignature has no RequiredForGroup setting.

The signature canvas size and PNG upload format are fixed by the widget. The XML definition only chooses where the resulting file is stored and which help or rules apply.

Availability and Required Validation

The signing dialog is available only when the widget is editable and the current user has file-upload permission. The dialog provides Clear and Undo commands and refuses an empty signature. Use a separate validation rule if a signature is mandatory.

This widget records a graphical signature, not by itself a legal-signature workflow. Apply the required identity, audit, consent, certificate, and retention controls in the surrounding process where legal or evidentiary signing is required.

Example

1
2
3
4
<HandSignature XPath="Approval/Signature">
    <Hints><![CDATA[]]></Hints>
    <Rules />
</HandSignature>