Components available in the Skedulo Plus Form Builder

A list of components available in the Skedulo Plus Form Builder for creating mobile forms.

Overview

The Skedulo Plus Form Builder provides a range of components that you can use to create custom mobile forms for the Skedulo Plus mobile application. These components allow you to capture data from your mobile users and create custom workflows.

Components in the Skedulo Plus Form Builder

The following components are available in the Skedulo Plus Form Builder.

Text input

The text input component is used to capture single-line text input from the user. The text input field supports up to 255 characters.

Text input component

Properties

Property Description Required
Label The title of the text input component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Keyboard type The keyboard type for the text input. Select the type from the drop down menu:
  • Default
  • Email address
  • Numeric
  • Phone pad
  • Number pad
  • Decimal pad
No
Placeholder text The placeholder text for the text input. No
Required If selected, the text input must be completed to save the form. No
Validation rules A regex pattern to validate the data input. No
Enable barcode scanner If selected, this enables the option to scan a barcode in the text input. No

Examples

The images that follow show how the component appears in a form in the Skedulo Plus app when it has different configuration options selected:

What the component looks like in the app Description
Text input component example in Skedulo Plus A single-line text input component that has a placeholder text, and is required to fill out.
Text input component example in Skedulo Plus A single-line text input component that has a description, and is not required to fill out.
Barcode scanning A text input with a barcode scanner.

Example validation rule

Validation rules support regular expression (regex) patterns to validate the data input of your text input component. An invalid input will display an error message to the user, and the form will not be saved until the input is corrected.

For example, to validate an email address, use the following regex pattern:

^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$

In the Form Builder:

Text input component example in Skedulo Plus showing the validation rule

Text input component example in Skedulo Plus showing an invalid email address

Text input component example in Skedulo Plus showing a valid email address


Text area

The text area component is used to capture single or multiple lines of text input from the user. The text area field supports up to 131,072 characters.

Text area component

Properties

Property Description Required
Label The title of the text input component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Keyboard type The keyboard type for the text input. Select the type from the drop down menu:
  • Default
  • Email address
  • Numeric
  • Phone pad
  • Number pad
  • Decimal pad
No
Placeholder text The placeholder text for the text input. No
Required If selected, the text input must be completed to save the form. No
Multi-line If selected, the text input will allow multiple lines of text. No
Validation rules A regex pattern to validate the data input. No
Enable barcode scanner If selected, this enables the option to scan a barcode in the text input. No

Examples

The images that follow show how the component appears in a form in the Skedulo Plus app when it has different configuration options selected:

What the component looks like in the app Description
Text input component example in Skedulo Plus A single-line text input component that has a description, and is not required to be filled out.
Text input component example in Skedulo Plus A multi-line text input component that has a placeholder text and a multi-line description with line breaks, and is required to be filled out.
Barcode scanning A text input with a barcode scanner.

Example validation rule

Validation rules support regular expression (regex) patterns to validate the data input of your text area component. An invalid input will display an error message to the user, and the form will not be saved until the input is corrected.

For example, to validate an email address, use the following regex pattern:

^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$

In the Form Builder:

Text input component example in Skedulo Plus showing the validation rule

Text input component example in Skedulo Plus showing an invalid email address

Text input component example in Skedulo Plus showing a valid email address


Read-only

The read-only component is used to display information to the user. It is not editable.

Read-only component

Properties

Property Description Required
Heading The title of the read-only component. No
Text to display A description of the read-only component. Yes

Example

The image that follows shows how the component appears in a form in the Skedulo Plus app:

Read-only component example in Skedulo Plus


Number input

The number input component is for users to record an integer.

Read-only component

Properties

Property Description Required
Label The title of the number-input component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Placeholder text A description of what the user should enter. No
Required If selected, the text input must be completed to save the form. No

Example

The image that follows shows how the component appears in a form in the Skedulo Plus app:

Number input component example in Skedulo Plus


Decimal input

The decimal input component is used to record a decimal number.

Decimal input component

Properties

Property Description Required
Label The title of the decimal input component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Placeholder text A description of what the user should enter. No
Field length The maximum of digits allowed before the decimal point.
For data-mapped forms, this field is auto-populated from the mapped field and cannot be edited.
Yes
Field decimal places The maximum number of digits allowed after the decimal point.
For data-mapped forms, this field is auto-populated from the mapped field and cannot be edited.
Yes
Required If selected, the decimal input must be completed to save the form. No

Example

The following image shows how the component appears in a form in the Skedulo Plus app.

In the example below, if the field length is set to 5 and the decimal places to 2, the field can accept the number 12345.67.

Decimal input field in Skedulo Plus

The drop-down component is used to capture a single selection from a list of options. There is no limit to the number of items in the drop-down list.

Drop down component

Properties

Property Description Required
Label The title of the drop-down component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Placeholder text The placeholder text for the drop-down. No
Required If selected, the drop-down must be completed to save the form. No
Add drop-down choices Provide a list of items to include in the drop-down list. One item per line. Yes

Example

The image that follows shows how the component appears in a form in the Skedulo Plus app:

Drop down component example in Skedulo Plus


Image

