From wiki.ginstr.com
Jump to: navigation, search
m
Line 120: Line 120:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears at the top of the '''audio''' widget on the app screen.
+
::defines the text which appears at the top of the '''audio''' widget on the app screen.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide an audio recording before submitting the form).
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide an audio recording before submitting the form).
::'''error message in case of input error'''
+
:::'''error message in case of input error'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''audio''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''audio''' widget which is added to the app).
 
|}
 
|}
  
Line 145: Line 145:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears at the top of the '''barcode''' widget on the app screen.
+
::defines the text which appears at the top of the '''barcode''' widget on the app screen.
  
'''hint'''
+
:'''hint'''
:defines the text which appears within the empty code field.
+
::defines the text which appears within the empty code field.
  
'''alignment'''
+
:'''alignment'''
:this dropdown offers the choice between two options:
+
::this dropdown offers the choice between two options:
::;vertical:displays the "scan code" button below the code field
+
:::;vertical:displays the "scan code" button below the code field
::;horizontal:displays the "scan code" button on the same line as the code field
+
:::;horizontal:displays the "scan code" button on the same line as the code field
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to scan a barcode before submitting the form).
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to scan a barcode before submitting the form).
::'''error message in case of input error'''
+
:::'''error message in case of input error'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
 +
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 +
 
 +
:'''min. length'''
 +
::defines the minimum number of characters which can be accepted as a barcode.
 +
::If <code>0</code> is entered here the default minimum of 1 character will apply.
 +
:::'''error message'''
 +
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the code you have entered is too short (<code>min. length</code> char min)" (where <code>min. length</code> is the '''min. length''' defined in the field above) will be shown if the barcode entered by the app user has fewer characters than the defined '''min. length'''.
 +
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 +
 
 +
:'''max. length'''
 +
::defines the maximum number of characters which can be accepted as a barcode.
 +
::If <code>0</code> is entered here there will be no limit on the maximum number of characters.
 +
:::'''error message'''
 +
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the code you have entered is too long (<code>max. length</code> char max)" (where <code>max. length</code> is the '''max. length''' defined in the field above) will be shown if the barcode entered by the app user has more characters than the defined '''max. length'''.
 +
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 +
 
 +
:[[File:checkbox0.png|link=]] '''is unique'''
 +
::Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
 +
 
 +
<u>actions</u>
 +
 
 +
:'''query type'''
 +
::'''query single result'''
 +
:::retrieves a single record from [[ginstr web]] which matches the scanned barcode
 +
::::This option should only be used if the [[ginstr web]] table contains '''unique''' barcode records.
 +
::'''query sorted result'''
 +
:::retrieves all records from [[ginstr web]] which matches the scanned barcode
 +
::::Selecting this option reveals the otherwise-hidden '''sort by''' dropdown (see below).
 +
 
 +
:'''widgets to load'''
 +
::defines which of the widgets currently on screen should load data from the '''ginstr web''' app table when the query button is pressed.
 +
::All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
 +
::Only the widgets selected in the list below this checkbox will be cleared by this reset button.
 +
 
 +
:::'''sort by'''
 +
::::The loaded information can be sorted by widget by selecting a widget name from the '''sort by''' dropdown.
 +
 
 +
:'''messages'''
 +
::'''on no rights'''
 +
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown to a [[SSO_common_content#subaccounts|subaccount]] user without appropriate [[SSO_common_content#roles|<code>read</code> permissions]].
 
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
<u>database</u>
+
::'''on no result'''
 
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
[[File:checkbox1.png|link=]] '''is part of database'''
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
:This checkbox should be checked if the input from this field is part of the database table.
+
:::[[File:checkbox1.png|link=]] If the '''clean all widgets on no result''' checkbox here is checked, all data entered into the on-screen widgets will be cleared when no records are found in the app table matching the query entered.
::(This checkbox is checked by default for each new '''barcode''' widget which is added to the app).
+
:::[[File:checkbox0.png|link=]] If the '''clean all widgets on no result''' checkbox here is unchecked, the data entered into the on-screen widgets will be retained when no records are found in the app table matching the query entered.
 
|}
 
|}
  
Line 178: Line 218:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears at the top of the '''barcode''' widget on the app screen.
+
::defines the text which appears at the top of the '''barcode''' widget on the app screen.
 +
 
 +
:'''hint'''
 +
::defines the text which appears within the empty code field.
 +
 
 +
:'''alignment'''
 +
::this dropdown offers the choice between two options:
 +
:::;vertical:displays the "scan code" button below the code field
 +
:::;horizontal:displays the "scan code" button on the same line as the code field
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to scan a barcode before submitting the form).
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to scan a barcode before submitting the form).
::'''error message in case of input error'''
+
:::'''error message in case of input error'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
 +
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 +
 
 +
:'''min. length'''
 +
::defines the minimum number of characters which can be accepted as a barcode.
 +
::If <code>0</code> is entered here the default minimum of 1 character will apply.
 +
:::'''error message'''
 +
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the code you have entered is too short (<code>min. length</code> char min)" (where <code>min. length</code> is the '''min. length''' defined in the field above) will be shown if the barcode entered by the app user has fewer characters than the defined '''min. length'''.
 +
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 +
 
 +
:'''max. length'''
 +
::defines the maximum number of characters which can be accepted as a barcode.
 +
::If <code>0</code> is entered here there will be no limit on the maximum number of characters.
 +
:::'''error message'''
 +
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the code you have entered is too long (<code>max. length</code> char max)" (where <code>max. length</code> is the '''max. length''' defined in the field above) will be shown if the barcode entered by the app user has more characters than the defined '''max. length'''.
 +
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 +
 
 +
:[[File:checkbox0.png|link=]] '''is unique'''
 +
::Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
 +
 
 +
<u>actions</u>
 +
 
 +
:'''query type'''
 +
::'''query single result'''
 +
:::retrieves a single record from [[ginstr web]] which matches the scanned barcode
 +
::::This option should only be used if the [[ginstr web]] table contains '''unique''' barcode records.
 +
::'''query sorted result'''
 +
:::retrieves all records from [[ginstr web]] which matches the scanned barcode
 +
::::Selecting this option reveals the otherwise-hidden '''sort by''' dropdown (see below).
 +
 
 +
:'''widgets to load'''
 +
::defines which of the widgets currently on screen should load data from the '''ginstr web''' app table when the query button is pressed.
 +
::All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
 +
::Only the widgets selected in the list below this checkbox will be cleared by this reset button.
 +
 
 +
:::'''sort by'''
 +
::::The loaded information can be sorted by widget by selecting a widget name from the '''sort by''' dropdown.
 +
 
 +
:'''messages'''
 +
::'''on no rights'''
 +
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown to a [[SSO_common_content#subaccounts|subaccount]] user without appropriate [[SSO_common_content#roles|<code>read</code> permissions]].
 
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
<u>database</u>
+
::'''on no result'''
 
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
[[File:checkbox1.png|link=]] '''is part of database'''
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
:This checkbox should be checked if the input from this field is part of the database table.
+
:::[[File:checkbox1.png|link=]] If the '''clean all widgets on no result''' checkbox here is checked, all data entered into the on-screen widgets will be cleared when no records are found in the app table matching the query entered.
::(This checkbox is checked by default for each new '''barcode''' widget which is added to the app).
+
:::[[File:checkbox0.png|link=]] If the '''clean all widgets on no result''' checkbox here is unchecked, the data entered into the on-screen widgets will be retained when no records are found in the app table matching the query entered.
 
|}
 
|}
  
Line 203: Line 291:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the date displayed.
+
::defines the text which appears above the date displayed.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''is unique'''
+
:[[File:checkbox0.png|link=]] '''is unique'''
:Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
+
::Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
  
 
<u>database</u>
 
<u>database</u>
  
::[[File:checkbox1.png|link=]] '''is part of database'''
+
:::[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''birthday''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''birthday''' widget which is added to the app).
 
|}
 
|}
  
Line 225: Line 313:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the number entry field.
+
::defines the text which appears above the number entry field.
  
'''hint'''
+
:'''hint'''
:defines the text which appears in the empty number entry field.
+
::defines the text which appears in the empty number entry field.
  
'''button label'''
+
:'''button label'''
:defines the text which appears in the button.
+
::defines the text which appears in the button.
  
'''initial input'''
+
:'''initial input'''
:defines the numerical value inserted in the number entry field by default. If no '''initial input''' value is defined, the '''hint''' value will be displayed in the empty number entry field instead.
+
::defines the numerical value inserted in the number entry field by default. If no '''initial input''' value is defined, the '''hint''' value will be displayed in the empty number entry field instead.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:Checking this checkbox makes this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
+
::Checking this checkbox makes this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
[[File:checkbox0.png|link=]] '''is unique'''
+
:[[File:checkbox0.png|link=]] '''is unique'''
:Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
+
::Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
  
 
<u>database</u>
 
<u>database</u>
  
