From wiki.ginstr.com
Jump to: navigation, search

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 and subsequently retrieves data from the record in the ginstr web table belonging to said barcode, storing the values in the designated on-screen widgets.
This widget also allows a barcode value to be entered manually.
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 value.
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 value.
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 filled upon the scanning of a valid barcode.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
message 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.
message 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.
clean all widgets on no result
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 allows a barcode to be scanned by the app user and subsequently retrieves data from the record in the ginstr web table belonging to said barcode, storing the values in the designated on-screen widgets.
This widget does not allow a barcode value to be entered manually.
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 value.
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 value.
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 filled upon the scanning of a valid barcode.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
message 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.
message 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.
clean all widgets on no result
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:
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 functions may be added by clicking the gbam zoom+.png buttons to the right of the first write value field. The gbam zoom-.png button next to each additional write value field can be used to remove each additional function.
Similarly, arithmetical 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.
The status value (checked or unchecked) is read from the database / ginstr web table and 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 store 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 another of the on-screen widgets 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 which allows the app user to select from a pre-defined 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 remove an existing option, select it from the list and click the
remove
button to remove it.
To change an existing option, select it from the list, edit the number in the lower input field and click the
update
button.
message on 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.
message on 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 e-mail

The email widget allows the app user to enter an e-mail address, which is subsequently saved to a designated column on ginstr web.
e-mail: properties
general settings
label
defines the text which appears in the e-mail widget.
hint
defines the text which appears in the e-mail address 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 e-mail widget which is added to the app).

gbam Fax.png fax

The fax widget allows the app user to enter a fax number, 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.
hint
defines the text which appears in the fax 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 fax widget which is added to the app).

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
label
defines the text which appears for the widget in the device preview.
This widget is hidden so the labelwill not appear to the app user.

actions

on event
this dropdown defines which event should trigger the recording of the user name (the default option is on screen load)

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.
GPS (hidden): properties
general settings
column headline
defines the column header for the column which is to store the GPS position values in ginstr web.

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.

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 GPS (hidden) widget which is added to the app).

gbam auditAddress.png GPS address

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: 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.

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 GPS address widget which is added to the app).

gbam GPS Hidden.png GPS address (hidden)

If this widget is added (provided GPS has been enabled on the device), the device's current address is recorded and saved to a designated column on ginstr web.
GPS address (hidden): properties
general settings
column headline
defines the column header for the column which is to store the GPS address values in ginstr web.

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.

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 GPS address (hidden) widget which is added to the app).

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

If this widget is added (provided GPS has been enabled on the device), the address (based on the device's current GPS co-ordinates) is shown on screen.
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 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 adds a predefined increment to a numerical value stored in another widget, allowing the resulting value to be used or displayed by subsequent widgets.
increment number (hidden): properties
general settings
label
defines the text which appears for the widget in the device preview.
This widget is hidden so the labelwill not appear to the app user.

actions

increment value in widget
this dropdown defines the widget which contains the numerical value to which the increment should be added
increment
number entry field for defining the increment to be added
This field accepts both decimal and integer numbers, and the value can be either positive or negative.
on event
this dropdown defines which event should trigger the addition of the increment (the default option is on screen load)
execute
this dropdown defines whether the increment should be added before or after the event defined in the on event dropdown

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.
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 integer number value on a separate line.
horizontal
displays the label to the left of the integer number 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.
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 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 another of the on-screen widgets 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.
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 integer number value on a separate line.
horizontal
displays the label to the left of the integer number 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.
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 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 is hidden from view, but when added, it checks the ginstr web table for the app and saves the total number of records to one of the other on-screen widgets.
load number of records (hidden): properties
general settings
defines the text which appears for the widget in the device preview.
This widget is hidden so the labelwill not appear to the app user.

actions

save number of rows to
this dropdown defines the widget which will store the total count of records from the ginstr web table
execute
this dropdown defines whether the increment should be added before or after the event defined in the on event dropdown
on event
this dropdown defines which event should trigger the addition of the increment (the default option is on screen load)
message 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.

gbam auditLoadRecordColumnValue.png load value from table (hidden)

The load value from table (hidden) widget is hidden from view, but when added, it retrieves a value from the ginstr web table for the app based on the contents of one of the on-screen widgets and saves the result to another of the other on-screen widgets.
load value from table (hidden): properties
general settings
label
defines the text which appears for the widget in the device preview.
This widget is hidden so the labelwill not appear to the app user.

actions

query type
query single result
retrieves a single record from ginstr web which matches the value stored in the widget defined in the value to load dropdown
This option should only be used if the ginstr web table contains unique 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).
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown
value to load
defines which of the widgets currently on screen determines which value is loaded from the ginstr web app table
save result to
defines which of the widgets currently on screen should store the value which is loaded from the ginstr web app table
on event
this dropdown defines which event should trigger the retrieval of the value
execute
this dropdown defines whether the increment should be added before or after the event defined in the on event dropdown
message 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.

