Data fields

Table of contents

  1. Text
  2. Choice
  3. Image
  4. Attachment
  5. Location / map
  6. Date & time
  7. URL
  8. Timestamp

A data model may contain several data fields to store different types of information. For examples:

  • User has an email, a name, and optional an avatar.
  • Apartment has a location, description, rental-price, and a few photos.

The following types of data fields are available:

Text
Text (long, may contain line breaks)
Choice
Choice
Image
Image
Attachment
Attachment
Location
Location / map
Date & Time
Date & time
URL
URL

Text

  • Single line text
  • Multi-line text

Choice

The Choice field is useful to define a custom selection list.

Example - A “Defect” model has a “severity” field:

Choice with selection values
Choice

Image

Images can either be taken using the phone camera or be selected from the local or cloud storage (e.g. Dropbox, OneDrive).

The administrator can provide a default image as a placeholder. If there is no image uploaded by the user, this image will be displayed. The administrator can also define an image size if all images should be displayed in the same size.

Example - Default user avatar:

Set a default avatar
Default avatar

Attachment

Attachments can be uploaded just like images. They are useful if your users need to attach Word or PDF documents. Attachment doesn’t have a built-in viewer, but there is a “Download” button available for users.

Location / map

The location field is useful for displaying maps. Locations can be given by their coordinates (latitude and longitude) directly. You can also use the “Pin to location” and “Use current location” features to work with them visually.

Example - An apartment page shows the location of the apartment:

Location displayed in map
Full-screen map
Pin to location

Date & time

There are three types of time-related fields:

  • Date
  • Time (clock time without the date)
  • Date & time
Select date
Select time

URL

The URL field can be used to define an external link. Tap on it will open the link in a web browser.

Timestamp

Every model also contains two system built-in timestamp fields. They are read-only and maintained by the system:

  • Created at: when the data record is created
  • Updated at: when the data record is last modified