Videosign User Guide

Overview

The signaturepad component has the feature to record a video to be used as signature data. In other words, the signpad can work normally, or can also be signed while recording the user. This can be useful when there is the need to proof who was the person signing the form, since the video can be played anytime for confirmation.

Specifications

The functionality can work in any of the three main types of OZ Viewer: HTML5, iOS, and Android. However, the OZ Viewer and the OZ Designer need to be the version 9.0. In other words, this functionality cannot be used with the OZ Viewer 8.0 version.

Activating Videosign and Videosign audit information

Videosign functionality can be activated by setting up the following parameters to true in the OZR file.

1) signpad_use_video_audit: Parameter for enabling videosign functionality.

2) SetUseVideoAudit: Parameter for activating videosign in that particular signpad component.

3) signpad_show_video_audit_info: Optional parameter for showing the information of the video in the document when previewing, saving, or printing.

// OnStartUp event of ReportTemplate
This.SetReportOption("eform.signpad_use_video_audit", "true");
This.SetReportOption("eform.signpad_show_video_audit_info", "true");

// OnBind event of Signpad component
This.SetUseVideoAudit(true);

Parameters (signpad_videoaudit_option_json)

Different options can be configured for the videosign feature. The configuration is made through a json string called "signpad_videoaudit_option_json" which can be set as a viewer parameter. The options available for configuration can be seen next:

Frame	high, middle, low (default)	Recording frame level
Resolution	high, middle, low (default)	Recording resolution level
SoundRecord	true | false (default)	Whether to record sound
TimeLimit	integer (default:20)	Signature timeout (unit: seconds)
FaceDetect	true (default) | false	Whether to check facial recognition when saving signature data
ErrorActionType	message (default), keepsign	Error type when video signature cannot be executed message: A message window is displayed. keepsign: Displayed as a regular signature pad. * Error message Video signature cannot be performed.
GuideText { FaceDetect: "", InputSign: "" }	string (default: empty)	Intructions to be dsplayed on the screen (if the value is empty, the information area is not displayed)

In the following code, an exemplification of the json string can be seen.

// Example of eform.signpad_videoaudit_option_json
{
    "Frame" : "low",
    "Resolution" : "low",
    "SoundRecord" : "false",
    "FaceDetect": "true",
    “Thumbnail” : true,
    "TimeLimit" : "30"
    "Error ActionType" : "keepsign"
    "Guide Text " : {
        "FaceDetect": "Please make sure your face is visible on the screen.",
        "InputSign": "The signature must be completed within the given time."
    }
}

Finally, the json string can be set inside the OZR file through its SetReportOption method in the OnStartUp event of the ReportTemplate:

// OnStartUp event of ReportTemplate
var json = "{\"Frame\":\"low\",\"Resolution\":\"low\",\"SoundRecord\":\"false\",\"FaceDetect\":\"true\",\"TimeLimit\":\"30\",\"ErrorActionType\":\"keepsign\",\"GuideText\":{\"FaceDetect\":\"화면에 얼굴이 보이도록 해주세요.\",\"InputSign\":\"정해진 시간 안에 서명을 완료해야 합니다.\"}}";
This.SetReportOption("eform.signpad_videoaudit_option_json", json);

Use Flow

a) face recognition screen (not in HTML5)

b1) signing screen

b2) singing screen (group)

c) face recognition failure screen

d1) video playback screen

d2) signature screen

a) Face recognition screen: Initial screen where the user needs to use the face recognition system (this screen does not show in the HTML5 viewer).

b1), b2) Signing screens: Screens for signing, depending on wether the signing consists on one signpad, or in two signpads grouped together.

c) Face recognition failure screen: Screen that pops up if the face recognition was not succesfully. In that case, the user goes back to the face recognition screen and needs to sign again. (This screen does not show in HTML5 viewer).

d1) video playback screen: The user can play the video recording anytime to review the signature process.

d2) signature screen: The user can also review the signature itself.