2Managing Permits

Using the Agency Springboard

The Agency Springboard provides a landing page for agency staff to manage their work.

The Agency Springboard offers access to task lists and specific pages based on the staff role in the agency, from supervisors and accounting staff to permit technicians and inspectors.

You use these elements on the Agency Springboard to perform daily tasks:

  • Global Banner

  • Alerts

  • Quick Actions (I Want To)

  • Task Lists

  • Tiles

Depending on your setup, the Agency Springboard might looks like the following example. This example is configured to show the quick actions section, the task list element, and a selection of springboard tiles. Similar elements may appear on the landing pages for public users.

This example illustrates the Agency Springboard. The alerts banner is not shown in the example.

Example of an Agency Springboard

Page Element

Description

Global Banner

The global banner appears as the page header with functionality that might include some or all of these elements:

  • Navigator: Access pages using a tree menu navigation.

  • Global search: Search for applications (in process or completed), inspections (scheduled and completed), and projects (active only). Searching opens the search results page, which has three results lists, one for each type of object. The header for the list of projects is hidden if your agency does not use project functionality.

  • Page finder: If configured by your agency, you can navigate to pages by searching for the page in the page finder.

  • Notifications: Review notifications sent based on communication events based on the status of tasks. For example, as a plan coordinator, you and the applicant receive a notification when a plan review is closed or canceled.

  • Main map: Search applications by address, street, application ID, or parcel on an interactive map.

  • Profile: Select your preferences, reset your password, or sign out.

Alerts

Alerts are displayed as a banner that broadcasts messages with important information. These alerts are configured by the agency administrators.

Quick Actions (I Want To)

The quick actions section contains a drop-down list from which you choose an action, such as starting an application or scheduling an inspection. The actions in the list and on the tiles can provide access to the same pages.

Task Lists

The task list section provides links to the Task Management page with predefined filters you access to manage tasks. The counts for each type of task help you monitor workload:

  • My Tasks

  • Group Tasks

  • My Workflow Tasks

  • My Inspections

  • My Plan Reviews

Note: The items that appear on the Agency Springboard are determined by the security roles assigned. For example, agency roles specific to the permits service display all of the items above, whereas, roles specific to the planning and zoning service display My Tasks, Group Tasks, and My Workflow Tasks, but do not display My Inspections or My Plan Reviews.

For more information about tasks, see Managing Tasks.

Tiles

Tiles appear in the springboard section as icons with links to the pages you use to administer specific types of transactions. For example, you can access pages for accounting, customer payments, plan reviews, inspections, conditions, and so forth.

For example, click the Permits tile to open a list of permit applications. For more information, see Overview of Public Landing Page Tiles.

For information about setting up these elements on the Agency Springboard, see Setting Up the Agency Springboard.

Starting an Application

Before starting an application, users must determine the appropriate type of application. Application types, including types of permit applications and types of planning applications, are configured by the agency during implementation. The Apply page provides multiple tools to help users choose the appropriate application type.

Working With the Apply Page

The Apply page offers these options for finding application types:

Option

Description

Available to Which Users

Search

Search for an application type by name.

All

Recent application types

View the five application types for the applications that you most recently submitted.

Registered public users, agency staff

Popular application types

View the five application types that have been used most frequently in the last 30 days

All

Browse application types

Browse categorized groups of permit application types or planning application types.

All

Guided questionnaire (includes saving and retrieving recommendations)

Answer questions about a project, and the guide provides recommendations regarding the necessary application types.

Registered and anonymous public users

This example illustrates the Apply page for registered public users. The left side of the page has multiple options for finding application types. In this example, the user has not started looking for an application type, so the right side of the page does not have any information.

Apply page for a registered user

In this example, the user has started browsing for application types. As the user works with the tools on the left side of the Apply page, the related information appears on an overlay on the right side of the page. In this illustration, the user is browsing for planning application types, so the overlay shows expandable categories of planning application types.

Apply page with the Planning Applications overlay
Note: The agency sets up the overlays to show the application offering on the left and the expandable application categories containing application types on the right side. For more information about setting up landing pages with overlays as illustrated in these examples, see Setting Up Permit Display Groups or Setting Up Planning Application Display Groups.

Accessing the Apply Page

Users can directly access the Apply page from the landing pages:

  • The Apply tile, which appears on the anonymous user landing page and the registered user landing page.

  • The Start an Application quick action in the I Want To field, which appears on the registered user landing page and the Agency Springboard.

Registered users and agency staff have additional options for accessing the Apply page:

  • Click the Apply button on the Applications page (registered users) or the Transactions page (agency staff).

  • Click the Apply button after selecting a parcel on the Explore Your City map (registered users) or the Main Map (agency staff).

Searching for Application Types By Name

To search for an application type by name:

  1. Click in the search field.

    A drop-down list shows any matches.

  2. If you don’t see the desired application type in the initial drop-down list, begin typing the name of the application type.

    As you type, the drop-down list changes to show only application types that match your search criteria.

  3. To start an application, click the desired application type in the drop-down list.

Searching for Popular and Recent Application Types

To search for popular and recent application types:

  1. Click in the search field.

  2. Review these lists of popular and recently used application types that appears in the overlay on the right panel of the Apply page.

    List

    Description

    Recent

    Lists the application types (up to five) for the applications that the current user most recently submitted. These can be permit application types or planning application types.

    Note: Anonymous public users do not see a list of recent application types.

    Popular

    List the application types (up to five) that have been used most often in the last 30 days.

  3. To start an application, click Select for the desired application type.

Browsing for Application Types

To browse for application types:

  1. Click either the Planning Applications button or the Permit Applications button on the Apply page.

    The overlay on the right side of the page lists categories of application types for the specified transaction type.

  2. Expand categories to browse the application types.

  3. To start an application, click Select for the desired application type.

Using a Guided Questionnaire to get Application Type Recommendations

If your agency sets up a questionnaire using Oracle Policy Automation, the questionnaire can guide users and make application type recommendations. The guide users the OPA policy model that you specify for the Permits offering, if one exists. If there's no offering-level policy, the questionnaire comes from the agency-level OPA policy model. For more information on identifying the OPA policy model to use, see Setting Up Agencies.

To find application types using a guided questionnaire:

  1. Click the Guide button to open the guided questionnaire.

    This button appears only if the agency has configured an OPA policy for recommending application types.

  2. Step through the questionnaire.

    At the end of the questionnaire, the guide will recommend application types and provide an option to save the recommendations.

  3. Optionally save the recommendations.

    A registered user follows these steps to save the recommendations:

    1. Enter a nickname for the recommendations in the Nickname field.

    2. Click Save.

      The recommendations are associated with the user account and can be retrieved from the Apply page.

    An anonymous user follows these steps to save the recommendations:

    1. Enter an email address in the Email ID field.

    2. Enter a nickname for the recommendations in the Nickname field.

    3. Click Save.

      The system sends the user an email with an acknowledgement number that can be used to retrieve the recommendations from the Apply page.

Viewing Saved Recommendations

Public users can view guided questionnaire recommendations that they save.

To view the recommendation that are already associated with a registered public user's account, the user follows these steps:

  1. Sign in.

  2. Click the Apply button on the registered public user landing page.

  3. Click View Recommendations.

    The recommendations appear in the right panel overlay under the heading Recommended Permits.

Both registered and anonymous public users can retrieve recommendations that were saved during an anonymous session. To retrieve these recommendations, the user follows these steps:

  1. Access the Apply page.

  2. Locate the Search Saved Recommendations link:

    • Anonymous users can find this link in the right frame of the Apply page.

    • Registered users who are signed in must click the View Recommendations link in the left panel. The resulting overlay on the right panel includes the Search Saved Recommendations link.

  3. Click Search Saved Recommendations to open a new window.

  4. Enter the Acknowledgement Number that was emailed to the user when the recommendations were saved.

  5. Enter the Emailthat the user provided when saving the recommendations.

  6. Click Search.

Completing an Application

Note: An anonymous public user who starts an application must sign in before the application pages appear. Users who have not previously registered must register first.

Agencies configure the specific sections and fields for each type of application. Regardless of these specifics, the general interface for completing an application is consistent.

This example illustrates an application.

Example of an application

These are some elements of the standard interface for completing an application:

  • The application begins with data entry steps that the agency configures.

    There can be one or many data entry steps.

  • Agencies configure the sections and fields for each data entry step, but all applications include an Applicant section to identify the applicant.

    When a registered public user starts an application, the Applicant section is prepopulated, and certain identifying fields are read-only. Agency staff must manually enter applicant information.

  • A Review step appears after the last data entry step for an application.

    The page for the Review step shows all of the data entry sections on a single long read-only page.

  • If applicable, the Fee Summary step is the last step in the application.

  • A drop-down field at the top of the application page lists the steps, including data entry pages, the Review page, and the Fee Summary page. Selecting a step takes the user directly to that step.

  • The final item on the step list is an option to toggle between the Single-Page View and Multi-Page View.

    In single-page view, all of the data entry steps are combined into a single step labeled Step 1: Single-Page View. The Review and Fee Schedule steps remain separate.

  • Previous and Next buttons enables users to move through the steps.

  • On the final step, a Submit button replaces the Next button.

    Submitting an application initiates the workflow for the application. Registered public users can’t make changes to an application after it is submitted.

  • The Save button enables users to save their progress without submitting the application.

    If an application is saved without being submitted, the user can continue working on the application later.

  • The Close Application button closes the application and discards unsaved changes.

    A warning message gives users the chance to return to the application instead of closing it.

Managing Transactions

View application data and statuses for permits and planning applications using the Transactions page. You can also perform actions, such as paying fees and accessing detailed application information from this page.

Tip: As agency staff, you can access this page on a phone as well as on a laptop or desktop computer. The layout changes based on the device you are using.

As agency staff, such as a permit technician or planning and zoning administrator, you can use the Transactions page to view a complete list of applications submitted to your agency. Go to the list of transactions to perform these tasks:

  • Manage application activity.

  • Create or resubmit permit and planning applications on behalf of applicants.

  • Cancel pending and payment pending applications on behalf of applicants.

  • Manually enter fee payments on behalf of applicants.

  • Access details about permit and planning application activity.

Note: The Transactions page provides a summary of permits and planning applications to agency staff only. Registered users who have applied for a permit or submitted a planning application for themselves or as a representative for someone else, see only the applications that they are associated with on the Applications page. The Applications page contains basic application information for the logged in user. The user profile controls which application data appear on the Transactions and Applications pages for agency staff and applicants, respectively.

Registered users can access the list by selecting Go to Applications from the quick actions drop-down list or by clicking the Applications tile on the landing page for registered users.

Agency staff can access the Transactions page by clicking the Permits or Planning Applications tile on the Agency Springboard.

This example illustrates the Transactions page showing permit applications, as viewed by agency staff and containing the page elements described in the following tables. The list under the Permits tab shows only active applications.

Transactions - Permits page

This example illustrates the Transactions page showing planning applications, as viewed by agency staff and containing the page elements described in the following tables. The list under the Planning Applications tab shows only active applications.

Transactions - Planning Applications page