::[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
 
:This checkbox should be checked if the input from this field is part of the database table.
 
:This checkbox should be checked if the input from this field is part of the database table.
 
::(This checkbox is checked by default for each new '''calculated value''' widget which is added to the app).
 
::(This checkbox is checked by default for each new '''calculated value''' widget which is added to the app).
Line 257: Line 345:
 
:This section allows you to define the numerical calculation to be performed with the value entered in to the widget's number entry field.
 
:This section allows you to define the numerical calculation to be performed with the value entered in to the widget's number entry field.
  
:Each part of the formula must be added manually. First, enter the numerical value in the '''write value''' field and press the [[File:gbam_zoom+.png|link=]] button to the right. Then, select the desired operand from the dropdown list.
+
:Each part of the formula must be added manually.
 +
 
 +
:First, enter a mathematical function from the following list in the '''write value''' field and press the [[File:gbam_zoom+.png|link=]] button to the right to add it to the formula.
 +
::<u>Valid functions:</u>
 +
:::'''abs''' − absolute value (default function - must be added if no other function is required)
 +
:::'''acos''' − arc cosine
 +
:::'''asin''' − arc sine
 +
:::'''atan''' − arc tangent
 +
:::'''cbrt''' − cubic root
 +
:::'''ceil''' − nearest upper integer
 +
:::'''cos''' − cosine
 +
:::'''cosh''' − hyperbolic cosine
 +
:::'''exp''' − euler's number raised to the power (e^x)
 +
:::'''floor''' − nearest lower integer
 +
:::'''log''' − logarithmus naturalis (base e)
 +
:::'''log10''' − logarithm (base 10)
 +
:::'''log2''' − logarithm (base 2)
 +
:::'''sin''' − sine
 +
:::'''sinh''' − hyperbolic sine
 +
:::'''sqrt''' − square root
 +
:::'''tan''' − tangent
 +
:::'''tanh''' − hyperbolic tangent
 +
:::'''signum''' − signum function
 +
 
 +
:The first '''operand''' dropdown defines the on-screen widget which will supply the first numerical value.
 +
 
 +
:For some purposes, only a single numerical value and one of the above operators will be required. If more than one numerical value is required in the formula, press the [[File:gbam_zoom+.png|link=]] button to the right of the '''operand''' dropdown to reveal additional fields.
 +
 
 +
:The '''operator''' dropdown defines the arithmetical operation to be carried out between the first numerical value defined by the first '''operand''' dropdown, and the second numerical value defined by the '''operand''' dropdown below the '''operator''' dropdown.
 +
::<u>valid operations:</u>
 +
:::'''+'''  :  plus (addition)
 +
:::'''-'''  :  minus (subtraction)
 +
:::'''*'''  :  ×, times (multiplication)
 +
:::'''/'''  :  ÷, obelus (division)
 +
 
 +
:The second '''operand''' dropdown defines the on-screen widget which will supply the second numerical value.
 +
 
 +
:Additional operations may be added or removed as required by clicking the [[File:gbam_zoom+.png|link=]] or [[File:gbam_zoom-.png|link=]] buttons to the right of the '''operand''' dropdowns.
  
 
:The full formula is displayed in the '''formula''' field at the bottom.
 
:The full formula is displayed in the '''formula''' field at the bottom.
 
:Once added, each part of the formula can be removed by pressing the [[File:gbam_zoom-.png|link=]] button to the right of the corresponding '''write value''' field.
 
  
 
:To clear all entered formulae, press the <div style="display:inline-block;width:80px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:silver"><span style="color:black">clear all</span></div> button.
 
:To clear all entered formulae, press the <div style="display:inline-block;width:80px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:silver"><span style="color:black">clear all</span></div> button.
Line 273: Line 396:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears next to the checkbox
+
::defines the text which appears next to the checkbox
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''checkbox''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''checkbox''' widget which is added to the app).
 
|}
 
|}
  
Line 292: Line 415:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears next to the checkbox.
+
::defines the text which appears next to the checkbox.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:If this checkbox is checked, the '''status''' value (checked or unchecked) shown in the widget will be stored as part of the database table record in [[ginstr web]] as <code>[[Datatypes#status|status]]</code> [[Datatypes|datatype]].
+
::If this checkbox is checked, the '''status''' value (checked or unchecked) shown in the widget will be stored as part of the database table record in [[ginstr web]] as <code>[[Datatypes#status|status]]</code> [[Datatypes|datatype]].
::(This checkbox is checked by default for each new '''checkbox (read-only)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''checkbox (read-only)''' widget which is added to the app).
 
|}
 
|}
  
Line 309: Line 432:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears inside the reset button on the app screen.
+
::defines the text which appears inside the reset button on the app screen.
  
 
<u>actions</u>
 
<u>actions</u>
  
'''widgets to clean'''
+
:'''widgets to clean'''
:defines which of the widgets currently on screen should be reset to default when the reset button is pressed.
+
::defines which of the widgets currently on screen should be reset to default when the reset button is pressed.
:All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
+
::All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
:Only the widgets selected in the '''widgets to clean''' list below this checkbox wbe cleared by this reset buttonssed.
+
::Only the widgets selected in the '''widgets to clean''' list below this checkbox will be cleared by the reset button.
 
|}
 
|}
  
Line 327: Line 450:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the date displayed.
+
::defines the text which appears above the date displayed.
  
 
<u>database</u>
 
<u>database</u>
  
::[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''date''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''date''' widget which is added to the app).
 
|}
 
|}
  
====[[File:gbam_DateTime_Hidden.png|40px|link=]] date and time (hidden)====
+
====[[File:gbam_DateTime_Hidden.png|40px|link=]] date & time (hidden)====
::If this widget is added, the current date and time is recorded and saved to a designated column on [[ginstr web]].
+
::If this widget is added, the current date & time is recorded and saved to a designated column on [[ginstr web]].
  
 
::{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
 
::{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
! '''date and time (hidden)''': [[#properties|properties]]
+
! '''date & time (hidden)''': [[#properties|properties]]
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''database column headline'''
+
:'''column headline'''
:defines the column header for the column which is to hold the '''date and time''' values in [[ginstr web]].
+
::defines the column header for the column which is to hold the '''date & time''' values in [[ginstr web]].
 +
 
 +
<u>database</u>
 +
 
 +
:[[File:checkbox1.png|link=]] '''is part of database'''
 +
::This checkbox should be checked if the input from this field is part of the database table.
 +
:::(This checkbox is checked by default for each new '''date''' widget which is added to the app).
 
|}
 
|}
  
Line 355: Line 484:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the date displayed.
+
::defines the text which appears above the date displayed.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if date value shown in the widget is part of the database table.
+
::This checkbox should be checked if date value shown in the widget is part of the database table.
::(This checkbox is checked by default for each new '''date & time (read-only)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''date & time (read-only)''' widget which is added to the app).
 
|}
 
|}
  
 
====[[File:gbam_Date_R_O.png|40px|link=]] date (read-only)====
 
====[[File:gbam_Date_R_O.png|40px|link=]] date (read-only)====
::This widget displays the current date and time on screen and is not editable by the user.
+
::This widget displays the current date on screen and is not editable by the user.
  
 
::The date value is subsequently saved in a table column (provided the option '''is part of database''' is checked).
 
::The date value is subsequently saved in a table column (provided the option '''is part of database''' is checked).
Line 374: Line 503:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the date and time displayed.
+
::defines the text which appears above the date & time displayed.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:If this checkbox is checked, the  date and time value shown in the widget will be saved as part of the database table.
+
::If this checkbox is checked, the  date value shown in the widget will be saved as part of the database table.
::(This checkbox is checked by default for each new '''date (read-only)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''date (read-only)''' widget which is added to the app).
 
|}
 
|}
  
Line 391: Line 520:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the number entry field.
+
::defines the text which appears above the number entry field.
'''hint'''
+
 
:defines the text which appears in the number entry field until its contents are edited by the user.
+
:'''hint'''
 +
::defines the text which appears in the number entry field until its contents are edited by the user.
 +
 
 +
:'''masked''' [[File:checkbox0.png|link=]]
 +
::Checking this checkbox will mask the number entered to the field, similar to a password entry field.
 +
 
 +
:'''alignment'''
 +
::this dropdown offers the choice between two options:
 +
:::;vertical:displays the '''label''' above the '''decimal number (read-only)''' value on a separate line.
 +
:::;horizontal:displays the '''label''' to the left of the '''decimal number (read-only)''' value on the same line.
 +
 
 +
:'''initial input'''
 +
::defines the numerical value inserted in the number entry field by default. If no '''initial input''' value is defined, the '''hint''' value will be displayed in the empty number entry field instead.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:Checking this checkbox makes this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
+
::Checking this checkbox makes this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
[[File:checkbox0.png|link=]] '''is unique'''
+
:'''decimal places'''
:Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
+
::defines the allowed number of decimal places.
 +
:::(Default value = <code>2</code>)
  
'''decimal format'''
+
:[[File:checkbox0.png|link=]] '''is unique'''
:'''error message'''
+
::Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entered data is not a valid decimal number" will be shown when an invalid decimal number is entered in this field.
 
:::[[File:checkbox0.png|link=]] If the '''show default error message''' checkbox is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 
  
'''decimal places'''
+
:[[File:checkbox0.png|link=]] '''comparable'''
:defines the allowed number of decimal places.
+
::Checking this checkbox enables the number entered to be compared to the value stored in another widget, and display an error message if the number entered fails the specified criteria.
::(Default value = <code>2</code>)
+
:::<u>available criteria:</u>
 +
:::*equals
 +
:::*not equal
 +
:::*greater than
 +
:::*greater than or equal
 +
:::*less than
 +
:::*less than or equal
 +
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message will be shown when the number shown fails the specified criteria.
 +
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''decimal number''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''decimal number''' widget which is added to the app).
 
|}
 
|}
  
Line 432: Line 580:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears as the heading.
+
::defines the text which appears as the heading.
'''alignment'''
+
 
:this dropdown offers the choice between two options:
+
:'''masked''' [[File:checkbox0.png|link=]]
::;vertical:displays the '''label''' above the '''decimal number (read-only)''' value on a separate line.
+
::Checking this checkbox will mask the number shown in the field, similar to a password entry field.
::;horizontal:displays the '''label''' to the left of the '''decimal number (read-only)''' value on the same line.
+
 
 +
:'''alignment'''
 +
::this dropdown offers the choice between two options:
 +
:::;vertical:displays the '''label''' above the '''decimal number (read-only)''' value on a separate line.
 +
:::;horizontal:displays the '''label''' to the left of the '''decimal number (read-only)''' value on the same line.
 +
 
 +
:'''initial input'''
 +
::defines the numerical value shown in the number entry field by default.
 +
 
 +
<u>validations</u>
 +
 
 +
:[[File:checkbox0.png|link=]] '''required'''
 +
::Checking this checkbox makes this a '''required''' input field. When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.
 +
:::'''error message'''
 +
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
 +
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 +
 
 +
:'''decimal places'''
 +
::defines the allowed number of decimal places.
 +
:::(Default value = <code>2</code>)
 +
 
 +
:[[File:checkbox0.png|link=]] '''is unique'''
 +
::Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
 +
 
 +
:[[File:checkbox0.png|link=]] '''comparable'''
 +
::Checking this checkbox enables the number entered to be compared to the value stored in another widget, and display an error message if the number shown fails the specified criteria.
 +
:::<u>available criteria:</u>
 +
:::*equals
 +
:::*not equal
 +
:::*greater than
 +
:::*greater than or equal
 +
:::*less than
 +
:::*less than or equal
 +
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message will be shown when the number shown fails the specified criteria.
 +
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:If this checkbox is checked, the '''decimal number (read-only)''' value shown in the widget will be stored as part of the database table record in [[ginstr web]] as <code>[[Datatypes#number|number]]</code> [[Datatypes|datatype]].
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''decimal number (read-only)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''decimal number (read-only)''' widget which is added to the app).
 
|}
 
|}
  
Line 453: Line 635:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the dropdown.
+
::defines the text which appears above the dropdown.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate an option from the dropdown is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate an option from the dropdown is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''decimal number dropdown''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''decimal number dropdown''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''dropdown menu options'''
+
:'''dropdown menu options'''
:defines the individual number options which the user will be able to select from the dropdown.
+
::defines the individual number options which the user will be able to select from the dropdown.
:To add an option, enter the desired number in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The number option will now appear in the list above the input field.
+
::To add an option, enter the desired number in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The number option will now appear in the list above the input field.
:To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
+
::To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
:To change an existing option, select it from the list, edit the number in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
+
::To change an existing option, select it from the list, edit the number in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
  
'''messages'''
+
:'''messages'''
:'''no data'''
+
::'''no data'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''no selection text'''
+
::'''no selection text'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
 
|}
 
|}
  
Line 495: Line 677:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''email''' widget.
+
::defines the text which appears in the '''email''' widget.
 
|}
 
|}
  
Line 506: Line 688:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''fax''' widget.
+
::defines the text which appears in the '''fax''' widget.
 
|}
 
|}
  
Line 517: Line 699:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''database column headline'''
+
:'''database column headline'''
:defines the column header for the column which is to hold the '''user''' values in [[ginstr web]].
+
::defines the column header for the column which is to hold the '''user''' values in [[ginstr web]].
 
|}
 
|}
  
Line 528: Line 710:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''database column headline'''
+
:'''database column headline'''
:defines the column header for the column which is to hold the '''GPS position''' values in [[ginstr web]].
+
::defines the column header for the column which is to hold the '''GPS position''' values in [[ginstr web]].
 
|}
 
|}
  
Line 541: Line 723:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the address field.
+
::defines the text which appears above the address field.
'''hint'''
+
:'''hint'''
:defines the text which appears in the address field if GPS is disabled on the device or otherwise unavailable.
+
::defines the text which appears in the address field if GPS is disabled on the device or otherwise unavailable.
 
|}
 
|}
  
Line 554: Line 736:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''database column headline'''
+
:'''database column headline'''
:defines the column header for the column which is to hold the '''GPS position''' values in [[ginstr web]].
+
::defines the column header for the column which is to hold the '''GPS position''' values in [[ginstr web]].
 
|}
 
