Form Design Guide
Overview
nFORM supports the design of custom forms for submission by the regulated community. These forms are highly configurable, and nFORM provides much flexibility for form designers.
Electronic versions of agency forms often look significantly different from their paper counterparts. There are many different approaches and techniques for implementing form elements in nFORM. Designing these forms can sometimes be an art, requiring implementation, trial, feedback, and refinement.
This guide covers standard form design activities, including the form creation process and refining a form design. More advanced features are described in the Advanced Form Design Guide.
Included in this guide:
Creating a Form
Forms are created in a dynamic manner, allowing each agency to tailor them to their specific needs. This section details the four key steps to create a form:
Create and configure the form attributes.
Design the form content.
Define the default form submission workflow.
Preview, test, and publish the form.
Step 1: Create and Configure the Form Attributes
The first step in creating a form involves crafting a new draft and defining its core attributes. During this phase, a new form is added to nFORM with key properties, including a name, description, instructions, and the responsible organization. Users can also duplicate an existing form and use it as a template. An adjacent export option allows form designers to efficiently export a form for future use.
Add a New Draft Form to nFORM
To create a new draft nFORM form:
Click the Forms option in the top menu.
Click the Add Form button at the top right of the Forms page.
Assign the Form to an Organization
Next, the form must be assigned to a parent organization. This determines where the form is listed and helps external users find the forms they need to submit. It also controls which internal users have access to manage the form and process submissions. Typically, the agency or program responsible for processing the form is designated as the responsible organization.
Select the appropriate parent organization when prompted, under “Select the organization the new form will be associated with.”
This setting can be updated later on the Forms Designer Form tab.
Configure the Form Attributes
The form designer consists of three main steps:
Form Details
Sections and Controls
Processing Steps and Actions
Online applications require all three steps to be completed, whereas offline forms only require Step 1 (Form Details). This section covers Step 1, which involves configuring the core form attributes.
There are many configuration attributes available for use within a form. However, each tab on the Form Details page includes fields that must be completed before a form can be published. These fields are marked with a red asterisk.
Overview Tab
The Overview tab is used to configure form information that is shared across all versions of the form. Fields on this tab are described below.
Field | Description | Notes |
|---|---|---|
Responsible Organization | The parent organization or program for the form. | See Assign the Form to an Organization above for more information. |
Tag | A unique identifier for the form. | Form tags must be unique, as they are used to map any export, import, or other use of data back to the original form. This is especially important when an external system or database needs to access submission data outside of nFORM (such as for data integration). See the Tagging Fundamentals section in the Data Integration Guide for additional details on tagging. |
Identifying Keywords | Words that users can search to find the form. | Identifying keywords do not need to include the form name, form reference number, or form short description, which are already automatically searched by the finder. |
Form for Internal Use Only | A checkbox indicating whether the form should be available to the public. | If checked, the public will not have access to the form. |
… (Form Revision Notes) | Notes to communicate changes made to specific form versions. | A revision note can be edited or deleted by the user that created it. Revision notes automatically indicate what form version they were added to. |
Details Tab
The Details tab is used to configure the main form information. Fields on this tab are described below.
Field | Description | Notes |
|---|---|---|
Status | Indicator of where a form is in its lifecycle. Options include:
| If a form in Draft status is a new version of an existing form, the most recent published version continues to be available for submissions. |
Change Status | Several buttons that can be used to change form statuses. Buttons include:
| Only draft versions of a form can be published. Only draft or published forms and form versions can be deactivated. Only published or inactive forms and form versions can be made into drafts, and only one version of a form can be a draft at a given time. Only forms with no open submissions can be deleted. If there are open submissions, they must be deleted before the form can be deleted. |
Form Name | Public title of the form that is displayed throughout the system. |
|
Reference Number | A unique numerical identifier for the form. | This field is often used to reference a paper form number. |
Short Description | Text displayed to support the user in understanding the purpose of the form and its intended audience. |
|
Activate Display of Alternative Submission Identifier | A checkbox indicating whether an alternate identifier is enabled. | Enabling an alternate identifier will be enabled allows the form designer to collect data from the submitter, which will then be displayed on the Processing Dashboard and submission headers. For more information on this feature, see the Alternative Identifier section of the Advanced Form Design Guide. |
General Instructions | Text displayed on the form’s home page to provide initial instruction for using and completing the form. |
|
Default Form Type Value on Form | The default form type for this form (for example, new, renewal, or modification). | When a user submits a form, they are prompted to select the reason for submission. This setting determines the default reason for this form type. “Off” can be selected when this attribute is not used. |
Lock Form Type Field on Form | An option to lock the Reason field on submissions. | Selecting “Yes” for this attribute will lock the Reason field value based on the configured default value, forcing this value to be consistent for the form. |
Copy as New – Enable Copy as New | An option to allow submitters to copy previous submissions to use as a base for new submissions from the Submission View page. |
|
Confidential Attachments – Label for Confidential Attachment Justification Field | If enabled, a label that appears above the confidential attachment justification field requesting that users provide a reason if they wish to keep an attachment confidential. | This label will only appear if a user identifies an attachment to be kept confidential. |
Reset Steps on Revision | An option to reset timelines and benchmarks for processing a submission following a revision of a submission. |
|
Reminders: Send NN days prior to target date | The number of days prior to a given processing step’s target date that "Near Target Date" notifications are issued. | These notifications can be configured in the Trigger Action field of the Workflow Notifications section of the Form Designer. Notifications are only sent to users who are configured to receive such alerts. For more information, see the Processing Step Notifications section below. |
Reminders: Complete form within NN days of submission | The number of days the agency is targeting to assign the form a finalizing status, such as Issued or Denied. |
|
Reminders: Complete form within NN days of being deemed complete | The number of days after a submission is deemed complete that the agency is targeting to assign the form a finalizing status, such as Issued or Denied. | This benchmark is only relevant if the Deemed Complete submission status is enabled. |
Date Tracking | A read-only field allowing for review of recent form activity. |
|
Use Tab
The Use tab is used to configure the manner in which a form will be used. Fields on this tab are described below.
Field | Description | Notes |
|---|---|---|
Promote Form Version for Submissions on Publish? | The option to automatically apply published updates to a form to any draft submissions. If this box is selected, users are notified upon reopening their draft submission that it will be updated to the latest form version before they can continue the submission process. | To take advantage of this feature, this setting must be enabled prior to a submission being started. |
Online Submission Available? | The option to allow the form to be completed using the online submission. |
|
Allow Contact Re-Use? | The option to allow users to reuse entered contact information within a form submission. |
|
Offline Form Available? | The option to allow users to download an electronic copy of the form and submit it outside of nFORM. | This is generally used for forms that are not suitable for online submission or as an offline alternative. If this box is selected, the Allow to Print Blank Form? option will not be available, and additional fields will appear:
|
Allow to Print Blank Form? | The option to allow users to print a blank version of the form for reference. | If this box is selected, the Offline Form Available? option will not be available. Note this field only appears if configured in the system. |
Pre-Fill Tab
The Pre-fill tab is used to configure the data import process if utilized. For more information on this feature, see the Data Integration Guide.
Certification Tab
The Certification tab is used to configure what is presented to the user during the certification and signature process. Fields on this tab are described below.
Field | Description | Notes |
|---|---|---|
Create Copy of Record | The option to create a Copy of Record (PDF archive) for each submission. | This is mandatory if signatures are required. |
Enable Review Step | The option to include a review step on the form, which summarizes all information entered. | This is mandatory if signatures are required. |
Signature(s) Required | The option to require one or more signatures upon submission. |
|
Digital (in-app) Signature | The option to allow users to digitally certify submissions directly in nFORM upon submission. If this option is selected, the following additional fields apply:
| Users who wish to sign digitally must obtain electronic signatory permissions through the agency. |
Hard-Copy Signature | The option to allow users to certify submissions by printing a signature form, which they (and any other signers) sign and mail to the agency. | If this option is selected, the form designer must select the default template or upload a custom hard-copy signature form using the Use Custom Template option in the Hard-Copy Signature Form area. |
Access: Unrestricted (user registration not required) | The option to allow anyone to submit the form. | Access settings are only available if Signature(s) Required is not selected. |
Access: Registered Users | The option to allow only users who have self-registered an account to submit the form. | Access settings are only available if Signature(s) Required is not selected. |
Access: Verified Registered Users (including Electronic Signature users) | The option to allow only users who have self-registered an account and been assigned the Verified User or Electronic Signature role for the parent organization to submit the form. | Access settings are only available if Signature(s) Required is not selected. |
Access: Require Explicit Permission to Submit Form | The option to allow only users who have been assigned the Authorized Submitter role for the parent organization to submit the form. | Access settings are only available if Signature(s) Required is not selected. |
Fees Tab
The Fees tab is used to configure any fees associated with submitting this form online. Fields on this tab are described below.
Field | Description | Notes |
|---|---|---|
Account Number | The primary account number for where fees are distributed. | This is for reference and reporting purposes only. |
Payment Processing | Allowable payment methods for a form. Options include:
| Online payments allow the submitter to pay fees via a third party payment processor, if that feature is enabled and configured. Offline payments allow the submitter to print a remittance slip, write a check, and send a payment to the agency for any fees due. |
Require Payment Prior to Submission? | The option to require full payment prior to considering the form as submitted. | Submissions are assigned a Payment Due status after certification until payment is received. Once paid, the submission is assigned a Submitted status. If unchecked, payment will occur after submission. |
Payment Remittance Address | The address where form fee payments should be remitted. |
|
Use Default Payment Voucher? | The option to present the default nFORM payment voucher to the submitter. | If unchecked, a custom payment voucher template can be uploaded and used for submissions of this form, and additional fields will be available under the Payment Voucher Template heading. For more information about this feature, see the Payment Voucher Design Guide. |
Fee Type | Allowable fee types for a form. Options include:
|
|
Flat Fees | Any flat fees specific to the form. For each flat fee, the following must be provided:
| If Flat Fee is selected as the fee type, at least one fee must be provided. One or more flat fees can be established, and the user can select the appropriate fee (for example, small quantity generator or large quantity generator). |
Calculation Based Fees | The details of the calculated fee to process the form. | For more information about this feature, see the Fee Configuration section of the Advanced Form Design Guide. |
Contacts Tab
The Contacts tab is used to configure contact information for the form. This information appears on the submitter’s Form View and Submission View pages. Fields on this tab are described below.
Field | Description | Notes |
|---|---|---|
Contact Address | The contact address associated with the form. |
|
Other Contact Methods | Other contact methods for the form. When adding other contact methods, the following additional fields are available:
|
|
Links Tab
The Links tab is used to configure links related to the form (such as statutes, regulations, user guides, or organization websites). These links appear on the submitter’s Form View page.
Clicking the add link… link or the Edit button under Actions opens the Manage Link page. Fields on this page are described below.
Field | Description | Notes |
|---|---|---|
Link Name | A name for the link, which is used as the hyperlink text within the form. |
|
Link | The web address of the web resource. | This value must be a fully qualified web address (for example, “http://...” for a website). |
Display After | A custom sort order for the list of values. |
|
FAQs Tab
The FAQs tab is used to configure frequently asked questions for the form. These questions appear on the submitter’s Form View page.
Clicking the add faq… link or the Edit button under Actions opens the Manage FAQ page. Fields on this page are described below.
Field | Description | Notes |
|---|---|---|
Question | The question text. |
|
Answer | The answer to the question. | The answer is displayed when a user selects the question. |
Display After | A custom sort order for the list of values. |
|
Integrations Tab
The Integrations tab is used to configure custom data integrations for the form. In particular, this area allows a user to customize where on the file system a copy of the submission package will be archived. To enable this option:
Select the Export submission data to the file system checkbox.
The file path under “Submission data will be exported to the following file system location” represents the base file location where submissions will be exported. This setting is configured at the system level in the configuration settings.
Select the Use the default file export path configured for your nFORM installation option to allow submissions to copied to the location specified.
Select the Customize the path based on the contents of the submission option to allow submissions to be copied to subfolders within the file path specified. This setting allows users to group like submissions (for example, by program area, division, or permit type).
For additional details on the formula used to identify the subfolder where the submission package is stored, see Appendix A: Formula Builder Examples in the Advanced Form Design Guide.
Text Templates Tab
The Text Templates tab is used to configure text templates for the form, which enable an organization to provide consistent communication with the submitter. These text templates are available for selection by processing staff when processing a submission.
Clicking the add standard text template… link or the Edit button under Actions opens the Manage Standard Text Template page. Fields on this page are described below.
Field | Description | Notes |
|---|---|---|
Standard Text Template Title | A simple description of the standard text template, which is presented to users when selecting a template. |