Using the Transactions Page

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, select one of the following tabs:

    • Permits: View a list showing active permit applications only.

    • Planning Applications: View a list showing active planning applications only.

    • All: View a list showing all permits and planning applications, including inactive, canceled, and withdrawn applications.

  3. You can perform these actions to display permits or planning applications that meet specific criteria:

    Page Element

    Description

    Download

    Click the download button to export the list to a .csv file.

    Search

    Search by alphanumeric characters on the fields for permits or planning applications in the list. The permits or planning applications that meet the search criteria are displayed on the page.

    When you search on dates, use this format: MM/DD/YYYY.

    Search results display only the primary address for the permit or planning application. You can confirm the correct transaction by clicking the row for the permit or planning application and reviewing all of the associated addresses in the application details.

    Filter By

    Apply filters to display permits or planning applications that contain the selected parameter values in the list. Click the filter button to open the filter options, where you can define, modify, and save your own filters.

    As a planner, you can also find the planning applications assigned to you or unassigned applications by selecting predefined filters, My Assigned Applications or Unassigned Applications, respectively.

    Sort By

    Select an option to sort the applications in the list by these fields:

    • Application

    • Type

    • Status

    • Creation Date

    • Created By

    • Applicant

    • Total Fees

    • Total Due

    List View

    Grid View

    Map View

    View the inventory of permits or planning applications in a list, on a grid, or on an interactive map. See Using Maps.

Managing Application Activity

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, select one of the following tabs:

    • Permits: View a list showing active permit applications only.

    • Planning Applications: View a list showing active planning applications only.

    • All: View a list showing all permits and planning applications, including inactive applications that are completed, voided, canceled, or withdrawn.

  3. Use the information on the Transactions page to manage applications created by public users.

    You can locate the application and basic information about the application using the following information:

    Page Element

    Description

    Application

    View the application ID, application type, and status.

    Review the application status, for example, Payment Pending, Submitted, Pending, Permit Issued, and so on.

    Property

    View parcel information.

    Review the parcel information, including the street address, if available.

    The transaction list displays only the primary address. You can review all of the addresses associated with the application in the details, which you access by clicking the application row.

    Description

    View the description of the application entered on the application form or on the Overview page in the permit or planning application details.

    Submission Information

    Review the user name of the person who filled out the application and the date the application was created. For example, the application was Created by John Doe on 12/20/2018.

    Review the permit or planning applicant’s name. This may not be the same as the person who created the request. For example, Applicant: Rita Johnson.

    Planner

    View the planner assigned to a planning application. This field appears only on the Planning Applications list.

    Fees

    Review the total fees that may be applicable to the permit or planning application and a fee balance if the total has not been paid.

    Pay button

    Select the Pay button to submit a payment on behalf of the applicant.

    Resubmit button

    Select the Resubmit button to resubmit an application.

    The application status is Pending Submit because there may be a problem initiating workflow. Click the Resubmit button to retry initiating workflow.

    Resubmitting the application does not affect the fee calculations.

    Actions button

    Select the Actions button to access the option for canceling an application. The button appears only when the application has a pending status.

    Click Cancel Application to cancel an application with a pending or payment pending status.

Identifying Transactions Page Icons

The icons on the Transactions page help you identify application activity as described in the following table:

Icon

Description

Pending Submittal icon

Indicates that there was an error during the submittal process and the application status is pending submittal. There may be a problem initiating workflow. Click the Resubmit button to retry initiating workflow.

Projects icon

Indicates that the permit or planning application is part of one or more projects. For more information, see Viewing Project Summaries.

Pre-Application icon

Indicates the planning application is classified as a pre-application.

Condition - Hold icon (Hold)

Condition - Lock icon (Lock)

Condition - Notice icon (Notice)

Indicates that a condition has been placed on the application. Conditions are set up by the agency and include these:

  • Hold

  • Lock

  • Notice

For more information about conditions, see Applying Conditions to Applications.

Starting or Updating an Application

As agency staff, you can start new applications or update existing applications. Only agency staff can update applications that have already been submitted.

If an application has a pending status, the applicant can make updates to the application. When the applicant selects a pending permit or planning application on their Applications list page, the service directs them back to the application form.
  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. To create a new application, click the Apply button to access the questionnaire and submit the application.

  3. To update an existing application, click the row for the selected application to open the pages comprising the details.

  4. Go to the page for the information of the existing application that you would like to update, using the links in the left navigation panel. The actions vary by your role and the specific page.

For more information, see Starting an Application.

Canceling a Pending Application

Agency staff and registered public users can cancel an application with a Pending or Payment Pending status on the Transactions page using the Cancel Application action button.

For more information about canceling a pending application, see Canceling an Application.

Entering Application Fee Payments

Applicants typically pay their fees online using the payment cart, but if needed, you can initiate a payment on behalf of the applicant using the Pay button on the Transactions page.

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. Click the Pay button for the selected application with an outstanding fee balance.

  3. When using the Pay button, you bypass the payment cart and go directly to the Checkout page in payment services.

For paying fees from the Fees and Payments page in the application details, see Working with Fees and Payments.

Accessing Application Details

You can access application details from the Transactions page.

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. Click the row for the selected application on the Transactions page.

    The Overview page for the application appears in the content pane of the details page.

For more information about the overview of permit details, see Viewing the Permit Summary.

For more information about the overview of planning application details, see Viewing the Planning Application Detail Overview.

Canceling an Application

Agency staff and applicants can cancel applications in a pending or payment pending status that have not yet been submitted.

Caution: When you cancel a pending application, the action is permanent. There isn’t any way to restore a canceled application.

The system status for the application changes from Pending or Payment pending to Voided.

For information about withdrawing an application that was submitted and is already in progress, see Withdrawing an Application.

This example illustrates the Transactions page, where agency staff can delete an application. The steps are described in the following text. The Cancel Application link is called out with a red box.

Example of Transactions page showing the Cancel Application action

Canceling Pending Applications

The agency or applicants can cancel or void a pending or payment pending permit on the Transactions page for agencies or on the Applications page for registered public users. Registered public users can only cancel one of their own applications, Agency staff must have the correct access to cancel applications.

To cancel an application:

  1. Select Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, find the permit or planning application with a pending or payment pending status that you want to cancel.

  3. Click the Actions icon in the row of the application you want to cancel.

  4. Click Cancel Application.

  5. On the Cancel Application page, enter your reason for permanently canceling the application.

  6. Click OK.

Note: When you cancel an application, the system also cancels any plan reviews that are associated with the application.

Working with Permit Details

You find permit detail pages in a collection that consolidates all aspects of a permit application, including contacts, communication, parcel information, fees and payments, plan reviews, inspections, and workflow.

The permit detail pages include the functionality you need to manage a permit throughout its lifecycle.

To access the permit detail pages:

  1. Select the Permits tile on the Agency Springboard.

  2. On the Transactions page, click the row for a permit.

  3. Navigate to permit information using the links in the left panel.

The information for a permit comprises these pages:

Page Name

Description

Overview

View the core information regarding the selected permit with links to more detail.

See Viewing the Permit Summary.

Property Information

View parcel data from the permit application and a map of the parcel location.

See Working with Property Information.

Workflow

View the workflow status of each task as defined by the agency using Oracle Autonomous Integration Cloud (OIC).

See Using Workflow.

Permit Details

Review information captured during the application intake that is specific to the permit type. For example, for a solar permit, the applicant enters the number of solar panels to be installed.

See Viewing Permit Application Details.

Plan Reviews

Perform administrative tasks for review cycles as a plan coordinator and perform reviews of building plan documents prior to permit issuance as a plan reviewer on the Plan Review page.

See Managing Manual Plan Review Cycles and Managing Electronic Plan Review Cycles.

Contacts

Review and add contacts for the permit.

See Adding Contacts to Applications.

Conditions

Review conditions placed on the permit or person that must be resolved to complete the permit process.

See Applying Conditions to Applications.

Attachments

View a list of files and upload or download documents on this page.

See Working with Application Attachments.

Comments

Review or add comments pertaining to this permit.

See Working with Application Comments.

Inspections

Review a consolidated list of inspections related to a permit. As a permit coordinator, you manage inspection activity for the permit on this page.

See Managing Inspections for a Permit.

Fees and Payments

Review fees assessed and payments due. You can also add additional fee items and pay fee items from this page.

See Working with Fees and Payments.

Projects

View the summary of projects associated with a permit in the permit details. The permit can be assigned to multiple projects.

See Viewing Project Summaries.

Communications

Send ad hoc email messages and notifications associated with this permit.

See Working with Application Communications and Working with Ad Hoc Communications.

Viewing the Permit Summary

You view a permit summary on the Overview page, where you get a snapshot of information regarding a permit with links to more detail.

When you access the details for a permit, you see a summary of the permit activity. This information is updated to show the latest activity.

As agency staff, you can also withdraw an in-progress application on the Overview page. Both agency staff and the applicant can add a description of the application.

Tip: As agency staff, you can access this page on a phone as well as on a laptop or desktop computer. The layout and some functionality change based on the device you are using. For more information about using the Overview page on a phone in the Oracle Inspector mobile application, see the Oracle Inspector Overview.

This example illustrates the Permit Detail Overview page, which is described in the following text.

Permit Details - Overview page

Using the Overview Page

  1. Navigate to Permits > Permits or click the Permits tile on the Agency Springboard.

  2. On the Transactions page, click the row for a selected permit to open the Overview page.

  3. On the Overview page, review details or enter information in the Overview section:

    Page Element

    Description

    Status

    Review the application status.

    Completed Date

    Review the date the application was completed.

    Description

    Enter a description of the application by clicking the Add link in the Description field. The agency staff or applicant can add a description.

    Submitted By

    Review the name of the person who submitted the application.

    Submission Date

    Review the date the application was submitted for processing.

    Expiration Date

    Review the expiration date of the application.

    Only agency staff can click the Update link next to the Expiration Date field to manually enter an expiration date for the application.

    Withdraw Application

    Click the Withdraw Application button to change the application to a withdrawn status. When you withdraw an application, any scheduled inspections or plan reviews are canceled.

    For more information about withdrawing an application, see Withdrawing an Application.

    Print Permit

    Click to view the permit in PDF format in a separate browser tab.

    Note: This button appears only for permits with the Inspection status. Additionally, your browser’s pop-up blocker must allow pop-up windows from the environment domain to generate the PDF of the permit.
  4. Review information about the selected permit in the sections and navigate to more details:

    Page Element

    Description

    Applicant

    View the applicant’s name and contact information.

    Click the View Details link to open the Contacts page, where you can add additional contacts.

    Workflow

    View a list of active and recently completed tasks, including the task status, assignment, last updated date, and number of days in the current status.

    Click the View Details link to open the Workflow page.

    Inspections

    View the number of scheduled, upcoming, and completed inspections, as well as the number of inspections that have passed and failed.

    Click the View Details link to open the Inspection List page.

    Fees and Payments

    View the total fees paid, amount due, and the date and amount of the last payment.

    Click the View Details link to open the Fees and Payments page.

    Projects

    View the projects to which this permit belongs.

    Click the View Details link to open the Projects page, where you can see the list of projects in more detail. Click the Project ID link to find out more about the project, which may contain other permits.
    Note: If you’re using a phone, you can review a summary and access details for fees and payments, and projects, from the Overview page. For complete details, access permit applications using a laptop or desktop computer.

Withdrawing an Application

Only agency staff can withdraw applications that have been submitted for processing and are in progress.