|}
  
Line 571: Line 753:
  
 
::{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
 
::{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
! '''increment''': [[#properties|properties]]
+
! '''increment number (hidden)''': [[#properties|properties]]
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''increment''' widget.
+
::defines the text which appears in the '''increment''' widget.
 
|}
 
|}
  
Line 585: Line 767:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the number entry field.
+
::defines the text which appears above the number entry field.
'''hint'''
+
:'''hint'''
:defines the text which appears in the number entry field until its contents are edited by the user.
+
::defines the text which appears in the number entry field until its contents are edited by the user.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:Checking this checkbox makes this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form. When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
+
::Checking this checkbox makes this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form. When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
[[File:checkbox0.png|link=]] '''is unique'''
+
:[[File:checkbox0.png|link=]] '''is unique'''
:Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
+
::Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''integer number''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''integer number''' widget which is added to the app).
 
|}
 
|}
  
Line 617: Line 799:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears as the heading.
+
::defines the text which appears as the heading.
'''alignment'''
+
:'''alignment'''
:this dropdown offers the choice between two options:
+
::this dropdown offers the choice between two options:
::;vertical:displays the '''label''' above the '''integer number (read-only)''' value on a separate line.
+
:::;vertical:displays the '''label''' above the '''integer number (read-only)''' value on a separate line.
::;horizontal:displays the '''label''' to the left of the '''integer number (read-only)''' value on the same line.
+
:::;horizontal:displays the '''label''' to the left of the '''integer number (read-only)''' value on the same line.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:If this checkbox is checked, the '''integer number (read-only)''' value shown in the widget will be stored as part of the database table record in [[ginstr web]] as <code>[[Datatypes#text|text]]</code> [[Datatypes|datatype]].
+
::If this checkbox is checked, the '''integer number (read-only)''' value shown in the widget will be stored as part of the database table record in [[ginstr web]] as <code>[[Datatypes#text|text]]</code> [[Datatypes|datatype]].
::(This checkbox is checked by default for each new '''integer number (read-only)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''integer number (read-only)''' widget which is added to the app).
 
|}
 
|}
  
Line 638: Line 820:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''load''' widget.
+
::defines the text which appears in the '''load''' widget.
 
|}
 
|}
  
Line 649: Line 831:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''load value from table (hidden)''' widget.
+
::defines the text which appears in the '''load value from table (hidden)''' widget.
 
|}
 
|}
  
Line 660: Line 842:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''male / female''' widget.
+
::defines the text which appears in the '''male / female''' widget.
 
|}
 
|}
  
Line 671: Line 853:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''NFC''' widget.
+
::defines the text which appears in the '''NFC''' widget.
 
|}
 
|}
  
Line 682: Line 864:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''NFC (read-only)''' widget.
+
::defines the text which appears in the '''NFC (read-only)''' widget.
 
|}
 
|}
  
Line 693: Line 875:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''NFC (with image)''' widget.
+
::defines the text which appears in the '''NFC (with image)''' widget.
 
|}
 
|}
  
Line 704: Line 886:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''note''' widget.
+
::defines the text which appears in the '''note''' widget.
 
|}
 
|}
  
Line 715: Line 897:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''phone no.''' widget.
+
::defines the text which appears in the '''phone no.''' widget.
 
|}
 
|}
  
Line 726: Line 908:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''database column headline'''
+
:'''database column headline'''
:defines the column header for the column which is to hold the '''phone serial no. (hidden)''' values in [[ginstr web]].
+
::defines the column header for the column which is to hold the '''phone serial no. (hidden)''' values in [[ginstr web]].
 
|}
 
|}
  
Line 738: Line 920:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears at the top of the '''photo''' widget on the app screen.
+
::defines the text which appears at the top of the '''photo''' widget on the app screen.
  
'''max photos'''
+
:'''max photos'''
:defines the maximum number of photos that the app user is able to submit with the form.
+
::defines the maximum number of photos that the app user is able to submit with the form.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide a photograph before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide a photograph before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''photo''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''photo''' widget which is added to the app).
 
|}
 
|}
  
Line 768: Line 950:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears at the top of the '''photo (read-only)''' widget on the app screen.
+
::defines the text which appears at the top of the '''photo (read-only)''' widget on the app screen.
  
'''max photos'''
+
:'''max photos'''
:defines the maximum number of photos that the app user is able to submit with the form.
+
::defines the maximum number of photos that the app user is able to submit with the form.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide a photograph before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide a photograph before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''photo (read-only)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''photo (read-only)''' widget which is added to the app).
 
|}
 
|}
  
Line 796: Line 978:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears at the top of the '''QR code''' widget on the app screen.
+
::defines the text which appears at the top of the '''QR code''' widget on the app screen.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to scan a QR code before submitting the form).
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to scan a QR code before submitting the form).
::'''error message in case of input error'''
+
:::'''error message in case of input error'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''QR code''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''QR code''' widget which is added to the app).
 
|}
 
|}
  
Line 821: Line 1,003:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears at the top of the '''QR code''' widget on the app screen.
+
::defines the text which appears at the top of the '''QR code''' widget on the app screen.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to scan a QR code before submitting the form).
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to scan a QR code before submitting the form).
::'''error message in case of input error'''
+
:::'''error message in case of input error'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''QR code (read-only)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''QR code (read-only)''' widget which is added to the app).
 
|}
 
|}
  
Line 846: Line 1,028:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the text entry field of this widget.
+
::defines the text which appears above the text entry field of this widget.
  
'''hint'''
+
:'''hint'''
:defines the text which is displayed within the text entry field until its contents are edited by the user.
+
::defines the text which is displayed within the text entry field until its contents are edited by the user.
  
'''button label'''
+
:'''button label'''
:defines the text which appears inside the '''load''' button on the app screen.
+
::defines the text which appears inside the '''load''' button on the app screen.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
[[File:checkbox0.png|link=]] '''is unique'''
+
:[[File:checkbox0.png|link=]] '''is unique'''
:This checkbox allows the user to ensure that the input from this field is required to be unique.
+
::This checkbox allows the user to ensure that the input from this field is required to be unique.
  
'''min length'''
+
:'''min. length'''
:defines the minimum number of characters which can be accepted as a search string.
+
::defines the minimum number of characters which can be accepted as a search string.
:If <code>0</code> is entered here the default minimum of 1 character will apply.
+
::If <code>0</code> is entered here the default minimum of 1 character will apply.
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the text you have entered is too short (<code>min length</code> char min)" (where <code>min length</code> is the '''min length''' defined in the field above) will be shown if the search string entered by the app user has fewer characters than the defined '''min length'''.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the text you have entered is too short (<code>min. length</code> char min)" (where <code>min. length</code> is the '''min. length''' defined in the field above) will be shown if the search string entered by the app user has fewer characters than the defined '''min. length'''.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
'''max length'''
+
:'''max. length'''
:defines the maximum number of characters which can be accepted as a search string.
+
::defines the maximum number of characters which can be accepted as a search string.
:If <code>0</code> is entered here there will be no limit on the maximum number of characters.
+
::If <code>0</code> is entered here there will be no limit on the maximum number of characters.
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the text you have entered is too long (<code>max length</code> char max)" (where <code>max length</code> is the '''max length''' defined in the field above) will be shown if the search string entered by the app user has more characters than the defined '''max length'''.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the text you have entered is too long (<code>max. length</code> char max)" (where <code>max. length</code> is the '''max. length''' defined in the field above) will be shown if the search string entered by the app user has more characters than the defined '''max. length'''.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''query title''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''query title''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''widgets to load'''
+
:'''widgets to load'''
:defines which of the widgets currently on screen should load data from the '''ginstr web''' app table when the query button is pressed.
+
::defines which of the widgets currently on screen should load data from the '''ginstr web''' app table when the query button is pressed.
:All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
+
::All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
:Only the widgets selected in the list below this checkbox will be cleared by this reset button.
+
::Only the widgets selected in the list below this checkbox will be cleared by this reset button.
  
::'''sort by'''
+
:::'''sort by'''
:::The loaded information can be sorted by widget by selecting a widget name from the '''sort by''' dropdown.
+
::::The loaded information can be sorted by widget by selecting a widget name from the '''sort by''' dropdown.
  
'''messages'''
+
:'''messages'''
:'''on no rights'''
+
::'''on no rights'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown to a [[SSO_common_content#subaccounts|subaccount]] user without appropriate [[SSO_common_content#roles|<code>read</code> permissions]].
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown to a [[SSO_common_content#subaccounts|subaccount]] user without appropriate [[SSO_common_content#roles|<code>read</code> permissions]].
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''on no result'''
+
::'''on no result'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 
|}
 
|}
  
Line 913: Line 1,095:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the text entry field of this widget.
+
::defines the text which appears above the text entry field of this widget.
  
'''hint'''
+
:'''hint'''
:defines the text which is displayed within the text entry field until its contents are edited by the user.
+
::defines the text which is displayed within the text entry field until its contents are edited by the user.
  
'''button label'''
+
:'''button label'''
:defines the text which appears inside the '''load''' button on the app screen.
+
::defines the text which appears inside the '''load''' button on the app screen.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
[[File:checkbox0.png|link=]] '''is unique'''
+
:[[File:checkbox0.png|link=]] '''is unique'''
:This checkbox allows the user to ensure that the input from this field is required to be unique.
+
::This checkbox allows the user to ensure that the input from this field is required to be unique.
  
'''min length'''
+
:'''min. length'''
:defines the minimum number of characters which can be accepted as a search string.
+
::defines the minimum number of characters which can be accepted as a search string.
:If <code>0</code> is entered here the default minimum of 1 character will apply.
+
::If <code>0</code> is entered here the default minimum of 1 character will apply.
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the text you have entered is too short (<code>min length</code> char min)" (where <code>min length</code> is the '''min length''' defined in the field above) will be shown if the search string entered by the app user has fewer characters than the defined '''min length'''.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the text you have entered is too short (<code>min. length</code> char min)" (where <code>min. length</code> is the '''min. length''' defined in the field above) will be shown if the search string entered by the app user has fewer characters than the defined '''min. length'''.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
'''max length'''
+
:'''max. length'''
:defines the maximum number of characters which can be accepted as a search string.
+
::defines the maximum number of characters which can be accepted as a search string.
:If <code>0</code> is entered here there will be no limit on the maximum number of characters.
+
::If <code>0</code> is entered here there will be no limit on the maximum number of characters.
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the text you have entered is too long (<code>max length</code> char max)" (where <code>max length</code> is the '''max length''' defined in the field above) will be shown if the search string entered by the app user has more characters than the defined '''max length'''.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "the text you have entered is too long (<code>max. length</code> char max)" (where <code>max. length</code> is the '''max. length''' defined in the field above) will be shown if the search string entered by the app user has more characters than the defined '''max. length'''.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''query title''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''query title''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''widgets to load'''
+
:'''widgets to load'''
:defines which of the widgets currently on screen should load data from the '''ginstr web''' app table when the query button is pressed.
+
::defines which of the widgets currently on screen should load data from the '''ginstr web''' app table when the query button is pressed.
:All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
+
::All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
:Only the widgets selected in the list below this checkbox will be cleared by this reset button.
+
::Only the widgets selected in the list below this checkbox will be cleared by this reset button.
  
