6Managing Cases

Reviewing and Claiming Cases

A case is created when an inspection results in a code violation or citation. Agency staff can create a case directly, without an incident being reported. Code enforcement technicians use the worklist to view a list of unassigned cases and claim them as necessary.

Code enforcement technicians have two options for reviewing and claiming cases:

  • Viewing a case summary on the Worklist page and then clicking the Claim button.

    The code technician claiming an incident is by default the assigned technician for the case. This option is used for claiming a new case created directly — without a reported incident.

  • Using the Case Overview page to directly update the Technician Assigned field.

    Although this option is always available, it’s most useful for reassigning the case to another technician.

Reviewing and Claiming Cases Using the Worklist

  1. From the agency springboard, click the Worklist tile.

  2. Select the Unassigned Cases tab. This page lists all the unclaimed cases in the system.

  3. Review the following summary information about the case:

    Page Element

    Description

    Case

    This column displays:

    • The case ID that is assigned based on the agency’s autonumbering rules.

    • The issue type and subtype, separated by a hyphen.

    Creation Date

    Displays the date on which the case was created.

    Location

    Displays the location of the issue.

    Issue Description

    Displays the description of the case

    Case Status

    Displays the status of the case, for example, Compliance, Violation, Citation, and so on.

    Comply by

    Displays the last date to ensure compliance.

  4. If necessary, review the complete details for the case.

    1. Click the View More Details icon to access the Case page.

    2. On the Case page, review the information on the Overview, Details, Inspections, Notices, and other tabs. See Navigating to Case Details.

    3. Click the Back icon in the banner at the top of the page to return to the worklist, and re-navigate to the Unassigned Cases tab.

  5. Click the Claim button to claim the case.

    Claiming a case makes you the assigned technician. As the assigned code technician, you are now responsible for processing the case.

Reviewing and Claiming Cases on the Case Detail Page

  1. Select the Cases tile on the Agency Springboard, then click View More Details for a specific case.

  2. In the Overview section of the Case page, search and select a code technician from the Technician Assigned field.

Note: The new assignment is saved immediately. You do not need to explicitly save, nor do you have an option to cancel the change.

Processing Cases

Agency staff view information and statuses for all the code enforcement cases they are assigned. You can perform actions such as creating a case and accessing detailed case information from the Cases page.

As agency staff such as a code technician, you can use the Cases page to view a complete list of cases. Go to the list of cases to perform these tasks:

  • Manage case activity.

  • Create a case.

  • Update case status.

  • Access details about case history.

Using the Cases Page

  1. Select the Worklist tile on the Agency Springboard and click the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. You can perform these actions to display cases 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 cases in the list. The cases that meet the search criteria are displayed on the page.

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

    Filter By

    Apply filters to display cases 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.

    You can use the predefined filters Case, Creation Date, Issue Description. Case Status, and Comply By.

    Case filter is not available in the worklist.

    Sort By

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

    • Case

    • Creation Date

    • Location

    • Issue Description

    • Case Status

    • Comply By

Managing Case Activity

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, you can locate the basic information about the case using the following information:

    Page Element

    Description

    Create Case

    Click to create a new case.

    This option is not available in the Worklist — Cases page. You should navigate to the Cases page using the Cases tile.

    Case

    View the case ID, issue type, and issue subtype.

    Creation Date

    View the date on which the case was created.

    Location

    View the location of the issue.

    Issue Description

    Review the description of the case.

    Case Status

    View the status of the case, for example, Compliance, Violation, Citation, and so on.

    Comply by

    View the last date to ensure compliance.

    Actions

    Click to perform actions such as updating status.

Creating a Case

Agency staff such as a code technician can directly create a code enforcement case when they identify a code violation. Such a case is listed as an unassigned case, among other cases that originated from reported incidents.

To create a case:

  1. Select the Cases tile on the Agency Springboard.

  2. The Cases page lists all cases created out of reported code violations. Click the Create Case button.

  3. On the Select an Issue Type page, select the type and subtype of the issue you want to report for the code violation.

  4. On the Provide the Location of the Issue page, enter the location details or use the map to locate the address for which you are reporting the violation. Click Next.

  5. On the Tell Us What’s Going On page, enter the description of the issue you are reporting. You can also attach a photo, video, or an audio file as reference. Click Next.

  6. On the Just a Few More Questions page, enter additional information such as indicating whether the issue poses a health hazard or public safety risk. Click Next.

    The fields on this page are configured by the agency administrator who creates the intake form for the issue subtype. For more information about the issue intake form, see Using the Intake Form Designer for Code Enforcement.

  7. On the Code Violations page, click Add. Select one or more code violations from a list of current or other violations and click Done. Click Next.

  8. Review the information you entered on the Review page and click the Submit button.

You will see the case transaction is now listed in the Cases page. This unassigned case transaction will now be listed in the Unassigned Cases tab on the Worklist page. A code technician should claim the case from the worklist and proceed for further processing.

See the next session for the case related pages and their descriptions.

Navigating to Case Details

You find detail pages in a collection that consolidates all aspects of a code enforcement case, including property information, inspections, case information, responsible parties, citations, fees and payments, case history, and more.

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