Agency staff can withdraw applications with a system status of Submitted or in-progress statuses on behalf of an applicant. An applicant can’t initiate an application withdrawal in the system.

You can withdraw permit applications with one of these statuses:
  • Submitted

  • In Progress

  • Plan Review

  • Permit Issued

  • Inspection

And you can withdraw planning applications with one of these statuses:
  • Submitted

  • In Progress

  • Hearing

When you withdraw an application that is in progress, the system also cancels or withdraws any of the following that are associated with the application:

  • Open permit inspections

  • Open plan review cycles and reviewers

  • Scheduled pre-application meetings

  • Scheduled public hearings

The system status of the application changes to Withdrawn.

For information about canceling an application that hasn’t been submitted yet and is still in a pending status, see Canceling an Application.

Withdrawing In-Progress Applications

You withdraw an application on the Overview page in the application details. Agency staff must have the correct permissions to withdraw an application.

To withdraw an application:

  1. Select Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, click the row for the permit or planning application that you want to withdraw.

  3. On the Overview page, click the Withdraw Application button.

  4. On the Withdraw Application page, enter the reason for withdrawing the application.

  5. Click OK.

Working with Property Information

Property information shows parcel data from the permit or planning application and a map of the parcel location. You can add parcels, and modify or delete the parcel, owner, and address information.

Property information is configured on the application forms by the agency during the design process. When filling out an application, the public user enters information, which is then displayed in the detail pages of the permit or planning application. Only agency staff can update information on the Property Information page after an application has been submitted.

Viewing Parcel Information

You view a list of parcels associated with this permit or planning application in the Parcel List section. The list view displays parcel details. You can also view the location of the parcels on a map.

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, click the row for the permit or planning application you are working with.

  3. On the Property Information page, view the list of parcels in the Parcel List section.

  4. Click the parcel number button in the list to view the parcel details, owner, and address in the right pane.

  5. Click the map icon to find the parcels in the list on a map.

Adding Parcels

The system automatically makes the first parcel added to the permit the primary parcel.

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, click the row for the permit or planning application you are working with.

  3. On the Property Information page, click the Search icon in the Parcel List section.

  4. Use the search field on the Search Property page to find parcels by parcel number, address, or owner. Only parcels enabled by the agency are available as lookup values.

  5. Click the check boxes for one or more parcels.

  6. Click the Add Selected button.

Updating Parcel Details

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, click the row for the permit or planning application you are working with.

  3. On the Property Information page, click the Edit button in the Parcel Number section.

  4. On the Parcel Detail page, you can turn on the Primary switch to make this the primary parcel for the permit.

  5. Update parcel data such as the property description, jurisdiction, subdivision, primary zone, zone description, land use, parent parcel, parcel type, book, section, page, map book page, map name, boundary description, and so on.

  6. Click Save.

Updating Parcel Owner Details

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, click the row for the permit or planning application you are working with.

  3. On the Property Information page, click the owner row in the Owner section.

  4. On the Parcel Owner Detail page, you can turn on the Primary switch to make this the primary parcel owner.

  5. Enter a value in the Zip Code field to add address information.

  6. You can also update the owner name, secondary owner name, ownership type, home phone, and email address.

Adding Parcel Addresses

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, click the row for the permit or planning application you are working with.

  3. On the Property Information page, click the Search icon in the Address section.

  4. Use the search field on the Search Property page to find parcels by parcel number, address, or owner.

    Only parcels associated with this permit are available as lookup values.

  5. Click the check boxes for one or more parcels.

  6. Click the Add Selected button.

Updating Parcel Addresses

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. On the Transactions page, click the row for the permit or planning application you are working with.

  3. On the Property Information page, click the address row in the Address section.

  4. On the Parcel Address Detail page, you can turn on the Primary switch to make this the primary parcel address.

  5. Update parcel address data such as address type, address line 1, address line 2, street number, street, street type, unit, floor, direction, building, municipality, and longitude and latitude.

  6. Click Save.

Viewing Permit Application Details

You review information captured during the application intake that is specific to the permit type in the application details. Some agency staff can update the permit details captured from the application.

When an agency designs the application form for a specific type of permit, they use elements that capture the information necessary for evaluating adherence to permit requirements. For example, for a solar permit, an applicant would enter data about the job (type of work, job cost, and so on) and solar details (type of roof, roof area, number of solar panels, and so on). These application details are reflected on the application details page for the permit.

Permit Application Details

Description

Construction Information

Captures Information regarding the current construction site and the proposed construction project.

Demolition

Captures information related to the scope of the demolition and if hazardous materials or utilities need to be considered—such as electricity, gas, water, and so on—when demolition is required as part of the job.

Electrical Equipment

Describes electrical features, such as outlet types, amps, voltage, and electric appliances.

Fence Information

Describes the proposed fence attributes, such as type, material, dimensions, location, and so on.

Grading Information

Describes the scope of grading work, such as the acreage affected, materials to be used and the amount of material.

Insurance

Provides a contractor’s insurance type and policy information.

License Qualification

Enables a contractor to add any state licences they have.

Mechanical Equipment

Describes features of the job site related to ventilation, heating, cooling, fire safety, and so on.

Photovoltaic Information

Describes attributes of a site’s solar energy configuration, such as roof area, coverage area, inverter information, and so on.

Plumbing Equipment

Describes attributes of a site’s plumbing configuration.

Pool Information

Describes attributes of a pool, such as type, depth, location, surrounding fencing, and so on.

Property Information

Describes the parcel as it is registered with the municipality, such as the parcel ID, parcel type, and so on.

Regulated Business Activity

Enables you to specify any regulated activity or controlled substances allowed on the premises, such as alcohol, carnival rides, casino games, and so on.

Right of Way Use

Enables you to provide any details related to the use of a right-of-way on the property or to gain access to the property, such as traffic, parking, or pedestrian impact.

Roof Information

Describes features of a structure’s roof, such as existing roof type, proposed roof type, number of layers, and so on.

Site and Zoning

Describes features of the property related to acreage, flood preparedness, as well as zoning and land usage information.

Special Event

Enables applicants to specify information about an event, including the safety plan, concessions, facilities, potential impacts, and traffic plans.

Yard Sale

Enables applicants to specify yard sale information, such as the start time, end time, and the number of days.

Updating Permit Application Details

The fields available to update depend on the permit details on the application form.

  1. Select the Permits tile on the Agency Springboard.

  2. On the Transactions page, click the row for the permit.

  3. Click Permit Information to expand the section in the left navigation panel.

  4. Click Application Details.

  5. On the Application Details page, click the Edit button.

  6. Update available fields on the page.

  7. Click the Done button to save.

Using Workflow

Workflow provides a defined structure for the permit and planning application lifecycles. For example, humans perform manual steps such as approving a permit application, while the workflow engine performs automated steps such as updating permit and inspection statuses.

Managing workflow tasks consists of updating the assignment, status, and priority for a task that a human performs. You can also add comments to a task and edit workflow comments.

You do not, however, use workflow functionality to perform the actual task. If workflow includes a task to review plans, you need to review the plans manually and record your plan review decision in the plan review pages. Once the plan review cycle is complete and all decisions are approved or not required, the workflow engine automatically moves the workflow to the next step. As an inspector, when you approve the final inspection, the workflow engine automatically changes the inspection task in the workflow to complete.

Workflow and Non-Workflow Tasks

This topic discusses workflow tasks. These are tasks that are defined in workflow process definitions within Oracle Autonomous Integration Cloud (OIC). Agency staff manages these tasks using the Workflow page in the details of a permit or planning application.

Oracle provides an additional page that agency staff can use to review both workflow and non-workflow tasks. For information about this functionality, see Managing Tasks.

Managing Workflow Tasks

Use the two-panel view on the Workflow page to see past and current workflow tasks and to manage task assignments, status, priority, and comments.

This example illustrates the two-panel view of the Workflow page, which is described in the following text.

Two-panel view of the permit details Workflow page
Note: You can update or assign a task only if it is in progress. You can add comments to tasks that are complete, but you cannot make other changes. You cannot make any changes to a task that is not started.

To manage a workflow task:

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. Click the row for the permit or planning application you want to view.

  3. Use the navigation links on the left side of the screen to select Workflow.

    The Workflow page appears on the right side of the page. This page can be toggled between a two–panel view and a list view. The list view is display-only and visible to both agency staff and registered public users; the two–panel view is for agency staff only. The default two-panel view includes the following:

    Panel

    Description

    Task summary cards on the left.

    The left panel lists completed and in progress tasks. Each task appears on a card that lists the following information:

    • Task name

    • Task status

      Although completed tasks can have a variety of statuses based on the outcome of the task, the status of an in progress task is always In Progress. If the workflow process definition uses parallel gateways, you might see multiple in-progress tasks.

    • Assignee

      Tasks can be assigned to an individual, or they can be assigned to a group whose members can claim the task.

    • Either the due date (for in progress tasks), or the last-updated date, which is the completion date for past tasks.

    Task details on the right.

    The right panel displays more details for the task that is selected in the left panel.

    If the task is in progress, use the right panel to change the task assignment, update the status and priority, or add task comments.

    Completed tasks are not updatable, but you can add comments to them.

  4. Select a workflow task from the left frame to see details in the right frame.

  5. Review read-only task information.

    These fields are not updatable regardless of the task status:

    Page Element

    Description

    Task Name

    The task name as defined in the OIC workflow engine. For example, the Application Acceptance task is for reviewing and accepting a permit or planning application that has been submitted.

    Task ID

    The identifier for this specific instance of a task. For example, multiple permits or planning applications have an Application Acceptance task, but the Task ID for accepting the application is unique for each permit or planning application.

    Assigned To

    The name of the individual who is assigned to the task, or, if the task isn’t assigned to an individual, displays the name of the group or role that is responsible for the task.

    Assigned Date

    The date that the task assignment was last updated.

    Assigned By

    The name of the person who last updated the task assignment. When an assignee claims a task, the Assigned To and Assigned By names are the same.

    Due Date

    The date by which the task must be completed. The workflow process definition in OIC sets the due date. Generally the due date is defined as a specific amount of time after the task is started.

  6. If the task is in progress, you can reassign it using these buttons:

    Page Element

    Description

    Reassign

    Click to choose an assignee for the task.

    See Managing Tasks.

    Claim

    Click to assign the task to yourself.

    This button is visible only for tasks that are assigned to a group rather than to an individual.

    Release

    Click to remove yourself as the task assignee. The task is reassigned to its default group so that group members can see and claim the task.

    This button is visible only for tasks that are assigned to you.

  7. To update the status or priority of an in progress task, use these fields:

    Page Element

    Description

    Status

    Select a status that represents the final outcome of the task.

    The task statuses depend on the workflow setup. For example, the available statuses for a task that requires a simple approval might be Approve and Reject. The workflow status of each task is defined by the agency using OIC.

    Other tasks might require different statuses. The sample workflow that Oracle provides includes these statuses for the task where you review an application: Accepted - Plan Review Not Required, Accepted - Plan Review Required, More Info Needed, and Reject.

    Note: Task statuses are not the same as application status. However, the workflow engine can update the application status based on the outcome of a task.

    Priority

    Set the priority to High, Medium, or Low. The priority is informational only.

  8. Click Update to save your changes.

    When you save your changes, the system does the following:

    • Sends an update to the workflow engine in OIC, triggering any subsequent tasks in the workflow.

      For example, in a delivered sample workflow, approving a permit application triggers an update to the permit status, which triggers an email to the applicant. The workflow then reaches a decision point that checks whether a plan review is required. The next human step in the process is either completing a plan review or, if no review is required, issuing the permit.

    • Refreshes the Workflow page, which becomes read-only if the task is complete.

    • Displays a Refresh icon on the read-only page so that you can check if any new human workflow tasks get triggered.

  9. Click Refresh to update the page and see if the completion of the task has triggered another workflow task for the application.

    Processing time can vary, so you might need to wait before refreshing the page.

