Intake form configuration groups

This section describes how to create and define an Intake Form Configuration Group, with instructions for each section of the Intake Form Configuration Group, and how to include or exclude the field groups on certain types of applications.

For instructions on applying an Intake Form Configuration Group to an application type, follow the steps in Create and configure new record types.

Add an intake form configuration group

An Intake Form Configuration Group enables you to specify parameters and settings for the fields on an intake form. For example, you can display or hide fields, choose whether those fields are mandatory or optional, specify where the fields display on the form, and so forth.

You can set the parameters for fields on intake forms:

Display: Do you want the field to display on the form?
Required: Is the field required or optional?
Validate: Do you want to give users the ability to validate their entry against your database?
Default Values: Do you want to display default values that tell users what information you expect them to enter? (This only applies to Contact sections)
Display Button: Where do you want the field to display on the intake form?
Display Order: Where do you want the field to display on the intake form?
depending on the field type (for example, Default Values are only available for certain fields):

To add an intake form configuration group

From the user account menu , go to Administration > Application > Intakeform configuration.

Select Add.

Civic Platform displays the Intake Form Configuration Group - Add page, illustrated in the sample screen below. The first column lists the intake form fields and its sections, starting with Record Detail. The columns that display horizontally across the top of the page contain the parameters you can set for each row listed in the first column.

Field	Description
Display	Select Yes to display the field on the intake form. Select No to hide the field on the intake form.
Required	Select Yes to require the user to complete this field. If you select Yes, users cannot submit the form unless the form contains the required information. Select No to make this field optional. If you select No, users can submit the form without entering a value in this field.
Validate	Select Yes to enable a Validate button on the form. If a section requires validation, users can only search and add information from the reference database into the section. The reference database can be the local Civic Platform database, an external data source that holds address, parcel, owner data, or data from ‘PERMITS’ Plus, Kiva, or GIS. If you select Yes at the Validate and Required options of the Applicant or Contact section, all the other sections and the fields in the intake form are inactive until users validate the section. If a contact list requires validation, you only need to validate the primary contact in the list. Select No to disable validation. If a section does not require validation, users can enter new information or modify the information that they select from the reference database.
Default value	Specify a default value from the drop-down list to indicate the information you expect the user to enter in the field. For example, if users generally enter billing information in this form, you can set the default value for a contact field to “billing contact,” so that a user who is completing the form sees “Billing Contact” in the field. For the Multiple Contact fields, select the “Select to add contact types” link and add the default contact types and the minimum number of contacts a user must enter. When you set default values to “required,” users must enter the information on the form before Civic Platform allows them to submit the form.
Display button	Check the As Owner option to display the As Owner button in this section on the form. To hide this button, clear the check box. Check the As Lic Pro option to display the As Lic. Pro button in this section on the form. To hide this button, clear the check box.
Display order	Enter a Display Order number that represents the field’s position on the form. For example, to display the Record Detail first on the form, enter 1.

Enter a name for your new Intake Form Configuration Group.

For each row in the first column, specify the parameter settings for the columns that display horizontally across the top of the page

Field	Description
Display	Select Yes to display the field on the intake form. Select No to hide the field on the intake form.
Required	Select Yes to require the user to complete this field. If you select Yes, users cannot submit the form unless the form contains the required information. Select No to make this field optional. If you select No, users can submit the form without entering a value in this field.
Validate	Select Yes to enable a Validate button on the form. If a section requires validation, users can only search and add information from the reference database into the section. The reference database can be the local Civic Platform database, an external data source that holds address, parcel, owner data, or data from ‘PERMITS’ Plus, Kiva, or GIS. If you select Yes at the Validate and Required options of the Applicant or Contact section, all the other sections and the fields in the intake form are inactive until users validate the section. If a contact list requires validation, you only need to validate the primary contact in the list. Select No to disable validation. If a section does not require validation, users can enter new information or modify the information that they select from the reference database.
Default value	Specify a default value from the drop-down list to indicate the information you expect the user to enter in the field. For example, if users generally enter billing information in this form, you can set the default value for a contact field to “billing contact,” so that a user who is completing the form sees “Billing Contact” in the field. For the Multiple Contact fields, select the “Select to add contact types” link and add the default contact types and the minimum number of contacts a user must enter. When you set default values to “required,” users must enter the information on the form before Civic Platform allows them to submit the form.
Display button	Check the As Owner option to display the As Owner button in this section on the form. To hide this button, clear the check box. Check the As Lic Pro option to display the As Lic. Pro button in this section on the form. To hide this button, clear the check box.
Display order	Enter a Display Order number that represents the field’s position on the form. For example, to display the Record Detail first on the form, enter 1.

