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 Code Technician 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 Code Technician Worklist

  1. From the agency springboard, click the Code Technician 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 Code Technician 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 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. 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 Code Technician Worklist — Cases page. You must 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, Closed, Compliance, Violation, Void, Mandatory Abatement and Legal.

    For details about the options, see Viewing the Case Detail Overview.

    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 in the Code Technician Worklist. 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.

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:

    • Violation

    • Closed

    • Compliance

    • Void

    • Mandatory Abatement

    • Legal

    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.

    If the new status is Violation or Citation, you select the new compliance date. The system allows you to generate a new notice and any applicable citation fee, and a corresponding inspection is scheduled. Selecting the Legal status cancels the scheduled inspections and no new inspection, appeal, or hearing can be scheduled.

    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.

    Appeal By

    Indicates the last date by which a user is allowed to submit an appeal for the case.

    An Edit link is available for a supervisor to change the appeal due date. Click the Edit link to open the Update Appeal by Date page, use the calendar to select a new date, and enter a reason for the update. Click Done.

    Note: The Edit link is displayed only after the compliance date is set.

    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. In the Inspections section shows the next inspection due date.

    See Using the Code Officer Worklist.

  6. 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 Timeline

With case timeline, you can view all the Code Enforcement activities associated with a particular case in a chronological order. You can drill down for additional information for each event or filter the timeline to show by event types.

The Case Timeline shows a list of code enforcement case events in a chronological order with the newest on top. The event types include:

  • Incident reported

  • Inspection

  • Case created

  • Case updated

  • Appeal

  • Hearing

  • Fee paid

  • Notice

Viewing a Case Timeline

The Timeline page shows the list of all the time-based events for the case. You can view the case timeline and perform actions on the Timeline 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 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 Timeline in the left panel to open the list of case events.

Page Element

Description

Filter button

Filter the cases based on event types, such as, All, Appeal, Case created, Hearing, Case updated, Inspection, Notice, Fee paid and Incident reported.

Print button

Print a copy of the current timeline.

Download button

Download the case events to an Excel spreadsheet.

Show List View button

Display the case events in a list view. The details displayed include the date and time, the event type, case status, name of the agent who created or updated the event, and the reason or description of the event. Click the chevron at the end of each row to go to the Case Overview page.

Show Timeline View button

Display the case events in a horizontal timeline view. The date range is set to start from 30 days before the initial event and to end 30 days after the last event.

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 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. 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 Code Technician 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 Code Technician 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.

Viewing Cases Associated with a Parcel

Agency staff can view summary of cases that are associated with a parcel on the Transactions page, Cases tab.

For more information, see Viewing Transactions Associated with a Parcel.

Using Workflow

Workflow provides a defined structure for the business licenses, permits, planning applications, and code enforcement life cycles. 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 don't 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 and update the status of the workflow task to indicate the result, such as setting the status to Complete. 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

Workflow tasks are defined in workflow process definitions within Oracle Integration Cloud (OIC). Agency staff manages these tasks using the Workflow page in the details of a business license, permit, planning application, and code enforcement – incident or case page.

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.

Note: You can view the workflow information for applications currently being processed as well as completed applications, if needed.

Managing Workflow Tasks

Use the Workflow page to see past and current workflow tasks and to manage task assignments, status, priority, and comments.

For Code Enforcement – Incident and Case, the Workflow pages give a two-panel view which can further be toggled between a stage view and a milestone view.

For other applications like Business Licenses, Permits and Planning Applications, the Workflow page gives 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.

Using the Stage View or Milestone View in Workflow for Code Enforcement

The Code Enforcement – Incident and Case Workflow pages display in a two-panel view, with a Task panel and Task Details panel. The two-panel view can further be toggled between a stage view and milestone view. In the stage view, the agency staff gets a quick indication of the number of stages in the workflow as buttons at the top of the page. You can click a stage to view details in the task panels below.

In the milestone view, the agency staff can see a time line of tasks and dates on which they were completed for the selected incident or case at the top of the page. Details are displayed in the task panels below. By default, the Code Enforcement – Incident and Case Workflow pages display a stage view.

To access Incident or Case Workflow page in the two-panel, stage view:

  1. Select the Incidents or Cases tile on the Agency Springboard.

  2. Click the row for the incident you want to view. Or click the View Details button for the case you want to view.

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

    By default, the Workflow page for Code Enforcement displays stage view, showing the two-panel view below.

    This example illustrates the Code Enforcement – Case Workflow page in a two-panel, stage view.

    Case workflow - Stage view

    Page Element

    Description

    Stage View and Milestone View icons

    Use these buttons to toggle between the stage and milestone views.

    Stages

    Click the stage buttons at the top of the Workflow page to open the tasks associated with it in the task panels below.

    The names of these stages and their labels are displayed as configured in the Oracle Integration Cloud (OIC) that are defined by the agency. The stages are represented in different colors to show their status:

    • Blue: Active

    • Green: Completed

    • Gray: Not active or Terminated

    You can click the buttons in the active and completed stages to view their details in the Task Details panel.

    Examples of stages that appear in an incident's workflow include Reported, Inspection, Violation, Legal, and Closed.

    Terminate Workflow

    Click this button to stop or terminate a workflow.

    Once a workflow has started, the Terminate Workflow button allows an agency staff to stop the workflow at any stage without completing the remaining tasks. This action terminates or cancels all the tasks in the workflow, even if it was open for an agency staff.

    Note: You cannot activate a terminated workflow.

    Form

    Use the form to review any information entered by the code enforcement officer or to enter your own information.

    Code Enforcement – Incident and Case Workflow pages have an option to include a form or a checklist in the Task Details panel. The agency can customize the form for their specific requirement.

To access the Incident or Case Workflow page in the two-panel, milestone view:

  1. Select the Incidents or Cases tile on the Agency Springboard.

  2. Click the row for the incident or case you want to view.

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

    The Workflow page appears on the right side of the page.

  4. By default, the stage view is displayed. Click the Milestone View icon to toggle the view.

This example illustrates the Code Enforcement – Case details workflow page in a two-panel, milestone view.

Case workflow - Milestone view

Page Element

Description

Stage View and Milestone View icons

Use these buttons to toggle between the stage and milestone views.

Milestones

Displays the milestone tasks and the date on which they were completed for the selected incident. Examples of milestone tasks that appear in an incident's workflow include Start, Incident Reported, and Inspection Schedule.

Terminate Workflow

Click this button to stop or terminate a workflow.

Once a workflow had started, the Terminate Workflow button allows an agency staff to stop the workflow at any stage without completing the remaining tasks. This action terminates or cancels all the tasks in the workflow, even if it was open for an agency staff.

Note: You cannot make a terminated workflow active again.

Form

Use the form to check or enter information as specified by the agency.

Code Enforcement – Incident and Case Workflow pages have an option to include a form or a checklist in the Task Details panel. This form is customizable by the agency to cater to their specific requirement

Using the Two-Panel View in Workflow for an Application

To manage workflow tasks in a two-panel view:

  1. Select the Business Licenses, Permits, Planning Applications, Incidents, or Cases tile on the Agency Springboard.

  2. Click the row for the business license, permit, planning application, incident or case you want to view.

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

    Note: By default, the Workflow page displays the list view for Permits, Planning and Zoning, and Business Licenses.
  4. Click the Show Two-Panel View button to display the two-panel view.

    This example illustrates the Permits Workflow page in a two-panel view.

    Permits workflow - two-panel view

    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.

    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.
  5. Select a workflow task from the left frame to see details in the right frame.

  6. Review read-only task information.

    These fields can’t be updated 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.

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

  8. 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,Planner Assigned,Specialist Assigned, 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.

  9. 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. Processing time can vary.

Using a Form in Code Enforcement – Incident and Case Workflow Pages

Code Enforcement – Incident and Case Workflow pages have an option to include a form or a checklist in the Task Details panel. The agency can customize the form for their specific requirement.

An example of an incident task having a form can have the following checkpoints for the agency staff:

  • Check if Repeat Offender

  • Send Courtesy Notice

An example of an abatement task having a form can have the following checkpoints for the agency staff:

  • Schedule Inspection Post Abatement

  • Add Fee

  • Send Notice

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

Requesting Additional Information

If additional information is required or questions need to be answered prior to advancing a transaction along in the workflow, you can click the Request Info button. This disables the Status and the Priority fields to keep the transaction in the current state while the requested information is reviewed. After clicking the Request Info button, the name of the button toggles to Accept Info, which you click after you have reviewed the additional information submitted to enable the Status and the Priority fields again.

After clicking Request Info, the status of the current workflow task reads Information requested until you click the Accept Info button. The status appears on the Workflow tab in the transaction details, the Worklist, and the Task Management page.