Adding Comments to a Workflow Task

Comments are a useful mechanism for adding information to a workflow task. You can control whether the comment is visible to public users who view their application workflow. The default setting is for comments to be visible, so you must manually hide comments that you do not want the public user to see.

For more information about comments, see Working with Application Comments.

To add a comment to a task:

  1. Access the workflow task.

  2. Click Add Comment.

  3. To write a new comment from scratch, enter and format your comment in the rich text field on the page.

  4. To create a new comment based on one or more existing comments:

    1. Click Select Comments.

    2. On the Select Comments page, click Favorite, Standard, or Recent to see the corresponding list of comments.

      Favorite, standard, and recent comments are described in the topic Working with Application Comments.

    3. Locate and select the comments you want to copy, using the search and filter options as needed.

    4. Click Insert to copy the text of the selected comments into the field for the new comment.

    5. If necessary, modify the copied text.

  5. If you want to hide the comment from public users, click the Hide from Public icon to toggle the visibility setting.

    When the icon displays an open lock, the comment is visible to the public. This is the default setting for new comments.

    When the icon displays a closed padlock, the comment is hidden from the public.
  6. Click Save to save the comment and return to the Workflow page.

Modifying a Comment in a Workflow Task

To modify a comment:

  1. Access the workflow task.

  2. Click an existing comment to view it on the Comment page.

  3. Modify the text of the comment as needed.

    if you use the Select Comment option to add text from an exiting comment, the new text is added after any existing text.

  4. To modify the comment visibility, click the Hide From Public icon.

    Clicking the icon toggles the setting. When the icon displays an open lock, the comment is visible to the public. When the icon displays a closed padlock, the comment is hidden from the public.

  5. Click Save to save changes and return to the Workflow page.

Deleting a Comment from a Workflow Task

To delete a comment:

  1. Access the workflow task.

  2. Click an existing comment to view it on the Comment page.

  3. Click the Delete icon.

    The comment is deleted, the window closes, and you return to the Workflow page.

Managing Attachments for a Workflow Task

You can upload files to attach them to specific workflow tasks. File that you associate with a workflow task are visible only on the detail page for that task. That is, workflow attachments are not visible on the general Attachments page for an application.

To manage attachments for a workflow task:

  1. Access the workflow task.

  2. Click the Attachments link to display attachments information.

    The Attachments link and Comments link toggle the display between task comments and task attachments. In Attachments view, a grid displays the File Name, a Description, and the File Size for each attachments.

  3. To add a new attachment:

    1. Click Add.

    2. Select a file using your browser’s file selection window.

    3. On the Add Attachments page, verify the File Name and optionally enter a Description.

    4. Click Upload.

      When the upload is complete, the new attachment appears in the workflow task details.

  4. To view or modify attachment information:

    1. Click the Actions icon for the existing attachment.

    2. Select View Details.

    3. On the Attachment page, review the File Name, File Size, and the Last Updated By and Uploaded By user names.

    4. Optionally update the Description.

    5. Click Save or Cancel to return to the Attachments page.

  5. To download a file, click the Actions icon and select Download.

  6. To delete a file, click the Actions icon and select Delete.

    You are prompted to confirm the deletion.

  7. To close the Attachments window, click Cancel.

Viewing the Overall Workflow for an Application

Use the list view on the Workflow page to view all of the workflow tasks that a human must perform for a specific permit or planning application. This list does not include system tasks such as updating the application status and sending automated notifications.

The list includes completed, in progress, and not started steps. Showing all of these steps together provides a big-picture view of the process. However, some steps that are not yet started might not be applicable depending on the workflow path.

Note: Unlike the two-panel view, the list view is visible to registered public users who access information for their application. The list view is read-only, so public users are never able to update tasks.

To use the list view:

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. Click the row for the permit or planning application you want to view.

  3. Use the navigation links in the left frame to select Workflow.

  4. Click the Show List View icon.

  5. Review the task list.

    The task list displays:

    • The Task Name and Status.

    • The Last Updated Date.

    • The Days Taken, which represents the number of days elapsed while the task is in progress.

      The value is the number of days so far for an in progress task, or the total days from start to finish for a completed task. This field is blank for tasks that have not started.

    • Comments, which displays the two most recent comments.

      For each comment, this column displays the creation date and time, the creator, and the comment text. Lengthy comment text is truncated.

  6. To review task history, click a specific task to open the Task Details page.

    This page lists the dates that the task was updated along with the task status on that date, the number of days taken as of that date, and all comments that were added on that date.

  7. Close the Task Details page to return to the workflow list view.

Altering Workflow

If needed, supervisors or administrators can change the workflow for a transaction type manually. This enables you to change the workflow step in the case of system outage or user error, for example.

To alter workflow:

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. Click the row for the permit or planning application you want to view.

  3. Use the navigation links in the left frame to select Workflow.

  4. Click the Alter Workflow button.

  5. On the Alter Workflow make these changes:

    • New Workflow Activity Name: Select the desired workflow step.

    • Update Transaction Status: Select the proper status for the workflow step.

    • Comments: It is recommended to note who made the change and describe the circumstances requiring the manual intervention.

  6. Click Save.

Managing Tasks

The Task Management page enables you to review both workflow and non-workflow tasks and to reassign tasks (including claiming a task for yourself).

Application-related tasks include workflow tasks related to the overall permit lifecycle and inspections as well as non-workflow tasks related to plan reviews. They also include workflow tasks related to the planning application lifecycle.

Reviewing and Managing Tasks

  1. On the agency springboard, select the My Workflow tile.

  2. On the Task Management page, select the tab that lists the tasks that you want to review:

    Task Tab

    Description

    Available Actions

    My Workflow

    Lists tasks that are assigned to you.

    Release

    Reassign

    Group Workflow

    Lists workflow tasks that are assigned to a group to which you belong. Non-workflow tasks (plan review tasks and inspection tasks) do not appear here.

    Tasks on the Group Tasks tab are not assigned to individual group members. So this list functions as a group work queue from which individuals can claim specific workflow tasks. When a task is claimed, it is assigned to the individual and no longer appear in the list of group tasks.

    Claim

    Reassign

    All Workflow

    Lists all tasks assigned to groups to which you belong, including tasks that are assigned to you and to other group members.

    Reassign

  3. Use the search, filter, and sort options to refine the list of tasks as needed.

  4. Use these fields to review task information:

    Page Element

    Description

    Task Type

    Identifies the nature of the task to be performed. Values include:

    • Inspection

    • Plan Review

    • Workflow

      The Workflow task type represents overall permit workflow.

    Transaction

    Displays the transaction type number. For example, in the case of a permit, it displays the permit number and permit type for the associated permit.

    Tasks

    Displays a task name and identifier that depend on the task type:

    • For workflow tasks, the workflow process name and task ID appear. The task ID is for the specific instance of the task.

    • For inspection tasks, the inspection name and ID appear.

    • For plan review tasks, the plan review name and cycle count appear.

    Status

    Displays the task status. Different types of tasks can have different statuses. For example, inspection tasks can have the status Scheduled, which is not applicable to permit workflow tasks.

    Assignment

    Displays the date that the task assignment was last updated and to whom the task is assigned.

    >

    Click to access details for the permit to which the task is related. The page that appears depends on the type of task. For example, clicking the button for a permit workflow takes you to the Workflow page in the permit details.

  5. To update the task assignment, select one of these options from the task’s Actions menu:

    • Claim assigns the task to yourself. This action is available only for tasks that are currently assigned to a group. It is not relevant on the

    • Release removes the assignment without assigning a new owner. The task will now appear on the Group Task list until it is claimed or reassigned.

    • Reassign opens the Reassign Task page, where supervisors can select a new assignee.

Reassigning a Workflow Task

Claiming a workflow task is a quick shortcut for assigning a task to yourself. To assign a task to someone else, though, you must use the Reassign action.

Note: Only supervisors can reassign tasks. For example, agency staff members with the role PSC Permits Supervisor can reassign tasks, however, agency staff members with the role PSC Permits Technician cannot.

To reassign a workflow task:

  1. On the agency springboard, click the My Workflow tile.

  2. Locate the workflow task on either the My Workflow list, the Group Workflow list, or the All Workflow list.

    Use the search, filter, and sort options to help you refine the task list.

  3. Click the Actions icon, and then select Reassign.

    The Reassign Task page appears.

  4. Confirm that the Search By value is User.
  5. Enter your search criteria, then click Search.

    You can search by Keyword, First Name, Last Name, and Email.

  6. Locate the desired assignee in your search results, then click the Select button for that assignee.

    The system prompts you to confirm the assignment, then reassigns the workflow task and returns you to the task list.

Adding Contacts to Applications

This topic discusses how to add contacts to an application. Users can add contacts to a permit or planning application after submittal.

Adding Contacts to an Application

The Contacts page displays the applicant details entered at the time of creating the transaction and allows you to add additional contacts to be associated with the transaction. Additional Contacts can be:

  • Add from Registered Contacts: You just select a contact already registered in the system and include in the transaction .

  • Add Brand New Contact Manually: You create a new contact by entering all the contact details and then include in the transaction .

Note: Applicants can add additional contacts at the time of filling the transaction application.
  1. Select Permits or Planning Applications. Select Transactions and then select a Submitted transaction row.

    Select Permit Information or Planning Application Information and select Contacts. The Contacts page displays the applicant information in the top section and Additional Contacts option in the bottom section.

    You can make changes to the following fields for the applicant information and save the record:

    Salutation, Suffix, Country, Address fields, State, County, City, Zip Code, Phone, and Email.

    Note: The address fields are unavailable for entry by default. To enable these fields for entry, click the Don’t know link or enter a zip code.
  2. Click Add New Contact to open the Contact Details page and include a new contact. The Contact Details page lists all the registered contacts. The Create New Contact button below the Contacts grid allows you to create a new contact and include it in the transaction.

    • To add a registered contact, select a contact from the Registered Contact list. A modal window opens, allowing to select the Contact Type and the Primary flag.

      Page Element

      Description

      Select Contact Type

      Use the look up to view all the contact types and their description and then select the contact type for the transaction.

      Is This Primary Contact

      Turn on the switch if you want to make the selected contact person as the primary contact. If you make this contact person as the primary contact, then if there is any earlier contact assigned as Primary, it will automatically change to non primary contact.

      Click OK to save the record and return to the Contacts page, which lists your newly added registered contact.

    • To create a brand new contact, click Create New Contact and manually enter all contact details.

  3. Update the additional contacts by clicking the Details button on a contact from the Additional Contacts list.

    • For registered contacts, the following fields are not available for edit: First Name, Middle Name, Last Name, and Business.

    • For newly created contacts, all the fields are available for edit.

  4. Click Save to save the contact and return to the Contacts page, which lists your contacts.