To access the case detail pages:

  1. Select the Code Technician Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. The Cases page lists only the cases that are assigned to the logged in technician. Turn on the Show All Cases switch to view all the cases in the system.

    Locate the case you are working with and click the View More Details button on the case row.

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

The information for a case comprises these pages:

Page Name

Description

Overview

View the information highlights regarding the selected case with links to more detail.

See Viewing the Case Detail Overview.

Property Information

View parcel data from the case and a map of the parcel location.

See Working with Case Property Information.

Inspections

View a list of inspections scheduled for the case. You can also schedule inspections from this page.

See Working with Code Enforcement Inspections.

Notices

View a list of notices sent for the selected case. You can also generate notices from this page.

See Working with Notices.

Code Violations

View a list of code violations related to the case. You can also add additional code violations from this page.

See Working with Code Violations.

Comments

Review or add comments pertaining to this case.

See Working with Comments.

Attachments

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

See Working with Attachments.

Appeals and Hearings

View a list of appeals and hearings that are raised for the case.

See Working with Appeals and Hearings.

Responsible Parties

View the details of the party responsible for the violations leading to the case. You can also add a responsible party from this page.

See Adding Responsible Parties.

Citations

View a list of citations issued for the case. You can also issue citations from this page.

See Working with Citations.

Fee and Payments

Review citation fees assessed and payments due.

See Working with Citation Fees and Payments.

Case History

View a list of updates that were made to the case such as changing the case status or the compliance date, along with the reason for the update.

See Working with Case History.

Viewing the Case Detail Overview

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

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

As agency staff, you can use the Overview page to set the status of the case, assign inspectors and technicians to the case, update the issue description, and change the priority of the case.

Using the Overview Page

  1. Select the Code Technician Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard

  2. On the Cases page, click View More Details for the case row you want to access.

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

    Page Element

    Description

    Case Status

    Review the case status. To change the status of the case, click the Edit link to open the Update Status page, select a new status value, and enter a reason for the change. Click Done.

    Inspector Assigned

    Assign an inspector to the case by using the look-up prompt.

    Technician Assigned

    Assign a technician to the case by using the look-up prompt.

    The Assign Technician page lists only the technicians that are associated with the issue type and subtype of this case. Select the Show All Technicians check box to list all the technicians.

    Note: This check box is available to agency staff with appropriate permissions, only when the Autoassignment option is turned on.

    Technicians can claim cases from the code technician worklist. To access the code technician worklist, select Code Technician Worklist on the Agency Springboard and click the Unassigned Cases tab. See Using the Code Technician Worklist.

    Issue Description

    Review the description of the issue. To update the description, click the Edit link to open the Update Issue Description page and change the description text. Click Done.

    High Priority

    Indicates the priority of the case. To update the priority, click the Edit link to open the Update Case Priority page, select the switch, and use the calendar to select a new compliance date. Click Done.

    Compliance Date

    Review the date by which the case must ensure compliance, which is calculated based on the time rules set up by the agency. If there is no compliance date recorded, the page shows the Add button. You can click to open the Compliance Date page and enter the compliance date. Click Done.

    To update the compliance date, click the Edit link to open the Update Compliance Date page, select a new date from the calendar, and enter a reason for the change. Click Done.

    Reported Date

    Review the date on which the incident was reported.

    <number> days to comply

    Review the number of days left to ensure compliance.

  4. In the Responsible Parties section, the Access Number field displays a unique identifier, which is generated at the time of case creation. The responsible party must provide the access number at the time of to requesting access to their case. See Resolving Issues.

  5. Review important information about the selected case in separate sections on the Overview page. Click the View Details link to navigate to the page. Only those sections that contain data records to show are displayed in the overview page.

Working with Case Property Information

Property information shows the location details of the property that is associated with the case. The information includes the parcel ID, address of the property, and the name of the property owner. You can change the property using a search, or update the existing property details using the edit option.

Viewing Parcel Information

You view the parcel associated with this case on the Property Information page. You can also view the parcel location on a map.

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, click View More Details for the case you are working with.

  3. Select the Property Information tab in the left panel to open the detail view of the property.

Changing Property

You can change the property associated with the case on the Property Information page.

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

  2. On the Cases page, click View More Details for the case you are working with.

  3. In the case details, select the Property Information tab in the left panel to open the detail view of the property.

  4. On the Property Information page, click the Search button.

  5. On the Search Property page, search a new parcel and click Select.

Updating Property Address

You can update the parcel address associated with the case on the Property Information page.

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

  2. On the Cases page, click View More Details for the case you are working with.

  3. In the case details, select the Property Information tab in the left panel to open the detail view of the property.

  4. On the Property Information page, click the Edit button.

  5. On the Update Property Information page, you can enter new values for the address, city, and state. Click Done.

Working with Code Enforcement Inspections

The case information includes a consolidated list of inspections that are carried out and those that are scheduled for a case. As a code technician you manage inspection activity for a case — including reviewing inspection count, status, assignments, schedule dates, results and more — on the Inspections page.