::'''sort by'''
+
:::'''sort by'''
:::The loaded information can be sorted by widget by selecting a widget name from the '''sort by''' dropdown.
+
::::The loaded information can be sorted by widget by selecting a widget name from the '''sort by''' dropdown.
  
'''messages'''
+
:'''messages'''
:'''on no rights'''
+
::'''on no rights'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown to a [[SSO_common_content#subaccounts|subaccount]] user without appropriate [[SSO_common_content#roles|<code>read</code> permissions]].
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown to a [[SSO_common_content#subaccounts|subaccount]] user without appropriate [[SSO_common_content#roles|<code>read</code> permissions]].
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''on no result'''
+
::'''on no result'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 
|}
 
|}
  
Line 976: Line 1,158:
 
::This widget adds a group of 2 radio buttons.
 
::This widget adds a group of 2 radio buttons.
  
:{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
+
::{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
 
! '''radio group (2 options)''': [[#properties|properties]]
 
! '''radio group (2 options)''': [[#properties|properties]]
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the radio button group.
+
::defines the text which appears above the radio button group.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the radio button group before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the radio button group before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''radio group (2 options)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''radio group (2 options)''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''radio button options'''
+
:'''radio button options'''
:defines the individual options which the user will be able to select from the radio button group.
+
::defines the individual options which the user will be able to select from the radio button group.
:To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
+
::To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
:To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
+
::To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
:To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
+
::To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
 
|}
 
|}
  
Line 1,013: Line 1,195:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the radio button group.
+
::defines the text which appears above the radio button group.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the radio button group before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the radio button group before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''radio group (3 options)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''radio group (3 options)''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''radio button options'''
+
:'''radio button options'''
:defines the individual options which the user will be able to select from the radio button group.
+
::defines the individual options which the user will be able to select from the radio button group.
:To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
+
::To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
:To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
+
::To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
:To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
+
::To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
 
|}
 
|}
  
Line 1,046: Line 1,228:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''button label'''
+
:'''button label'''
:defines the text which appear inside the save button on the app screen.
+
::defines the text which appear inside the save button on the app screen.
  
 
<u>actions</u>
 
<u>actions</u>
  
'''widgets to save'''
+
:'''widgets to save'''
:defines which of the widgets currently on screen should save data to the '''ginstr web''' app table when the save button is pressed.
+
::defines which of the widgets currently on screen should save data to the '''ginstr web''' app table when the save button is pressed.
:All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
+
::All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
  
'''clean all widgets on save'''
+
:'''clean all widgets on save'''
:defines which of the widgets currently on screen should be cleared when the save button is pressed.
+
::defines which of the widgets currently on screen should be cleared when the save button is pressed.
:All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
+
::All visible widgets are selected by default. Multiple widgets can be selected by holding the <code>Ctrl</code> key and clicking on their names individually.
:Only the widgets selected in the list below this checkbox will be cleared upon successful save.
+
::Only the widgets selected in the list below this checkbox will be cleared upon successful save.
  
'''messages'''
+
:'''messages'''
:'''on no rights'''
+
::'''on no rights'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown to a [[SSO_common_content#subaccounts|subaccount]] user without appropriate [[SSO_common_content#roles|<code>create</code> permissions]].
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown to a [[SSO_common_content#subaccounts|subaccount]] user without appropriate [[SSO_common_content#roles|<code>create</code> permissions]].
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''on save'''
+
::'''on save'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default message will be shown to confirm that the data has been successfully saved.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default message will be shown to confirm that the data has been successfully saved.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''on all fields required'''
+
::'''on all fields required'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown if the screen contains '''required''' fields which have not been filled when the save button is pressed.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown if the screen contains '''required''' fields which have not been filled when the save button is pressed.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''on not unique'''
+
::'''on not unique'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown if the screen contains '''required''' fields which have not been filled when the save button is pressed.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown if the screen contains '''required''' fields which have not been filled when the save button is pressed.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
 
|}
 
|}
  
Line 1,086: Line 1,268:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''screen title''' widget.
+
::defines the text which appears in the '''screen title''' widget.
 
|}
 
|}
  
Line 1,097: Line 1,279:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''screen title''' widget.
+
::defines the text which appears in the '''screen title''' widget.
 
|}
 
|}
  
Line 1,108: Line 1,290:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''screen title with settings''' widget.
+
::defines the text which appears in the '''screen title with settings''' widget.
 
|}
 
|}
  
Line 1,119: Line 1,301:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''screen title with settings and logout''' widget.
+
::defines the text which appears in the '''screen title with settings and logout''' widget.
 
|}
 
|}
  
Line 1,130: Line 1,312:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''button label'''
+
:'''button label'''
:defines the text which appears inside the button on the app screen.
+
::defines the text which appears inside the button on the app screen.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide a signature in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''button label''' text to indicate that signature entry is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide a signature in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''button label''' text to indicate that signature entry is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''button label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''button label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''signature''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''signature''' widget which is added to the app).
 
|}
 
|}
  
Line 1,155: Line 1,337:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the dropdown.
+
::defines the text which appears above the dropdown.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''text dropdown''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''text dropdown''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''dropdown menu options'''
+
:'''dropdown menu options'''
:defines the individual text options which the user will be able to select from the dropdown.
+
::defines the individual text options which the user will be able to select from the dropdown.
:To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
+
::To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
:To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
+
::To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
:To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
+
::To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
  
'''messages'''
+
:'''messages'''
:'''no data'''
+
::'''no data'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''no selection text'''
+
::'''no selection text'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
 
|}
 
|}
  
Line 1,197: Line 1,379:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the dropdown.
+
::defines the text which appears above the dropdown.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''text dropdown autocomplete''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''text dropdown autocomplete''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''dropdown menu options'''
+
:'''dropdown menu options'''
:defines the individual text options which the user will be able to select from the dropdown.
+
::defines the individual text options which the user will be able to select from the dropdown.
:To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
+
::To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
:To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
+
::To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
:To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
+
::To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
  
'''messages'''
+
:'''messages'''
:'''no data'''
+
::'''no data'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''no selection text'''
+
::'''no selection text'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
 
|}
 
|}
  
Line 1,239: Line 1,421:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the dropdown.
+
::defines the text which appears above the dropdown.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''text dropdown dependent''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''text dropdown dependent''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''dropdown menu options'''
+
:'''dropdown menu options'''
:defines the individual text options which the user will be able to select from the dropdown.
+
::defines the individual text options which the user will be able to select from the dropdown.
:To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
+
::To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
:To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
+
::To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
:To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
+
::To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
  
'''messages'''
+
:'''messages'''
:'''no data'''
+
::'''no data'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''no selection text'''
+
::'''no selection text'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
 
|}
 
|}
  
Line 1,281: Line 1,463:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the dropdown.
+
::defines the text which appears above the dropdown.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''text dropdown database''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''text dropdown database''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''dropdown menu options'''
+
:'''dropdown menu options'''
:defines the individual text options which the user will be able to select from the dropdown.
+
::defines the individual text options which the user will be able to select from the dropdown.
:To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
+
::To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
:To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
+
::To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
:To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
+
::To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
  
'''messages'''
+
:'''messages'''
:'''no data'''
+
::'''no data'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''no selection text'''
+
::'''no selection text'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
 
|}
 
|}
  
Line 1,323: Line 1,505:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the dropdown.
+
::defines the text which appears above the dropdown.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option from the dropdown is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''text dropdown multiselect database''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''text dropdown multiselect database''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''dropdown menu options'''
+
:'''dropdown menu options'''
:defines the individual text options which the user will be able to select from the dropdown.
+
::defines the individual text options which the user will be able to select from the dropdown.
:To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
+
::To add an option, enter the desired text in the lower input field and click the <div style="display:inline-block;width:40px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">add</span></div> button. The text option will now appear in the list above the input field.
:To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
+
::To delete an existing option, select it from the list and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">delete</span></div> button to delete it.
:To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
+
::To change an existing option, select it from the list, edit the text in the lower input field and click the <div style="display:inline-block;width:60px;height:auto;text-align:center;padding:0px 4px;vertical-align:middle;-moz-border-radius:3px;-webkit-border-radius:3px;border-radius:3px;background-color:#12B9FF"><span style="color:white">update</span></div> button.
  
'''messages'''
+
:'''messages'''
:'''no data'''
+
::'''no data'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
:'''no selection text'''
+
::'''no selection text'''
::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
+
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
+
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.
 
|}
 
|}
  
Line 1,367: Line 1,549:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears as the heading.
+
::defines the text which appears as the heading.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:If this checkbox is checked, the '''read only text''' value shown in the widget will be stored as part of the database table record in [[ginstr web]] as <code>[[Datatypes#text|text]]</code> [[Datatypes|datatype]].
+
::If this checkbox is checked, the '''read only text''' value shown in the widget will be stored as part of the database table record in [[ginstr web]] as <code>[[Datatypes#text|text]]</code> [[Datatypes|datatype]].
::(This checkbox is checked by default for each new '''text multiline (read-only)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''text multiline (read-only)''' widget which is added to the app).
 
|}
 
|}
  
 
====[[File:gbam_Multiselect.png|40px|link=]] text multiselect====
 
====[[File:gbam_Multiselect.png|40px|link=]] text multiselect====
::The '''multiselect''' widget
+
::The '''text multiselect''' widget
  
 
::{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
 
::{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
! '''multiselect''': [[#properties|properties]]
+
! '''text multiselect''': [[#properties|properties]]
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears in the '''multiselect''' widget.
+
::defines the text which appears in the '''text multiselect''' widget.
 
|}
 
|}
  
Line 1,397: Line 1,579:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears as the heading.
+
::defines the text which appears as the heading.
'''alignment'''
+
:'''alignment'''
:this dropdown offers the choice between two options:
+
::this dropdown offers the choice between two options:
::;vertical:displays the '''label''' above the '''read only text''' value on a separate line.
+
:::;vertical:displays the '''label''' above the '''read only text''' value on a separate line.
::;horizontal:displays the '''label''' to the left of the '''read only text''' value on the same line.
+
:::;horizontal:displays the '''label''' to the left of the '''read only text''' value on the same line.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:If this checkbox is checked, the '''read only text''' value shown in the widget will be stored as part of the database table record in [[ginstr web]] as <code>[[Datatypes#text|text]]</code> [[Datatypes|datatype]].
+
::If this checkbox is checked, the '''read only text''' value shown in the widget will be stored as part of the database table record in [[ginstr web]] as <code>[[Datatypes#text|text]]</code> [[Datatypes|datatype]].
::(This checkbox is checked by default for each new '''text single line (read-only)''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''text single line (read-only)''' widget which is added to the app).
 
|}
 
|}
  
Line 1,419: Line 1,601:
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears at the top of the '''video''' widget on the app screen.
+
::defines the text which appears at the top of the '''video''' widget on the app screen.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide a video recording before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to provide a video recording before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate the field is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''video''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''video''' widget which is added to the app).
 
|}
 
|}
  
Line 1,440: Line 1,622:
 
::This widget adds a group of 2 radio buttons, labelled '''yes''' and '''no'''.
 
::This widget adds a group of 2 radio buttons, labelled '''yes''' and '''no'''.
  