Note: The Request Info and Accept Info buttons are optional to display, and also note that Request Info and Accept Info are the default labels for the buttons. You can add your own labels if needed, depending on the task. You can hide and provide custom labels using custom properties in the workflow process definition for any human task. For more information on workflow process definition custom properties, see Using Custom Properties.

Viewing the Overall Workflow (List View) 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 case of system outage, user error, and so on.

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. You can't alter a workflow step back to a pending status.

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

    Note: Click View Workflow, if you need to review the steps and swimlanes in the underlying workflow process diagram as defined in OIC. This displays an image of the entire workflow process diagram you can view.
  6. Click Save.

    Note: If the alter request is not successful, supervisors have the option to redo the alter request and try again.

A workflow process definition may contain one or more parallel tasks. Parallel tasks:

  • Do not depend on each other to be completed.

  • Can be completed simultaneously.

In the case of parallel tasks, the Alter Workflow tab displays each applicable parallel task for you to alter the workflow status accordingly for each.

For example, if a workflow process for a given transaction, requires a Plan Approval and a Structural Approval to occur in parallel, then the Alter Workflow tab displays those two tasks together.

This example illustrates a workflow process definition with parallel tasks.

Workflow process definition with parallel tasks

This example illustrates the Alter Workflow tab displaying parallel tasks.

Alter Workflow dialog box showing parallel tasks

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 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. 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 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. 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 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. 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 Code Technician 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 Code Technician Worklist and in the case details. As agency staff, you generate a notice from the notice object, update the various details, review, edit, 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 > Code Technician 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 Ad Hoc 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 Code Technician 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.

    The middle section has the following page elements:

    Page Element

    Description

    Do you want to edit the notice?

    Turn on this switch, to download and edit a generated notice.

    Download and Edit

    Click this button to download the generated notice in the rich text format (RTF) or in a portable document format (PDF).

    Upload Edited Document

    Click this button to re-upload an edited notice either as RTF or PDF.

    Review and Print

    Click this button to open the generated notice in a new window. You can review the details, print the document, and send it to the responsible party.

    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 Complete 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 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. 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 Code Technician 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. Agency staff can view, modify, and add comments on the Comments page for a transaction, contractor license, case, or incident.

Note: Applicants and contacts can view and add comments to their own permits as well as update and delete the comments they added. Before contacts can manage comments, your agency must add the PSC Contact User duty role (ORA_PSC_CONTACT_USER_DUTY) to the PSC Custom Registered Public User role (CUSTOM_PSC_REGISTERED_PUBLIC_USER) and enable permit access for the contact type.

Adding Comments

You view, modify, 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 Modifying Comments

  1. Access the detail page for the transaction, contractor license, 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.

  3. You can modify, 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, contractor license, 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 Hide from Public icon, to hide a comment from public view and also toggle between hide and show.

    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 display the text you enter. See Managing Comments to enable the option of Rich Text Editor formatting.

  4. Click Save 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 * (asterisk) 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 or record, such as a permit, planning application, case, business license, or contractor license on the Attachments page.

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

Note: Applicants and contacts can view and add attachments to their own permits as well as update and delete the attachments they added. Before contacts can manage attachments, your agency must add the PSC Contact User duty role (ORA_PSC_CONTACT_USER_DUTY) to the PSC Custom Registered Public User role (CUSTOM_PSC_REGISTERED_PUBLIC_USER) and enable permit access for the contact type.

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 or record detail pages, including pages for permits, planning applications, cases, business licenses, and contractor 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 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.

For more information about managing attachments associated with a contractor license, see Managing Contractor License Details.

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.

    Note: The page elements may vary on the Attachments page depending on the type of transaction or record.

    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 and Subcategory

    View the document category for the attachment.

    The category and subcategory are available when a document group is specified during setup for the transaction type or in the contractor license options.

    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 Deleteaction 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 file name 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. For contractor licenses, you can update the referenced person in the Assigned To field.

Downloading Attachments

There are multiple ways to download attachments.

To download 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 Select Multiple icon above the grid.

  4. Select one or more documents to download.

  5. Click the Download icon.

To download a single 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 Select Multiple 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.

Code officers such as a code technician can directly schedule hearings for a case, independent of appeals.