As agency staff, you use the Inspection list page to view a complete list of case inspections that were carried out and scheduled for future. Access the inspections list in the case details to perform these tasks:

  • Review inspection activity recorded by the inspector.

  • Perform actions such as scheduling, rescheduling, and canceling an inspection.

Note: As part of the inspection process, an inspector performs inspections, add comments and attachments, and submit a result of the inspection. If the submitted result is Violation or Citation, all the entered details are captured and made available on the Inspections page of the case. The Inspections page can be accessed by the agency staff only on a laptop or a desktop computer. For details on managing inspection on a mobile device, see Overview of Mobile Oracle Municipal Code Officer.For details about managing inspections on a laptop or desktop computer, see Using the Code Officer Worklist.

Viewing Inspection Information

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, select the case you are working with by clicking the View More Details button.

  3. Click Inspections in the left navigation panel of the case details.

  4. On the Inspections page, you can view inspection information in these fields:

    Page Element

    Description

    Schedule Inspection

    Click to open the Schedule page and use the calendar to select from the dates that the assigned inspector is available for an inspection.

    Note: This option is available only if there are no pending inspections scheduled. The status of all the inspection schedules must be either Completed or Canceled.

    Inspection

    View the number of inspections carried out till date for the case.

    The format of the inspection count is set up by the agency administrator on the Inspection Count page. See Setting Up Inspection Counts.

    Inspection Status

    View the status of the inspection:

    • Completed

    • Scheduled

    • Canceled

    Assigned To

    Identifies the inspector assigned to the case.

    Scheduled Date

    View the date on which the inspection is scheduled.

    Inspection Completion Date

    View the date on which the inspection was completed.

    Inspection Outcome

    View the result of the inspection.

    • In compliance

    • Violation

    • Referral

    • Remains in Violation

    • Issue Citation

    • Remains in Citation

    • Extension

    • Mandatory Abatement

    • Closed

    For more information about submitting inspection results, see Overview of Mobile Oracle Municipal Code Officer.

    Reschedule

    Click to open the Schedule page and use the calendar to select the next available date for the assigned inspector to schedule the inspection.

    Note: This option is available only for inspections that are not completed.

    Canceled

    Click to cancel the inspection schedule.

    Note: This option is available only for inspections that are not completed.

Viewing Inspection Detail

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, select the case you are working with by clicking the View More Details button.

  3. Click Inspections in the left navigation panel of the case details.

  4. On the Inspections page, click View More Details for the inspection record you want to view.

  5. On the Inspection Detail page, you view the details of the inspection along with any comments and attachments included by the inspector at the time of inspection.

  6. To enter a comment, click the Add Comment button to open the Add Comment page. You can add an existing comment or enter a new one. Click Save.

  7. To add an attachment, click the Add button and select the attachment. Enter a description and click Upload.

  8. Close the Inspection Detail page.

Scheduling Inspection

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, select the case you are working with by clicking the View More Details button.

  3. Click Inspections in the left navigation panel of the case details.

  4. On the Inspections page, click Schedule Inspection.

    This option is available only if there are no inspections already scheduled for the case.

  5. On the Schedule page, use the Next Schedule Date field to select a date from the calendar, which shows only those dates that the assigned inspector is available.

  6. Click Save.

    The new schedule is listed in the Inspections page and the Schedule Inspection button is no longer displayed. The assigned inspector receives a notification on his mobile application about the new inspection schedule.

Rescheduling and Canceling Inspection

You can reschedule or cancel an inspection schedule that is not completed.

  1. Select the Worklist tile on the Agency Springboard and click the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, select the case you are working with by clicking the View More Details button.

  3. Click Inspections in the left navigation panel of the case details.

  4. To reschedule, click the Reschedule button on the inspection row.

  5. To cancel the schedule, click the Cancel button on the inspection row.

After you cancel an inspection schedule, you schedule a new inspection using the Schedule Inspection option.

Working with Notices

Once a case is created, a corresponding notice object is automatically created and access is made available in the Worklist and in the case details. As agency staff, you generate a notice from the notice object, update the various details, review, and print it for dispatch.Agency staff can also manually create ad hoc notices for a case.

You can access the notice record using any of the following navigations:

  • Notice of Violation and Notice of Citation tab:

    Agency Springboard > Worklist > Notice of Violation and Notice of Citation. The Generate or Continue option is available in the row. Click View More Details if you want to view the complete details.

  • Case Overview page:

    Agency Springboard > Cases. Select the case you are working with. On the Overview page, scroll down to the Notices section. The Generate or Continue option is available in the row. Click View Details if you want to view the complete details.

  • Notices Page:

    Agency Springboard > Cases. Select the case you are working with. Select Notices in the left navigation panel.

Viewing Notices

You view a list of notice records for the case citation and violation in the case detail pages.

The Notices page shows the list of all notices for the case. You can view the information and perform actions as described here:

Page Element

Description

Notice ID

View the identifier of the notice.

Notice

View the generated name of the notice, based on the nature of violation.

Notice Type

View the type of notice:

  • Ad hoc

  • System generated

Case Status

View the status of the case:

  • Violation

  • Citation

Status