:{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
+
::{| class="wikitable mw-collapsible mw-collapsed" style="width:840px"
 
! '''yes / no''': [[#properties|properties]]
 
! '''yes / no''': [[#properties|properties]]
 
|-
 
|-
 
| <u>general settings</u>
 
| <u>general settings</u>
'''label'''
+
:'''label'''
:defines the text which appears above the radio button group.
+
::defines the text which appears above the radio button group.
  
 
<u>validations</u>
 
<u>validations</u>
  
[[File:checkbox0.png|link=]] '''required'''
+
:[[File:checkbox0.png|link=]] '''required'''
:This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select either 'yes' or 'no' before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option is mandatory.  
+
::This checkbox allows the user to make this a '''required''' input field (i.e. it will be mandatory to select either 'yes' or 'no' before submitting the form). When checked, an asterix (*) is automatically added to the end of the '''label''' to indicate that selecting an option is mandatory.  
::'''error message'''
+
:::'''error message'''
:::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
+
::::[[File:checkbox1.png|link=]] If the '''show default message''' checkbox here is checked, the default error message "entering the <code>label</code> is required" (where <code>label</code> is the '''label''' defined in the <u>general settings</u> section) will be shown when an app user attempts to submit the form without providing an input in this field.
:::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
+
::::[[File:checkbox0.png|link=]] If the '''show default message''' checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
  
 
<u>database</u>
 
<u>database</u>
  
[[File:checkbox1.png|link=]] '''is part of database'''
+
:[[File:checkbox1.png|link=]] '''is part of database'''
:This checkbox should be checked if the input from this field is part of the database table.
+
::This checkbox should be checked if the input from this field is part of the database table.
::(This checkbox is checked by default for each new '''yes / no''' widget which is added to the app).
+
:::(This checkbox is checked by default for each new '''yes / no''' widget which is added to the app).
  
 
<u>actions</u>
 
<u>actions</u>
  
'''radio button options'''
+
:'''radio button options'''
:the options '''yes / no''' cannot be modified. If different options are desired, the [[#radio_group_(2_options)|'''radio group (2 options)''' widget]] should be used instead.
+
::the options '''yes / no''' cannot be modified. If different options are desired, the [[#radio_group_(2_options)|'''radio group (2 options)''' widget]] should be used instead.
 
|}
 
|}
  

Revision as of 18:29, 11 January 2018

Contents

gbam icon.png    User Manual
ginstr logo main.png business app maker


Using ginstr business app maker

  1. Sign up for a ginstr SSO account.
  2. Login to the SSO lobby.
  3. Click on the ginstr business app maker icon in the SSO lobby to navigate to the ginstr business app maker page
  4. In the content section, you can Add widgets by dragging them from the widgets panel in to the desired position on the device preview.
  5. Customise each widget by selecting the widget and editing its properties in the properties panel
  6. Individual widgets can be rearranged by dragging them in to the desired order in the device preview.
  7. Individual widgets in the device preview can be copied or deleted using the copy / delete buttons that appear when hovering your mouse over any widget in the device preview.
  8. In the theme section, you can choose a theme to style the colour and appearance of the text, buttons, input fields and dropdown elements.
  9. The background section allows you to choose a background image or colour for all app screens.
  10. Choose a homescreen icon from the range of options available in the app icon section.
  11. The login screen graphics section allows you to choose an appropriate image to be shown on the login screen.
  12. When you are happy with the content and appearance of your app, navigate to the final preview section, where the app can be saved, published or shared.


Accessing ginstr business app maker

ginstr business app maker icon

To access the ginstr business app maker, you must first be logged in to the SSO lobby at https://sso.ginstr.com/

If you do not have a ginstr SSO account, you can click the sign up! link to create one.

When logged in to the SSO lobby, you will be shown a list of available applications with their respective icons asked to choose an application to launch.

Clicking on the ginstr business app maker icon (shown left) will open the ginstr business app maker in a new browser tab.

Landing Screen

The ginstr business app maker Landing Screen

The first screen that is displayed on opening the ginstr business app maker consists of two options:

create your own app
this option allows you to create your own personal app from scratch
modify a template app
this option allows you to use an existing app created by ginstr or by our community

Layout of the ginstr business app maker

The ginstr business app maker consists of a central device preview, which displays a preview of the main app screen, and various buttons and sidebars which allow the user to customize the app.

The ginstr business app maker navigation bar

At the bottom of the device preview in the centre of the page there is a navigation bar which can be used to navigate between the following sections:

The
gbam back.png   back
and
next   gbam next.png
buttons can be used to move to the previous or next section in the sequence. Alternatively, individual sections can be selected by clicking on their title.
Pressing the
gbam back.png   back
button while on the content section will return to the landing screen.
Pressing the
next   gbam next.png
button while on the login screen graphics section will navigate to the final preview section, where the app can be saved, published or shared.

The screen layout and sidebar content will vary depending on which of the above sections of the ginstr business app maker is active.

content

1. Layout of the content section

The content section consists of a central device preview, with a sidebar on the left containing the widgets panel, and a sidebar on the right containing the properties panel.

On this page, you can drag and drop widgets from the widgets panel to the central device preview and arrange them as desired. The properties panel on the right shows options to customise whichever widget is selected in the device preview.

The following options appear at the top of the screen:

  • zoom slider
this can be used to increase (gbam zoom+.png) or decrease (gbam zoom-.png) the size of the device preview as required
  • preview type dropdown
this dropdown box can be used to switch between mockup view (showing a generic device bezel around the device preview), and artboard view (showing a single line border around the device preview).
  • display language dropdown
this dropdown box can be used to select a default language for the app, where en is English & de is German
If the language is changed here, the text resources and widget titles referred to in this manual will change.
This manual is based on the features which appear on the ginstr business app maker when an app is being created or edited in English.
  • project name
this input box defines the name of the current app, which is required when saving or publishing
The project name defined here
  • is used to identify the app in the list of applications in ginstr launcher
  • is used to identify the app in the list of app tables in ginstr web
  • appears on the login screen of the app
  • appears below the app icon on the device homescreen
save
button
this button opens the save app dialog window and allows you to save the current status of your app without publishing
save as
button
this button opens the save app dialog window and allows you to save the current status of your app without publishing
publish app
button
this button opens the final preview screen and allows you to publish your app. This button is hidden if there are no widgets added to the device preview.
  • show hidden widgets checkbox1.png
this checkbox toggles whether or not hidden widgets are visible in the device preview. Hidden widgets automatically record data to ginstr web tables but are not visible to the user of the app.

widgets

The widgets panel contains all available widgets organised into categories. The search bar at the top left can be used to search for a specific widget.

Widgets can be added to the app by selecting them from the widgets panel and dragging them to the device preview screen in the centre of the page.

The order in which these widgets are shown can be rearranged on the screen by dragging and dropping individual widgets above or below each other.

If any individual widget is selected from the device preview, its properties can be edited in the properties panel at the top right of the ginstr business app maker screen.

If one or more widgets has been selected in the device preview, the selected widget(s) can be deleted using the
delete highlighted widget(s)
button.

You can also use the Delete key on your keyboard for the same purpose.

Multiple individual widgets can be selected by holding the Ctrl key while clicking on different widgets.

Multiple consecutive widgets can be selected by selecting one widget then holding the ⇧ Shift key and clicking another widget in the device preview. This will select not only first selected widget and the second clicked widget, but also all widgets positioned between them in the device preview.

All selected widgets will be highlighted against the app background in the device preview.

The properties which can be defined for each widget type are described below.

gbam audio.png audio

This widget allows an audio recording to be made and subsequently saved to a designated column on ginstr web as part of the record.
After an audio recording is made, a counter displays the number of recordings captured.
audio: properties
general settings
label
defines the text which appears at the top of the audio widget on the app screen.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to provide an audio recording before submitting the form).
error message in case of input error
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new audio widget which is added to the app).

gbam barcode.png barcode

This widget allows a barcode to be scanned by the app user.
barcode: properties
general settings
label
defines the text which appears at the top of the barcode widget on the app screen.
hint
defines the text which appears within the empty code field.
alignment
this dropdown offers the choice between two options:
vertical
displays the "scan code" button below the code field
horizontal
displays the "scan code" button on the same line as the code field

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to scan a barcode before submitting the form).
error message in case of input error
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
min. length
defines the minimum number of characters which can be accepted as a barcode.
If 0 is entered here the default minimum of 1 character will apply.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "the code you have entered is too short (min. length char min)" (where min. length is the min. length defined in the field above) will be shown if the barcode entered by the app user has fewer characters than the defined min. length.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
max. length
defines the maximum number of characters which can be accepted as a barcode.
If 0 is entered here there will be no limit on the maximum number of characters.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "the code you have entered is too long (max. length char max)" (where max. length is the max. length defined in the field above) will be shown if the barcode entered by the app user has more characters than the defined max. length.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
checkbox0.png is unique
Checking this checkbox allows the user to ensure that the input from this field is required to be unique.

actions

query type
query single result
retrieves a single record from ginstr web which matches the scanned barcode
This option should only be used if the ginstr web table contains unique barcode records.
query sorted result
retrieves all records from ginstr web which matches the scanned barcode
Selecting this option reveals the otherwise-hidden sort by dropdown (see below).
widgets to load
defines which of the widgets currently on screen should load data from the ginstr web app table when the query button is pressed.
All visible widgets are selected by default. Multiple widgets can be selected by holding the Ctrl key and clicking on their names individually.
Only the widgets selected in the list below this checkbox will be cleared by this reset button.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
messages
on no rights
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown to a subaccount user without appropriate read permissions.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
on no result
checkbox1.png If the show default message checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
checkbox1.png If the clean all widgets on no result checkbox here is checked, all data entered into the on-screen widgets will be cleared when no records are found in the app table matching the query entered.
checkbox0.png If the clean all widgets on no result checkbox here is unchecked, the data entered into the on-screen widgets will be retained when no records are found in the app table matching the query entered.

gbam barcodeReadOnly.png barcode (read-only)

This widget displays a barcode retrieved from a record saved in ginstr web.
barcode (read-only): properties
general settings
label
defines the text which appears at the top of the barcode widget on the app screen.
hint
defines the text which appears within the empty code field.
alignment
this dropdown offers the choice between two options:
vertical
displays the "scan code" button below the code field
horizontal
displays the "scan code" button on the same line as the code field

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to scan a barcode before submitting the form).
error message in case of input error
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
min. length
defines the minimum number of characters which can be accepted as a barcode.
If 0 is entered here the default minimum of 1 character will apply.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "the code you have entered is too short (min. length char min)" (where min. length is the min. length defined in the field above) will be shown if the barcode entered by the app user has fewer characters than the defined min. length.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
max. length
defines the maximum number of characters which can be accepted as a barcode.
If 0 is entered here there will be no limit on the maximum number of characters.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "the code you have entered is too long (max. length char max)" (where max. length is the max. length defined in the field above) will be shown if the barcode entered by the app user has more characters than the defined max. length.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
checkbox0.png is unique
Checking this checkbox allows the user to ensure that the input from this field is required to be unique.

actions

query type
query single result
retrieves a single record from ginstr web which matches the scanned barcode
This option should only be used if the ginstr web table contains unique barcode records.
query sorted result
retrieves all records from ginstr web which matches the scanned barcode
Selecting this option reveals the otherwise-hidden sort by dropdown (see below).
widgets to load
defines which of the widgets currently on screen should load data from the ginstr web app table when the query button is pressed.
All visible widgets are selected by default. Multiple widgets can be selected by holding the Ctrl key and clicking on their names individually.
Only the widgets selected in the list below this checkbox will be cleared by this reset button.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
messages
on no rights
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown to a subaccount user without appropriate read permissions.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
on no result
checkbox1.png If the show default message checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
checkbox1.png If the clean all widgets on no result checkbox here is checked, all data entered into the on-screen widgets will be cleared when no records are found in the app table matching the query entered.
checkbox0.png If the clean all widgets on no result checkbox here is unchecked, the data entered into the on-screen widgets will be retained when no records are found in the app table matching the query entered.

gbam birthday.png birthday

This is a widget which allows the app user to select a date which is subsequently saved in a table column.
birthday: properties
general settings
label
defines the text which appears above the date displayed.

validations

checkbox0.png is unique
Checking this checkbox allows the user to ensure that the input from this field is required to be unique.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new birthday widget which is added to the app).

gbam numberCalculation.png calculated value

The calculated value widget performs a numerical calculation upon pressing a button and displays the result.
calculated value: properties
general settings
label
defines the text which appears above the number entry field.
hint
defines the text which appears in the empty number entry field.
button label
defines the text which appears in the button.
initial input
defines the numerical value inserted in the number entry field by default. If no initial input value is defined, the hint value will be displayed in the empty number entry field instead.

validations

checkbox0.png required
Checking this checkbox makes this a required input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate the field is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
checkbox0.png is unique
Checking this checkbox allows the user to ensure that the input from this field is required to be unique.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new calculated value widget which is added to the app).

actions

This section allows you to define the numerical calculation to be performed with the value entered in to the widget's number entry field.
Each part of the formula must be added manually.
First, enter a mathematical function from the following list in the write value field and press the gbam zoom+.png button to the right to add it to the formula.
Valid functions:
abs − absolute value (default function - must be added if no other function is required)
acos − arc cosine
asin − arc sine
atan − arc tangent
cbrt − cubic root
ceil − nearest upper integer
cos − cosine
cosh − hyperbolic cosine
exp − euler's number raised to the power (e^x)
floor − nearest lower integer
log − logarithmus naturalis (base e)
log10 − logarithm (base 10)
log2 − logarithm (base 2)
sin − sine
sinh − hyperbolic sine
sqrt − square root
tan − tangent
tanh − hyperbolic tangent
signum − signum function
The first operand dropdown defines the on-screen widget which will supply the first numerical value.
For some purposes, only a single numerical value and one of the above operators will be required. If more than one numerical value is required in the formula, press the gbam zoom+.png button to the right of the operand dropdown to reveal additional fields.
The operator dropdown defines the arithmetical operation to be carried out between the first numerical value defined by the first operand dropdown, and the second numerical value defined by the operand dropdown below the operator dropdown.
valid operations:
+  : plus (addition)
-  : minus (subtraction)
*  : ×, times (multiplication)
/  : ÷, obelus (division)
The second operand dropdown defines the on-screen widget which will supply the second numerical value.
Additional operations may be added or removed as required by clicking the gbam zoom+.png or gbam zoom-.png buttons to the right of the operand dropdowns.
The full formula is displayed in the formula field at the bottom.
To clear all entered formulae, press the
clear all
button.

gbam checkbox.png checkbox

Checkboxes can be added to the app as widgets. The responses are saved to a column on ginstr web as either true (true status icon.png) or false (false status icon.png) status.
checkbox: properties
general settings
label
defines the text which appears next to the checkbox

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new checkbox widget which is added to the app).

gbam checkbox R O.png checkbox (read-only)

This widget is used to show a text label next to a checkbox which retrieves its status value (checked or unchecked) from a record saved in ginstr web.
The status value (checked or unchecked) can not be changed in the ginstr app on the device.
checkbox (read-only): properties
general settings
label
defines the text which appears next to the checkbox.

database

checkbox1.png is part of database
If this checkbox is checked, the status value (checked or unchecked) shown in the widget will be stored as part of the database table record in ginstr web as status datatype.
(This checkbox is checked by default for each new checkbox (read-only) widget which is added to the app).

gbam clear.png clear

This is a button which, when pressed, resets or clears the contents of the form.
clear: properties
general settings
label
defines the text which appears inside the reset button on the app screen.

actions

widgets to clean
defines which of the widgets currently on screen should be reset to default when the reset button is pressed.
All visible widgets are selected by default. Multiple widgets can be selected by holding the Ctrl key and clicking on their names individually.
Only the widgets selected in the widgets to clean list below this checkbox will be cleared by the reset button.

gbam date.png date

This is a widget which allows the app user to select a date which is subsequently saved in a table column.
date: properties
general settings
label
defines the text which appears above the date displayed.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new date widget which is added to the app).

