Forms
The Forms content item displays a Form Builder form to allow users to add and edit content. For more information, see Form Builder.
WarningDo not add more than one form to a content record. Adding more than one form to a content record is not currently supported.
Form configuration options
This content item uses the Common content item configuration options, in addition to the following:
- Form – Select the form to be displayed.
- Default success message – Displays a successful submission message. The default message is Successfully updated. Use this option to override the default message. If you have defined button-specific messages, these messages are appended to theDefault success message.
- Default failure message – Displays a failed submission message. The default message is Form not saved. Use this option to override the default message. If you have defined button-specific messages, these messages are appended to the Default failure message.
- Display additional error/success message (at the top of the page) – The standard location for submission-related error and success messages is at the bottom of the page. When enabled, the Display additional error/success message option also displays submission-related error messages at the top of the page.
- This form creates a new contact account – Enables account creation features on a specific form. New accounts have a status of Active in all cases. To create a valid contact record, a form must require the First Name, Last Name, and Email fields to be filled in by the user. The following options appear:
-
Contact type - Assigns either the Individual or Company role to the new contact account.
-
Customer type – Assigns a specified member type to the new contact account.
-
Billing category – Assigns a specified billing category to the new contact account.
-
For logged in non-staff users, auto-assign new contact to user’s primary org – When creating an associate account, this option ties the associate account directly to the company of the Company Administrator.
-
Duplicate prevention options – Managing duplicates is an important part of ensuring that new accounts are on-boarded correctly.
NoteThese options only apply when the username and password fields are present. See Displaying a form for more information about duplicate checking.
Use the following options to help manage duplicates:
-
Email – Provides basic validation that a user’s email address does not already exist in iMIS.
-
Query based – Uses a custom query to check for duplicates. Fields marked Use for duplicate check will be used by an IQA query. If the IQA returns a match, the account-creation process is halted.
NoteFields on the form marked Use for duplicate check must be added as filters to the IQA query. If a duplicate check field is not added as a filter or a filter does not use a duplicate check field, the query will not return matches for the field.
-
Use custom duplicate found message – Displays when a duplicate is found. It is recommended to suggest a corrective course of action for the form user, such as, “An account already exists with the email you have provided. Please visit our sign-in page.”
-
Allow user to proceed when duplicate is found– Allows users that have been identified as potentially having accounts to continue to sign-up and create an account which will likely be a duplicate. This will not allow a duplicate username to be created if that username is already in iMIS.
-
-
- Lock form to update specific contact – Anonymous forms using Locked to an ID allows you to deploy forms to collect submissions from anonymous users. Form data is stored for the selected contact. For example, a non-member account called Event Evaluations can be set up in iMIS and used to record submissions for a post-event survey. All submissions recorded using that form are recorded as being submitted by the specified ID, regardless of whether the information is received from a logged-in user or anonymously. Using a multi-instance table data source, you can capture detailed submissions from as many individuals as you want and have them grouped together for analysis.
Note
Forms that use this feature must reference a multi-instance data source.
- Contact to update - Select the specific iMIS record that will be updated by this form.
WarningWhen Lock form to update specific contactis enabled, the selected contact should never be a system account, such as Manager, Guest, Administrator, system, or IMISLOG.
