4.1 List of elements
Element types
There are basically two groups of element types; input elements (questions) and layout elements (pages, grids, etc). All element types are described below.
The Form element
This is the main element of the form, placed on top of the Elements panel. The initial name shown here is the same as the form name entered in the Dashboard but you may change it in the Form element’s Label in the Settings tab under Element Properties. In this tab you can also set Date and Time values for the entire form, but these settings can be overwritten by the settings of the form’s individual Date and Time elements. In the Rules tab you can set Rules with IF… THEN logic. The Styling tab is used to set the colors and symbol of the form’s tile shown in the App. The Print tab has settings for page size and margins when printing form reports in a PDF file. In the Other tab you can set values for various elements, in addition to form states for sending form data to the server. These are shown to the app user in the Summary page’s Form State dialog box – see Using: 3.5 The Summary page. Read more about the advanced property settings for the form element here: Designing: 6.1 The main Form element.
Basic elements
Date
Date in localized format, see 4.3 Date and Time.
Date and time
Date and time in localized format, see Designing: 4.3 Date and Time.
Decimal
Decimal number with any number of decimals, e.g. 100.0. Use the function Round if you want to set a specific number of decimals.
You can remove all + and – buttons through a setting on the form element’s Other tab. There you can also set the number of decimals entered that will show in a repeat table or in a PDF.
Spacer
‘Empty’ visual element giving vertical space between elements. The height is set by selecting the number of lines to span. If you want a height smaller than 1 line, try using a very small font size in the spacer element’s Styling tab.
Multimedia Label
Multimedia displayed without any input from the user. It may contain static text and images, as well as codes to e.g. element IDs, see Designing: 7.2 Adding images to a form design.
Number
Any integer number, without decimals. You can remove all + and – buttons through a setting on the form element’s Other tab.
Text Input
A single line field of text that is dynamic; it expands to contain any length of text. You can’t enter a line break in it.
Text Input Area
A field that can contain any length of text. Default height of the field visible in the form is 3 lines, but the designer can set it up to 60 lines high. When typing in the field, the user can press Enter for line breaks, thus formatting it better than Text Input fields. Characters cannot be formatted (change font size, make bold, etc.) in Text Input and Text Input Area elements.
This field will automatically expand in the app to show all the lines of text entered in the field.
Time
Time in localized format, see Designing: 4.3 Date and Time.
Selection elements
Boolean (true/false)
Pushbutton to select between two options e.g. True or False, Yes or No. Note: you may type anything you like in the Label properties of the two options, such as ‘Dayshift’ and ‘Nightshift’, but the Element IDs of the two options must remain true and false. The two states may then be quoted in rules: IF … = true, THEN…
Dynamic list
This is a dropdown list resembling a Single Select dropdown, but the options in the list come from a file in Dashboard’s Resources, so the list can be maintained form there. See Designing: 4.6 Dynamic lists for more information on this.
Multiple select (Checkboxes)
Element for selecting one or more options in square checkboxes.
Option
Options are list items for the elements Boolean, Multiple select and Single select.
Single select (Dropdown or Radio buttons)
Element for selecting only one option from several round radio buttons or from a dropdown list.
Slider
Slider for selecting a value. When first added in the form design, the slider will go from 0 to 100 in steps on 1, and the start (default) value is 0. In the Properties – Other tab you can change these settings to for instance go from 0 to 1 in steps of 0.25, with a default value of 0.5.
Media
Audio Capture
Record sound or select an audio file to be sent to the Zegeba server.
File attachment
Select and upload any file to be sent to the server. If the file is an image or a PDF, a Properties – PDF option will allow it to be appended at the back of the automatically generated PDF – see Designing: 4.2.4 PDF tab.
Image Capture
Capture an image or select an image file to be sent to the server.
If the Properties – Other option Allow drawing on image is selected, the user will be able to draw on the image after it has been added to the form.
Video Capture
Capture a video or select a video file to be sent to the server.
Video Stream
Stream a video from the server when online without saving it to the app. See Designing: 7.4 Adding video and audio to a form design.
Specialized elements
Action
You can place the buttons on the Summary page inside the form. Choose between [Save and Close], [Close/Cancel], [Generate PDF], [Set Form State], [View] and [Save]. In a form opened in the app, [Save] will sync the form capture to the server as a new edit while keeping the form open. If you leave that form by cancelling, the saved version can not be found in the app but it will be listed in the Dashboard. You can use these buttons in combination with the Form elements option on the Other Property tab called “Hide navigation bar at the bottom”.
The buttons can be individually styled from the option Customize buttons in the Properties – Styling tab. See Designing: 4.2.3 Styling tab.
Custom Content
In this element you can place HTML code to print whatever you like on the form page, e.g. HTML tables for external data or for referencing data entered into the form. See Designing: 4.7 Custom Content.
Location Capture
Capture Geo location (GPS or network location). Note that for this field to work during data capture, the phone or tablet has to have Position/GPS switched on. You can press and hold the update button with the circular arrows to get a more precise location. Some devices may require a switch off and then switch on of Position/GPS before the position is captured.
Charts (custom charts and visuals)
The Charts element can be used to show simple and complex charts and graphics in a form, with visuals that dynamically update itself based on data from the form. See Designing: 4.5 Charts.
Link (to another element, resource or web link)
Link to another element, e.g. a repeat or to an external resource file, e.g. pdfs or web pages. External links are cached offline in the installed app. See Designing: 6.6 Links / Go to / Actions.
Signature
Handwritten signature captured with mouse, finger or stylus, depending on the device used.
Note that the signature has an automatic Date and Time stamp. However; if the signature will be shown as part of a repeat, the date and time is not included in the repeat view.
You can choose between 3 different time zones: Signature Timestamp “As Capturer”, “As Capturer with Time Zone” and “Point in Time”. The second option has the capturer’s time zone noted, the last option is the UTC (Coordinated Universal Time).
Group (of elements)
Accordion
Accordion is a collapsible group with a heading.
Group
Grouping of elements for visual representation or skip logic. The group can have visible or invisible heading and borders, and can be used inside a grid to list several elements in one grid cell.
Page
A Form must have at least one visible Page.
Tab (on a Tab group)
A tab on a Tab group. It functions similar to a Group when it comes to layout, content and printing.
Tab Group
A group element for Tab pages to put multiple “pages” on a single page or anywhere on a page or group. Must be placed on a page before adding Tab elements.
Subform
Repeat (subforms)
A repeat is a subform which can be repeated 0 or more times. It allows for repeated capture of a group of data. See Designing: 6.5 Repeats.
Repeat Subset (subset of referenced repeat’s answers)
The Repeat Subset element is used inside a repeat to link it to another repeat, often called a subrepeat. You can also use it to show a list of repeat instances in multiple places. See Designing: 6.5.3 Subrepeats.
Grid (table structure)
A flexible 12 column grid with header and rows. One grid cannot have more that 12 columns, but you can place grids within grid cells to allow for more columns.
Row (on a Grid)
Autonumbered and named Rows of a Grid. Can contain 1 – 12 elements.
Image map (clickable)
Clickable Image
Any image can be turned into a dynamic image with clickable regions. See Designing: 7.3 Creating clickable images.
Clickable Area
Areas of a clickable image can be defined using a polygon or rectangle shape. Each area functions like a Link (see above). See Designing: 7.3 Creating clickable images.
Area Style
Each Clickable Area can have various styles for different states. See Designing: 7.3 Creating clickable images.
Header and Footer
Footer
Show a footer on each page and/or on printed pdf. Note that you cannot use input elements such as Text in footers. As default, footers are only shown on printed PDF pages, so you have to go to the Footer element’s Properties tab PDF and select Show Header/Footer in Form View (not only PDF) to see the footer on the on-screen form too.
Header
Show a header on each page and/or on printed pdf. Note that you cannot use input elements such as Text in headers. As default, headers are only shown on printed PDF pages, so you have to go to the Header element’s Properties tab PDF and select Show Header/Footer in Form View (not only PDF) to see the header on the on-screen form too.