Allows you to point the form builder field to an API endpoint (hosted by ShareDo, or in a ShareDo plugin) that will provide a list of values to be shown in a drop-down list.

It is similar to the Option Set picker, but the list of values comes from an API.

Attributes:

• endpointUri: URI to a service that returns an array of elements (see below)
• allowNoSelection: if true, the 'None' option will be shown.
• multiple: allow multiple selection if true.
• placeholderText: label to use for the 'None' option.
• visibleIf: set visibility conditions using ‘field=value’ pairs.
• chronologyCard: whether changes to this field are logged to chronology.
• hideIfNoData: whether to hide this field if no data is returned from the API

The endpoint specified in the endpointUri setting must return a JSON array in the following format:

[
  {text: 'Item One', value: '1'},
  {text: 'Item Two', value: '2'},
  // etc.
]

The text property is the user-facing text that will be shown for each item.

The value is the identifier for that item, and should be unique.

ShareDo contains an example endpoint that returns a list of countries in this format.

Add an API Picker Field, and set the endpointUri to 

/api/lists/00000000-0000-0000-0000-000000000000/test-list-countries?format=alpaca

to see a working example of this control.

Adds a check box to the form.

Attributes:

Displays a currency field.   
  

Attributes:

Date field. Provides a calendar date-picker from which a user can pick a date. 
 
See the Form builder data/time field enhancement section of the ShareDo v7.6.0 Release Notes for important information on the displayFormat attribute. In versions before v7.6, the format attribute was used but restricted date formatting to the ISO 8601 standard (YYYY/MM/DD). Changing the date format could cause issues in ShareDo.

Attributes:

Date time fields. Provides the user with a calendar and clock control to pick the date and time. 
 
See the Form builder data/time field enhancement section of the ShareDo v7.6.0 Release Notes for important information on the displayFormat attribute.  In versions before v7.6, the format attribute was used but restricted date formatting to the ISO 8601 standard (YYYY/MM/DD). Changing the date format could cause issues in ShareDo. 

Attributes:

Displays a decimal. Use configuration to set the precision (the number of digits) and the min and max values.

Attributes:

The header snippet lets you add header-style text to your form.  

Attributes:

This creates a field that allows you to pick an icon.

Attributes:

Displays an integer. Use configuration to set the min and max values.  

Attributes:

The label snippet lets you add a text-only label to your form.

Attributes:

The memo field provides a multi-line text field. Use the rows attribute to specify the initial number of rows to display on the form.  

Attributes:

This field creates an ODS picker that displays a filtered list of ODS entities based on the selected role.

Attributes:

This snippet allows you to add a drop-down list to your form.  
 

Attributes:

• Use the optionSetName attribute to specify the system name of the option set (found in admin under the data dictionary). 
• Use the multiple option to specify whether the user can select more than one item from the list.

Note that if a subsequent field has a visibleIf display option based on the option set selection, then you should use the ID of the selected item rather than the option set value name.

The participant picker field allows a user to select a participant.  

Attributes:

• multiple: if set to true, allows you to select multiple participants.
• roleSystemNames: Provides the participant role system names you are selecting.
• includeAncestors: allows selection of participants from ancestors (for example, if you have a task with a parent work type, it includes the participants form the parent work type.)
• includeAncestorTypePaths: specifies the type paths where you want to limit selection (for example, matter).
• allowParticipantAdd: allows the user to add a participant.
• autoSelectSingleParticipant: if there is only one participant available, it will be autoselected if this is set to true. This only works if the “multiple” attribute is set to false.

Captures a percentage value.   

Attributes:

Defines a new section on the form.

Attributes:

Provide the addition of a standard text field.  

Attributes:

Adds a toggle button to your form. 
 

Attributes:

The tree field creates a tree list that allows multi-select.   

Attributes:

• selectMode values: "LeafOnly" restricts selection to leaf nodes only. Any other value (e.g. "Any") allows selection of any node (leaf or parent). Only "LeafOnly" is explicitly checked; there is no constant for the alternative.
• displayMode values: "Full" shows the full label path in the selection (e.g. Parent > Child > Leaf). "Single" (or any non-"Full" value) shows only the selected node’s label. Use one value only: "Single" or "Full".

This field creates a picker where you can select a unit of measure.

Attributes: