Skip Headers
Oracle® Application Express Application Builder User's Guide
Release 4.1

Part Number E21674-05
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

Accessing Debugging Mode

The Debug mode is a built in mechanism used to track down unexpected application behavior. You enable and disable debug mode for the current page and session by clicking the Debug and No Debug links in the Developer Toolbar. To view Debug reports, click the View Debug link in the Developer Toolbar.

Description of d_toolbar.gif follows
Description of the illustration d_toolbar.gif

Topics:

Enabling and Disabling Debugging

You enable and disable debug mode at the application-level using the Debugging attribute on the Edit Application Definition page.

To enable or disable debugging:

  1. On the Workspace home page, click the Application Builder icon.

  2. Select an application.

  3. Click the Edit Application Properties button to the right of the application name.

    The Edit Application page appears.

  4. Scroll down to Properties.

  5. For Debugging:

    • Yes. Enables the application debug mode using the browser at runtime.

    • No. Disables the application debug mode using the browser at runtime.

Running an Application in Debugging Mode

You run and disable debug mode at runtime by clicking Debug and No Debug on the Developer Toolbar. By default, Debugging mode is disabled. See "Enabling and Disabling Debugging".

To enable or disable Debug mode:

  1. On the Workspace home page, click the Application Builder icon.

  2. Run the application.

  3. On the Developer Toolbar, click Debug.

    The debugging mode is enabled. Debug data is captured in the background.

  4. To disable debug mode, on the Developer Toolbar, click No Debug.

Using f?p Syntax to Access Debugging Mode

You can also use f?p syntax to run an application in Debugging mode. Simply call the page and set the Debug argument to YES. For example:

f?p=100:1:&APP_SESSION.::YES

Viewing Debug Reports

To view a debug reports:

  1. On the Workspace home page, click the Application Builder icon.

  2. Select the desired application.

    You can view debug reports when the application is running or in development mode.

  3. To view a debug reports in development mode:

    • Click the Find icon and then the Debug tab. See "Using the Find Icon".

    • On the Application home page, click Utilities, and then Debug Messages.

  4. To view debug reports when the application is running, click View Debug on the Developer Toolbar.

    A list of Debug reports displays.

  5. Click the View Identifier to the left of the session you want to view.

    The following illustration shows debug reports viewed in the Item Finder.

    Description of debug_report.gif follows
    Description of the illustration debug_report.gif

  6. To view steps that took the longest, hover over that step on the graph above the report.

    The step details display.

  7. To go to that step in the report, click on the bar.

    Note:

    Debug sessions listed in the report live for at least 2 weeks and age out along with the activity log. This is usually more than adequate for debugging purposes.