View the status of the notice:

  • Pending: Indicates that the notice object is created.

  • In Progress: Indicates that details are entered in the notice and saved.

  • Generated: Indicates that the notice is generated and printed.

  • Sent: Indicates that the notice has been sent to the responsible party.

  • Received: Indicates that the notice was received by the responsible party.

Sent Date

View the date on which the notice was dispatched.

Tracking Number

View the tracking number associated with the shipment of the notice.

Attachment

Icon to indicate that an attachment is present in the notice.

Received Date

View the date on which the notice was received by the responsible party.

Actions

Select from available options, which are based on the status of the notice:

  • Generate : Click to open the Generate Notice page and enter details to generate the notice. This option is available only for the notice records in Pending status.

  • Continue: Click to open the Generate Notice page and complete the details of the previously saved notice. This option is available only for the notice records in In Progress status.

View More Details button

Click to open the Edit Notice Details page to enter additional details about the notice, such as tracking details.

This option is available only for the notice records that are in Generated, Sent, or Received status.

Creating an Ad Hoc Notice

To manually create an ad hoc notice for a case:

  1. Navigate to the notice record using one of the methods listed in the previous section.

  2. Click the Add button.

  3. On the Add Adhoc Notice page, select an ad hoc notice subtype from the list. You can use the Search option to search for and select the ad hoc notice subtype applicable for the case. Selecting the ad hoc notice subtype returns you to the Notices page.

  4. In the Notices page, you can see the new ad hoc notice listed.

Generating a Notice

You can generate a notice from the Worklist or from case details.

  1. Navigate to the notice record using one of the methods listed in the previous section.

  2. Click the Generate button.

    Note: This option is available only for the notice records in Pending status. If the status is in In Progress, you will see the Continue option. Use this option in case the notice was generated earlier and saved for later.
  3. On the Generate Notice page, the top section shows notice information such as the name, issue type and subtype.

    Note: The sections below for editing notice details and entering tracking details are displayed only when it is relevant to the notice.

    Use the Edit Notice Details section for information on:

    • Verify Details: Enter the compliance date and a description about the violation or citation.

    • Responsible Party and Mailing Address: Click the Add button to search and select a responsible party associated with the violation or citation. You can click the responsible party row to open the Update Responsible Party page and make changes to the contact details.

    • Code Violations: Review the list of code violations added by the agency staff. You can delete one or more code violations. To add them, you should access the Code Violations page.

    Use the Enter Tracking Details section to enter the details of the notice shipment such as the carrier name, tracking number, and any comments.

  4. Click Save Changes. You can close the window and return to the notice at a later time. You can use the Continue button to access this page later.

  5. Click Review and Print. The notice page opens in a new window. You can review the details, print the document, and send it to the responsible party.

  6. Click Done on the Generate Notice page. The status of the notice record changes to Generated and the record is removed from the worklist. You can access the record on the Notices page, which lists all the notices records for the case.

Editing Notice Details

For notices that are in the Generated or Sent status, you can review and update the details.

  1. Select Cases on the agency Springboard.

  2. On the Cases page, click View More Details for the case you are working with.

  3. Select Notices in the left navigation panel. Select the notice row which you want to update.

  4. On the Edit Notice Details page, the top section shows the notice ID, status, notice name and notice type.

    The Tracking Details section allows you to enter the details for sent date, carrier name, mailing cost, tracking number, and the received date.

    The Attachments section allows you to add, view detail, download and delete attachments. Example of an attachment can be a copy of the report that was sent to the responsible party.

Note: The status of the notice changes when you enter the dates for the Sent Date/ Received Date fields and save the page.

Working with Code Violations

Agency staff view, add, and manage code violations associated with a case on the Code Violations page. You add one or more code violations to a case based on the specific code used on a violation.

In addition to the code violations included by the system based on the incident issue type, inspectors add code violations during their inspection using their mobile device.

Agency staff such as a code technician manage the code violations using the Code Violations page in case details. For more information on mobile inspections, see Overview of Mobile Oracle Municipal Code Officer.

Viewing Code Violations

View a list of code violations that were added by the inspector and the technician, along with their corrective actions to resolve the violation.

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, click View More Details for the case row you want to access.

  3. Click Case Information and then select Code Violations in the left panel to open the list of code violations.

  4. Expand each code violation record to view the description and the related corrective actions.

  5. As agency staff you can use the Edit icon to modify the summary and descriptions for violations. You can also modify the description for corrective actions. The Description field enables you to use Rich Text formatting options for the text you enter. Use the Delete icon to delete a violation and its corrective action.

Adding Code Violations

You add code violations to a case using the Select Codes page.

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

  2. On the Cases page, click View More Details for the case you are working with.

  3. Click Case Information and select Code Violations in the left panel to open the list of code violations.

  4. Click the Add button to open the Select Codes page, search, and select violations .The Selections tab shows the code violations you have selected:

    Page Element

    Description

    Current violation and Other violations

    • Current violation: View a list of code violations associated with the issue subtype that was selected at the time of recording the issue or violation.

    • Other violations: View a list of all the code violations in the system.

    Search look-up

    Search by entering the name of a specific code violation using the look-up.

    Select one or more code violations using the check boxes and click Done to include them in the case.

  5. Click Done to add the selected violation to the case and return to the Code Violations page.

