Managing Productivity and Sample Apps in a Full Development Environment

In a full development environment, developers can view, install, run, remove, unlock, export, change authentication, and update productivity and sample apps.

Accessing the App Gallery Page

Tip:

In new workspace, a gray box displays on the App Builder home page labeled, Install a Productivity or Sample App. Click this box as a shortcut to access the App Gallery.

Use the App Gallery page to view, install, run, remove, unlock, export, change authentication, and update productivity and sample applications.

To access the App Gallery:

  1. Sign in to Oracle Application Express.
  2. On the Workspace home page, click the App Gallery icon.

    The App Gallery page appears.

  3. Review the available applications.
  4. To narrow the display:
    • Click the Search field at the top of the page and enter keywords.

    • Click the following buttons to the right of Search field:

      • All. View all applications.

      • 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 only installed productivity and sample apps.

  5. Select an application.

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

    On App Details page, you can:

    • Install App. If not installed, click Install 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 options that display on the App Details page depend upon whether the application is installed.

Installing a Productivity and Sample App

Tip:

In a new workspace, a gray box displays on the App Builder home page labeled, Install a Productivity or Sample App. Click this box as shortcut to access the App Gallery.

To install a Productivity and Sample App:

  1. Sign in to Oracle Application Express.

    The Workspace home page appears.

  2. Click the App Gallery icon.

    The App Gallery 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 App Details page appears.

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

    The Install Application 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 Productivity and Sample Apps Only Workspace.

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

Running a Productivity and Sample App

To run an installed Productivity and Sample App:

  1. On the Workspace home page, click the App Gallery icon.

    The App Gallery 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.

Removing a Productivity and Sample App

To remove an installed Productivity and Sample App:

  1. On the Workspace home page, click the App Gallery icon.

    The App Gallery 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 App Gallery Page."

Changing Authentication for an Installed Productivity and Sample App

To change the authentication for an installed productivity and sample app:

  1. On the Workspace home page, click the App Gallery icon.

    The App Gallery 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 App Gallery Page."

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 App Gallery icon.

    The App Gallery appears.

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

    Tip:

    Unlock is NOT available in a Productivity and Sample Apps Only Workspace.

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

Updating a Productivity and Sample App

You can update a productivity and sample app if an Update button displays on the App Details page.

To update a productivity and sample app:

  1. On the Workspace home page, click the App Gallery icon.

    The App Gallery page appears.

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

    The Update 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 App Gallery.