gbam DateTime Hidden.png date & time (hidden)

If this widget is added, the current date & time is recorded and saved to a designated column on ginstr web.
date & time (hidden): properties
general settings
column headline
defines the column header for the column which is to hold the date & time values in ginstr web.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new date widget which is added to the app).

gbam DateTime R O.png date & time (read-only)

This widget displays the current date & time on screen and is not editable by the user. The date & time value is subsequently saved in a table column.
date & time (read-only): properties
general settings
label
defines the text which appears above the date displayed.

database

checkbox1.png is part of database
This checkbox should be checked if date value shown in the widget is part of the database table.
(This checkbox is checked by default for each new date & time (read-only) widget which is added to the app).

gbam Date R O.png date (read-only)

This widget displays the current date on screen and is not editable by the user.
The date value is subsequently saved in a table column (provided the option is part of database is checked).
date (read-only): properties
general settings
label
defines the text which appears above the date & time displayed.

database

checkbox1.png is part of database
If this checkbox is checked, the date value shown in the widget will be saved as part of the database table.
(This checkbox is checked by default for each new date (read-only) widget which is added to the app).

gbam Number Decimal.png decimal number

This is a labelled number entry field which allows a number containing a decimal point to be recorded in a table column.
decimal number: properties
general settings
label
defines the text which appears above the number entry field.
hint
defines the text which appears in the number entry field until its contents are edited by the user.
masked checkbox0.png
Checking this checkbox will mask the number entered to the field, similar to a password entry field.
alignment
this dropdown offers the choice between two options:
vertical
displays the label above the decimal number (read-only) value on a separate line.
horizontal
displays the label to the left of the decimal number (read-only) value on the same line.
initial input
defines the numerical value inserted in the number entry field by default. If no initial input value is defined, the hint value will be displayed in the empty number entry field instead.

validations

checkbox0.png required
Checking this checkbox makes this a required input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate the field is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
decimal places
defines the allowed number of decimal places.
(Default value = 2)
checkbox0.png is unique
Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
checkbox0.png comparable
Checking this checkbox enables the number entered to be compared to the value stored in another widget, and display an error message if the number entered fails the specified criteria.
available criteria:
  • equals
  • not equal
  • greater than
  • greater than or equal
  • less than
  • less than or equal
checkbox1.png If the show default message checkbox here is checked, the default error message will be shown when the number shown fails the specified criteria.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new decimal number widget which is added to the app).

gbam Number Decimal R O.png decimal number (read-only)

This widget is used to load a decimal number value from ginstr web and display it on the app screen.
The decimal number (read-only) value can not be edited in the ginstr app on the device.
decimal number (read-only): properties
general settings
label
defines the text which appears as the heading.
masked checkbox0.png
Checking this checkbox will mask the number shown in the field, similar to a password entry field.
alignment
this dropdown offers the choice between two options:
vertical
displays the label above the decimal number (read-only) value on a separate line.
horizontal
displays the label to the left of the decimal number (read-only) value on the same line.
initial input
defines the numerical value shown in the number entry field by default.

validations

checkbox0.png required
Checking this checkbox makes this a required input field. When checked, an asterix (*) is automatically added to the end of the label to indicate the field is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
decimal places
defines the allowed number of decimal places.
(Default value = 2)
checkbox0.png is unique
Checking this checkbox allows the user to ensure that the input from this field is required to be unique.
checkbox0.png comparable
Checking this checkbox enables the number entered to be compared to the value stored in another widget, and display an error message if the number shown fails the specified criteria.
available criteria:
  • equals
  • not equal
  • greater than
  • greater than or equal
  • less than
  • less than or equal
checkbox1.png If the show default message checkbox here is checked, the default error message will be shown when the number shown fails the specified criteria.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new decimal number (read-only) widget which is added to the app).

gbam Number Decimal Dropdown.png decimal number dropdown

This is a dropdown list of numerical values.
decimal number dropdown: properties
general settings
label
defines the text which appears above the dropdown.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate an option from the dropdown is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new decimal number dropdown widget which is added to the app).

actions

dropdown menu options
defines the individual number options which the user will be able to select from the dropdown.
To add an option, enter the desired number in the lower input field and click the
add
button. The number option will now appear in the list above the input field.
To delete an existing option, select it from the list and click the
delete
button to delete it.
To change an existing option, select it from the list, edit the number in the lower input field and click the
update
button.
messages
no data
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
no selection text
checkbox1.png If the show default message checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.

gbam Email.png email

The email widget allows the app user to enter an email address, which is subsequently saved to a designated column on ginstr web.
email: properties
general settings
label
defines the text which appears in the email widget.

gbam Fax.png fax

The fax widget allows the app user to enter an email address, which is subsequently saved to a designated column on ginstr web.
fax: properties
general settings
label
defines the text which appears in the fax widget.

gbam auditUser.png ginstr username (hidden)

If this widget is added, the device's current user name is recorded and saved to a designated column on ginstr web.
ginstr username (hidden): properties
general settings
database column headline
defines the column header for the column which is to hold the user values in ginstr web.

gbam GPS Hidden.png GPS (hidden)

If this widget is added (provided GPS has been enabled on the device), the device's current GPS co-ordinates are recorded and saved to a designated column on ginstr web.
get GPS: properties
general settings
database column headline
defines the column header for the column which is to hold the GPS position values in ginstr web.

gbam auditAddress.png GPS address (read-only)

If this widget is added (provided GPS has been enabled on the device), the current address of the device is displayed on screen and subsequently saved to a designated column on ginstr web.
The address which is displayed/saved is approximate based on the current GPS co-ordinates of the device.
GPS address (read-only): properties
general settings
label
defines the text which appears above the address field.
hint
defines the text which appears in the address field if GPS is disabled on the device or otherwise unavailable.

gbam GPS R O.png GPS address (read-only)

If this widget is added (provided GPS has been enabled on the device), the device's current GPS co-ordinates are shown on screen and saved to a designated column on ginstr web.
GPS address (read-only): properties
general settings
database column headline
defines the column header for the column which is to hold the GPS position values in ginstr web.

gbam Horizontal Line.png horizontal line

A horizontal divider can be added to the app screen.
horizontal line: properties
This divider is a graphical element associated with the app theme and has no editable properties when selected.

gbam Auto Increment.png increment number (hidden)

The increment number (hidden) widget
increment number (hidden): properties
general settings
label
defines the text which appears in the increment widget.

gbam Number.png integer number

This is a labelled number entry field which allows an integer (whole number) to be recorded in a table column.
integer number: properties
general settings
label
defines the text which appears above the number entry field.
hint
defines the text which appears in the number entry field until its contents are edited by the user.

validations

checkbox0.png required
Checking this checkbox makes this a required input field (i.e. it will be mandatory to provide input in this field before submitting the form. When checked, an asterix (*) is automatically added to the end of the label to indicate the field is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
checkbox0.png is unique
Checking this checkbox allows the user to ensure that the input from this field is required to be unique.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new integer number widget which is added to the app).

gbam numberIntegerReadOnly.png integer number (read-only)