Working with Comments

This topic discusses how to use comments. You can view, edit, and add comments on the Comments page for a transaction, case, or incident.

Adding Comments

You view, edit, and add new comments on the Comments page. Three categories of comments are available for use:

  • Favorite comments: Mark comments you use regularly as your favorite and access them easily on the Favorite comments tab

  • Standard comments: Select and post a comment from a list of pre-defined comments on the Standard comments tab.

  • Recent comments: Select and post comments from a list of recently posted comments on the Recent comments tab.

Viewing and Editing Comments

  1. Access the detail page for the transaction, case, or incident you are working with.

  2. Click the Comments link in the left panel to view the Comments page.

    You view a list of comments in the right panel. If more information exists for a comment, click the More link to show the complete detail of the comment. Use the Less link to shrink the comment area back to its original size.

  3. You can edit, delete, or hide a comment from public view only if it was entered by you. Click the specific comment row to open the detail view and make changes.

  4. Click Save.

Adding a New Comment

  1. Access the detail page for the transaction, case, or incident you are working with.

  2. Click the Comments link in the left panel to view the Comments page.

  3. Click the Add Comment button to open the Add Comment page and enter a new comment. You can use the Rich Text Editor option for formatting your comment with tools such as the numbered list. The Link button allows you to embed a URL to a display text you enter. See Managing Comments to enable the option of Rich Text Editor formatting.

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

Adding Favorite, Standard, and Recent Comments

  1. You can post a comment that is already available in the system. On the Add Comment page, click the Select Comments button to view the three categories of comments:

    • Favorite: Comments that you have marked as favorite.

    • Standard: All the predefined comments available.

    • Recent: Comments that were recently posted.

  2. Select a comment 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 administrator 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 Attachments

You view a list of files and upload or download documents associated with a transaction, such as a permit, planning application, case, or business license on the Attachments page.

Attachments provide supporting documentation needed by agency staff when processing transactions.

You can manage attachments associated with a transaction on different pages in Oracle Public Sector Compliance and Regulation. Here’s a look at some of the areas that include attachment functionality:

  • The Attachments page in the transaction detail pages, including pages for permits, planning applications, cases, and business licenses.

  • The Workflow page in the transaction detail pages.

  • Inspection Detail and Checklist pages in Oracle Inspector.

  • New Violation and Inspection pages in Oracle Municipal Code Officer.

Recipients of transaction communications containing web forms can upload files when requested. You can also manage documents as part of the plan review process.

These are all sources of attachments that you’ll find associated with a transaction on the Attachments page.

For more information about managing attachments for a workflow task, see Using Workflow.

For more information about attachments in Oracle Inspector, see Overview of Mobile Oracle Inspector for Permits.

For more information about Oracle Municipal Code Officer, see Overview of Mobile Oracle Municipal Code Officer.

Viewing Attachments

To view a list of attachments:

  1. Access the detail page for the transaction where you want to view attachments.

  2. Click the Attachments link in the left panel to view the Attachments page.

    You may need to expand the section that includes the Attachments link.

  3. On the Attachment page, view the list of attachments.

    For permits, the attachments are displayed on two tabs. The Permits tab displays attachments added through the Attachments page. The All tab displays attachments added from all sources, including the Attachments page, the Workflow page, Oracle Inspector, plan reviews, and web form responses.

    Page Element

    Description

    File Name

    View the following information in the Filename field:

    • Icon indicating the file type

    • Filename with file type extension

    • File Size

    Description

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

    Source

    View the source of the attached file. Valid values are:

    • Permits

    • Inspection

    • Workflow

    • Plan Reviews

      Attachments that are added to electronic plan reviews have their source changed from Permits to Plan Reviews.

    For example, attachments added through Oracle Inspector display Inspection in this field.

    Attachments added to web form questionnaire responses display Permits in this field.

    Note: This column appears only on the All tab for permits.

    Uploaded By

    View the name of the person who uploaded the file along with the date and time that the person uploaded the file.

    Category

    View the document category for the attachment.

    The category is available when a document group is specified during setup for the transaction type.

    Note: This field in not available for case and business license attachments.

    Actions

    Click the actions icon to select and perform an action:

    • View Details

    • Download

    • Delete

    Note: For permits, the Delete action appears only on the Permits tab. Additionally, the security associated with your user ID may limit which actions are available to you.
  4. Click the Sort By to view attachments grouped by these fields: file name, file size, uploaded by, uploaded on, description, category, and subcategory.

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

Adding Attachments

You upload files to the Attachments page using the Add Attachments page. For permits, you use the Permits tab of the Attachments page.

To add attachments:

  1. Access the detail page for the transaction where you want to add attachments.

  2. Click the Attachments link in the left panel to view the Attachments page.

    You may need to expand the section that includes the Attachments link.

  3. Click the Add icon.

    Note: For permits, this icon appears only on the Permits tab.
  4. Select the file to upload in the browser dialog box and click Open.

    The filename appears on the Add Attachments page.

  5. On the Add Attachments page, optionally enter a description of the file.

  6. If the Category and Subcategory fields appear on the Add Attachment page, optionally select a document category and subcategory.

    These fields appear if the transaction type is associated with a document group. The document group defines the available values in these fields.

    For more information, see the implementation documentation for Setting Up Document Categories and Subcategories.

    Note: The document group for a transaction is based on the document group that was defined for the transaction type at the time the transaction is saved.
    Note: Document category and subcategory are not applicable to case attachments.
  7. Click the Upload button.

    The Add Attachment window closes, and the newly uploaded attachment appears on the Attachments page.

