7.13 Accessing Application Utilities

This section describes Application Builder utilities and reports that enable you to view your application from various perspectives. You can use these reports to view statistics and access reports of page and application components, templates, plug-ins, and conditions. For example, you can view details about buttons used on all pages within your application. Additionally, many reports are updatable so you can standardize components, such as item and region labels, without navigating to a specific page.

7.13.1 Using Application Builder Utilities

This section describes the tools and reports available on the Application Builder Utilities page.

7.13.1.1 Accessing the Utilities Page

To access Application Builder Utilities page:

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

  2. Select the application.

  3. Click the Utilities icon.

    The Utilities page features icons that link to the following tools and reports:

7.13.1.2 Viewing the Application Dashboard

The Application Dashboard details application components and attributes.

To view the Application Dashboard:

  1. Navigate to the Workspace home page.

  2. Click the Application Builder icon.

  3. Select an application.

    The Application home page appears.

  4. Click Utilities.

  5. Click Application Dashboard.

    The Application Dashboard appears and contains the following sections:

    • Application Overview lists detailed information and statistics about the current application, including the ID, name, alias, parsing schema, associated group, number of pages, and associated theme.

    • Security lists the current authentication scheme, number of public and non public pages, and the number of authorization schemes used within the current application.

    • Templates contains links to reports of templates used within the current application.

    • Pages by Type lists counts of components, including types of reports and forms and dynamic HTML.

    • Application Components contains links to reports of application-level controls and logic, including lists, shortcuts, lists of value, tabs, application computations, application items, plug-ins, and application processes.

    • Page Components contains links to reports of page-level controls and logic, including regions, items, branches, computations, validations, dynamic actions, classic report columns, interactive report columns, and button.

  6. To view a specific report, click the number to the right of the component type or template.

7.13.1.3 Viewing the Change History Report

The Change History report displays a summary report of edits to the current applications by developer, component type, and page number.

To view the Change History report:

  1. Navigate to the Workspace home page.

  2. Click the Application Builder icon.

  3. Select an application.

    The Application home page appears.

  4. Click Utilities.

  5. Click Change History.

    A Search bar displays at the top of the page. See "About the Search Bar."

7.13.1.4 Viewing the Recently Updated Pages Report

The Recently Updated Pages report displays a report of pages recently updated by the current user.

To view the Recently Updated Pages report:

  1. Navigate to the Workspace home page.

  2. Click the Application Builder icon.

  3. Select an application.

    The Application home page appears.

  4. Click Utilities.

  5. Click Recently Updated Pages.

    A Search bar displays at the top of the page. See "About the Search Bar."

7.13.1.5 Upgrading Applications to Include New Components

This section describes how to upgrade an existing application to include new components available in the current release.

7.13.1.5.1 About Upgrading an Existing Application

Use the Upgrade Application icon on the Utilities page upgrades the following components:

  • Update Text Field items to Number Field items when there is an IS NUMERIC validation.

  • Update the Value Required item attribute to Yes when there is a NOT NULL validation.

  • Upgrade Date Picker (Classic) to the new Date Picker.

  • Remove %null% in LOV Null Return Value of page items.

  • Upgrade FCKeditor 2 to CKEditor 4.

  • Upgrade SVG Charts to HTML5 Charts.

  • Upgrade HTML Charts to HTML5 Charts.

  • Upgrade Flash Charts to HTML5 Charts.

  • For interactive reports:

    • Enable Group By for interactive reports.

    • Enable Save Public Report for interactive reports.

    • Enable Subscription for interactive reports.

    • Enable Rows Per Page Selector for interactive reports.

    • Enable fixed report headers to the top of the page.

  • Numeric, Required, and Date Picker Item updates based upon conditional validations.

    A wizard displays all relevant validations per page and enables you to select the ones you want to replace with item settings. Then, select buttons that should not execute validations (such as Cancel). Lastly, you can select any validations that should always execute (for example, checking privileges before deletion).

7.13.1.5.2 Running Upgrade Application

To upgrade an existing application:

  1. Navigate to the Workspace home page.

  2. Click the Application Builder icon.

  3. Select an application.

    The Application home page appears.

  4. Click Utilities.

  5. Click Upgrade Application.

  6. Follow the on-screen instructions.

7.13.1.6 Using the Database Object Dependencies Report

The Database Object Dependencies report identifies database objects referenced by the current application. Review this report to determine what objects to move when deploying an application.

To view the Database Object Dependencies report:

  1. Navigate to the Workspace home page.

  2. Click the Application Builder icon.

  3. Select an application.

    The Application home page appears.

  4. Click Utilities.

  5. Click Database Object Dependencies.

    The Database Object Dependencies page appears.

  6. Click Compute Dependencies.

    Tip:

    Display of the report may take a moment depending on the size and complexity of your application.

    The Database Object Dependencies report appears.