This widget is used to load an integer number value from ginstr web and display it on the app screen.
The integer number (read-only) value can not be edited in the ginstr app on the device.
integer number (read-only): properties
general settings
label
defines the text which appears as the heading.
alignment
this dropdown offers the choice between two options:
vertical
displays the label above the integer number (read-only) value on a separate line.
horizontal
displays the label to the left of the integer number (read-only) value on the same line.

database

checkbox1.png is part of database
If this checkbox is checked, the integer number (read-only) value shown in the widget will be stored as part of the database table record in ginstr web as text datatype.
(This checkbox is checked by default for each new integer number (read-only) widget which is added to the app).

gbam Load.png load number of records (hidden)

The load number of records (hidden) widget
load number of records (hidden): properties
general settings
label
defines the text which appears in the load widget.

gbam auditLoadRecordColumnValue.png load value from table (hidden)

The load value from table (hidden) widget
load value: properties
general settings
label
defines the text which appears in the load value from table (hidden) widget.

gbam Male Female.png male / female

The male / female widget
male / female: properties
general settings
label
defines the text which appears in the male / female widget.

gbam NFC.png NFC

The NFC widget
NFC: properties
general settings
label
defines the text which appears in the NFC widget.

gbam NFC R O.png NFC (read-only)

The NFC (read-only) widget
NFC (read-only): properties
general settings
label
defines the text which appears in the NFC (read-only) widget.

gbam nfcImageQuery.png NFC (with image)

The NFC (with image) widget
NFC (with image): properties
general settings
label
defines the text which appears in the NFC (with image) widget.

gbam Note.png note (read-only)

The note widget
note: properties
general settings
label
defines the text which appears in the note widget.

gbam Telephone.png phone no.

The phone no. widget
phone no.: properties
general settings
label
defines the text which appears in the phone no. widget.

gbam Telephone Serial Number Hidden.png phone serial no. (hidden)

If this widget is added, the serial number of the device being used to create a record is saved to a designated column on ginstr web.
phone serial no. (hidden): properties
general settings
database column headline
defines the column header for the column which is to hold the phone serial no. (hidden) values in ginstr web.

gbam Photo.png photo

This widget allows a number of photos to be taken and subsequently saved to a designated column on ginstr web as part of the record.
After a photo is taken, a preview thumbnail is displayed and a counter displays the number of photos captured.
photo: properties
general settings
label
defines the text which appears at the top of the photo widget on the app screen.
max photos
defines the maximum number of photos that the app user is able to submit with the form.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to provide a photograph before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate the field is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new photo widget which is added to the app).

gbam Photo R O.png photo (read-only)

This widget displays a photo retrieved from a record saved in a ginstr web table.
The photo is not editable by the app user.
photo (read-only): properties
general settings
label
defines the text which appears at the top of the photo (read-only) widget on the app screen.
max photos
defines the maximum number of photos that the app user is able to submit with the form.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to provide a photograph before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate the field is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new photo (read-only) widget which is added to the app).

gbam QR Code.png QR code

This widget allows a QR code to be scanned by the app user.
QR code: properties
general settings
label
defines the text which appears at the top of the QR code widget on the app screen.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to scan a QR code before submitting the form).
error message in case of input error
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new QR code widget which is added to the app).

gbam QR Code R O.png QR code (read-only)

This widget displays a barcode retrieved from a record saved in ginstr web.
QR code (read-only): properties
general settings
label
defines the text which appears at the top of the QR code widget on the app screen.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to scan a QR code before submitting the form).
error message in case of input error
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new QR code (read-only) widget which is added to the app).

gbam Query.png query

This widget can load information into the form from the app's ginstr web table based on an identifying piece of information such as an ID number assigned to an existing record in the app's ginstr web table.
query: properties
general settings
label
defines the text which appears above the text entry field of this widget.
hint
defines the text which is displayed within the text entry field until its contents are edited by the user.
button label
defines the text which appears inside the load button on the app screen.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate the field is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
checkbox0.png is unique
This checkbox allows the user to ensure that the input from this field is required to be unique.
min. length
defines the minimum number of characters which can be accepted as a search string.
If 0 is entered here the default minimum of 1 character will apply.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "the text you have entered is too short (min. length char min)" (where min. length is the min. length defined in the field above) will be shown if the search string entered by the app user has fewer characters than the defined min. length.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
max. length
defines the maximum number of characters which can be accepted as a search string.
If 0 is entered here there will be no limit on the maximum number of characters.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "the text you have entered is too long (max. length char max)" (where max. length is the max. length defined in the field above) will be shown if the search string entered by the app user has more characters than the defined max. length.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new query title widget which is added to the app).

actions

widgets to load
defines which of the widgets currently on screen should load data from the ginstr web app table when the query button is pressed.
All visible widgets are selected by default. Multiple widgets can be selected by holding the Ctrl key and clicking on their names individually.
Only the widgets selected in the list below this checkbox will be cleared by this reset button.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
messages
on no rights
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown to a subaccount user without appropriate read permissions.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
on no result
checkbox1.png If the show default message checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

gbam Questionnaire.png questionnaire

The questionnaire widget
questionnaire: properties
general settings
label
defines the text which appears above the text entry field of this widget.
hint
defines the text which is displayed within the text entry field until its contents are edited by the user.
button label
defines the text which appears inside the load button on the app screen.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to provide input in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate the field is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
checkbox0.png is unique
This checkbox allows the user to ensure that the input from this field is required to be unique.
min. length
defines the minimum number of characters which can be accepted as a search string.
If 0 is entered here the default minimum of 1 character will apply.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "the text you have entered is too short (min. length char min)" (where min. length is the min. length defined in the field above) will be shown if the search string entered by the app user has fewer characters than the defined min. length.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
max. length
defines the maximum number of characters which can be accepted as a search string.
If 0 is entered here there will be no limit on the maximum number of characters.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "the text you have entered is too long (max. length char max)" (where max. length is the max. length defined in the field above) will be shown if the search string entered by the app user has more characters than the defined max. length.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new query title widget which is added to the app).

actions

widgets to load
defines which of the widgets currently on screen should load data from the ginstr web app table when the query button is pressed.
All visible widgets are selected by default. Multiple widgets can be selected by holding the Ctrl key and clicking on their names individually.
Only the widgets selected in the list below this checkbox will be cleared by this reset button.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
messages
on no rights
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown to a subaccount user without appropriate read permissions.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
on no result
checkbox1.png If the show default message checkbox here is checked, the default error message "no record found" will be shown when no records are found in the app table matching the query entered.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

gbam Radio Button.png radio group (2 options)

This widget adds a group of 2 radio buttons.
radio group (2 options): properties
general settings
label
defines the text which appears above the radio button group.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to select a value from the radio button group before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate that selecting an option is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new radio group (2 options) widget which is added to the app).

actions

radio button options
defines the individual options which the user will be able to select from the radio button group.
To add an option, enter the desired text in the lower input field and click the
add
button. The text option will now appear in the list above the input field.
To delete an existing option, select it from the list and click the
delete
button to delete it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.

gbam Radio Button 3 Options.png radio group (3 options)

This widget adds a group of 3 radio buttons.
radio group (3 options): properties
general settings
label
defines the text which appears above the radio button group.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to select a value from the radio button group before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate that selecting an option is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new radio group (3 options) widget which is added to the app).

actions

radio button options
defines the individual options which the user will be able to select from the radio button group.
To add an option, enter the desired text in the lower input field and click the
add
button. The text option will now appear in the list above the input field.
To delete an existing option, select it from the list and click the
delete
button to delete it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.

gbam Save.png save

This is a button which, when pressed, saves the form's contents to ginstr web.
save: properties
general settings
button label
defines the text which appear inside the save button on the app screen.

actions

widgets to save
defines which of the widgets currently on screen should save data to the ginstr web app table when the save button is pressed.
All visible widgets are selected by default. Multiple widgets can be selected by holding the Ctrl key and clicking on their names individually.
clean all widgets on save
defines which of the widgets currently on screen should be cleared when the save button is pressed.
All visible widgets are selected by default. Multiple widgets can be selected by holding the Ctrl key and clicking on their names individually.
Only the widgets selected in the list below this checkbox will be cleared upon successful save.
messages
on no rights
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown to a subaccount user without appropriate create permissions.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
on save
checkbox1.png If the show default message checkbox here is checked, a default message will be shown to confirm that the data has been successfully saved.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
on all fields required
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown if the screen contains required fields which have not been filled when the save button is pressed.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
on not unique
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown if the screen contains required fields which have not been filled when the save button is pressed.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.


gbam Screen Title.png screen title level-1

This widget adds title text in large font to be used as a screen title or heading.
screen title level-1: properties
general settings
label
defines the text which appears in the screen title widget.

gbam Screen Title.png screen title level-2

This widget adds title text in small font to be used as a screen title or heading.
screen title level-2: properties
general settings
label
defines the text which appears in the screen title widget.

gbam Screen Title Settings.png screen title with settings

This widget contains large-font title text and a settings button.
screen title with settings: properties
general settings
label
defines the text which appears in the screen title with settings widget.

gbam Screen Title LogOut.png screen title with settings and logout

This widget contains large-font title text, a settings button and a logout button.
screen title with settings and logout: properties
general settings
label
defines the text which appears in the screen title with settings and logout widget.

gbam Signature.png signature

This is a widget which allows the form to record a signature and subsequently displays a preview thumbnail of the signature.
signature: properties
general settings
button label
defines the text which appears inside the button on the app screen.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to provide a signature in this field before submitting the form). When checked, an asterix (*) is automatically added to the end of the button label text to indicate that signature entry is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the button label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new signature widget which is added to the app).

gbam Text Dropdown.png text dropdown

This widget is a dropdown list of text options.
text dropdown: properties
general settings
label
defines the text which appears above the dropdown.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate that selecting an option from the dropdown is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new text dropdown widget which is added to the app).

actions

dropdown menu options
defines the individual text options which the user will be able to select from the dropdown.
To add an option, enter the desired text in the lower input field and click the
add
button. The text option will now appear in the list above the input field.
To delete an existing option, select it from the list and click the
delete
button to delete it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
messages
no data
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
no selection text
checkbox1.png If the show default message checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.

gbam dropdownAutoCompleteText.png text dropdown autocomplete

This widget is a dropdown list of text options with autocomplete function.
text dropdown autocomplete: properties
general settings
label
defines the text which appears above the dropdown.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate that selecting an option from the dropdown is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new text dropdown autocomplete widget which is added to the app).

actions

dropdown menu options
defines the individual text options which the user will be able to select from the dropdown.
To add an option, enter the desired text in the lower input field and click the
add
button. The text option will now appear in the list above the input field.
To delete an existing option, select it from the list and click the
delete
button to delete it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
messages
no data
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
no selection text
checkbox1.png If the show default message checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.

gbam Text Dropdown Dependent.png text dropdown dependent

This widget is a dropdown list of text options, dependent upon
text dropdown dependent: properties
general settings
label
defines the text which appears above the dropdown.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate that selecting an option from the dropdown is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new text dropdown dependent widget which is added to the app).

actions

dropdown menu options
defines the individual text options which the user will be able to select from the dropdown.
To add an option, enter the desired text in the lower input field and click the
add
button. The text option will now appear in the list above the input field.
To delete an existing option, select it from the list and click the
delete
button to delete it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
messages
no data
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
no selection text
checkbox1.png If the show default message checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.