Viewing Attachment Details

To view document details on the Attachments details page:

  1. Access the detail page for the transaction where you want to view attachment details.

  2. Click the Attachments link in the left panel to view the Attachments page.

    You may need to expand the section that includes the Attachments link.

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

  4. Select View Details to open the document details page.

    The details on this page include the information from the Attachments page and information about the file size and the person who last updated the document information.

    Editable fields include the description and, if available, the document category and subcategory.

Downloading Attachments

To download an attachment from the Attachments page:

  1. Access the detail page for the transaction where you want to download attachments.

  2. Click the Attachments link in the left panel to view the Attachments page.

    You may need to expand the section that includes the Attachments link.

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

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

Deleting Attachments

There are multiple ways to delete attachments. The security associated with your user ID determines whether you can delete attachments.

Note: For permits, you can delete attachments only from the Permits tab of the Attachments page.

To delete selected attachments from the Attachments page:

  1. Access the detail page for the transaction where you want to delete attachments.

  2. Click the Attachments link in the left panel to view the Attachments page.

    You may need to expand the section that includes the Attachments link.

  3. Click the Edit icon above the grid.

  4. Select one or more documents to delete.

  5. Click the Delete icon.

To delete a single attachments from the Attachments page:

  1. Access the detail page for the transaction where you want to delete attachments.

  2. Click the Attachments link in the left panel to view the Attachments page.

    You may need to expand the section that includes the Attachments link.

  3. In the attachments grid, click the Action icon for the document you want to delete.

  4. Select Delete from the action menu.

Working with Appeals and Hearings

Agency staff can request an appeal on behalf of the responsible party, for a violation or citation that the responsible party has received. The details of the requested appeals, their hearing schedules, and decisions can be seen in the case details — Appeals and Hearings page.

Registered public users can request appeal for their case as a responsible party, using the Resolve Issue page. Permissions to access the case is issued by the agency staff after the user requests access. For information about registered users requesting access and requesting appeals, see Resolving Issues.

Viewing Appeals and Hearing Decisions

  1. Select the Worklist tile on the Agency Springboard and select the Appeals tab. This page lists only the cases that are appealed. Click View More Details for the case row you want to access.

    Alternatively, you can access the Appeals and Hearings page by selecting the Cases tile on the Agency Springboard. Click View More Details for the case you are working with. Click Case Information and select Appeals and Hearings in the left panel.

  2. The Appeals and Hearings page lists all the appeals and hearings for the case:

    Page Element

    Description

    Appeal Type

    View the type of appeal that was requested:

    • Violation

    • Citation

    Appellant

    View the name of the responsible party.

    Status

    View the status of the appeal:

    • Not Scheduled: The hearing is not scheduled.

    • Scheduled: The hearing is scheduled.

    • Completed: The hearing is completed with a decision outcome.

    Hearing Date

    Shows the scheduled date of hearing.

    Hearing Decision

    View the hearing decision, if completed:

    • Compliance: The property related to the case is in compliance.

    • Violation: The property related to the case is in code violation.

    • Citation: The property related to the case is in code violation and an associated citation fee must be paid.

    Note: You can request an appeal for the hearing decision recorded. The number of times an appeal can be requested for a case is set up by your administrator on the Time Rule setup page. See Setting Up Time Rules.

    Actions

    Click to view the actions you can perform on the appeal record:

    • Reschedule: Select to open the Appeal Violation or Appeal Citation page and select a new available date for the hearing. This option is available only if the appeal is in Scheduled status.

    • Update Decision: Select to open the Appeal Violation or Appeal Citation page and change the decision-related field values. For more details, see the section Updating Hearing Decision.

    • View Details: Select to open the Appeal Violation or Appeal Citation page and view the details of the completed appeal. This option is available only for completed appeals.

Requesting an Appeal

You can request an appeal only if there is no active appeal for the case. The time period within which you can request an appeal is determined by your administrator and is set up in the Time Rules page. For more information about time rules, see Setting Up Time Rules.

  1. Select the Cases tile on the Agency Springboard.

  2. On the Cases page, click View More Details on the case for which you want to request an appeal.

  3. Click Case Information and select Appeals and Hearings in the left panel to open the list of appeals and hearings.

  4. Click Request Appeal. The Appeal Violation or Appeal Citation page opens, depending on the status of the case — Violation or Citation.

    Page Element

    Description

    Appellant

    View the name of the responsible party.

    Appeal Reason

    Enter the reason for requesting the appeal.

    Hearing Date

    Select a date for the hearing.

  5. Click Save. The new appeal for the citation or violation is created and any inspection for the case is canceled.

