Quick Start Guide - bcgov/common-hosted-form-service GitHub Wiki
This documentation is no longer being updated. For the most up to date information please visit our techdocs
Follow this guide if you want to learn how to quickly get started building forms. You will require an IDIR attached to a valid email address to connect.
Are you building your first form? You can now watch our video series on how to get started.
On this page:
- Form settings
- Form structure
- Basic and advanced components
- Text field
- Select list
- Column layout
- Checkbox group
- Panel layout
- Static content
- B.C. Government components
- Save your design
- Managing versions
- Share your form
The name you provide here will show above the form.
A form is made up of components. For example: input fields, checkboxes or text boxes. You can drag and drop these components from the left column onto your form.
Advanced components have more configuration options than the basic fields (for example: advanced conditional logic). Having JavaScript programming experience will help when trying to take full-advantage of using advanced components.
When you drag a text field onto the form you will see this dialog screen.
Note: The form builder has specific components for Email, Phone or Number form fields. They look like the standard ‘text’ field, but the validation rules and appearance are slightly different and will help ensure the data you collect is in the right format.
Use this component when submitters may need to type more than one line of text.
When you want to create a list of items from the dropdown and let users select as you see below.
Go to “Data” tab and add the list items as you see below.
Use the ‘columns’ component to create a 2, 3 or 4 column layouts.
Go to “Data” tab and add a list of values
Add tooltip to help the user identify or learn more about an element. Tooltips will appear as question mark at the end of a field’s labels.
Panels allow you to create groupings of form fields.
Drag & drop the “Panel” component from the layout, then you will see the following dialog.
The "Static Content" components can be used to add headings and other text formats as shown in the sample form
"Business Name Search" component will show a search field that lets the user select from a database of organizations legally registered in BC.
Once you’ve created a form, make sure you save your design. To save your form click on the “Save Design” icon. You can also export / import your design (as a JSON schema) for re-use in another form or by other form designers.
Once you save the form, you will see this alert banner. You can preview your form or publish the form.
You can create a new version of your form design, using an existing version as a starting point. You do this by clicking on the plus icon next to an existing version. A new version will be in a 'draft' state until you set it as 'published' using the toggle in the table of versions. You can only have one draft version, but you can delete that to re-start a new one if required.
You can send the link to anyone you would like to share this form.