Skip to main content
Version: 9.4

App Kiosk Mode

The App Kiosk Mode is designed for providing the possibility to let unauthorized persons fill out forms in a secure way. In "single"-App Kiosk Mode an authorized person has to open a new form, switches to App Kiosk Mode and can then pass along the device to another person. To unlock the kiosk mode a pin is required. In "sequential"-App Kiosk Mode once it is activated, one form after another is opened without leaving the App Kiosk Mode.

Formdefinition

To enable the App Kiosk Mode a new App Kiosk Mode var tag has to be set within the form tag:

<var data-hf-name="AppKioskMode" ... ><var>

There are several configuration options

PropertyOptions/TypeDescription
data-hf-unlockcode*numberDefines the App Kiosk Mode unlock code. Only numbers are allowed
data-hf-locktime*numberDefines the App Kiosk Mode lock time in minutes. After n minutes the kiosk mode would be locked.
data-hf-kioskmode*Enum: singleDefines the app kiosk mode type: Single means that the app kiosk mode is activated on the formpage.
data-hf-kioskapprovelabelstringDefines the wording of the App Kiosk Mode approve label.
data-hf-data-hf-kiosklocklabelstringDefines the wording of the App Kiosk Mode lock label.
data-hf-kioskactivatefeaturesbooleanDefines if the form-activated app features (camera, sketches, map etc.) are also activated in the App Kiosk Mode
data-hf-kioskshowpinonlockbooleanDefines if pin is shown to the user when the app is getting to be locked in App Kiosk Mode (only single kiosk mode)

* These options are required

Example configuration
...
<form>
<var data-hf-name="AppKioskMode"
data-hf-kioskmode="single"
data-hf-kioskunlockcode="123456"
data-hf-kiosklocktime="1"
data-hf-kioskapprovelabel="Approve"
data-hf-kioskactivatefeatures="false"
data-hf-kioskshowpinonlock="false">
</var>
</form>
...

Condition

For handling which pages, tabs, blocks or HFWinJSCtrl.Condition areas are used within an active App Kiosk Mode the condition expression type kiosk will be used. For further information on the topic of Conditions an how to use them, see here.

Example Usage Tab
<form>
...
<li data-hf-title="Repair"
data-hf-condition='{
"cond": [
{
"type": "kiosk",
"val": false
}],
"else": "disabled"
}'>
<a href="#repair-block1"></a>
<a href="#repair-block2"></a>
<li>
...
</form>
Example Usage HFWinJSCtrl.Condition
<div id="invisible-control-kiosk" 
data-win-control="HFWinJSCtrl.Condition"
data-hf-condition='{
"cond": [
{ "type": "kiosk", "val": true }
],
"else": "invisible"
}'>
...
</div>

Server

  • The App Kiosk Mode state is only stored on the client.
  • The synchronization is stopped during the App Kiosk Mode is enabled. Data would only be stored on the device. When App Kiosk Mode is disabled, synchronization will be triggered.

PDF Rendering

  • PDFs are rendered as like the App Kiosk Mode is disabled.