Updating Hearing Decision

  1. Select the Worklist tile on the Agency Springboard and click the Cases tab.

    You can also navigate using the case list. Select Cases on the Agency Springboard to view a list of all cases. On the Cases page, click View More Details for the case you are working with. Click Case Information and select Appeals and Hearings in the left panel to open the list of appeals and hearings.

  2. Click the Action button on the row of the appeal you are working with.

  3. Click Update Decision.

    Note: This option is not available for a completed appeal row.
  4. Enter decision related information on the Appeal Violation/Citation page:

    Page Element

    Description

    Appellant

    View the name of the responsible party.

    Appeal Reason

    Update the reason for requesting the appeal.

    Hearing Date

    Select a date for the hearing.

    Hearing Decision

    Select the hearing decision that was taken:

    • Citation/Violation: Continues to be in violation or citation, according to the status of the case.

    • Compliance: There is no code violation, the case is in compliance.

    Decision Date

    Enter the date on which the hearing decision was taken.

    New Compliance Due Date

    Enter the new compliance date, if the hearing decision is Citation/Violation.

    New Citation Due Date

    Enter the due date for the payment of citation fees, if the decision is Citation.

  5. Click Save.

Adding Responsible Parties

Agency staff add and manage responsible parties related to a case.

Viewing Responsible Parties

  1. Select the Code Technician Worklist tile on the Agency Springboard and then select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, select the View More Details button for the case you are working with.

  3. Click Responsible Parties in the left panel to view the Responsible Parties page for the case.

    Page Element

    Description

    Responsible Party

    View the name of the party responsible for the reported violation.

    Mailing Address

    View the address of the responsible party.

    You can view the location of the address on a map at the top of the page.

    Email

    View the email address of the responsible party.

    Type

    View the type of the responsible party. For example, owner.

    Online Access Status

    Displays the status of the online access that was requested by the responsible party:

    • Not Requested

    • Pending Approval

    • Issued

    • Denied

    Actions

    Select from these options to allow or deny access to responsible parties for this case:

    • Allow Access as Owner

    • Allow Access as Contact

    • Deny Access

    These options are available only if a responsible party has requested access to this case. Once the access is issued, the responsible party can access their case details using the Resolve Issue page and take actions such as submitting appeals. See Resolving Issues.

    Note: These actions are also available to the assigned code technician on the Access Requests tab in the Code Technician Worklist.
  4. To view more information about the online access activity, click View Details for the responsible party record.

    The detail page shows the Online Access section only if the responsible party has requested for online access, using the Resolve Issue page.

Adding Responsible Parties

  1. Select the Code Technician Worklist tile on the Agency Springboard and then select the Cases tab.

  2. On the Cases page, select the View More Details button for the case you are working with.

  3. Click Responsible Parties in the left panel to view the Responsible Parties page for the case.

  4. Click the Add button to open the Search Responsible Party page and search the required parcel.

  5. Click Select.

  6. Click Save.

    Note: Presently you can add only one responsible party to a case.

Updating Responsible Party Detail

  1. Select the Code Technician Worklist tile on the Agency Springboard and then select the Cases tab.

  2. On the Cases page, select the View More Details button for the case you are working with.

  3. Click Responsible Parties in the left panel to view the Responsible Parties page for the case.

  4. Click the row of the responsible party to update the details.

  5. On the Edit Responsible Party page, you can change values for all fields except for the Type and Country.

    To enter an address, begin by entering the Postal Code. As you enter the code, the type-ahead list shows values that include appropriate state and city combinations. After you select a value, the city and state appear as read-only fields, and two address fields appear so that you can enter the rest of the address.

    If you don’t know the postal code, click the Don’t know link that appears when the postal code field is blank. Clicking this link displays a full set of address fields.

  6. Click Save.

Deleting Responsible Party

  1. Select the Code Technician Worklist tile on the Agency Springboard and then select the Cases tab.

  2. On the Cases page, select the View More Details button for the case you are working with.

  3. Click Responsible Parties in the left panel to view the Responsible Parties page for the case.

  4. Click the row of the responsible party.

  5. On the Edit Responsible Party page, click the Delete button. You are prompted to confirm the deletion.

Working with Citations

A code enforcement inspector issues a citation as a result of inspection related to a code violation. Citations can also be issued by agency staff such as a code technician using the Citations page in case details. A fee amount associated with each citation record is created, the details of which are listed in the Fees and Payments page.

Viewing Citations

You view a list of all citations issued for a case on the Citations page.

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, click View More Details for the case row you want to access.

  3. Click Citations in the left panel to open the list of citations.

    Page Element

    Description

    Citation ID

    View the identifier of the citation.

    Description

    View the description of the citation as entered at the time of issuing the citation.

    Comments

    View comments entered at the time of creating the case.

    Due Date

    View the due date for paying the citation fee.

    Created By

    View the name of the agency staff who created the case.

  4. Click a citation record if you want to open the detail view of the citation.

Issuing a Citation

Agency staff such as a code technician can issue a citation for a case on the Citations page.

  1. Select the Worklist tile on the Agency Springboard and click the Cases tab.

  2. On the Cases page, click View More Details for the case you are working with.

  3. Click Citations in the left panel to open the citations list page.

  4. Click the Issue Citation button to open the Issue Citation page and enter values for the fields:

    Page Element

    Description

    Description

    Enter a description about the citation.

    Due Date

    Enter the due date by which the citation fee must be paid.

    Comments

    Enter any optional comments related to the citation.

