TABLE OF CONTENTS
Adding a Media field to your Form design enables your app users to capture photos, audio or video as part of their Form submission. Simply drag and drop a Media field from the left-hand toolbar onto your Form page and then configure it using the right-hand properties panel. By default, the Media field will have its Media Type property set to Image. This allows the user to capture a photo or select an existing image from their device galley. Change the Media Type property as desired to capture audio or video instead.
Video capture is limited to 10MB file sizes. This is to save on data upload bandwidth since videos can be very large - easily 10 times bigger than a photo. On iOS devices, this usually allows for 30 seconds of footage due to iOS's ability to automatically lower the video resolution to fit this size limit. Android users, however, will need to manually lower the video resolution of their camera to record as much footage as possible. It is also recommended that Android users enable High efficiency video (HVEC) within Advanced Recording Options for the same reason.
Adding GPS data to your Image
When capturing images, you also have the option to capture the user's GPS location and heading information. This can be useful for several reasons. E.g., if your user is completing a land survey, you can use their position information to plot each image on a map. Select the "Include GPS Information" property to enable this functionality on your Media field.
Dynamic Image Watermarking
This feature allows you to apply dynamically generated text as a watermark onto images that are captured or chosen via a Media field during Form entry. You can define the desired text output via the "Apply Watermark Text" property on your Media field. The text stamped on the image is driven by a formula of your creation, with options to customize the color of the text and the position it appears in the image. And yes, multi-line watermarks are supported!
Watch a training video on Media Field Type
Basic Properties
Data Name
This is the name of the field that should be referenced in any form logic or API calls. Users will not see this name on the form.
Data names cannot contain spaces or any special characters other than an underscore and must begin with a letter. They are case-sensitive and must be referred to precisely whenever they are referenced.
Title Text
This is the name of the field that will be displayed to users on the app. This property is completely optional; while a field must contain a data name, a field title is optional.
The text color may be chosen with a hex code. The text may be also formatted as Bold or Italic and given a relative size -- Small, Medium (the default) or Large.
Hint Text
This optional field can be used to show secondary information to the user in the app. Consider using this to provide instruction or clarification to the user as they fill out the field.
Media Type
The choice made in this dropdown determines the type of media is accepted for the field. The options are Image, Video and Audio.
Include GPS Information
Include GPS allows the app user to capture a geographic location on taking a photo.
Note: This property only shows if Media Type Image is selected.
After Include GPS is selected the Location properties will show.
Desired Accuracy (Feet)
This dropdown controls the desired accuracy of the GPS position capture. Bear in mind that the higher the accuracy, the longer the device will take to acquire the coordinates; please see this article for more detail on this.
Fast GPS Capture
This checkbox option enables faster GPS capture but returns latitude and longitude values only. No other location metadata (e.g., heading) is captured.
NOTE: Accuracy may be reduced on devices with poor/slow GPS capabilities with this option enabled.
Display Map Type
This dropdown controls the type of map seen by the user when they select or view a location. See images below for illustration.
NOTE: The Windows app supports the Standard option only.
Standard | Satellite | Hybrid |
|
|
|
Go to the top.
Layout & Styling
Field Layout
This drop-down determines how this field is shown on the screen.
- Vertical places the Title and Hint vertically above the entry field.
- Horizontal will stack the entry field to the right of the Title and Hint text.
- Horizontal (Tablets Only) will use Vertical layout for phones and Horizontal for tablets.
Background Color
The color chosen in the hex code field here will apply to the section field. The Transparent box can also be chosen instead for making this transparent instead of a solid color.
Go to the top.
Validation & Behavior
Required
Checking this box will enforce validation against this field to make the field required, disallowing the user from progressing to the next page or submitting the form if it is left blank. If the user tries, they will be prompted with an error to return to the field and enter a value. When this validation occurs is determined by the "Validation Property" chosen on the page level; please see this article for more detail on this.
This property can also be made conditional based on a formula. To enable this, click "add condition" below the checkbox and enter a formula into the field that populates. The formula serves as the basic of the required-ness of this field.
Please see this article for more information on conditionally-required fields.
Visibility
The contents of this field will determine whether the field will be visible to the user. For more detail on visibility rules, please see this article.
Dynamic Image
This property is used to define a calculation/formula that will populate the field's media file. Often this is used in conjunction with the "Read Only" property (see below) so that the field will display to the user without the possibility of manual edits. This article is recommended as a starting point for more reading on this.
Define a calculation/formula that will dynamically populate an image into this field.
Example 1:
CONCAT('http://myexamplesite.com/', {{myfield}}, '.jpg')
Example 2:
{{mydsfield[2]}}
Please see this article for details on the relationship between Default Value and Dynamic Value.
Read Only
If this checkbox is checked, users will be able to see the contents of the field but will be unable to make edits.
Similar to the Required property, the Read Only property also includes the ability to define a conditional formula determining whether the read-only property is enabled. Click "add condition" to define such a formula.
Custom Validation
Add your own custom formula to this property for validating numbers entered into this field by users. The formula is only applied when the field has an answer. Enforcement will be done according to the "Validation Property" chosen on the page level; please see this article for more detail on this.
Validation Message
The contents of this property will serve as a custom message to display to the user if their input fails validation.
Go to the top.
Advanced Options
File Name
By default, the app will generate a date-based name for each file captured by the user. Use the File Name property to define your own file names using our template syntax for dynamic generation. The file extension is automatically added by the system based on the file type. Example below:
STOCK-{{mychoicefield}}-{(USERLASTNAME())}
Default Value
The value entered in this property serves as the initial value of the field prior to manual input. Please see this article for details on the relationship between Default Value and Dynamic Value.
Bind to Global Value
Global Values are a local key/value store that is available to any Screen on the app. Use this property to allow the user to view and save defaults for use across the app (e.g., a default project or customer). Please see this article for more information.
Exclude from Export/Display
By default, every field is displayed on Form entries in the Data area, and is included in non-templated exports (e.g., generic pdf, CSV, spreadsheet, database connectors). Use this property to prevent this field from showing on all such display and exports.
Is Personal Data
Indicates that data captured in this field may contain personal or sensitive data, which in turn can be anonymized when exported from the platform when then the "Anonymize Personal Data" option is checked on a form connector. Please see this article for more on this.
NOTE: Use of this option does not grant or imply additional security, protection and privacy of data.
Capture Only
Users normally have the option to capture media or to choose an existing file. Selecting this option will remove the "Choose" button from this media field in the app form, forcing the user to capture the media file.
Copy To Device Gallery
Users normally have the option to capture media or to choose an existing file. Selecting this option will remove the "Choose" button from this media field in the app form, forcing the user to capture the media file.
Apply Watermark Text
Applies dynamic watermark text to the image as part of the capture/choose process.
The watermark will be generated from this value which supports our template syntax for dynamic generation.
Multi-line watermarks are possible by using {( '\n' )} in the template.
Example 1:
Date: {( IMGDATE({{myfield}} )} {( '\n' )} GPS: {( FORMAT-GEO({{myfield}}, 'DMS') )}
Example 2:
{( CONCAT(NOW(), '\n', {{Site_ID}}, '-', {{Site_Name}}, '\n', ‘Front View of Building’) )}
Apply Stroke Outline
If enabled, a black stroke outline is applied to the watermark text. This can improve the readability of the watermark text on the captured image when the text is a similar color to the background photo.
Go to the top.