Viewing Appeals and Hearings

  1. Select the Code Technician Worklist tile on the Agency Springboard and select the Hearings tab. This page lists only the cases that are appealed, with a hearing schedule. 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

    Source

    Review the details of the record:

    • Source – Appeal or Hearing

    • Responsible Party

    • Date of creation

    Hearing Body

    Review the name of the hearing body that is assigned to the case hearing.

    Hearing Date

    Review the date on which the hearing is scheduled.

    Status

    View the status of the hearing:

    • Not Scheduled: The hearing is not scheduled.

    • Scheduled: The hearing is scheduled.

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

    Responsible Party

    Review the name of the responsible party for the case.

    Attachments

    View attachments related to the hearing.

    Actions

    Click to view the actions you can perform on the record, which are based on the status of the case – Hearing or Appeal:

    • Schedule Hearing: Select to schedule a hearing by selecting a hearing body and an available date.

    • Reschedule Hearing: Select to change the hearing date.

    • Update Hearing Decision: Select to enter the decision made in the hearing and add corrective actions.

    • Cancel: Click to cancel the appeal or hearing.

Adding 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 Add Appeal. The Add Appeal page opens.

    Page Element

    Description

    Appellant

    View the name of the responsible party.

    Appeal Date

    View the appeal date, which is the current date.

    Appeal Reason

    Enter the reason for requesting the appeal.

  5. Click Save. The new appeal for the case is created with a case status of Appeal, and any scheduled inspection is canceled.

Adding a Hearing

You can directly schedule a hearing for a case, without an appeal request. To add a hearing:

  1. Access the Appeals and Hearings page.

  2. Click Add Hearing to open the Schedule Hearing page.

    Page Element

    Description

    Appeal Source

    View the source of the appeal, which is Hearing

    Hearing Body

    Select the hearing body from the available list.

    Hearing Date

    Select a hearing date from the available options, which is determined by the schedules of the hearing body and the agency.

    Responsible Party

    View the name of the responsible party related to the case.

  3. Click Save. The new hearing for the case is scheduled with a case status of Hearing, and any scheduled inspection is canceled.

Updating Hearing Decision

After the public hearing is completed and the hearing body announces their decision, the assigned code technician updates the decision in the case details using the Appeals and Hearings page.

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

    Select the Code Technician Worklist tile on the Agency Springboard and select the Hearings tab. This page lists only the cases that are appealed, with a hearing schedule. Click Actions and select Update Hearing Decision.

    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 or hearing you are working with and click Update Hearing Decision.

    Note: This option is not available for a completed appeal row.
  3. Enter the decision related information on the Update Hearing Decision page:

    Page Element

    Description

    Hearing Body

    View the name of the hearing body assigned for the hearing.

    Hearing Date

    Select an available date for the hearing.

    Responsible Party

    View the name of the responsible party for the case.

    Hearing Decision

    Select the hearing decision from options set up by your administrator.

    Examples of decision options can be Compliance, Not in Compliance, Continue, No Outcome, and others.

    If you select the option related to non compliance, you must change the status of the case in the New Case Status field.

    Decision Date

    Enter the date on which the hearing decision was taken.

    New Case Status

    Select the new status for the case:

    • Legal

    • Violation

    • Citation

    • Mandatory Abatement

    This option appears if you have selected the Not in Compliance hearing decision.

    If the new status is Violation or Citation, you select the new compliance date. The system allows you to generate a new notice and any applicable citation fee, and a corresponding inspection is scheduled. Selecting the Legal status cancels the scheduled inspections and no new inspection, appeal, or hearing can be scheduled.

    Depending on the status you select, the workflow stages and their tasks are accordingly updated.

    Comments

    Enter any text for reference.

    New Compliance Due date

    Select a date by which the responsible party must ensure compliance. This option appears if the new status of the case is violation or citation.

    New Citation Due date

    Select a date by which the responsible party must pay the citation fee. This option appears if the new status of the case is citation.

    Corrective Actions

    Click Add to open the Corrective Actions page, search and select one or more corrective actions from a list. You can edit the description of each of the actions using the Rich Text formatting option.

    Attachments

    Click Add to open the Attachments page and include any documents.

  4. Click Save to close the Update Hearing Decision page and show the updated records on the Appeals and Hearings page. Depending on the options selected, the status of the case changes and the workflow stages and their tasks are updated. See Using Workflow.

    Also, an inspection is scheduled as needed, a citation record is created, and a notice is sent to the responsible party. See Working with Code Enforcement Inspections, Working with Notices, and Working with Citations.

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 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. 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 Code Technician 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 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. 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 total fees, as well as a list of separate fee items. Pay buttons are displayed, when you have fee items due for payment. Use the pay buttons to pay either all the balance amount which is due or pay only a particular fee item.

    Page Element

    Description

    Total Fees, Total Payable, Total Payments in Process, Total Paid, Balance Due, and Pay button

    The top section on the page displays the consolidated details for all the fees items displayed in the grid below. You can also use the Pay button here, to pay the total balance due for the selected case.

    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

    • Processing payment

    • 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

    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 Code Technician 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 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. 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 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. 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 Related Transactions