Once a citation is issued, a corresponding citation fee amount is calculated and the fee record is created in the Fees and Payments page. Fee amounts are calculated based on the fee schedule set up on the Issue Subtype page. For details, see Setting Up Issue Subtypes.

For details about a code enforcement inspector issuing citation using a mobile device, see Overview of Mobile Oracle Municipal Code Officer.

Working with Citation Fees and Payments

You view and manage citation fees and payments associated with a case on the Fees and Payments page in the case details.

Viewing Fees and Payments for a Case

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, click View More Details for the case row you want to access.

  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 case.

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

    Page Element

    Description

    Fee Item

    The identifier of the fee.

    Fee Reference ID

    The identifier of the fee.

    Amount

    The amount due for the fee.

    Note: Fee amounts are calculated based on the fee schedule set up on the Issue Subtype page. For more information, see Setting Up Issue Subtypes.

    Currency

    The currency in which the fees are paid.

    Status

    • Paid

    • Due

    Due Date

    The date by which the payment must be made.

    Assessed Date

    The date on which the fee was assessed.

    Payment Date

    The date on which payment was received.

    Payment Reference ID

    The identifier of the payment.

    Pay button

    Pay buttons are displayed, when you have fee items due for payment.

    Click the Pay button to access the Checkout page.

    A Pay button available on each row allows you to make the payment for the particular fee item. To make the full payment that includes all the fee items due, click the Pay button next to Balance Due.

Note: Presently the code enforcement fee module supports the configuration of only one fee item for each fee decision model. See Setting Up Fee Schedules.

Viewing Fee Item Details

  1. Select the Worklist tile on the Agency Springboard and click the Cases tab. Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, click View More Details for the case row you want to access.

  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 case.

  4. On the Fees and Payments page, select the fee item for which you want to view details.

  5. On the Fee Item Details page, view additional information about the fees including department, assessed date, created by, and last updated by.

Note: Code technicians can make citation payments on behalf of the responsible party by using the I want toPay Citation option on the Agency springboard.

Adding an Ad Hoc Fee Item

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, click View More Details for the case row you want to access.

  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 case.

  4. On the Fees and Payments page, click Add (+ button) to add an ad hoc fee item.

    Page Element

    Description

    Fee Item

    Search and select a fee item.

    If a Fee Item is associated with a department, then the Department field gets automatically populated when you select the fee item.

    Amount (USD)

    Enter the amount for the ad hoc fee.

    Status

    • Canceled

    • Due

    • Suspended

    • Pending (Default selection)

      Fee items with a status of Pending are not added in Balance Due in the Fees and Payments page.

    • Paid

    Department

    The department that calculates the fee amount.

    Assessed Date

    The date on which the fee was assessed.

    Due Date

    The date by which the payment must be made.

    Comments

    Add comments pertaining to this fee item.

  5. Click Save to save the changes.

Paying Citation Fees

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, click View More Details for the case row you want to access.

  3. Click Fees and Payments in the left panel.

  4. Click the Pay button to access the Checkout page.

    Use the Pay button in each row to individually pay for each fee item, or use the Pay button next to the Balance Due to pay all balance fees together.

  5. Click the Information icon next to the Total Amount to Be Paid to preview the fee items before making the payment.

  6. Depending upon the agency’s payment integration setup, various modes of payment are available, such as Credit Card, Debit Card, PayPal or Cash. Choose the payment method and click the Make Payment button to access the Payment Details modal.

  7. Verify details on the Payment Details page and click Done.

  8. The Cash Drawer page shows the details of the transaction. Click Save to save the changes and go to the Payment Successful page.

  9. Click the Print Receipt button to print the payment receipt.

  10. Click the Back link to return to the Fees and Payments page.

  11. In the Fees and Payments page, Payment Reference IDs are generated for the paid fee items. Click the link to view a receipt with details such as, receipt number and date, reference number, amount paid, item details, and payment method.

Working with Case History

You can track the history of changes made to the case attributes such as the status and the compliance date. Whenever the status or compliance date changes for a case, the change is recorded and is viewable in the details for the case on the Case History page.

Reviewing the Status History

  1. Select the Worklist tile on the Agency Springboard and select the Cases tab.

    Alternatively, you can select the Cases tile on the Agency Springboard to view all the cases in the system.

  2. On the Cases page, click View More Details for the case row you want to access.

  3. Click Case History in the left panel to view the Case History page for the selected case.

    Page Element

    Description

    Date and Time

    View the date and time when the change was made to the case attribute.

    Updated Attribute

    View the attribute that was updated, such as the compliance date or the status.

    Trigger

    View the trigger action that resulted in this change. For example, a manual update or a citation issued.

    Modified By

    View the name of the agency staff who updated the attribute value.

    Old Value

    View the attribute value before the change was made.

    New Value

    View the new value of the attribute that was saved.

    Reason

    View the reason for the change in value that was entered at the time of update.

    View More Details button

    Click to view the details of the change on the Case History page.