Applying Conditions to Applications

This topic describes how your Public Sector Community Development service allows you to view, update, apply, and resolve conditions on an application such as a permit or a planning application.

Viewing and Updating Conditions

The Conditions page lists all the conditions applied to the selected transaction (such as a permit or a planning application), sorted by the applied ones at the top followed by the resolved ones. The Condition Indicator at the top displays the most severe condition having a high priority. A link – All Conditions allows you to view all the active conditions applied, their severity, applied date, and the display message.

Note: The condition indicator is available on all pages across transactions and appears if one or more active conditions are applied. A condition is active until it is changed to Resolved.
  1. Select Permits or Planning Applications and select a transaction row. On the Permit or Planning Application .page, select Conditions under Permit or Planning Application Information.

    The Conditions page lists all the conditions applied to the transaction .

    This example illustrates the Conditions page.

    Conditions page
  2. Select a condition and click the View More Detail button to open the Condition Details page and view the details of the condition. For a detailed description of all the fields, see the next section..

  3. You can also edit the values and click Save to update the condition.

Applying a Condition to a Transaction

You apply conditions to transactions on the Apply Condition page.

  1. Select Permits or Planning Applications and select a transaction row. On the Permit or Planning Application .page, select Conditions under Permit or Planning Application Information. Select Apply Condition.

  2. On the Condition Details page, enter values for the following fields:

    Page Element

    Description

    Condition Name

    Select a condition from a list of conditions that are enabled in setup.

    Severity

    Lock

    Displays the level of severity as defined while setting up the condition:

    At the most severe level, the Lock condition suspends all operations, including workflow advancing, payment processing, inspection scheduling, and inspection results.

    Severity

    Hold

    Agency staff can select which rules to apply to conditions with this level of severity.

    Severity

    Notice

    This level functions as an alert and has no effect on operations.

    Business Rules

    Select one or more business rules. Options are:

    • Prevent New (applicable to a parcel)

    • Prevent Workflow Advancing

    • Prevent Issue or Final

    • Restrict Payment

    • Prevent Inspection Schedule

    • Prevent Inspection Result

    Note: The business rules available for selection are based on the severity of the condition you have selected. For example, for a condition whose severity is Hold you must select at least one business rule, and for a condition with Lock severity, all the business rules are automatically applied.

    For more details on the business rules, see Setting Up Conditions.

    Additional Information

    Enter additional information regarding the condition applied to the transaction.

    Display Message

    Displays the message on the Conditions list page as well as on the condition indicator at the top of the page, when you click the All Conditions link.

    Priority

    Select a priority from options High, Medium, and Low.

    Description

    Displays the description as entered while setting up the condition. You can change the text here and the condition description is updated when you save the condition.

    Applied By

    Displays in view mode, the name of the user who applied the condition, or as System if the condition is inherited.

    Applied Date

    Displays in view mode, the date on which the condition was applied.

  3. Click Save to save the condition and return to the Conditions page.

Resolving a Condition

You can resolve a condition that you applied to a transaction.

  1. Select Permits or Planning Applications and select a transaction row. On the Permit or Planning Application .page, select Conditions under Permit or Planning Application Information.

    Select the condition that you want to resolve and click the Resolve button to open the Resolve Condition page.

  2. Enter a resolution text in the Resolution Action field and click Save. The resolution is applied and the resolved condition is listed at the bottom of the condition list.

    Note: If you resolve an inherited condition, the condition applied to the transaction alone is resolved. The resolution has no effect on the condition that is applied to any other transactions associated with the parcel on which the condition was applied and inherited.

Viewing a Resolved Condition

You can view the details of a resolved condition on the Condition Details page.

  1. Select Permits or Planning Applications and select a transaction row. On the Permit or Planning Application .page, select Conditions under Permit or Planning Application Information.

  2. Select a row with a status of Resolved and click View Details.

  3. The Conditions Details page opens to display the details of the condition at the top, followed by an additional information about its resolution:

    • Applied By

    • Resolution Action

    • Resolved By

    • Resolved Date

  4. Click Cancel to return to the Conditions page.

Working with Application Attachments

You view a list of files and upload or download documents associated with an application on the Attachments page.

Attachments provide supporting documentation needed by agency staff during the permit or planning application process.

Viewing Application Documents

You view a list of application documents on the Attachments page.

  1. Select Permits or Planning Applications on the Agency Springboard.

  2. Click the row for a permit or planning application to access the detail.

  3. Click the Permit Information or Planning Application Information menu item in the left panel.

  4. Click the Attachments link to view the Attachments page for the permit or planning application.

  5. On the Attachment page, view the list of documents, including this information:

    Page Element

    Description

    File Name

    View the following information in the Filename field:

    • Filename with file type extension

    • File Size

    • Uploaded By user name

    • Uploaded On date

    Description

    View the description of the attachment as entered by the person who added the attachment.

    Uploaded By

    View the name of the person who uploaded the document.

    Category

    View the document category for the attachment.

    Actions

    Click the actions icon to select and perform an action:

    • View Details

    • Download

    • Delete

    Note: The security associated with your user ID may limit which actions are available to you.
  6. Click the Sort By to view attachments grouped by these fields: file name, file size, uploaded by, uploaded on, description, category, and subcategory.

  7. To find a specific attachment, you can enter values in the search field.

Adding Application Documents

You upload files to the Attachments page using the Add Attachments page. Inspectors can also add documents in Oracle Inspector.

Note: You can also add attachments in the two-panel view of the Workflow page for permits.
  1. Select Permits or Planning Applications on the Agency Springboard.

  2. Click the row for a permit or planning application to access the detail.

  3. Click the Permit Information or Planning Application Information menu item in the left panel.

  4. Click the Attachments link to view the Attachments page for the permit or planning application.

  5. Click the Add icon.

  6. Select the file to upload in the browser dialog box and click Open.

    The filename appears on the Add Attachments page.

  7. On the Add Attachments page, you can enter a description of the file, a document category, and a document subcategory, if desired.

    Use the look-up prompt to select a document category and subcategory that have been defined by the agency. For more information, see the implementation documentation for Setting Up Document Categories and Subcategories.

  8. Click the Upload button.

Viewing Application Document Details

You view document details on the Attachments details page.

  1. Select Permits or Planning Applications on the Agency Springboard.

  2. Click the row for a permit or planning application to access the detail.

  3. Click the Permit Information or Planning Application Information menu item in the left panel.

  4. Click the Attachments link to view the Attachments page for the permit or planning application.

  5. In the attachments grid, click the Action icon for the document that you want to view.

  6. Select View Details to open the document details page. In addition to the information on the Attachments page, you can see who last updated the document and when.

Downloading Documents

You download a document on the Attachments page.

  1. Select Permits or Planning Applications on the Agency Springboard.

  2. Click the row for a permit or planning application to access the detail.

  3. Click the Permit Information or Planning Application Information menu item in the left panel.

  4. Click the Attachments link to view the Attachments page for the permit or planning application.

  5. In the attachments grid, click the Action icon for the document you want to download.

  6. Select Download and save to the location of your choice.

Deleting Documents

You can use this method for deleting one or more documents.

  1. Select Permits or Planning Applications on the Agency Springboard.

  2. Click the row for a permit or planning application to access the detail.

  3. Click the Permit Information or Planning Application Information menu item in the left panel.

  4. Click the Attachments link to view the Attachments page for the permit or planning application.

  5. Click the Edit icon above the grid.

  6. Select one or more documents to delete.

  7. Click the Delete icon.

  8. To delete a single document, go to the Attachments page, and select Delete in the Action menu for the document you want to delete.

Working with Application Comments

This topic discusses how to use comments. You can view, edit, and add comments on the Comments detail page for an application.

Adding Comments for an Application

You view, edit, and add new comments on the Comments page. You can mark comments you use regularly as your favorite and access them easily from the Favorite comments tab. You can also select and post a comment from the Standard comments tab, which lists all the pre-defined comments. In addition, Recent comments tab allows you to select and post comments from a list of recently posted comments.

This example illustrates the Comments page, which is described in the following text.

Comments page

Viewing and Editing Comments

  1. Select Permits or Planning Applications on the Agency Springboard.

  2. Click the row for a permit or planning application to access the detail.

  3. Click the Comments link in the navigation panel on the left.

    You can view the list of comments and select the comment row to view the comment details. The Comment page opens to show the details of the comment.

  4. To view the details of a comment entered earlier click the comment row.

    You can edit, delete, or hide the comment from public only if it was entered by you.

  5. Click Save after making changes to the comment.

Adding a New Comment

  1. Select Permits or Planning Applications on the Agency Springboard.

  2. Click the row for a permit or planning application to access the detail.

  3. Click the Comments link in the navigation panel on the left.

  4. Click the Add Comment button to open the Add Comment page and enter a new comment. You can choose to use the Rich Text Editor option for formatting your comment. See Managing Comments documentation to enable the option of Rich Text Editor formatting.

  5. Click Post to post the comment and return to the Comments page.

Adding Favorite, Standard, and Recent Comments

  1. You can also post a comment that is already available in the Community Development service. Click the Select Comments button to open the Select Comments page and select a comment from one of the three tabs of comments – Favorite, Standard, and Recent.

    The Favorite tab lists all the comments you have marked as favorite. The Standard tab lists all the predefined comments available in the Community Development service. The Recent tab lists all the comments that were recently posted.

  2. Select a comment from any of these three categories and click the Insert button to post the comment.

Note: If you want to mark a standard comment as your favorite, click the * button on the comment row. The Favorite tab will add the comment to its list.Your agency decides the duration for which a comment can be called Recent. The duration can be set up on the Manage Comments page.

See Managing Comments.

Working with Fees and Payments

You view and manage fees and payments associated with a submitted permit or planning application on the Fees and Payments page in the application details.

Tip: As agency staff, you can access this page on a phone as well as on a laptop or desktop computer. The layout changes based on the device you are using.

Fees are calculated based on agency fee setup.

For more information about setting up automatic fee calculations based on permit or planning application type, see Creating Decision Models for Fees.

This example illustrates the Fees and Payments page containing the field values described in the following table.

Fees and Payment page for a permit

Viewing Fees and Payments for an Application

  1. Select the Permits or Planning Applications tile on the Agency Springboard.

  2. Click the row for the selected application on the Transactions page.

  3. Click Fees and Payments in the left panel or click the View Details link in the Fees and Payments section on the Overview page for the application.

  4. On the Fees and Payments page, view a list of fees, including this information:

    Page Element

    Description

    Fee Description

    The description of the fee item as defined when creating a fee item.

    Amount

    The amount due for each fee item.

    Currency

    The currency in which the transaction will be paid.

    Status

    • Canceled: Indicates the fee payment is no longer required.

    • Pending: Indicates the payment transaction is currently in process.

    • Hold: Indicates the fee requirement has been put on hold until an issue or condition associated with the application or a permit inspection has been resolved.

    • Due: Indicates the current fee request is due and needs to be paid.

    Department

    The department within the agency requiring the payment.

    Assessed Date

    The date the request for payment was issued.

    Payment Date

    The date payment was received.

    Payment Reference

    The payment reference issued for the transaction. Click the payment reference number to view the payment receipt.

    Invoice

    The payment invoice number of the paid fee associated with the application. Click the invoice number link to view the payment invoice.

    Total Fees

    The total amount of fees that may be applicable to the application.

    Total Payable

    The amount of fees that are designated as payable.

    The agency may generate fees that are not due upon application submission and are therefore not payable. For example, plan review or inspection fees may be applied based on whether a plan review or inspection is required or not. Or the agency may place a due fee on hold.

    Total Paid

    The amount of the total fees already collected.

    Balance Due

    The remaining portion of the fees yet to be collected.