gbam Male Female.png male / female

This widget adds a group of 2 radio buttons, labelled male and female.
male / female: properties
general settings
label
defines the text which appears in the male / female radio button options.

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 male / female widget which is added to the app).

actions

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

gbam NFC.png NFC

The NFC widget is automatically filled with the value of an NFC tag when scanned by the device.
This widget also allows an NFC tag value to be entered manually.
NFC: properties
general settings
label
defines the text which appears at the top of the NFC widget on the app screen.
hint
defines the text which appears within the empty 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 an NFC tag 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 an NFC tag value.
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 an NFC tag value.
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.

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 NFC widget which is added to the app).

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

The NFC (read-only) widget is automatically filled with the value of an NFC tag when scanned by the device and subsequently retrieves data from the record in the ginstr web table belonging to said NFC tag and stores the values in the designated on-screen widgets.
This widget does not allow an NFC tag to be entered manually or edited once scanned.
NFC (read-only): properties
general settings
label
defines the text which appears at the top of the NFC (read-only) widget on the app screen.
hint
defines the text which appears within the empty 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 an NFC tag 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.
checkbox0.png is unique
Checking this checkbox allows the user to ensure that the input from this field is required to be unique.

actions

widgets to load
defines which of the widgets currently on screen should load data from the ginstr web app table when a valid NFC tag is scanned.
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 filled upon the scanning of a valid NFC tag.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
message 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.
message 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 scanned NFC tag.
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 nfcImageQuery.png NFC (with image)

The NFC (with image) widget adds an image consisting of concentric circles which prompts the app user to scan an NFC tag with their device.
When an NFC tag is scanned which has an associated record in the ginstr web table, the corresponding data from the record is retrieved and stored automatically in the designated on-screen widgets.
NFC (read-only): properties
general settings
label
defines the text which appears at the top of the NFC (read-only) widget on the app screen.
hint
defines the text which appears within the empty 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 an NFC tag 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.
checkbox0.png is unique
Checking this checkbox allows the user to ensure that the input from this field is required to be unique.

actions

widgets to load
defines which of the widgets currently on screen should load data from the ginstr web app table when a valid NFC tag is scanned.
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 filled upon the scanning of a valid NFC tag.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
message 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.
message 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 scanned NFC tag.
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 Note.png note (read-only)

The note widget displays pre-defined text which cannot be edited by the app user.
note (read-only): properties
general settings
label
defines the text which appears in the note widget.

gbam Telephone.png phone no.

The phone no. widget allows the app user to enter a phone number, which is subsequently saved to a designated column on ginstr web.
phone no.: properties
general settings
label
defines the text which appears in the phone no. widget.
hint
defines the text which appears in the phone 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 phone no. widget which is added to the app).

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
column headline
defines the column header for the column which is to store the phone serial no. 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 phone serial no. (hidden) widget which is added to the app).

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.

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 and subsequently retrieves data from the record in the ginstr web table belonging to said NFC tag, storing the values in the designated on-screen widgets.
This widget also allows a QR code value to be entered manually.
QR code: properties
general settings
label
defines the text which appears at the top of the QR code 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 QR code value.
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 QR code scanned/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 QR code value.
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 QR code scanned/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 QR code
This option should only be used if the ginstr web table contains unique QR code records.
query sorted result
retrieves all records from ginstr web which matches the scanned QR code
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 filled upon the scanning of a valid QR code.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
message 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.
message 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 QR code scanned/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.
clean all widgets on no result
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 QR code scanned/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 QR code scanned/entered.

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

