The pencil toolbox in a Process has twelve question fields and three presentation options. Together they make up your form.
This guide will walk you through adding them to a Process and explains the settings for each one, so you can find everything in one place.
This guide covers:
- Adding a field or presentation option
- Settings most fields share
- Adding options to Checkbox, Radio button and Dropdown fields
- Question fields
- Presentation options
- Considerations, tips & guidance
Before you start:
- You need to be assigned the Process Manager permission
- You need a Process to add fields to. This guide is designed to be used alongside How to create a Process.
Adding a Process applet/field
- In your Process, select the pencil icon to open the pencil toolbox.
- Drag the field or option (applet) into a section and drop it when the blue line appears.
- Hover over it. Two icons appear in its top right-hand corner. Select the three dots to open its settings.
- Change the settings you need, then select Close.
Top tip: To move a field, hover over the dots, then drag it to a new position and drop it when the blue line appears.
Commonly shared configuration options
- Label: the text people see next to the field. Replace the default with something meaningful. Switch off Show label to hide it from people filling in the form.
- Placeholder (optional): greyed-out text in the answer box that shows people what to enter. It disappears once they type an answer.
- Required: makes the field mandatory. People can't submit the step until they've filled it in.
- Include in email: if your Process sends an email when the step is submitted, switch this off to leave the field out of the email.
Adding options to Checkbox, Radio button and Dropdown fields
- Select Options.
- Type an option and select Add. Repeat until you've added every option.
-
To change the order, choose Alphabetical, Reverse Alphabetical or Manual from the sorting dropdown. With Manual, hover over the up and down arrows next to an option until the cursor changes to a hand, then drag it into place.
Question fields
Text
Lets people type a short answer in plain text, with no formatting.
- Label: says Text by default.
- Placeholder, Required and Include in email
- Maximum length: 200 characters by default. You can raise or lower it.
Multi line
Gives people space for a longer answer, so it's ideal when you need extra detail.
- Label: says Multi line by default.
- Placeholder, Required and Include in email
- Maximum length: 4000 characters by default. You can raise or lower it.
- Display as rich text editor: switch this on to give people a small content editor so they can format their answer. Leave it off for plain text only.
Numeric
Lets people answer with a number only.
- Label: says Numeric by default.
- Placeholder, Required and Include in email
- Minimum value and Maximum value: limit the numbers people can enter. For example, if everyone has between 1 and 4 monitors, set a minimum of 1 and a maximum of 4. If someone enters a number outside the range, the box turns red and shows a warning icon that explains what's allowed when they hover over it.
Email address
Lets people type in an email address.
- Label: says Email Address by default.
- Placeholder, Required and Include in email
Date
Lets people choose a date, and a time if you need one.
- Label: says Date by default.
- Placeholder, Required and Include in email
- Only allow dates in the future: allows only dates that haven't happened yet.
- Only allow past dates: allows only dates that have already happened.
- Include time: adds time fields next to the date.
Checkbox
Lets people tick one or more options from a list you set up.
- Label: says Checkbox by default.
- Required and Include in email
- Options and Sorting: see adding options.
Radio button
Lets people choose just one option. All the options are shown on the form.
- Label: says Radio button by default.
- Include in email
- Options and Sorting: see adding options.
- A Radio button field always has an option selected. By default it's the first one in the list, so think about which option you put first.
Dropdown
Lets people choose one option from a list that sits behind a dropdown button.
- Label: says Dropdown by default.
- Required and Include in email
- Options and Sorting: see adding options.
- Default option (optional): the option shown before people make a choice. It also appears in the dropdown list.
Picker
Lets people pick something from your intranet, such as a user, a user group or a location from your area structure.
- Label: says Picker by default.
- Required and Include in email
- Button text: says Choose item by default. You can change it, but it can't be blank.
- Allow multiple selection: lets people choose more than one item.
- Picker type: select the dropdown arrow and choose what people can pick.
File upload
Lets people attach files to support their submission. In the toolbox it's called Upload file.
- Label: says File Upload by default.
- Required and Include in email
- Allow multiple files: lets people upload more than one file.
- Number of files: drag the slider to set the most files people can upload, up to 100.
- Button text: says Upload file by default. You can change it, but it can't be blank.
Read only
Fills in information your intranet already holds, such as the submitter's office, so people don't have to type it.
- Label: says Submitter's office by default.
- Include in email
- Value: select the dropdown arrow and choose what to show. The options down to and including Current date fill in straight away while you're editing.
- Custom field: shows a field from the Other Information section of people's profiles. These fields can be customised, so they vary between intranets. See How to customise user profile fields.
- Form submission reference and Stage submission reference: Oak creates a unique reference for each form and each step. They're blank while you build the Process and fill in when someone submits it. People can find their references in their profile's contributions.
- Submitter's Leaving Date: shows the leaving date from the submitter's profile. It's blank unless a leaving date has been entered by the person's manager, someone with the Personnel Manager permission, or a User and Group Manager.
Rating
Lets people give a star rating on anything you like.
- Label: says Rating by default.
- Required and Include in email
- Maximum value: drag the slider to set the rating scale, up to 10.
Adding other information and visuals
Presentation options don't collect answers. Use them to add information and visuals to your form.
Custom Content
Adds your own formatted text, images and more, such as an introduction or instructions. It works the same way as the Custom Content applet on homepages.
- Enable padding: on by default to leave space around the content. Switch it off to fill the width of the template.
- Include background colour: switch this off to remove the background colour.
- Content: select Enter or paste your HTML content here to open the content editor. For help, see How to get the most out of your content editor.
Image
Adds a single picture. A random stock image appears when you first add it.
- Pick a new image: opens the media picker so you can browse or upload an image.
- Caption (optional): appears at the bottom left of the image.
- Undo: reverses your changes after you confirm.
Banner
Adds eye-catching images, which are great for key messages or breaking up a text-heavy form.
- Allow user to choose image manually: if you have more than one image, lets people click through them instead of waiting for them to change.
- Banner size: Large by default.
- Add an image: opens the media picker. Add as many images as you need and use the up and down arrows to reorder them.
- Link: select the link icon on an image to choose where it links to in the Object Picker. For help, see How to use the Object Picker to select areas, content and people.
- Duration: with more than one image, select the duration icon to set how long each shows. The default is 5 seconds.
- Remove: select the bin icon to remove an image.
Considerations, tips & guidance
- Choosing between list fields: use Checkbox when people can pick more than one answer, Radio button for one answer with every option visible, and Dropdown for one answer from a long list.
- If people need to format their answer, use Multi line with the rich text editor switched on instead of Text.
- Showing the form submission reference with a Read only field helps whoever handles the next step contact the submitter, especially if they've sent the same form more than once. The stage submission reference helps when one person completes several steps.
- Custom Content does everything Image does and more, so consider using it instead. Images have a fixed height of 400 pixels.
- For banners, we recommend using Poster, as it resizes to fit the screen. There's nothing on a banner image to show it contains a link, so you may want to mention it in nearby text.
- When you've finished adding fields, see How to create a Process to set up what happens next, followed by How to edit the publish settings of a process.