Applicants and agency users can link their consultation, business license, permit, or planning applications to other transactions using the Related Transactions page. Agency staff can establish links between transactions and code enforcement cases. Only agency staff such as a code technician have access to the Case – Related Transactions page and are allowed to drill down to the case detail from other transactions. Public users do not have access to related transactions for cases.

As agency staff you can establish relationships between transactions and then perform actions such as viewing the related transaction applications, marking them as primary or sub-application, and removing the link.

The following diagram shows the related transactions linking for a selected application:

Related transactions linking

Related Transactions Linking

Viewing Related Transactions

The Related Transactions page lists all the transactions linked to the selected application including those transactions that are in turn linked to the transaction you have linked. To view all the related transactions:

  1. Access the Transactions page for your consultation, business license, permit, or planning application from the Agency Springboard. For Code Enforcement, access the Cases page.

  2. Select the business license, permit, case, 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 and view related transactions added by applicants, contacts, and agency staff.

    Note: For code enforcement cases, only agency staff can add and manage related transactions.
  4. View the details of the linked transactions:

    Page Element

    Description

    Primary application

    Sub-application

    View the relationship of the linked transaction application with the selected application.

    Transaction

    View the identifier of the linked transaction, a link to access the application detail, and the type of application.

    Note: The detail link is available only for agency staff. Public users accessing this page for their transaction can only view the identifier of the application or case. They cannot drill down to the detail page.

    Status

    View the status of the transaction or case and the date of update.

    Description

    View the description of the transaction.

    Source

    View the detail related to the linking of the transaction:

    • Manual or Automatic linking: The transactions that are manually linked to this application show as Manual and the other transactions that are indirectly linked show as Automatic. For example, if you link transaction 1 to your application X, then the Related Transaction page on your application X shows 1 as Manual and any other transaction that is linked to 1 shows as Automatic.

    • Primary or Sub-application: The relationship of the linked transaction with the selected application

    • Linked by <user> with <date>: The user (staff or public user) who linked the transaction, with the date of linking.

    Actions

    Click and choose from options to mark a transaction as primary, sub-application, for removing the link, or for applying conditions of approval to permits. See a separate section on performing actions.

Adding a Related Transaction

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

Code enforcement case related transactions are created and managed only by agency staff such as a code technician.

Note: Linking option for related transactions is set up in Functional Setup Manager (FSM). For details on setting up the related transactions for your agency, see Setting Up Agencies- Setting Up Related Transaction Linking.

To link a business license, permit, case, or planning application to a transaction:

  1. Access the Transactions page from the Agency Springboard.

    For cases, access the Cases tile from the Agency Springboard.

  2. Select the business license, permit, case, 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 button to open the Link Transaction page, which lists the applications you can link. Agency staff can access the list of cases in a separate tab. These pages list all the active applications and cases related to the selected property or case. Enable the Show All switch to view all the applications or cases in the system.

    Note: If no property is associated with the application or case, then all applications are listed by default.
  5. Select all the desired applications or cases using the check boxes and then click the Add Selected button to establish a link between the transaction applications. The Link Transaction page closes to show the Related Transactions page, which now lists the new transaction rows.

Performing Actions on Related Transactions

Agency staff and public users such as applicants and contact users with appropriate permissions can mark related transactions as primary or sub-application. Only agency staff can manage related transactions for code enforcement cases.

As an applicant or contact user you can remove the link between related transactions from your transactions. This is not applicable to code enforcement cases.

Agency staff have access to all transactions to remove related transaction links.

Click the Actions menu and select from:

  • Mark as Primary

  • Mark as Sub-application

  • Remove Application Link (Not available for an automatically linked transaction)

  • Apply Conditions of Approval: Add conditions of approval to the current permit.

    Note: This option is available only for permits.

    See Working with Permit Conditions of Approval

If a transaction is marked as Primary, its Actions menu will show the option to mark it as Sub-application. Likewise, if a transaction is marked as Sub-application, its action will show the option to mark it as Primary.