Adding a Fee Item

Using the Fees and Payments page, you can add additional fees to an application if the situation arises, such as a late fee, an unforeseen processing fee, an addition to the project request, and so on. These fees are assessed outside of the automatic fees process. The Add Fees button is not available when the application status is Pending Payment or Pending Submittal. When the fee status changes to Due, the system sends a notification to the applicant that new fees have been assessed and are due.

To add a fee item:

  1. Click Add Fees in the Fees and Payments grid to display the Add Fee Item page.

  2. Select the appropriate fee from the Fee Item lookup list.

  3. Enter the fee required for the item in the Amount field.
  4. Set the status of the fee item using the Status drop-down list, such as Due.

  5. Use the Department lookup list to select the department to collect the fee.

    The department defaults from the fee item, if specified. Otherwise, the system uses the department from the Permit Type or Planning Application Type setup.

  6. Set the appropriate date for the fee item using the Assessed Date field.

  7. Use the Memo field to add any additional description to help identify the nature of the newly added fee, which can help answer questions regarding why a fee was added during the application process.

  8. Click Save.

Paying Fees

To add a payment for all fees that are due, click the Pay button. Doing so takes you to the Checkout page, where you can select the payment method.

For more information about paying fees, see the Payment Flow Overview.

Viewing Project Summaries

If a permit or planning application is assigned to a project, agency staff and public users can view a summary of the project in the application details. The permit or planning application can be assigned to multiple projects.

Agencies create projects to group various applications. A project provides a summarized, consolidated view across project-related records, for example, a construction project for a residential building or commercial development. Projects can be simple or more complex, including permits and various compliance requirements through to completion.

This example illustrates the Projects summary page in the permit details, which is described in the surrounding text.

Permit Details - Projects page

Viewing the Project Summary

As an agency employee, you can navigate to the project summary in the application details through the Agency Springboard:

  1. Select Permits or Planning Applications on the Agency Springboard.

  2. Click the row for a permit or planning application to access the detail.

  3. Click Projects in the left navigation panel.

  4. On the Projects page, you see a summary of the project that was created by the agency staff on a master projects page.

    Page Elements

    Description

    Project ID

    Click the project ID link to access the projects page that was created by agency staff. The project ID is automatically generated after saving the project.

    Project Type

    Review the project type. A project type is based on the nature of the project and is set up during implementation, for example, Commercial Project or Residential Project.

    Status

    Review the status of the project. For example, Active, Canceled, On Hold, Inactive, or Completed.

    Address

    Review the address of the project.

    Project Name

    Review the name of the project.

    Project Summary

    Review a summary of the project. The summary can be a long description of the project, as entered by the agency staff.

    Project Start Date and Project End Date

    Review the start and end dates.

    Project Created By

    Review the name of the person who created the project.

Working with Application Communications

Application-specific messages enable agency staff and applicants maintain correspondence regarding the progress of applications.

Agency users can send emails, notifications, and texts associated with a specific application on the Communication Details page. Agency staff and applicants can also use the Communication Details page to view a record of the messages associated with an application.

Sending Application Communications

  1. Click Permits or Planning Applications on the Agency Springboard.

    Select an application on the Transactions page.

    Click Communications in the navigation bar.

  2. On the Communication Details page, click Add.

  3. On the Ad Hoc Message page, enter values for the following fields:

    Page Elements

    Definition

    Channel Type

    Specify what type of ad hoc message you want to send. Values are:

    • Email: Generates an email that is sent to users.

    • Notification: Generates a notification that appears when users click the notification icon in the application.

    • Text: Generates a short message service (SMS) text message that is sent to users.

    Note: The fields that are available to define on this page vary depending on the channel type that you select.

    Visibility

    Select which type of user can see this message. Values are:

    • Account owner

    • Public user

    • Agency staff only

    MIME Type (Multipurpose Internet Mail Extensions type)

    Select the format of the message. Values are:

    • HTML

    • Text

    Note: This field does not appear for the Text channel type.

    Priority

    Turn this switch on to display the notification at the top of the notification list.

    Note: This field appears only for the Notification channel type.

    User Can Delete

    Turn this switch on to enable users to delete this notification from their notification lists.

    Note: This field appears only for the Notification channel type.

    Select and Insert

    These fields enable you to insert variable attributes into your message. You select the field and the attribute that you want to insert in that field, and click Insert to enter a variable for that attribute.

    For example, if you select the Body field and the Status attribute, and click Insert, the ${Status} variable is inserted into the Message Body field of the message. When you send this message, the status of the application associated with the message is included in the body text.

    Create Web Form

    Click to access the Web Form modal page where you create a questionnaire that you can insert into your message. For each row of the web form, enter the Question text along with the Answer Type that you expect from the recipient for that question. Possible answer types are:

    • Date

    • Text

    • Number

    Click OK to save your web form questionnaire and return to the Ad Hoc Message page. The Create Web Form button displays the number of questions included on the web form in parentheses.

    Insert Web Form

    Click to insert the web form questions into the body of your message along with a link that the recipient can use to access and respond to the questionnaire.

    From

    Enter the email address, user ID, or phone number of the person or organization who is sending the generated message.

    Note: Enter email addresses for the Email channel type, user IDs for the Notification channel type, and phone numbers for the Text channel type.
    Note:

    To

    Enter the email address, user ID, or phone number of the person or organization that you want to receive the message.

    Note: Enter email addresses for emails, user IDs for notifications, and phone numbers for texts.

    Cc and Bcc

    Enter the email addresses of the people or organizations that you want to receive a copy of the message.

    Note: These fields appear only for the Email channel type.

    Subject

    Enter a brief description of the purpose and content of the message.

    Note: This field does not appear for the Text channel type.

    Message Body

    Enter the main body text of the message.

    For the Text channel type and emails and notifications with the Text MIME type, you can enter only plain, unformatted text.

    For the HTML MIME type, you can enter rich text, links, and images.

  4. Click Send.

Viewing Application Communications

  1. Click Permits or Planning Applications on the Agency Springboard.

    Select an application on the Transactions page.

    Click Communications in the navigation bar. The Communication Details page displays all of the messages that are associated with the application.

  2. For each row on the Communication Details page you can:

    • Click the Actions icon to resend or forward the message.

      Select the Resend action to access the message in the Message Details modal page in display-only mode. Click Resend to send the message another time to the same list of recipients.

      Select the Forward action to access the message in the Message Details modal page. Enter new recipient email addresses, update the message if necessary, and click Forward to send the updated message to the new recipients.

    • Click the View More Details button to view detailed information about the message.

Working with Ad Hoc Communications

Ad hoc communications enable agency staff to create and distribute alerts, emails, and notifications.

Agency staff can create and update ad hoc communications on the Communication Center page.

Alerts appear as text in the banner of the Agency Springboard or the landing pages for all anonymous, all registered users, or individual users. Emails are messages sent to anonymous or registered users, or individual users, and accessed through an email client. Notifications appear when registered and signed-in users click the notification icon at the top of the page in Oracle Public Sector Community Development. Short message service (SMS) text messages are electronic messages sent to anonymous or registered users over a cellular network or through an internet connection.

The Communications Center lists all of the emails and notifications that have been triggered from the system. This includes communications triggered as part of an event or action that a user or agency staff is performing, or that the agency staff is sending to the user. In-application communications associated with a particular permit or application also appear in the Communications Center.

Note: Agency staff can also create application-specific ad hoc emails, notifications, and texts on the Communication Details page in the transaction detail pages. You access the transaction through Transactions page, where you select a specific permit or planning application and select the Communications tab in the left-panel navigation. For more information, see Working with Application Communications.

Alert setup using the either the delivered PSC_GENERIC_ALERT event or the delivered ADHOC-EVENT event is also available. For step-by-step instructions for setting up alerts using the delivered events, see Defining Alerts.

Adding Ad Hoc Alerts

  1. Select Communication Center in the Navigator, or click Communication Center on the Agency Springboard.

  2. On the Alerts tab of the Communication Center page, click Add.

  3. On the Alert Details page, enter values for the following fields:

    Page Element

    Description

    Reference Name

    Enter a unique name for the alert.

    Start Date Time and End Date Time

    Enter the date and time when the alert starts and stops displaying.

    Enabled

    Turn on the switch to activate the alert.

    To

    Enter a value for the target recipients of the alert:

    • Individual Registered Users

      Enter comma-separated user IDs for the registered users, for example, SYSTEM_ADMIN,BUSINESS_ANALYST.

    • All Registered Users

      Enter this attribute: ${User}. The application displays the alert when the registered user logs in.

    • All Anonymous Users

      Enter this attribute: ${Anonymous}.

    • A Combination of Users

      Enter a string including comma-separated user IDs for the registered users, ${User} for all registered users, and ${Anonymous} for all anonymous users.

    Message Body

    Enter the main body of the alert using plain, unformatted text.

    Select and Insert

    These fields enable you to insert variable attributes into your message. You select the field and the attribute that you want to insert in that field, and click Insert to enter a variable for that attribute.

    For example, if you select the Body field and the Current Date attribute, and click Insert, the ${Current Date} variable is inserted into the Message Body field of the alert. When the application displays this alert, the current date is included in the body text.

    Remarks

    Enter any reference information for agency use. These remarks are not included in the displayed alert.

  4. Click Save.

Modifying Ad Hoc Alerts

  1. Select Communication Center in the Navigator, or click Communication Center on the Agency Springboard.

  2. Select an alert on the Alerts tab of the Communication Center page.

  3. On the Alert Details page you can:

    • Update the alert field values.

    • Delete the alert. You will be prompted to confirm the permanent deletion.

  4. Click Save.

Deleting Ad Hoc Alerts

  1. Select Communication Center in the Navigator, or click Communication Center on the Agency Springboard.

  2. On the Alerts tab of the Communication Center page click Edit.

  3. Select the check boxes next to the alerts that you want to delete.

  4. Click Delete. You will be prompted to confirm the permanent deletion.

