AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.
HTML5 forms are increasingly being used on touch devices, and one common requirement is to support signatures. Scribing (Writing with a stylus or finger) is becoming an accepted way of signing forms on mobile devices. HTML5 forms and Forms Designer now enable the option of having a scribble signature field on the form. When the form is rendered in the browser, one can sign on these fields using a stylus, mouse, or touch.
Open a form in Forms Designer.
Drag and drop the Signature Scribble field on the page.
Dimensions of the field selected in Forms Designer are reflected when the field is rendered. However, the dimension of the rendered signature box is calculated based on the aspect ratio of the field, and not on the dimension specified in Forms Designer.
Configure the Signature Scribble field.
The Signature Scribble field, by default, marks geolocation information as mandatory during the signing process on iPad (and is optional for other devices). This default behavior can be overridden by changing the value of the
geoLocMandatoryOnIpad property. This property is exposed as extras in the Signature Scribble Field. The steps to modify it are:
On the form, select the Signature Scribble field.
Select the XML Source tab.
To open the XML Source tab, click View > XML Source.
<ui> tag in the
<field> tag and modify the source code to look like the following:
<extras name="x-scribble-add-on"> <boolean name="geoLocMandatoryOnIpad">0</boolean> </extras>
Select the Design View tab. On the confirmation box, click Yes.
Save the form.
Render the form on a supported device/desktop browser.
Once a Signature Scribble field has been added to the form and rendered, clicking or tapping on the field opens a dialog box. The user can scribble a signature in the draw area designated by a dotted rectangle, using a mouse, finger or stylus.
A. Brush B. Eraser C. Geolocation D. Geolocation information
Clicking the geolocation icon while creating the scribble causes geographic location and time information to be embedded into the field.
On the iPad, by default, embedding geolocation information is mandatory.
On the iPad, the geolocation icon is not shown by default, and the geolocation information is automatically embedded, when you click OK.
For iPads, this setting can be altered by modifying the value of
geoLocManadatoryOnIpad parameter to
0, in the init parameters of the field.
While using this feature, a user can click the Eraser icon to clear the field, and start over. If geolocation information was added it is cleared, too.
Clicking the OK icon saves the scribble as an image in the field. The image and values can be submitted to server for further processing. Once a user has clicked OK, the scribble filed is locked. The signature cannot be edited again using the scribble widget.
Tapping or clicking the Scribble field opens the dialog box in read-only mode.
Click the Brushes icon to display a list of available pen sizes. Click or tap a pen size to use the corresponding pen.
To delete the signatures from the form: