Form fields: defaults, read-only and other settings
Summary This lesson is for people who build forms in the SD Form Builder. It goes through the settings in a field's Edit form field window: default values, the Read only switch, help text, an Other…
Check yourself
Checking your PaT sign-in…
How To
On this page
- Opening a field's settings
- Step 1
- Step 2
- Step 3
- Step 4
- Step 5
- Step 6
- Giving a field a default value
- Step 1
- Step 2
- Step 3
- Step 4
- Step 5
- Step 6
- Step 7
- Step 8
- Step 9
- Step 10
- Step 11
- Step 12
- Giving a Date Picker a default date
- Step 1
- Step 2
- Step 3
- Step 4
- Filling in dates and times
- Step 1
- Step 2
- Step 3
- Making a field read only
- Step 1
- Step 2
- Step 3
- Step 4
- Step 5
- Step 6
- Step 7
- Read-only signatures and the wider signature box
- Step 1
- Step 2
- Step 3
- Step 4
- Adding help text under a field
- Step 1
- Step 2
- Step 3
- Step 4
- Step 5
- Step 6
- Adding an Other option with its own answer box
- Step 1
- Step 2
- Step 3
- Step 4
- Step 5
- Step 6
- Button icons and the colour of a chosen button
- Step 1
- Step 2
- Step 3
- Step 4
- Step 5
- Step 6
- Step 7
- Slide Bar: range, value label and starting point
- Step 1
- Step 2
- Step 3
- Step 4
- Step 5
- Step 6
- Step 7
- Long answers that grow and are kept
- Step 1
- Step 2
- Step 3
- Step 4
- Step 5
- Step 6
- Step 7
- Showing a description under dropdown options
- Step 1
- Step 2
- Step 3
- Single Value Display: date format and first or last row
- Step 1
- Step 2
- Step 3
- Step 4
- Step 5
- Step 6
- Step 7
- Purpose / Intent of the Module
- Header One
Summary This lesson is for people who build forms in the SD Form Builder. It goes through the settings in a field's Edit form field window: default values, the Read only switch, help text, an Other option, button icons, slide bar settings, long answers that are kept in the browser, dropdown descriptions and the date settings of a Single Value Display. Each part also says what the person filling in the form sees, such as dates shown as DD/MM/YYYY and a chosen button that fills with colour.
Opening a field's settings
Step 1
When the SD Form Builder opens a form, a message says Fetching form, please wait..., then Form Fetched once the form has loaded.
Step 2
Find the field on the Canvas and click its Edit button: the green pencil in the row of small buttons at the field's top right.
Step 3
The Edit form field window opens, with the field's type in its title. Tabs run along the top of the window, starting with General, Default Value and Advanced. The window opens on General the first time, and after that on the tab you used last.
Step 4
Most settings in this lesson are on the General tab. A switch reads YES when it is on and NO when it is off. Click a switch to change it.
Step 5
When you have finished, click Save and Close at the bottom right of the window. The red Close button at the top right shuts the window without keeping your changes.
Step 6
Save and Close also saves the whole form. If the Canvas heading then shows (Unsaved changes) in red, click Save Form Now, at its right, to save the form.
Giving a field a default value
Step 1
A default value is the answer a field starts with. The person filling in the form can keep it or change it.
Step 2
In the field's Edit form field window (the green pencil at the field's top right), click the Default Value tab, the second tab along the top.
Step 3
For a Text (Single line) field, type the starting text in Default Value, on the Default Value tab.
Step 4
A Text (Multiple lines) field shows the same Default Value box, and the default appears on the form: the long text box opens with that text in it.
Step 5
For a Dropdown (Single selection), type the starting option in Default Value, on the Default Value tab, spelled exactly as it is in the dropdown's list. A misspelt option still shows as the answer, even though it is not in the list.
Step 6
For a Switch, switch Default Value, on the Default Value tab, to YES. The field then starts switched on.
Step 7
For a Star Rating, click a star in Default Value, on the Default Value tab: the third star starts the rating at 3 out of 5.
Step 8
For a Buttons (Button Select) field, click Yes or No in Default Value, on the Default Value tab. The form then opens with that button already chosen.
Step 9
Not every field type can have a default. If the Default Value tab shows no box, the field cannot have one, except a Slide Bar: its Default Value slider is on the General tab.
Step 10
A Multi Select Boxes field shows no box on its Default Value tab, so it cannot have a default.
Step 11
Click Save and Close, at the bottom right of the window.
Step 12
A default only fills a field that is empty, so it never replaces an answer someone has already given.
Giving a Date Picker a default date
Step 1
In the Edit form field window of a Date Picker (the green pencil at its top right), click the Default Value tab.
Step 2
On the Default Value tab, click the calendar button in the date box labelled Due Date, and pick the starting date in the calendar that opens.
Step 3
Click Save and Close, at the bottom right of the window.
Step 4
The Date Picker now opens showing that date, and the person filling in the form can change it. The default is a fixed date: it does not move on to today's date.
Filling in dates and times
Step 1
Date Picker and Select Date Range fields show dates as DD/MM/YYYY: day, month, then year, for example 23/09/2024.
Step 2
The person filling in the form clicks the calendar icon at the right of the date box and picks a date. On a computer, they can also type the date in the same order.
Step 3
To set a time in a Time Viewer, the person filling in the form clicks the time box itself. The time selector opens.
Making a field read only
Step 1
On the General tab of the field's Edit form field window (the green pencil at the field's top right), switch Read only to YES.
Step 2
Click Save and Close, at the bottom right of the window.
Step 3
The person filling in the form now sees the field and its answer, but they cannot change it.
Step 4
To show a fixed answer that nobody can change, give the field a default value as well as switching Read only to YES.
Step 5
The Color Picker, File Uploader and HTML Editor have Read only too. A read-only Color Picker shows its colour faded, and no other colour can be picked.
Step 6
A read-only File Uploader has no drop area. Anything already uploaded is listed with Change File and File Description (Optional) greyed out, and a Download File button that still works.
Step 7
A read-only HTML Editor shows its text with no toolbar, and the text cannot be edited.
Read-only signatures and the wider signature box
Step 1
The Signature box stretches to 90 percent of the width of the space it sits in, instead of staying a fixed size.
Step 2
To show a signature that nobody can change, switch Read only to YES on the General tab of the Signature's Edit form field window (the green pencil at its top right).
Step 3
Click Save and Close, at the bottom right of the window.
Step 4
A read-only signature shows as a picture, with no Clear button, so nobody can sign over it. If no one has signed, the box reads No signature provided.
Adding help text under a field
Step 1
On the General tab of the field's Edit form field window (the green pencil at the field's top right), switch Show additional help text to YES.
Step 2
The Additional help text section opens below the switch. Type the help in its Help text box.
Step 3
Leave Show help text underneath (YES is the Only option), in the same section, as it is: help text always shows under the field.
Step 4
Click Save and Close, at the bottom right of the window.
Step 5
The person filling in the form sees the help in small grey text under the field.
Step 6
On Radio Buttons, the help text shows at the bottom, under the last option.
Adding an Other option with its own answer box
Step 1
Click the green pencil at the top right of a Radio Buttons or Multi Select Boxes field. Its Edit form field window opens.
Step 2
Scroll down to the options table with the Label column, and click the + at the left end of its header row to add an option.
Step 3
Type Other as the new option's label, with a capital O and nothing else in the box. Only the exact word Other adds an answer box.
Step 4
Click Save and Close, at the bottom right of the window.
Step 5
On Radio Buttons, when the person filling in the form chooses Other, a box reading Please provide additional information appears under it, for their own answer.
Step 6
On Multi Select Boxes, when the person filling in the form ticks Other, an empty box appears under it for their own answer.
Button icons and the colour of a chosen button
Step 1
A new Buttons (Button Select) field shows Yes with a Check icon on the left, and No with an X icon on the right.
Step 2
To change them, click the green pencil at the field's top right. The General tab of its Edit form field window has Left button text, Left button icon, Right button text and Right button icon.
Step 3
Click Left button icon and choose an icon from the list, such as Check, Thumbs Up or Arrow Right. To find one quickly, type part of its name.
Step 4
Choose the right button's icon the same way in Right button icon, below Right button text.
Step 5
Click Save and Close, at the bottom right of the window. Each icon shows after its button's text.
Step 6
A Submit Form button can show an icon too: in its Edit form field window, in the Button section of the General tab, choose one in Button icon. The icon shows before the button's text.
Step 7
When the person filling in the form clicks one of the two buttons, it fills with colour and its text turns white: green for the left button, red for the right button.
Slide Bar: range, value label and starting point
Step 1
Click the green pencil at the top right of a Slide Bar. Its Edit form field window opens, with the slider's settings on the General tab.
Step 2
On the General tab, type the lowest and highest values in Minimum Value and Maximum Value. Left empty, the slider runs from 1 to 5.
Step 3
To make the ball stop only at chosen values, type them in Custom Values (Optional), on the General tab, with commas between them, such as 10, 25, 50, 100. Each value is written under the bar, and the bar runs from the lowest to the highest of them instead of from Minimum Value to Maximum Value.
Step 4
On the General tab, Display Format sets how the small label above the ball reads: choose Number (1, 2, 3...), Percentage (%) or Pixel (5px, 10px...). Number shows the value itself. Percentage shows how far along the bar the ball is: on a bar from 10 to 100, the value 25 shows as 17%.
Step 5
Drag the Default Value slider, also on the General tab, to the point where the ball should start. This slider runs over the same values as the Slide Bar on the form: it follows Minimum Value, Maximum Value and Custom Values as you type them. With no default, or a default below the minimum, the ball starts at the minimum value.
Step 6
Click Save and Close, at the bottom right of the window.
Step 7
As the person filling in the form drags the ball along the bar, a small label above it shows the value it is on, in the format chosen in Display Format.
Long answers that grow and are kept
Step 1
A Text (Multiple lines) box grows taller as the text fills more lines, up to a set height. After that, a scroll bar appears in the box. Press Enter, or Shift+Enter, to start a new line.
Step 2
To keep what someone types in the box, click the Advanced tab in the field's Edit form field window (the green pencil at the field's top right).
Step 3
On the Advanced tab, switch Persist field value to YES.
Step 4
Click Save and Close, at the bottom right of the window.
Step 5
PaT now keeps the answer in the person's browser each time they click out of the box. If they close the form and open it again in the same browser, their text is back.
Step 6
The text is kept in that browser, on that device, only: another browser or device starts empty. Anyone else who uses the same browser sees the text too, so avoid the setting for private answers on a shared computer.
Step 7
Text (Single line), Dropdown (Single selection) and Switch fields have the same Persist field value setting on their Advanced tab.
Showing a description under dropdown options
Step 1
A Dropdown (Single selection) can show a short description under each option in its list. Its options must come from an endpoint: see the lesson Forms - API Integration.
Step 2
Use an endpoint whose data has a column named description. When the person filling in the form opens the list, each option's description shows in small grey text under its name. Open the list on the form once to check that the descriptions are there.
Step 3
Options typed into the dropdown's Label table have no description.
Single Value Display: date format and first or last row
Step 1
A Single Value Display shows one figure from an endpoint, such as a total or a date. It is the first tile in the Reporting control of the SD Form Builder: see also the lesson SD Dashboard: building a dashboard.
Step 2
When the endpoint returns several rows, choose which one the display shows in Use First or Last row in endpoint: First or Last. It is on the General tab of the display's Edit form field window.
Step 3
To choose how a value that looks like a date is shown, type a format in Date Format for Value (If value is detected as date), on the same tab.
Step 4
Build the format from DD for the day, MM for the month number, MMM for the short month name and YYYY for the year, such as YYYY-MM-DD or MMM YYYY.
Step 5
Date Format for Label (If label is detected as date), on the same tab, does the same for the label.
Step 6
Click Save and Close, at the bottom right of the window.
Step 7
Then click Preview, the green button at the top left of the SD Form Builder, to check the row and the dates the display shows with your endpoint's data.
Purpose / Intent of the Module
A brief description of what this module is about
Header One
Rate this page
Checking your PaT sign-in…