Sending Ad Hoc Emails, Notifications, and Texts

  1. Select Communication Center in the Navigator, or click Communication Center on the Agency Springboard.

  2. On the Emails, Notifications, and Texts tab of the Communication Center page, click Add.

  3. On the Message Details page, enter values for the following fields:

    Page Elements

    Definition

    Channel Type

    Specify what type of ad hoc message you want to send. Values are:

    • Email: Generates an email that is sent to users.

    • Notification: Generates a notification that appears when users click the Notifications button in the header at the top of the page in the application.

    • Text: Generates a short message service (SMS) text message that is sent to users. You can’t change the sent number because it’s coming from a third-party service.

    Note: The fields that are available to define on this page vary depending on the channel type that you select.

    Visibility

    Select which type of user can see this message. Values are:

    • Account owner

    • Public user

    • Agency staff only

    MIME Type (Multipurpose Internet Mail Extensions type)

    Select the format of the message. Values are:

    • HTML

    • Text

    Note: This field does not appear for the Text channel type.

    Priority

    Turn this switch on to display the notification at the top of the notification list.

    Note: This field appears only for the Notification channel type.

    User Can Delete

    Turn this switch on to enable users to delete this notification from their notification lists.

    Note: This field appears only for the Notification channel type.

    Reference

    Enter a unique alphanumeric reference for the communication.

    Select and Insert

    These fields enable you to insert variable attributes into your message. You select the field and the attribute that you want to insert in that field, and click Insert to enter a variable for that attribute.

    For example, if you select the Body field and the Current Date attribute, and click Insert, the ${Current Date} variable is inserted into the Message Body field of the alert. When the application displays this alert, the current date is included in the body text.

    Create Web Form

    Click to access the Web Form modal page where you create a questionnaire that you can insert into your message. For each row of the web form, enter the Question Text along with the Answer Type that you expect from the recipient for that question. Possible answer types are:

    • Date

    • Text

    • Number

    Click OK to save your web form questionnaire and return to the Message Details page. The Create Web Form button displays the number of questions included on the web form in parentheses.

    Insert Web Form

    Click to insert the web form questions into the body of your message along with a link that the recipient can use to access and respond to the questionnaire.

    From

    Enter the email address, user ID, or phone number of the person or organization who is sending the generated message.

    Note: Enter email addresses for the Email channel type, user IDs for the Notification channel type, and phone numbers for the Text channel type.
    Note:

    To

    Enter a value for the target recipients of the message.

    For notifications, enter comma-separated user IDs for the registered users, for example, SYSTEM_ADMIN,BUSINESS_ANALYST.

    For emails, enter comma-separated email addresses for the recipients, for example, john.doe@example.com.

    For text messages, select the phone number of the person or organization who is sending the generated text message from the drop-down list.

    Cc and Bcc

    Enter the email addresses of the people or organizations that you want to receive a copy or a blind copy of the message.

    Note: These fields appear only for the Email channel type.

    Subject

    Enter a brief description of the purpose and content of the message.

    Note: This field does not appear for the Text channel type.

    Message Body

    Enter the main body text of the message.

    For the Text channel type and emails and notifications with the Text MIME type, you can enter only plain, unformatted text.

    For the HTML MIME type, you can enter rich text, links, and images.

  4. Click Send.

Viewing Ad Hoc Emails, Notifications, and Texts

  1. Select Communication Center on the Agency Springboard.

  2. For each row on the Emails, Notifications, and Texts tab of the Communication Center page you can:

    • Click the Actions icon to resend or forward the message.

      Select the Resend action to access the message in the Message Details modal page in display-only mode. Click Resend to send the message another time to the same list of recipients.

      Select the Forward action to access the message in the Message Details modal page. Enter new recipients, update the message if necessary, and click Forward to send the updated message to the new recipients.

    • Click the View More Details button to view detailed information about the message.

Viewing Application Status History

You can view the history of application status changes on the Status History page in the application details.

Whenever the status changes for a transaction, the change is recorded and viewable in the details for the application. The status history is display-only.

This example illustrates the Status History page, which is described in the following text.

Status History page

Reviewing the Status History

  1. Select Permits or Planning Applications on the Agency Springboard.

  2. Click the row for a permit or planning application to access the detail.

  3. Click the Additional Information menu item in the left panel.

  4. Click the Status History link to view the Status History page for the permit or planning application.

    Page Element

    Description

    Status

    Displays all of the transaction statuses that have been applied to the application.

    For a list of transaction statuses, see Setting Up Transaction Statuses.

    Updated By

    Displays the name of the person who performed the action that updated the status in the system.

    Updated Date

    Displays the date when the status changed for the application. The dates are displayed by the first to latest status.

    Reason

    Displays the justification for withdrawing an in-progress application or for canceling a pending application. A reason is required when the agency staff withdraws or cancels an application.

Working with Related Transactions

Applicants and agency users can link their permit or planning applications to other transactions using the Related Transactions page. You can establish relationship between transactions and then perform actions such as viewing the related transaction applications and managing comments.

Adding a Related Transaction

As an applicant, you can establish links only from your permit or planning application. Agency staff can however add related transactions for any permit or planning application.

To link a permit or planning application to a transaction:

  1. Select the Permit or Planning Application tile on the Agency Springboard.

  2. On the Transactions page select the permit or planning application for which you want to link a transaction.

  3. Click the Related Transactions link in the left panel to open the Related Transactions page.

  4. Click the Link Transaction button to locate and then link the required permit or planning application. The Related Transactions page lists the new transaction row with a link to access the linked application.

Removing a Related Transaction Link

As an applicant you can remove the link between related transactions from your own permit or planning application. Agency staff have access to all permit and planning applications to remove related transaction links.

To remove an application link:

  1. Select the Permit or Planning Application tile on the Agency Springboard.

  2. On the Transactions page select the permit or planning application from which you want to remove the application link.

  3. Click the Related Transactions link in the left panel to open the Related Transactions page.

  4. Click the Actions button on the related transaction row and select Remove Application Link. The Related Transactions page lists the remaining related transaction rows.

Using Maps

Maps provide a convenient way for both agency staff and public users to see application locations and to select parcels when starting an application.

Map functionality relies on integration with a third-party map service such as Esri Geographic Information Systems (GIS).

This example shows some of the options on the Explore Your City map for registered public users.

Map example - Explore Your City page

Pages With Maps

The following table describes how you access and use maps throughout the system:

Page and Users

Navigation

Usage

Main Map page (agency staff)

Click the Main Menu icon in the page header.

View application locations on a map.

Select parcels by searching or by drawing on the map, and start applications for selected parcels.

Search applications by address or parcel number, and filter applications by start date, end date, and application type.

Explore Your City page (anonymous and registered public users)

Click the Explore Your City tile on the landing page.

All public users can view and search applications and select parcels.

Registered users can additionally filter applications so that only the user’s own applications appear on the map. Also, registered users can start new applications for parcels that they select.

Generate Notifications List page (agency staff)

From the Planning Application detail page, click Planning Application Information in the left panel, then click the Hearing link.

Locate the hearing, then select the Actions button and choose Generate Notifications from the menu that appears.

Create a notification zone by specifying a distance from selected parcels.

This page is accessed from a hearing for an application, and the parcels from the application are automatically selected. You can change the selection if necessary.

After creating a notification zone, download .csv files with parcel, address, and owner information for all parcels that are at least partially within the zone.

Application list pages:

  • Transactions page (agency staff)

  • Applications page (registered public users)

  • Agency staff: click either the Permits tile or the Planning Applicationson the agency springboard, then click the Map View icon on the Transactions page.

  • Registered public users: click the Applications tile on the public user landing page, then click the Map View icon on the Applications page.

View map markers for listed applications.

The map view of these pages has a left frame that lists the applications. Clicking a specific application zooms the map to the application location.

Detail pages for an individual application (agency staff and registered public users):

  • Permit page

  • Planning Application page

From the Applications page or the Transactions page, access an individual application in the list.

If the application is associated with a parcel address, the map at the top of the page includes a map marker to indicate the primary address for the application.

If the application is not associated with a location, the map displays a default area that your agency configures.

Property Picker map (agency staff and registered public users)

  • Start a new application, and continue until you reach the Property section. Click the Find Parcel on Map icon.

  • Access the details for an existing application, and click the Property Information link to display the Property Information page. Click the Find Parcel on Map icon in the Parcel List section.

Choose a parcel on the map, then add it to the current application.

Parcel detail pages (agency staff)

Click the Parcel tile on the agency springboard to access the parcel list, then drill into an individual parcel

The map above the parcel detail pages displays a marker at the parcel address.

Address detail pages (agency staff)

Click the Property Address tile on the agency springboard to access the address list, then drill into an individual address.

The map above the address detail pages displays a marker at the specified address.

Generic Map Tools

The main toolbar on any map has tools that relate to the map itself, without regard to applications.

Use map profiles to configure which tools are available on the main toolbar. Different maps support different tools. For information on configuring which tools appear in the main map toolbar, see Setting Up Map Profiles

These are the generic map tools that can appear on the main map toolbar:

Image

Name

Description

Zoom In and Zoom Out

Zoom In and Zoom Out

These standard zoom controls are available for all maps.

You can also double-click a map location to zoom in.

Show Default Map View

Show Default Map View

Click to restore the map to its default display area.

Use map profiles to configure whether this button appears on the toolbar.

Select Base Map

Select Base Map

Click to display a pop-up window with a gallery of map options such as Streets or Topographic.

Use map profiles to configure whether this button appears on the toolbar.

Select Layers

Select Layers

Click to display a pop-up menu for changing the visibility of various map layers. Examples of layers include the parcel layer and address layer provided by the map service.

To hide the pop-up menu, click the button again.

Use map profiles to configure whether this button appears on the toolbar.

Show Attribution

Show Attribution (for maps in page headers)

Click to display a pop-up window that identifies the third-party map sources.

This toolbar button is not configurable. Some maps have this button, while other maps, such as Explore Your City, display attribution information across the bottom of the map page.

Show Attribution
Identify GIS Information (for maps that are not in page headers)

Click to enable the display of object details for map objects (such as parcels) that you click. Details appear in a pop-up window. To stop displaying object details, click the button again to turn off the option to identify GIS information.

The location of the pop-up window depends on the docking settings in the map profile.

Use map profiles to configure whether this button appears on the toolbar.

Show or Hide Selection Tools

Show Selection Tools or Hide Selection Tools

Click to show or hide a toolbar with drawing tools. Use the drawing tools to select parcels on the map.

This button is not configurable. It appears on the Main Map and Explore Your City map.

Show Transactions

Show Transactions

Click to display the Show Transactions pop-up window. This window has controls for showing or hiding transactions on the map and for filtering those transactions by date or by the kind of application (permit application or planning application).

Map Markers

Map markers identify the location of an object such as an application, a parcel, or an address.

This example illustrates the Parcel page, where the map marker shows the parcel’s location. Similar markers appear on the detail pages for applications, addresses, and property owners.

Parcel map marker example

This example illustrates the Explore My City page, where map markers show application locations. Numbers on markers indicate the number of applications associated with the location. When there is just one application, the marker doesn’t have a number.

Application map marker examples

Each color represents different types of transactions:

Map Marker

Description

Red

One or more permit applications for the same location.

Blue

One or more planning applications for the same location.

Purple

A mix of permit applications and planning applications for the same location.

Orange (darker circle within a lighter circle)

Multiple parcels clustered together.

This marker is used when the map’s zoom level would cause the markers for neighboring transactions to overlap. As you zoom in, the cluster marker disappears and markers for the individual parcels appear.

Viewing Details for a Marker

Clicking an application marker displays a pop-up window with additional details. (However, if the selection toolbar is visible and there is an active selection tool, clicking performs the selection action rather than opening the details pop-up.)

This example illustrates the detailed information for a map marker. The location of the pop-up window depends on the docking settings in the map profile

Map marker details

The detail window includes this information:

Map Marker Detail

Description

Permit or Planning Application or Project followed by the application number

Identifies whether this is a permit application or a planning application, and identifies the individual application.

<Application Type>

Identifies the specific permit application type or planning application type.