This widget allows a QR code to be scanned by the app user and subsequently retrieves data from the record in the ginstr web table belonging to said QR code, storing the values in the designated on-screen widgets.
This widget does not allow a QR code value to be entered manually.
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.
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 QR code value.
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 QR code scanned 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 QR code value.
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 QR code scanned 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 QR code
This option should only be used if the ginstr web table contains unique QR code records.
query sorted result
retrieves all records from ginstr web which matches the scanned QR code
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 filled upon the scanning of a valid QR code.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
message 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.
message 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 QR code scanned.
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.
clean all widgets on no result
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 QR code scanned.
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 QR code scanned.

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.
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.
checkbox0.png is unique
This checkbox allows the user to ensure that the input from this field is required to be unique.

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 updated by this query.
sort by
The loaded information can be sorted by widget by selecting a widget name from the sort by dropdown.
message 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.
message 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 is used to group several other widgets together as a questionnaire.
questionnaire: properties
general settings
label
defines the text which appears above the questionnaire questions.

actions

add external widgets
defines which of the widgets currently on screen should be grouped as a questionnaire.
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 updated by this query.

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 remove an existing option, select it from the list and click the
remove
button to remove 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 remove an existing option, select it from the list and click the
remove
button to remove 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.
message 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.
message 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.
message 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.
message 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.
max signatures
defines the maximum number of signatures which can be recorded.

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 remove an existing option, select it from the list and click the
remove
button to remove it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
message on 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.
message on 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 which is filtered by the characters which are entered in to the dropdown field.
text dropdown autocomplete: properties
general settings
label
defines the text which appears above the dropdown.
hint
defines the text which appears inside the dropdown field until its contents are edited by the user.

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.
max. length
defines the maximum number of characters which can be accepted as a barcode value.
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.

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 remove an existing option, select it from the list and click the
remove
button to remove it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
message on 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.
message on 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 the output of another of the on-screen widgets.
text dropdown dependent: properties
general settings
label
defines the text which appears above the dropdown.

gbam Text Dropdown Database.png text dropdown from database

This widget is a dropdown list of text options retrieved from the database, allowing the user to select a single option.
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 remove an existing option, select it from the list and click the
remove
button to remove it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
message on 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.
message on 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 retrieved from the database, which allows the user to select multiple different 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 remove an existing option, select it from the list and click the
remove
button to remove it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
message on 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.
message on 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 displays multi-line text 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 in the widget.

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

This widget is a dropdown list of pre-defined text options which allows the user to select multiple different options.
text multiselect: 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 remove an existing option, select it from the list and click the
remove
button to remove it.
To change an existing option, select it from the list, edit the text in the lower input field and click the
update
button.
message on 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.
message on 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.
message on selected
checkbox1.png If the show default message checkbox here is checked, the default message will appear once an option is selected 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 message to be shown in the dropdown instead.

gbam Single Line.png text single line

This widget is a labelled text entry field which allows the text entered to be recorded in a table column.
text single line: properties
general settings
label
defines the text which appears as the heading.
hint
defines the text which appears in the empty text entry field until its contents are edited by the user.
multiline checkbox0.png
Checking this checkbox will allow multiple lines of text to be entered in to the field.
masked checkbox0.png
Checking this checkbox will mask the text, similar to a password entry field.
alignment
this dropdown offers the choice between two options:
vertical
displays the label above the text entry field on a separate line.
horizontal
displays the label to the left of the text entry field on the same line.

validations

checkbox0.png required
This checkbox allows the user to make this a required input field (i.e. it will be mandatory to enter text in to the text entry field 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 by the widget.
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 text 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 by the widget.
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 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.

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 Text Single Line R O.png text single line (read-only)

This widget is used to display a single line of text 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 in the widget.
masked checkbox0.png
Checking this checkbox will mask the text, similar to a password entry field.
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 colour and/or 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.