7.13.1.7 Accessing Application Express Views

Application Express Views are data dictionary views that expose the metadata for applications. In Application Express Views, you cannot only see the view, but you can also see the data they contain.

To access the Application Express Views page:

  1. Navigate to the Workspace home page.

  2. Click the Application Builder icon.

  3. Select an application.

    The Application home page appears.

  4. Click Utilities.

  5. Click Application Express Views.

    The Application Express Views page appears.

    A Search bar displays at the top of the page. Available controls include:

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

    • Text area - Enter case insensitive search criteria (wildcard characters are implied) to search for a view by name and click Go.

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

    • View Icons - Displays each view as a large icon. To access a view, click the appropriate icon.

    • View Report - Displays each view as a line in a report. To access a view, click the name.

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

  6. Select a view

To view the data within a view, select columns from the Select Column tab and click the Results button.

On the Results tab, expand the Query region to view the query that was executed. You can copy this query for reuse with SQL Commands or SQL Developer.

7.13.2 Accessing Page Specific Utilities

To access Page Specific Utilities page:

  1. Navigate to the Workspace home page.

  2. Click the Application Builder icon.

    The Application Builder home page appears.

  3. Select an application.

    The Application home page appears.

  4. Click Utilities.

  5. Under Page Specific Utilities, select one of the following:

    • Cross Page Utilities

    • Page Groups

    • Region Utilities

    • Button Utilities

    • Item Utilities

    • Computations Utilities

    • Validation Utilities

    • Process Utilities

    • Dynamic Action Utilities

    • Branch Utilities

7.13.3 Utilizing Cross Page Utilities

This section describes the tools and reports available on the Cross Page Utilities page.

7.13.3.1 Accessing Cross Page Utilities

To access the Cross Page Utilities page:

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

  2. Select an application.

  3. Click Utilities.

  4. From Page Specific Utilities, click Cross Page Utilities.

    The Cross Page Utilities page provides access to the following tools and reports:

7.13.3.2 Grid Edit of all Pages

Use the Grid Edit of all Pages report to edit the page name, alias, title, page template, and security options. To link to a specific page, click the Edit icon adjacent to the page number. To save your changes, click Apply Changes.

7.13.3.3 Delete Multiple Pages

Use Delete Multiple Pages to delete multiple pages at once. See "Deleting Multiple Pages."

7.13.3.4 Page Attributes

The Page Attributes report details attributes, components, controls, and application logic for each page in the current application. To customize the report, use the search bar at the top of the page. See "About the Search Bar."

To link to a specific page, click the page number.

7.13.3.5 Page Groups

Use Page Groups to better organize the pages within an application. See "Creating Page Groups."

7.13.3.6 Page Locks

Use Page Locks to prevent conflicts during application development. By locking a page, you prevent other developers from editing it. See "Using Page Designer" and "Locking and Unlocking a Page."

7.13.4 Accessing Cross Application Reports

Use the links on the Cross Application Reports page to view and edit information across multiple applications in the current workspace. You access cross application reports from Workspace Utilities page.

To access cross application reports:

  1. Sign in to Oracle Application Express.

    The Workspace home page appears.

  2. Click the Application Builder icon.

    The Application Builder home page appears.

  3. Click the Workspace Utilities icon.

  4. Locate Cross Application Reports on the right side of the window.

  5. Under, Cross Application Reports, click All Reports to view the Cross Application Reports page.

  6. Select a report to view.

7.13.5 Using Interactive Report Utilities

This section describes options under Interactive Report Utilities on the right side of the Utilities page.

7.13.5.1 Deleting Saved Interactive Reports

The Saved Interactive Reports page lists saved interactive reports in the currently selected application.

To manage saved interactive reports:

  1. Sign in to Oracle Application Express.

    The Workspace home page appears.

  2. Click the Application Builder icon.

    The Application Builder home page appears.

  3. Select an application.

    The Application home page appears.

  4. Click Utilities.

  5. Under Interactive Report Utilities, select Saved Reports.

    The report displays all of the saved report for the application which are not primary defaults. Each row includes the page number, region name, report type, report name, report alias, and owner.

  6. To view private saved reports, deselect the checkbox for the Primary Default filter located below the search bar.

  7. To delete a report, select the check box adjacent to the page number and click Delete Checked.

  8. To view the page containing the report, click the page number.

7.13.5.2 Viewing Subscriptions

End users can receive updated versions of a report by subscribing to it. Workspace administrators can view and manage these subscriptions on the Subscriptions page.

To manage saved interactive reports:

  1. Sign in to Oracle Application Express.

    The Workspace home page appears.

  2. Click the Application Builder icon.

    The Application Builder home page appears.

  3. Select an application.

    The Application home page appears.

  4. Click Utilities.

  5. Under Interactive Report Utilities, select Subscriptions.

    A report appears.