Setting Up Contractor License Options
Contractor license options are system-wide settings that control contractor license processing and data. You can maintain multiple sets of options, each with its own identifying code. But only one code at a time can be active.
Use contractor options to control:
Whether you integrate with an external licensing body to validate license information during application intake.
Whether to allow users to manually choose classifications for licenses.
Whether to decline an application based on the status of the license.
Which sections for supplemental license information are visible to users.
Which ownership and insurance types the applicant can select in the intake form.
You can also establish an integration with an external licensing body to load license information into your contract records.
Configuring Contractor License Options
To set up contractor options:
Select
Click Add to create a new set of options, or click an existing row to modify it.
If you’re creating a new set of options, enter a unique Code as an identifier.
Enter a Description for this set of configuration options.
The description should be suitable for end-users because both public users and agency staff see the description when entering contractor information.
Use the Active switch to indicate whether this is your active contractor configuration.
Only one set of configuration options can be active. If another configuration is already active, then an error message explains that you must turn off this switch for the active configuration first.
Use these switches to enable additional configuration options:
Configuration option switches for contractor licenses
Page Element
Description
Integrated with External Source
When this option is enabled, users can retrieve license information from an external licensing body in the intake form. Click the Integrations link to identify the Oracle Integration Cloud (OIC) integration that retrieves the information.
When integration is inactive, the Limit to Contractor List option is automatically enabled and the License Types link appears.
Whether the Integrated with External Source switch is on or off, you can set up an integration to load license data using batch processing in the Integrations section.
Limit to Contractor List
When this option is enabled:
Users can only select licenses from the agency’s contractor records in the intake form, whether or not there’s an active integration.
The agency can still add licenses to the contractor records from an external source using an integration.
When this option is off, licenses entered in the intake form are retrieved first from the contractor records if they exist there, then from the external licensing body.
Document Group
Select a document group.
When you specify a document group, document attachments can be classified into categories and subcategories when you upload files. Then you can see the category for a document on the Attachments page in the contractor license details.
For more information, see Setting Up Document Groups.
Working with Integrations
To enable integration with an external contractor license source:
Click the Integrations link to configure integration settings in the Integrations grid.
Click the Add action to add an integration. You can only add one of each type of integration.
Enter the following for each integration:
Integration-related page elements
Page Element
Description
Type
Identifies the process that uses integration:
Verify license online retrieves information for a specific license that a user enters in the main contractor page or in the intake form for a permit or planning application. These pages have a button that the user clicks to initiate information retrieval.
Batch load license data establishes the integration used to load information for multiple licenses into your contractor records when batch processing runs.
You can create only one row for each integration type.
Integration Name
Enter the name of the OIC integration that retrieves contractor license information.
Integration Parameter
Enter the query parameters for the OIC integration end point.
Integration Version
Enter the version number of the OIC integration.
Key
Leave this field blank. The source key is maintained in the OIC integration definition.
Integration Enabled
Indicate whether the integration type is enabled.
Selecting License Types
You must set up license types when the system isn't integrated with an external source. Applicants select a contractor license type when entering contractor information in the intake form.
If the Integrated with External Source switch is turned off, the License Types link becomes visible.
To select license types for this set of license options:
Click the License Types link to maintain license types.
Click the Add action to add a license type.
Enter the following information for each license type:
License type page elements
Page Element
Description
License Type
Enter the unique identifier for the license type.
Description
Enter the descriptive name of the license type.
Enabled
Indicate whether the license type is enabled.
Working with License Classifications
To set up license classifications for this set of license options:
Click the Classifications link to maintain the license classifications in the Classifications grid.
Click the Add action to add a classification.
Enter the following information for each license classification:
License classification page elements
Page Element
Description
Code
Enter the unique identifier for the license classification. The contractor licensing body sets these codes.
Description
Enter the descriptive name of the license classification.
Enabled
Indicate whether the license classification is enabled.
Working with License Statuses
The statuses that the licensing body assigns are called source statuses. When integration is turned on, you map a source status to an agency’s internal status.
To set up license status mapping rules:
Click the Status Rules link to maintain a mapping in the Status Rules grid.
Click the Add action to add a mapping.
Enter the following information for each status rule:
Status rule elements
Page Element
Description
Status
Select the agency status for this rule. When a license has this status in the contractor records, and the Decline Application switch is on, the application can’t be submitted.
If using an integration, select the agency status to assign to licenses that have the specified source status. If multiple source statuses map to a single agency status, there will be multiple rows for the agency status.
Source Status
Enter a license status that’s assigned by the licensing body. This field is only available when you’re integrating with a licensing body. When integration is turned on, you map a source status to an agency’s internal status.
Decline Application
Enable this switch to prevent applications from being submitted when a contractor license has this agency status, or this source-to-agency status mapping when integrated with an external licensing body. This option also prevents you from adding contractor licenses with the source status to the permit details.
Enabled
Indicate whether the status rule is enabled.
Displaying Category Sections
Sections are specific categories of supplemental information about licenses. License classifications appear in a section on the intake form and contractor record. Other sections include information about bonds and insurance such as Workers' Compensation. You can change section titles that appear on the intake form and contractor record by updating the section description on Contractor License Sections setup page.
To select the sections you want to display:
Click the Sections link to maintain sections in the Sections grid.
Click the Add action to add a section.
In the list of available sections, use the Enabled switch to control section visibility. Turning off the switch hides the section on the intake form and contractor record from both agency staff and public users.
Selecting Ownership Types
Applicants select an ownership type from the list when providing license information on the intake form. You define which ownership types are available to choose from.
To select the ownership types you want to display:
Click the Ownership Types link to maintain the types of business ownership that can be associated with the contractor’s license in the application.
Click the Add action in the Ownership Types grid.
Using the lookup prompt, you can select from the ownership types that you set up on the Ownership Types page, for example, Corporation, Partnership, or Sole Proprietorship. For information about setting up ownership types, see Setting Up Ownership Types. If an ownership type is retrieved from an integration but isn’t in the contractor license options, the ownership type is added to the contractor license option details.
Turn on the Enabled switch to indicate the ownership type is active.
Setting Up Insurance Types
To set up the insurance types you want to display:
Click the Insurance Types link to display the Insurance Types grid.
Click the Add action to add the types of insurance information that can be associated with a license.
Enter values in the Insurance Type and Description fields.
Turn on the Enabled switch to indicate the insurance type is active.