Field Service Mobile Element Properties

A mobile element is a field or control that you can configure for a tab in the Field Service Management (FSM) Mobile app. Mobile element properties determine how the element appears and behaves in the FSM Mobile app.

Property Reference

The following table lists mobile element properties and accepted values. It also identifies the element types that support each property. Some properties do not work with every element type. Before you add a property to a configuration, review the element types that support it and the values it accepts.

Property

Description

Supported Element Types

Accepted Values

hidden

Hides the element in the FSM Mobile app.

any

  • true

  • false

required

Requires the element to have a value before you can submit the current form. Dynamic expressions can't set this property.

any

  • true

  • false

readonly

Displays the element as read-only in the FSM Mobile app and prevents interaction.

any

  • true

  • false

usesessionkey

Adds the current session key to a link as a URL parameter when the link is accessed.

url

  • true

  • false

disabled

Displays the element as disabled in the FSM Mobile app and prevents interaction.

any

  • true

  • false

value

Sets the element's default value. Takes effect only when the current record doesn't exist yet or a dynamic expression changes the property.

any

Varies by element type.

label

Sets the label of an element.

any

string (any)

type

Sets the element type.

any

string (valid element types listed here)

column

Controls the element's position in a table. Hides the element from its table view when the value is empty or null.

any

number (any)

parent

Sets the parent element, which is often a table element.

any

string (id of another element on the same form)

placeholder

Displays a placeholder value until you enter a value. Provides guidance about how to complete the field.

  • select (multiselect)

  • html (inlinehtml, richtext)

  • textarea (help, longtext)

  • email

  • password

  • tel

  • text

  • url

string (any)

pattern

Validates input against a regular expression. Rejects input that doesn't match the regular expression and displays a message.

  • date

  • datetime (datetimetz)

  • time (timeofday)

  • email

  • password

  • tel

  • text

  • url

string (valid regular expression)

min

Sets the minimum field value. Displays an error message when a value is less than this setting. Prevents form submission when a value does not meet the min requirement.

  • date

  • datetime (datetimetz)

  • time (timeofday)

  • number (float, integer, percent, currency)

number (any)

max

Sets the maximum field value. Displays an error message when a value is greater than this setting. Prevents form submission when a value doesn't meet the max requirement.

  • date

  • datetime (datetimetz)

  • time (timeofday)

  • number (float, integer, percent, currency)

number (any)

step

Controls the smallest increment by which the field value can increase or decrease.

  • date

  • datetime (datetimetz)

  • time (timeofday)

  • number (float, integer, percent, currency)

number (any)

precision

Controls the number of decimal places displayed in a numeric field.

number (float, integer, percent, currency)

number (integer)

unit

Controls the unit prefix or suffix shown in a numeric field. Supports custom units and the following default units:

  • usd

  • percent

  • byte

  • celsius

  • fahrenheit

number (float, integer, percent, currency)

string (valid unit types)

stepper

Displays plus (+) and minus (-) buttons that increment or decrement the value.

number (float, integer, percent, currency)

  • true

  • false

cols

Sets the number of text columns shown when the element first opens.

  • html (inlinehtml, richtext)

  • textarea (help, longtext)

number (integer)

rows

Sets the number of text rows shown when the element first opens.

  • html (inlinehtml, richtext)

  • textarea (help, longtext)

number (integer)

maxlength

Sets the maximum number of characters that the element accepts.

  • html (inlinehtml, richtext)

  • textarea (help, longtext)

  • text

number (integer)

barcode

Activates a barcode scanner that enters or selects a value.

  • select (multiselect)

  • text

  • true

  • false

remote

Controls whether the element stores options locally or retrieves them remotely. Loads remote options on demand and requires an internet connection. Works with search to find current records dynamically in NetSuite.

select (multiselect)

  • true

  • false

options

Defines the options that the select element presents.

select (multiselect)

multiple

Permits selection of more than one option in the field.

select (multiselect)

  • true

  • false

search

Displays a free-text search box that filters the options in the select or multiselect field.

select (multiselect)

  • true

  • false

width

Sets the width, in pixels, of the element in the FSM Mobile app.

signature

number (integer)

height

Sets the height, in pixels, of the element in the FSM Mobile app.

signature

number (integer)

camera

Controls whether the image field requires a new photo or a specific camera.

image

  • false (file upload or camera allowed)

  • true (camera only, file upload not allowed)

  • "user" (the selfie camera only)

  • "environment" (the front facing camera only)

accept

Defines the file types that the element accepts. Uses a list of unique file type specifiers. For more information, see Unique File Type Specifiers.

  • file (document)

  • image

string (representing a list of unique filetype specifiers)

maxsize

Sets the maximum file size in kilobytes (KB). Displays an error message and prevents form submission when the selected file exceeds this size.

  • file (document)

  • image

number (integer)

downsample

Sets the maximum image height or width, whichever is larger. Compresses an image when its largest dimension exceeds this value.

  • file (document)

  • image

number (integer)

Related Topics

General Notices