<Address>

Identifies the location for the application.

<sequence number> of <total number of applications> and controls for paging through multiple applications.

Indicates that there are multiple applications associated with the marker, and enables you to page through the applications.

More menu icon

Button to display an action menu.

Click to open a menu with these actions:

  • Zoom To: select to zoom in on this applications’ location on the map.

  • Go: select to open the corresponding application details page in a new window.

Searching for Transactions and Parcels On Maps

This table describes search, filter, and selection functions on various maps.

Map

Description

Main Map (agency staff)

Explore My City (public users)

These maps have robust options for working with parcels and applications, including:

  • Viewing all applications in the map area.

  • Filtering applications by date and kind of application (permit applications or planning applications).

  • For registered public users, filtering applications to show only the user’s own applications.

  • Selecting parcels by searching either addresses or parcel numbers.

  • Selecting parcels using tools for drawing point, polylines, or polygons.

  • Starting applications for selected parcels.

For more detailed information about working with the Main Map and the Explore My City map, see Using the Main Map and Explore Your City Map.

Transactions (agency staff)

Applications (registered public user)

On these list pages, the map view shows the location of the listed applications. The search and filter options in the map view are the same options that you have in the list view.

The map view includes a left frame with a list of permits, and you can click a permit to zoom to its marker on the map.

Generate Notifications List (agency staff)

This maps has the same parcel selection options as the Main Map, including:

  • Selecting parcels by searching either addresses or parcel numbers.

  • Selecting parcels using tools for drawing point, polylines, or polygons.

Property picker map within an application (all users)

The property picker map has a single search field where users can enter an address. If a match is found, the map zooms to the to the desired location and displays a pop-up box that points to the location so the user can click it to select the parcel.

Clicking a parcel on the map retrieves the parcel identifier from the map service. This value is used as criteria for searching the Parcel table, and the search results appear in a modal window. As long as the parcel number has a unique match in the Parcel table, the search results include just one value, representing the selected parcel. From the search results window, you can select the parcel and add it to the application.

Using the Property Picker to Select a Parcel for an Application

The property picker is a map-based tool for choosing the parcel to association with an application.

To select a parcel using a map:

  1. Access the page where you select a parcel to associate with the application, and open the property picker:

    • In an unsubmitted application, find the Parcel section and click the Search Property icon, which looks like a map marker.

    • In a submitted application, access the application detail page, click the Property Information link, find the Parcel List section, and click the Find Parcel on Map icon, which looks like a map marker.

    On either page, clicking the icon opens the map-based property picker.

  2. Use map tools such as searching or zooming to locate the parcel on the map.

  3. Click the parcel.

    The map closes, and the Search Property window opens. The system searches properties using the parcel ID provided by the map service, so the list of search results shows the parcel that you selected.

  4. Select the check box for the parcel.

  5. Click the Add Selected button.

    The selected parcel is now added to the application.

Using the Main Map and Explore Your City Map

The agency-facing Main Map and the public-facing Explore Your City map provide a variety of options for viewing existing applications on the map and for selecting parcels so that you can start new applications.

To provide different types of users with the most appropriate interface, there are separate main maps for agency users, registered public users, and anonymous public users. These maps have different map profiles, giving you control over whether various map options are available to each audience. However, these maps provide the same functionality, enabling users to:

  • Search for and select parcels, and then start an application for the selected parcels.

  • View transaction locations on the map.

There are some differences depending on whether the user is a registered public user, an anonymous user, or agency staff. These differences are noted in the documentation.

This example shows the Explore Your City map for registered public users.

Explore Your City map page

Selecting Parcels

Selecting parcels on the map enables you to start applications for those parcels. The system brings the parcel information into the application intake form.

To select parcels, use the search feature, or the drawing tools on the selection toolbar, or a combination of both. When parcels are selected:

  • The parcel polygons on the map are solid blue.

  • The Selected Locations overlay replaces the Search overlay and provides additional information about the selected locations.

  • Apply and Guide buttons appear at the bottom of the Selected Locations overlay so that you can start an application for the selected parcels.

    The Guide button provides access to a questionnaire that is configured using Oracle Policy Automation (OPA). The button appears only if your agency has implemented this functionality.

    Anonymous public users cannot start applications, so they don’t see the Apply button. They still see the guide button.

This example shows a map with selected parcels.

Selected parcels on a map

To select and deselect parcels using the Search overlay:

  1. Enter a full or partial address or parcel number in the search field.

    As you type in the search field, up to five matching addresses and parcels appear in a type-ahead drop-down list. The type-ahead list includes headings to indicate which items are Addresses and which are Parcels.

  2. Press the Return key or click the magnifying glass icon to perform a full search.

    The Search window expands to show lists for Addresses and Parcels with a count for each type of result. Initially a maximum of five items appears in each list.

    If more results exist, click the More link to show all results in a scrolling list. When the list is expanded, click the Less link to shrink the list back down to five locations.

  3. To select a parcel, click a single address or parcel number from either the type-ahead list or the full results list.

    The corresponding parcel on the map is selected, and the search field is replaced by the Selected Locations list.

  4. To deselect a single parcel from the Selected Locations list, click the Delete icon for that parcel.

  5. To deselect all parcels from the Selected Locations list, click the Clear All link at the top of the list.

  6. To re-display the search field without losing your selection, click the Search link.

    Perform as many searches as needed to select the desired parcels. Each time you select a parcel, it is added to the Selected Locations list.

  7. To return to the Selected Locations overlay from the Search overlay without performing a search, click the Selected Locations link.

    This link appears if at least one parcel is selected.

To select and deselect parcels using drawing tools:

  1. Show or Hide Selection Tools Click the Show Selection Tools button on the map’s general toolbar.

    The drawing toolbar appears.

  2. Use these tools to make your parcel selection:

    Selection Toolbar Button

    Description

    Draw a Point

    Draw a Point

    Click one or more points on the map to select the parcels that contain the points.

    Draw a Polyline

    Draw a Polyline

    Click two or more points on a map to draw a multi-segment line (a polyline) connecting the points that you click. Double-click on the final point to stop drawing. All parcels that intersect the resulting polyline are selected.

    Draw a Polygon

    Draw a Polygon

    Click three or more points on a map to draw a polygon. The system redraws the polygon after each click. Double-click on the final point to stop drawing. All parcels that are at least partially within the resulting polygon are selected.

    Deselect One

    Deselect One

    Click a selected parcel to deselect it.

    Note: Selecting a parcel does not deselect previously selected parcels. You must use the Deselect One or the Deselect All tool to remove parcels from your selection.
    Deselect All

    Deselect All

    Click this button to deselect all parcels.

    Close

    Close

    Click to close the toolbar.

  3. Review details of your selections on the Selected Locations list.

    The Selected Locations list replaces the search window whenever parcels are selected.

Working With the Selected Locations List

The Selected Locations overlay enables you to review information about the locations you have selected. It also provides options for deselecting individual locations or all locations.

This example illustrates the Selected Locations overlay. In this example, the addresses and parcel numbers of selected locations are links to the corresponding detail pages. These links are only present for agency staff. When public users see the Selected Locations overlay, the addresses and parcel numbers appear as plain text.

Selected Locations overlay

To use the Selected Locations overlay:

  1. Review the address and parcel information for locations that you selected.

    Each location card represents an address. If you select a parcel with multiple addresses, each address appears on a separate card.

    Agency staff can access the detail pages for selected addresses and parcels by clicking the address or the parcel number link on the card. Public users do not have access to detail information, so for public users, the addresses and parcel numbers are plain text instead of links.

  2. Click a location card to select it and learn more about the parcel.

    On the map, the polygon for the selected location is outlined.

    If the selected parcel is associated with applications, the selected card expands and displays an Applicationsicon with an application count. If the parcel is not associated with any applications, the selected card looks the same as it does when it’s collapsed.

  3. To see a list of applications for a parcel, click the Applications icon.

    The Applications list replaces the Selected Locations list. The list includes these elements:

    Page Element

    Description

    <Address> and Parcel ID for the parcel.

    The identifying information for the parcel appears at the top of the list.

    <Application ID> and Application Type>

    The first column in the application list displays identifying information about the application.

    <Application Status>

    The second column in the application list displays the application status.

    Go icon

    The last column in the application list displays the Go icon. Click this icon to open a new window with the appropriate application details page (the Permit page or the Planning Application page). The window does not have any navigation controls, so the user simply closes the window when done.

    The details are read-only for public users. For agency users, access is based on the user’s security.

  4. From the applications list, click the return button in the window header to go back to the Selected Locations list.

Starting an Application

After you select parcels on a map, you can start an application for the specified location.

To start an application:

  1. Confirm that the correct parcels are selected.

  2. To go to the Apply page, click the Apply button.

    This button is not visible to anonymous public users.

    The Apply page provides multiple options to help you choose the correct application type and start the application.

    As long as the application intake form includes a Property section, the property information will be pre-filled based on the parcels that were selected when you clicked the Apply button.

    See also Starting an Application.

  3. To use the Guide to choose an application type, click the Guide button.

    The Guide is a questionnaire to help identify the recommended applications for a project. The Guide button is available only if an Oracle Policy Automation (OPA) definition is associated with the agency record. For more information, see Setting Up Agencies and Managing OPA Policies for Agency.

    If you start an application at the end of your guided questionnaire, the property information section of the intake form will be pre-filled based on the parcels that were selected when you clicked the Guide button.

Showing Transactions

Agency staff, registered public users, and anonymous public users can all view transaction markers on the map. Registered public users can additionally filter the map to show only their own transactions.

To show transactions on the map:

  1. Show Transactions Click the Show Transactions button on the map’s general toolbar.

    The Show Transactions overlay appears.

  2. In the Show Transactions overlay, use these check boxes to choose if map markers identify application locations:

    Page Element

    Description

    All Applications

    When you select this check box, the map displays markers for all applications in the mapped area. Deselecting this check box clears the map markers.

    My Applications

    Only registered public users see this check box. They can select this check box to filter applications so that only the user’s own applications are marked on the map. Deselecting this check box clears the map markers.

    This check box and the All Applications check box are mutually exclusive, so selecting one deselects the other.

  3. If you choose to show map markers, use the Results Shown message at the bottom of the window to see how many map markers are shown.

    The message informs you how many results have been mapped and how many total results exist. The number of results shown is based on the whole map extent and does not change as you zoom and pan.

    Users can see up to 200 results at a time. If more than 200 results exist, use the Previous (<) and Next (>) icons to scroll to a different block of results and update the map to show markers for the new block of results.

  4. To filter applications by date or by the type of application (permit versus planning):

    1. Filter By Click the Filter By button to display additional filter fields.

    2. Enter filter criteria in these fields:

      Page Element

      Description

      Start Date

      If you enter a start date, only applications that were submitted on or after this date are included.

      End Date

      If you enter an end date, only applications that were submitted on or before this date are included.

      Type

      Select Permit or Planning Application to show just one kind of application. To go back to seeing all applications, clear the selection by choosing Type.

    3. Click Apply.

      The filter section of the window is hidden, and the Filter By icon changes from gray to blue to show that filters are active.

  5. To clear filters, display the filter area and click the Clear button.

  6. Show Transactions To close the Show Transactions overlay, click the Show Transactions button on the map’s general toolbar again.