The Form Builder app is a dynamic environment to create custom Forms, Form Templates, and Questionnaires to gain insightful feedback directly from your users. Build Forms from scratch or use Templates to quickly generate and alter multiple forms from an existing set of questions and inputs.
How to Get
If you are interested in gaining access to the Form Builder App, please contact your Account Executive.
Once the Form Builder App is installed in your instance, you must first create the following groups in your Domo instance before you can create Forms and Templates:
Any member in the _FB_CreateForms_ group has permission to create Forms from scratch, or generate a form from an existing template. Members of this group cannot create or edit existing templates.
Any member in the _FB_CreateTemplate_ group has permission to create Templates from scratch and edit existing Templates. Members of this group can create and edit both Forms and Form Templates.
Users who are not members of either of these groups will only have permission to view and submit existing Forms.
Using Form Builder
Under the Forms tab, you can create new forms, view, and edit all available forms.
Manage Existing Forms
- Click the ellipsis on the Form you would like to manage.
Select Edit, Duplicate, or Delete.
Note: If you choose to edit a form, previous responses to the form are not changed.
Any changes made to a new copy of a form are not reflected in older versions.
Deleting a form is a permanent action and is not reversible.
Create a New Form
To create a new form,
Under the Forms tab, click Create New Form.
Fill out the following basic information for the new form:
Form Basic Information
Field Description Name/Description The name and description for the form Tags Terms related to the form. Adding tags allows you to quickly find the form through the search functionality. Groups Any Domo group(s) who should be able to view and submit the form. Leave this field empty if the form should be globally available.Note: Currently, only Domo Groups can be added to a Form. If there is an individual you would like to share a Form with, they will first need to be added to a specific Group. Response Type Restricts the number and type of responses that users can submit.
One response per user: Each user may only submit one response. Once a user has submitted a response, the form will no longer be listed in their available forms.Note: If a user has permission to edit the form it will still be listed in their available forms, but they will no longer be able to submit a response.
Crowdsourced (collaborative): Multiple users contribute to a single response.
Next, add a section to the form by clicking Add Section.
Standard: Allows you to create a section that contains any of the following Field Types.
Table: Allows you to create a section that contains a table for users to fill in based on options from a dropdown.
Name the section.
Then, select the type of field you would like to add to your section...Note: Multiple inputs can be added to a section. Each section of the form will be displayed as its own page.
Icon Field Description Example Title and Description Add a title and description to your section. This does not replace the section title; it is information and has no user interaction. Text Question Add a text question to your section. Text questions can be multi-line or single-line response questions. Dropdown Selection Create a dropdown of options a user can select from. You can customize the order in which items appear in the list and allow for multi-select. Date Select Add a date select field for a user to give a specific date or a date range as an answer. Add Image Allow users to upload their own images. Lookup Question Allow users to choose a column from a table card to pull values from to populate the dropdown selection values.
If you added a table section, select the table card and columns you wish to add.
When the form is complete, click Save and then click Back.
The form will now be listed in your available forms.
Templates allow you to create one single template that can be used to quickly make multiple forms without having to build them all from scratch. Under the Templates tab, you can create new templates and view and manage all available templates.
Manage Existing Templates
- Click the ellipsis on the Template you would like to manage.
Select Create Form, Edit, Duplicate, or Delete.
Note: If you choose to edit a template, any forms generated from the template before it was changed are not affected. If the changes need to cascade to the forms generated from the template, they must be completed individually.
Any changes made to a new copy of a template are not reflected in older versions.
Deleting a template is a permanent action and is not reversible.
Create a New Template
To create a new template,
Under the Templates tab, click Create New Template.
Fill out the following basic information for the new template:
For more information on these fields, see Form Basic Information.
Next, add a section to the template by clicking Add Section.
Name the section.
Then, select the type of field you would like to add to your section.Note: Multiple inputs can be added to a section. Each section of the template will be displayed as its own page.
For more information on the different fields you can add, see Field Types.
When the template is complete, click Save and then click Back.
The template will now be listed in your available templates.
Questionnaires allow you to group templates into a single form. By default, templates are grouped in the Unassigned templates section. To assign a template to a questionnaire, drag and drop the template over the questionnaire folder.
To manage your Questionnaires,
- Click the ellipsis on the questionnaire you would like to manage.
Select Create Form, Delete, Duplicate, or Rename
For a user to take and submit a Form, they will just need to navigate to the Form Builder app. Then, select the Form from the available list. Form submissions are recorded in a new DataSet that is created upon the Form's first submission. When the DataSet is created, its name is an automatically generated GUID (globally unique identifier.) We recommend renaming the DataSet once it's created to more easily locate and identify.
Connecting New Form Builder Data
Each time that you generate a new Form Builder card from the app's asset, it creates a new group of Export datasets in the Data Center that are used to power the Form Viewer app. This means that your Form Viewer is still pointing to the old Form Builder assets, so you'll need to update Form Viewer to point at the new Export datasets. The datasets that need to be updated will be called ExportColumns, ExportGroups, ExportSubmittedUsers, ExportFilters, ExportTags, ExportForms, ExportItems, and ExportSections.
In order to fix this issue, go to your Form Viewer app and select Edit Card from the wrench menu. Scroll down and swap out all of the currently mapped datasets to the new Form Builder datasets. The Export datasets should all be identified but the app context ID, which you will also find in the Form Builder dataset name.
After making these updates, you'll be able to see the new form in the Form Viewer app.