Search for an intake form configuration group

From the user account menu , go to Administration > Application > Intakeform configuration.
Enter the name of the group that you want to find.
Select Submit.
Select the red dot that appears next to the group that you want.

Edit an intake form configuration group

After you set up an Intake Form Configuration Group, you might need to change certain details about it. You can change the standard sections that you want to display in a group, as well as change the required and validation status of each section.

You cannot change the group name.

To edit an Intake Form Configuration Group

From the user account menu , go to Administration > Application > Intakeform configuration.
Select the red dot by the Intake Form Configuration Group that you want to edit.

Civic Platform displays the Intake Form Configuration Group Details-Edit page.

Update the values for each section of the application as defined in the intake form configuration group parameter settings

Field	Description
Display	Select Yes to display the field on the intake form. Select No to hide the field on the intake form.
Required	Select Yes to require the user to complete this field. If you select Yes, users cannot submit the form unless the form contains the required information. Select No to make this field optional. If you select No, users can submit the form without entering a value in this field.
Validate	Select Yes to enable a Validate button on the form. If a section requires validation, users can only search and add information from the reference database into the section. The reference database can be the local Civic Platform database, an external data source that holds address, parcel, owner data, or data from ‘PERMITS’ Plus, Kiva, or GIS. If you select Yes at the Validate and Required options of the Applicant or Contact section, all the other sections and the fields in the intake form are inactive until users validate the section. If a contact list requires validation, you only need to validate the primary contact in the list. Select No to disable validation. If a section does not require validation, users can enter new information or modify the information that they select from the reference database.
Default value	Specify a default value from the drop-down list to indicate the information you expect the user to enter in the field. For example, if users generally enter billing information in this form, you can set the default value for a contact field to “billing contact,” so that a user who is completing the form sees “Billing Contact” in the field. For the Multiple Contact fields, select the “Select to add contact types” link and add the default contact types and the minimum number of contacts a user must enter. When you set default values to “required,” users must enter the information on the form before Civic Platform allows them to submit the form.
Display button	Check the As Owner option to display the As Owner button in this section on the form. To hide this button, clear the check box. Check the As Lic Pro option to display the As Lic. Pro button in this section on the form. To hide this button, clear the check box.
Display order	Enter a Display Order number that represents the field’s position on the form. For example, to display the Record Detail first on the form, enter 1.

and in the intake form fields and sections.

