3.2 Managing Packaged Applications in a Full Development Environment

In a full development environment, developers can view, install, run, remove, unlock, export, change authentication, and update packaged applications.

See Also:

"Managing Custom Applications" in Oracle Application Express Administration Guide and "Using a Packaged Apps Only Workspace"

Parent topic: Utilizing Packaged Applications

3.2.1 Accessing the Packaged Apps Page

Use the Packaged App page to view, install, run, remove, unlock, export, change authentication, and update packaged applications.

Tip:

In new workspace, a gray box displays on the App Builder home page labeled, Install a Packaged Application. As a shortcut to access the Packaged Apps page to install a packaged application, click Install a Packaged Application.

  1. Sign in to Oracle Application Express.
  2. On the Workspace home page, click the Packaged Apps icon.
  3. Review the available applications.

    Click the Search field at the top of the page and enter keywords to narrow the display.

    Click the buttons to the right of Search field to narrow display:

    • All. Click All to view all packaged apps.

    • Productivity. View only productivity applications. Productivity applications are fully functional applications that have been designed to address a specific business need. Once a productivity application is installed, you must unlock it before you can edit it.

    • Sample. View only sample applications. Sample applications are not a complete application but instead contain code snippets or sample code. By default, sample applications are fully editable.

    • Installed. View previously installed packaged applications.

  4. Select an application.

    The Packaged Application Details page appears, displaying summary information about the application.

    On Packaged Application Details page, you can:

    • Install Packaged App. If not installed, click Install Packaged App to install it.

    • Manage. If installed, click Manage to change the application authentication, unlock, or remove the application.

    • Run. If installed, click Run to run the application.

    Tip:

    The actual options that display on the Packaged Application Details page depend upon whether the application is installed.

See Also:

Parent topic: Managing Packaged Applications in a Full Development Environment

3.2.2 Installing a Packaged Application

Tip:

In a new workspace, a gray box displays on the App Builder home page labeled, Install a Packaged Application. Click Install a Packaged Application as a shortcut to access the Packaged Apps page.

To install a packaged application:

  1. Sign in to Oracle Application Express.

    The Workspace home page appears.

  2. Click the Packaged Apps icon.

    The Packaged Apps page appears.

  3. Locate an application to install. Use the Search field at the top of the page to narrow the display results.
  4. Click an application to install.

    The Packaged App Details page appears.

  5. Click Install Packaged App.
  6. Select an Authentication scheme and click Next.
  7. Click Install Packaged App again.

    The Packaged Application Details page appears. The success message, Application installed, displays at the top of the page.

  8. Click Manage.

    The Manage dialog displays three buttons:

    • Change Authentication

    • Unlock Remove

    • Remove

    Tip:

    Unlock is NOT available in a Packaged Apps Only Workspace.

  9. To run the application, click the Run icon.

See Also:

Parent topic: Managing Packaged Applications in a Full Development Environment

3.2.3 Running an Installed Packaged Application

To run an installed packaged application:

  1. On the Workspace home page, click the Packaged Apps icon.

    The Packaged Apps page appears.

  2. Click the Installed tab, select the application, and then click the Run icon.

  3. Enter the appropriate credentials:

    1. Username - Enter your workspace username.

    2. Password - Enter your workspace password.

    3. Click Sign In.

    The application displays in a new window.

    See Also:

    "How Your Browser Impacts the Way Applications Run"

Parent topic: Managing Packaged Applications in a Full Development Environment

3.2.4 Removing an Installed Packaged Application

To remove an installed packaged application:

  1. On the Workspace home page, click the Packaged Apps icon.

    The Packaged Apps page appears.

  2. Click the Installed tab and select the application to be removed.
  3. Click Manage.
  4. Click Remove.
  5. When prompted, click Remove Application.

Tip:

You can also perform this task on the Application Details page. See "Accessing the Packaged Apps Page."

Parent topic: Managing Packaged Applications in a Full Development Environment

3.2.5 Changing Authentication for an Installed Packaged Application

To change the authentication for an installed packaged application:

  1. On the Workspace home page, click the Packaged Apps icon.

    The Packaged Apps page appears.

  2. Click the Installed tab and select the application.
  3. Click Manage.
  4. Click Change Authentication.

    The Change Authentication page appears.

  5. From Authentication, select an authentication scheme and click Apply Changes.

Tip:

You can also perform this task on the Application Details page. See "Accessing the Packaged Apps Page."

See Also:

"Establishing User Identity Through Authentication"

Parent topic: Managing Packaged Applications in a Full Development Environment

3.2.6 Unlocking an Installed Productivity Application

The main difference between an Oracle-supplied sample and productivity application is the level of support. Once a productivity application is installed, you must unlock it before you can edit it. By default, sample applications are fully editable.

Note:

Unlocking a productivity application makes it ineligible for future upgrades or support by Oracle Support.

To unlock an installed productivity application:

  1. On the Workspace home page, click the Packaged Apps icon.

    The Packaged Apps page appears.

  2. Click the Installed tab and select the application.
  3. Click Manage.
  4. Click Unlock.

    Tip:

    Unlock is NOT available in a Packaged Apps Only Workspace.

    The Unlock Packaged Application page appears.
  5. Click Unlock Application.

See Also:

"Installing a Packaged Application"

Parent topic: Managing Packaged Applications in a Full Development Environment

3.2.7 Updating a Packaged Application

You can update a packaged application if an Update button displays on the Packaged Application Details page.

To update a packaged application:

  1. On the Workspace home page, click the Packaged Apps icon.

    The Packaged Apps page appears.

  2. Click the Installed tab and select the application to be removed.
  3. Click Update Application.

    The Update Packaged Application page appears.

Note:

Because sample applications are unlocked by default, they cannot be updated. To access the latest sample applications, Oracle recommends deleting the sample application from your workspace and reinstalling from the Packaged Apps gallery.

See Also:

"Running an Installed Packaged Application"

Parent topic: Managing Packaged Applications in a Full Development Environment