The image component is used to display a static image in a form. The image can be a QR code, an instructional image, or a visual guide.

Image component

Properties

Property Description Required
Label The title of the image component. Yes
Enter the URL to the image Provide a public URL for the image. Yes

Example

The images that follow show how a static image component appears in a form in the Skedulo Plus app:

Image component example in Skedulo Plus Image component example in Skedulo Plus

Multi-select drop-down

The multi-select drop-down component is used to capture multiple selections from a list of options.

Multi-select drop-down component

Properties

Property Description Required
Label The title of the multi-select drop down component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Placeholder text The placeholder text for the multi-select drop down. No
Required If selected, the multi-select drop down must be completed to save the form. No
Add drop-down choices Provide a list of items to include in the multi-select drop-down list. One item per line. Yes
Restrict how many choices users can pick If selected, you can set a minimum number of selections, a maximum number of selections, or both. See Restrict the number of selections. No

Example

The image that follows shows how the component appears in a form in the Skedulo Plus app:

Multi-select drop-down component example in Skedulo Plus

Restrict the number of selections

Use Restrict how many choices users can pick to control how many options a mobile user must select. For example, you can require at least two selections before a task form is submitted.

When you turn on the setting, enter a value in Minimum selections, Maximum selections, or both. The number of available choices displays below each field, and a summary such as “At least 2” or “Between 1 and 3” confirms the rule.

Restrict how many choices users can pick in the multi-select drop-down component

In the Skedulo Plus app, if the number of selections is outside the allowed range, the field shows an error and the form can’t be submitted until the selection is corrected.

The Form Builder flags invalid settings before you save, such as:

  • A minimum that is greater than the maximum.
  • A minimum or maximum that is higher than the number of available choices.

The Form Builder checks these settings again when you publish the form, in case choices were removed after the limit was set.


Date

The date component is a date picker used to capture a date from the user.

Date component

Properties

Property Description Required
Label The title of the date component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Required If selected, the date must be completed to save the form. No
Restrict which dates users can pick If selected, you can set the earliest allowed date, the latest allowed date, or both. See Restrict dates and times. No

Example

The image that follows shows how the component appears in a form in the Skedulo Plus app:

Date component example in Skedulo Plus


Time

The time component is a time picker that allows users to select a time that is entered in the form data. The time picker uses 12-hour time format.

Time component

Properties

Property Description Required
Title The title of the time component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Mandatory If selected, the time must be completed to save the form. No
Restrict which times users can pick If selected, you can set the earliest allowed time, the latest allowed time, or both. See Restrict dates and times. No

Example

The image that follows shows how the component appears in a form in the Skedulo Plus app:

Time component example in Skedulo Plus


Restrict dates and times

You can set the earliest and latest values a mobile user can enter in a date or time component. For example, you can stop caregivers from entering a future date when they document a visit.

To set a limit, turn on Restrict which dates users can pick on a date component, or Restrict which times users can pick on a time component. You can set an Earliest allowed value, a Latest allowed value, or both.

In the example below, the earliest allowed date is the value of another date component, Incident Date, and the latest allowed date is Today + 7 days.

Restrict which dates users can pick in the date component

Anchors

Base each limit on one of the following:

  • Today (date components) or Current time (time components).
  • A specific date or time.
  • Another field on this form: select another date or time component on the same form.

Today and Current time are calculated in the mobile user’s local time zone when they fill in the form, so users can always enter their own current date.

Offsets

Click Add offset to shift a limit from its anchor. Select a direction, such as Plus, enter a number, and select a unit:

  • Date components: by days, months, or years.
  • Time components: by minutes or hours.

For example, to allow dates up to one week ahead, set the latest allowed date to Today + 7 days.

How restrictions appear in the app

When a value falls outside the allowed range, the field shows an error that names the limit. The form can’t be submitted until the value is corrected.

The Form Builder flags invalid setups before you save, such as an earliest allowed date that is later than the latest allowed date.


Toggle

The toggle component is used to capture a true/false selection from the user. The toggle component is set to false by default.

Toggle component

Properties

Property Description Required
Label The title of the toggle component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No

Example

The image that follows shows how the component appears in a form in the Skedulo Plus app:

Toggle component example in Skedulo Plus


Attachment

The attachment component is used to capture an attachment from the user. Users can upload images from their device gallery, take a photo, or upload a file from their device. All common formats are supported.

Attachment component

Properties

Property Description Required
Label The title of the attachment component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Required If selected, the attachment must be completed to save the form. No

Example

The image that follows shows how the component appears in a form in the Skedulo Plus app:

Attachment component example in Skedulo Plus

Signature

The signature component is used to capture a signature that is uploaded as an attachment.

Signature component

Properties

Property Description Required
Label The title of the signature component. Yes
Description A text string that displays below the component to provide users with additional information about how to complete the item using this component. The character limit is 2000 and it can contain line breaks and numbered or bulleted lists. No
Required If selected, the attachment must be completed to save the form. No
Display “Full name” input Displays a text field for the user to enter their full name. This setting is false by default. No

Example

  • Signature with full name input

Signature component example in Skedulo Plus

Signature component example in Skedulo Plus