Field	Description
Record detail	The Record Detail section of a form displays the details of the record. The only parameter that you can set for this section is the Display Order.
Address	The address section of an intake form lets users enter the address of the primary parcel, including a range of street and unit numbers. If you set the Display and Required parameters in this section to Yes, Civic Platform validates whether a user adds information to the Addresses section on the Location tab upon the submittal of a new record.
Parcel	The parcel section of an intake form lets users enter information about the parcel. The County Assessor’s Parcel Number (APN) determines the parcel information. If you set the Display and Required parameters in this section to Yes, Civic Platform validates whether a user adds parcel information to the Parcels tab upon the submittal of a new record.
Owner	The owner section of an intake form lets users enter information about the individual or institution that owns the parcel, property, or structure. If you set the Display and Required parameters in this section to Yes, Civic Platform validates whether a user adds owner information to the People tab upon the submittal of a new record.
Licensed professional	The licensed professional section lets users enter contractor, architect, engineer, or developer (CAED) information. The state usually provides this information, including the license number and license type. If you set the Display, Required, and Validate parameters in this section to Yes, Civic Platform validates whether a user adds licensed professional information to the People tab upon the submittal of a new record.
Applicant	The applicant section lets users enter information about the individual or institution who submits the form. If you set the Validate and Required parameters in this section to Yes, the Validate button displays in this section. All other sections of the form are inactive, and the user must complete the Applicant section and select the Validate button to activate the other sections. You cannot activate this section if you activated the Multiple Contacts section. If you set the Display, Required, and Validate parameters in this section to Yes, Civic Platform validates whether a user adds applicant information to the People tab upon the submittal of a new record. If you specify a default value for this section, Civic Platform also validates whether a user adds the required type of applicant.
Contact 1 Contact 2 Contact 3	Up to three Contact sections on a form let users enter information about billing, legal, and any additional contacts. If you set the Validate and Required parameters in any Contact section to Yes, the Validate button displays in the section. All other sections of the form are inactive, and the user must complete any Contact sections and select the Validate button to activate the rest of the form. If you set the Display, Required, and Validate parameters in this section to Yes, Civic Platform validates whether a user adds contact information to the People tab upon the submittal of a new record. If you specify a default value for this section, Civic Platform also validates whether a user adds the required type of contact. NOTE: You cannot activate this section if you activate the Multiple Contacts section.
Multiple contacts	Set the Display option to Yes to display multiple contacts as a list and to allow users to add more than three contacts. From the list of contacts, users can set a primary contact and can search for, add, and delete contacts. When you activate the Multiple Contacts section, you cannot activate the Applicant and Contact 1, Contact 2, and Contact 3 sections. If you set the Validate and Required parameters in this section to Yes, the Validate button displays in this section. All other sections of the form are inactive, and the user must complete the section and select the Validate button to activate the other sections. If you set the Required parameter to Yes and Validate to No, Civic Platform only enforces the Required parameter. If you set the Display, Required, and Validate parameters in this section to Yes, Civic Platform validates whether a user adds contact information to the People tab upon the submittal of a new record. If you specify a default value for this section, Civic Platform also validates whether the user added the required type of contact.
Complainant information	The complainant section lets users enter information to identify an individual or institution who registers a complaint. Only include this section for intake forms that you use in the code enforcement module. NOTE: The complaint and complainant sections of an Intake Form Configuration Group only work with Classic Administration - Daily User. Best practice is to configure Complaint and Complainant fields in Application Specific Information or Application Specific Information Tables for the enforcement record types.
Complaint information	The complaint section lets users enter a description of a complaint, including the reported address. Only include this section for intake forms that you use in the code enforcement module. NOTE: The complaint and complainant sections of an Intake Form Configuration Group only work with Classic Administration - Daily User. Best practice is to configure Complaint and Complainant fields in Application Specific Information or Application Specific Information Tables for the enforcement record types.
Additional information	The additional information section lets users enter information that the U.S. Census Bureau requires in a C404 report. This report, also known as the “Report of Privately-owned Residential Building or Zoning Permits Issued,” surveys new residential units, additions, and alterations.
Application status	Select Yes to display the Application Status. Civic Platform displays the Application Status based on the Application Status Group assigned to the Application Type. Select No to hide the Application Status.
Application‑specific information	The application-specific information section enables you to enter custom information specific to your agency.
Associated GIS features	For information about GIS, refer to the Accela Civic Platform GIS Administrator Guide. If you set the Display and Required parameters in this section to Yes, Civic Platform validates whether a user adds GIS features to the Map Objects section on the Location tab upon the submittal of a new record.
Structure	The structure section lets users enter information about any structures under construction. For example, “Twin Pines Mall.”
Establishment	An establishment is a business or residence that occupies space in a structure. For example, users can enter information about a store in a mall.
Event	The event section lets users access an existing calendar and schedule an event related to the intake form.
Asset	Select Yes to display the Asset Section in a new permit intake form. Select No to hide the Asset Section in a new permit intake form. If you set the Display and Required parameters in this section to Yes, Civic Platform validates whether a user adds asset information to the Assets tab upon the submittal of a new record.
Application- specific info table	Select Yes to display the Custom Lists section in a new permit intake form. Select No to hide the Custom Lists section in a new permit intake form.
Documents	The documents section lets users attach documents, such as building plans or an insurance bond, to a permit application. The value you enter in the Default Value field indicates the number of documents users can attach. You can configure the maximum number of documents or set a fixed number of documents in the Default Value field. If you set the Default Value to null, there is no limit to the number of documents you can allow users to add to a permit application. To set a maximum number of documents, enter “<=#” in the Default Value field. For example, if you want to set the maximum number of documents at 10, enter <=10. You can also set a maximum number of documents by entering <# For example, if you want to set the maximum number of documents at 10 or fewer, enter <11. To set a fixed number of documents, enter “=#” in the Default Value field. For example, if the fixed number of documents is 5, enter =5. If you set the Display and Required parameters in this section to Yes, Civic Platform validates whether a user adds a document to the Attachments tab upon the submittal of a new record.
Education	This section lets users enter the Education credentials of a licensed professional.
Continuing education	This section lets users enter the Continuing Education credentials for a licensed professional.
Examination	This section lets users enter the Examination details of a licensed professional.
Comments	This section lets users enter any additional description or details about the application.

Select Save.