4.5 Managing Bugs

Bugs track software defects. Bugs can be assigned, associated with milestones, and tracked by due date, status, and other attributes.

Topics:

4.5.1 Viewing Bugs

To view bugs:

  1. On the Workspace home page, click the Team Development icon.

  2. Click the Bugs icon.

    The Bugs Dashboard appears. The Bugs Dashboard displays an overview of known software defects. See "About the Bugs Dashboard".

  3. Click the Bugs tab.

    The Bugs page appears. See "About the Bugs Page".

4.5.1.1 About the Bugs Page

The Bugs page displays details about each bug. You can further customize the appearance of the page using the Search bar at the top of the page. Available controls on the Search bar include:

  • Search icon - Resembles a magnifying glass. Click this icon to narrow your search to only specific columns. To search all columns, select All Columns.

  • Text area - Enter case insensitive search criteria (wildcard characters are implied) and then click Go.

  • Go button - Executes a search or applies a filter.

  • View Report - Displays each bug as a line in a report. Use the Actions menu to customize this report.

  • View Detail - Displays detailed information about each bug. To display less information, click Basic.

  • Actions menu - Use this menu to customize the report view. See "About the Actions Menu".

4.5.2 Creating a Bug

To create a bug:

  1. On the Workspace home page, click the Team Development icon.

  2. Click the Bugs icon.

    The Bugs Dashboard appears.

  3. Click Create Bug.

  4. Fill in the appropriate fields. Mandatory fields are marked with a red asterisk (*).

  5. To learn more about a specific field, see item Help. See "About Field-Level Help".

  6. To add new values to editable select lists, enter a value in the field with the title New. For example, to add name to the Assigned To list, enter a value in New Assignee.

    The value you enter is added.

  7. Click Create.

4.5.3 Editing a Bug

To edit a bug:

  1. On the Workspace home page, click the Team Development icon.

  2. Click the Bugs icon.

    The Bugs Dashboard appears.

  3. Click the Bugs tab.

    The Bugs page appears.

  4. How you edit a bug depends upon the View selected in the Search bar. Options include:

    • View Detail - Click the bug number or click the Edit icon.

    • View Report - Click the Edit icon.

  5. Edit the appropriate fields.

  6. To add new values to editable select lists, enter a value in the field with the title New. For example, to add name to the Assigned To list, enter a value in New Assignee.

    The value you enter is added.

  7. Click Apply Changes.

4.5.4 About Attaching Files to a Bug

If enabled at the workspace-level, you can attach files to a To Do. To learn more, see "Enabling Support for File Attachments in Team Development" in Oracle Application Express Administration Guide.

Topics:

4.5.4.1 Attaching a File to a Bug

To attach a file to a bug:

  1. Navigate to the To Do page. See "Editing a Bug".

  2. From Actions, click Add File.

  3. On Add File:

    1. File - Locate the file to be uploaded.

    2. Description - Enter a description of the file.

    3. Click Add File.

    A new region, called Files, displays at the bottom of the page.

4.5.4.2 Viewing, Editing, and Removing Attached Files

To manage attached files:

  1. Navigate to the Bug page. See "Editing a Bug".

  2. Scroll down to Files.

  3. Click View and Manage Files.

    The Files page appears.

  4. To view a file, click the name.

  5. To edit the file description, click the Edit icon.

  6. To delete an attached file, click the Delete icon.

4.5.5 Viewing Bug Reports

Use bug reports to view bugs from different perspectives.

Topics:

4.5.5.1 About the Bugs Dashboard

The Bugs Dashboard displays an overview of known software defects. The Dashboard page contains the following regions:

  • Percent Closed

  • Assigned Developer

  • Severity

  • Status

To edit the dashboard:

  1. Edit the following fields at the top of the page and click Set.

    • Show

    • Release

  2. To reset the dashboard to the default display, click the Reset button.

4.5.5.2 About Calendar

Use the Show list on the Calendar page to display open bugs with an estimated close date, open bugs with no estimated close date, or closed bugs. Click the Previous and Next buttons to view other months. To view a specific bug, click the bug description. To create a new bug, click Create Bug.

4.5.5.3 About By Developer

The By Developer page displays bugs by developer. To view bugs associated with a specific assignee, click the appropriate section of the chart. A report appears displaying bugs by developer.

To alter the chart, select another release and click Set. To return to the default chart, click Reset. To create a new bug, click Create Bug.

4.5.5.4 About By Day

The By Day page displays number of bugs opened and closed by day. To alter the chart, select another release and click Set. To return to the default bar chart, click Reset. To create a new bug, click Create Bug.