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.

Topics:

3.2.1 Viewing Packaged Apps

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. Click Install a Packaged Application as a shortcut to access the Packaged Apps page to install a packaged application.

To access the Packaged App page:

  1. Sign in to Oracle Application Express.

  2. On the Workspace home page, 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.

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

  4. On Packaged Application Details page, you can:

    Tip:

    The actual options that display depend upon whether the application is installed.

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

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

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.

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 "Viewing Packaged Apps."

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 "Viewing Packaged Apps."

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.

3.2.7 Updating a Packaged Application

You can update a packaged application if an Update button displays on 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.