gbam Text Dropdown Database.png text dropdown from database

This widget is a dropdown list of text options retrieved from the database.
text dropdown from database: properties
general settings
label
defines the text which appears above the dropdown.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate that selecting an option from the dropdown is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new text dropdown database widget which is added to the app).

actions

dropdown menu options
defines the individual text options which the user will be able to select from the dropdown.
To add an option, enter the desired text in the lower input field and click the
add
button. The text option will now appear in the list above the input field.
To delete an existing option, select it from the list and click the
delete
button to delete it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
messages
no data
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
no selection text
checkbox1.png If the show default message checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.

gbam Text Dropdown Multiselect Database.png text dropdown multi-select from database

This widget is a dropdown list of text options.
text dropdown multi-select from database: properties
general settings
label
defines the text which appears above the dropdown.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to select a value from the dropdown before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate that selecting an option from the dropdown is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new text dropdown multiselect database widget which is added to the app).

actions

dropdown menu options
defines the individual text options which the user will be able to select from the dropdown.
To add an option, enter the desired text in the lower input field and click the
add
button. The text option will now appear in the list above the input field.
To delete an existing option, select it from the list and click the
delete
button to delete it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
messages
no data
checkbox1.png If the show default message checkbox here is checked, a default error message will be shown when an app user attempts to submit the form without selecting an option from the dropdown.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.
no selection text
checkbox1.png If the show default message checkbox here is checked, the text "select..." will appear in the dropdown before an option is selected.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom message to be shown in the dropdown instead.

gbam Text Multiline R O.png text multi-line (read-only)

This widget is used to load multi-line text data from ginstr web and display it on the app screen.
The read only text value can not be edited in the ginstr app on the device.
text multiline (read-only): properties
general settings
label
defines the text which appears as the heading.

database

checkbox1.png is part of database
If this checkbox is checked, the read only text value shown in the widget will be stored as part of the database table record in ginstr web as text datatype.
(This checkbox is checked by default for each new text multiline (read-only) widget which is added to the app).

gbam Multiselect.png text multiselect

The text multiselect widget
text multiselect: properties
general settings
label
defines the text which appears in the text multiselect widget.

gbam Text Single Line R O.png text single line (read-only)

This widget is used to load text data from ginstr web and display it on the app screen.
The read only text value can not be edited in the ginstr app on the device.
text single line (read-only): properties
general settings
label
defines the text which appears as the heading.
alignment
this dropdown offers the choice between two options:
vertical
displays the label above the read only text value on a separate line.
horizontal
displays the label to the left of the read only text value on the same line.

database

checkbox1.png is part of database
If this checkbox is checked, the read only text value shown in the widget will be stored as part of the database table record in ginstr web as text datatype.
(This checkbox is checked by default for each new text single line (read-only) widget which is added to the app).

gbam Video Input.png video

This widget allows a video recording to be made and subsequently saved to a designated column on ginstr web as part of the record.
After a video recording is made, a counter displays the number of recordings captured.
video: properties
general settings
label
defines the text which appears at the top of the video widget on the app screen.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to provide a video recording before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate the field is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new video widget which is added to the app).

gbam Yes No.png yes / no

This widget adds a group of 2 radio buttons, labelled yes and no.
yes / no: properties
general settings
label
defines the text which appears above the radio button group.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to select either 'yes' or 'no' before submitting the form). When checked, an asterix (*) is automatically added to the end of the label to indicate that selecting an option is mandatory.
error message
checkbox1.png If the show default message checkbox here is checked, the default error message "entering the label is required" (where label is the label defined in the general settings section) will be shown when an app user attempts to submit the form without providing an input in this field.
checkbox0.png If the show default message checkbox here is unchecked, a text entry field appears below the checkbox for defining a custom error message to be shown instead.

database

checkbox1.png is part of database
This checkbox should be checked if the input from this field is part of the database table.
(This checkbox is checked by default for each new yes / no widget which is added to the app).

actions

radio button options
the options yes / no cannot be modified. If different options are desired, the radio group (2 options) widget should be used instead.

properties

If any individual widget is selected from the device preview, its properties can be edited in the properties panel at the top right of the ginstr business app maker screen.

If no widget has been selected, the name of the app screen is displayed and can be edited in the screen name field in the general settings dropdown section.

The properties which can be defined for each widget type are described in the widgets section of this page.

Copy / Delete

Copy / Delete buttons

Once a widget is added to the device preview, moving your mouse over the widget will result in two buttons appearing at the top-right corner of the widget.

copy
pressing this button copies the selected widget, resulting in a duplicate of the widget appearing below the selected widget.
All of the properties belonging to the original widget will be reproduced in the duplicate widget, with the word 'copy' appended to the label text.
delete
pressing this button deletes the selected widget.
To delete multiple widgets, select them in the device preview using the Ctrl and/or ⇧ Shift keys, and then click on the
delete highlighted widget(s)
button at the bottom of the widgets panel or press the Delete key on your keyboard.

Undo / Redo

You can undo or redo any actions in ginstr business app maker with the following keyboard shortcuts:

  • Undo - Ctrl + Z (can be pressed multiple times to undo multiple actions)
  • Redo - Ctrl + Y (can be pressed multiple times to redo multiple actions)

theme

2. Layout of the theme section

This section allows you to choose a theme to style the colour and appearance of the graphical elements of your app.

In this section, the left sidebar contains thumbnails of screens of your app.

As with the content section, the device preview is shown in the centre of the screen.

The appearance of both the screen thumbnails and the central device preview are updated automatically when a selection is made from the right sidebar, which consists of the following options:

colour
the colour picker here allows you to select any custom colour for graphical elements by using the hue slider in the centre and the dragging the cursor anywhere in the upper shade box.
Alternatively, you can enter a HEX colour code on the lower input box.
Pressing the gbam scroll.png button next to the input box allows the entry of RGB (Red, Green, Blue) or HSL values (Hue, Saturation, Lightness) instead of a HEX code.
checkbox1.png auto
if the auto checkbox is checked, the chosen colour will be applied automatically to text labels, input filed borders and buttons automatically.
if the auto checkbox is un-checked, each of the following graphical elements can be selected from the dropdown list, allowing a custom colour to be defined for each element individually
  • theme colour
  • text colour
  • button text colour
  • hint colour
The preview panel shows how the various graphical elements will look with the chosen colour(s) applied.
themes
The theme preview tiles here allow you to select between variations for the display of buttons, input fields and dropdown elements.
Clicking on one of the theme preview tiles shown in the window will select it, and a blue border will appear around it.

background

3. Layout of the background section

This section allows you to choose a solid colour or background image for your app.

In this section, the left sidebar contains thumbnails of screens of your app.

As with the previous two sections, the device preview is shown in the centre of the screen.

The appearance of both the screen thumbnails and the central device preview are updated automatically when a selection is made from the right sidebar, which consists of the following options:

colour
the colour picker here allows you to select any custom colour for use as a background by using the hue slider in the centre and the dragging the cursor anywhere in the upper shade box.
Alternatively, you can enter a HEX colour code on the lower input box.
Pressing the gbam scroll.png button next to the input box allows the entry of RGB (Red, Green, Blue) or HSL values (Hue, Saturation, Lightness) instead of a HEX code.
The default background is plain white (#FFFFFF).
backgrounds
The background image preview tiles here allow you to select a background image to be used instead of a solid colour.
All of the images are shown gray scale in the preview tiles, however the colour which is selected in the colour picker will be applied to the image as a tint
Clicking on one of the background image preview tiles shown in the window will select it, and a blue border will appear around it.
The available background images can be filtered by brightness & colour by pressing the
filters
button at the bottom right-hand corner.
Previously applied filter settings can be cleared by pressing the
clear filter
button.

app icon

4. Layout of the app icon section

This section allows you to choose a homescreen icon for your app.

In this section, the left sidebar contains a preview of the currently selected app icon.

Below this is a
upload your icon
button which opens a file browser window for you to select an image file from your computer.

The right sidebar contains an array of pre-designed app icons. These can be filtered by the appropriate industry type by clicking on the checkboxes in the filters panel in the centre of the screen.

Previously applied filter settings can be cleared by pressing the
clear filter
button.
Each pre-designed icon can also be customised using the
background
or
edit
buttons at the top of the screen.
background
the colour picker here allows you to select any custom colour for use as a background by using the hue slider in the centre and the dragging the cursor anywhere in the upper shade box.
Alternatively, you can enter a HEX colour code on the lower input box.
Pressing the gbam scroll.png button next to the input box allows the entry of RGB (Red, Green, Blue) or HSL values (Hue, Saturation, Lightness) instead of a HEX code.
edit
here you can add custom text to the app icon
text
defines the text to appear overlaid on top of the selected app icon
font
dropdown which allows you to select a font for the custom text
font size
dropdown which allows you to select a font size for the custom text, along with buttons to apply Bold, Italic and Underline formatting
font colour
colour picker which allows you to select any custom colour for use as a background by using the hue slider in the centre and the dragging the cursor anywhere in the upper shade box.
Alternatively, you can enter a HEX colour code on the lower input box.
Pressing the gbam scroll.png button next to the input box allows the entry of RGB (Red, Green, Blue) or HSL values (Hue, Saturation, Lightness) instead of a HEX code.

login screen graphics

5. Layout of the login screen graphics section

This section allows you to choose an image to be displayed on the login screen of the app.

In this section, the left sidebar contains a preview of the login screen.

The right sidebar contains an array of pre-designed graphics files.

These can be filtered by the appropriate picture category by clicking on the checkboxes in the filters panel in the centre of the screen.

Previously applied filter settings can be cleared by pressing the
clear filter
button.

Clicking one of the graphics files will select it, and a blue border will appear around it. The preview in the left sidebar will be updated with the selected graphics file.

Clicking the
cancel
button in the login area image window will close the window and no change will be made.
You can also use the
upload your graphics file
button at the bottom-right of the screen to select a graphics file from your own computer if desired.

final preview

6. Layout of the final preview section

This section shows a final preview of your app and allows you to save and/or publish the app to ginstr launcher.

To the right of the central device preview are the following fields:

project name
this input box defines the name of the current app, which is required when saving or publishing
The project name defined here
  • is used to identify the app in the list of applications in ginstr launcher
  • is used to identify the app in the list of app tables in ginstr web
  • appears on the login screen of the app
  • appears below the app icon on the device homescreen
select category...
this dropdown is used to define which category the app will be published under.
select industry...
this dropdown is used to define which industry the app will be published under.
checkbox0.png allow other ginstr users to use your app as a template
if checked, you consent to allow your published app to be used as a template for other users of the ginstr business app maker.
save
button
this button opens the save app dialog window and allows you to save the current status of your app without publishing
save as
button
this button opens the save app dialog window and allows you to save the current status of your app without publishing
publish app
button
this button will publish the app to ginstr launcher. This button is hidden if there are no widgets added to the device preview.
Upon pressing the
publish app
button in, a progress bar is shown while the app is published to the ginstr cloud.

When the progress bar reaches 100%, you will be shown the app publishing success window to confirm that the app has been published successfully.

Press the
ok
button in the app publishing success window to return to the main ginstr business app maker screen.
To install the newly published app, log in to ginstr launcher on a device with your ginstr credentials and press the
install
button next to the name of the newly published app in the list of available applications.
The app icon which subsequently appears in the device homescreen can now be used to launch the application on the device.

Pressing the
back
button in the publish details window will return the user to the main ginstr business app maker screen without publishing the app.