19.2 Implementing Plug-ins

Create plug-ins to declaratively extend, share, and reuse the built-in types available in APEX.

• Understanding Plug-ins
  Learn about plug-ins and how to find examples.
• Creating Plug-ins
  Create plug-ins by navigating to Shared Components and running the Create Plug-in Wizard.
• Editing Plug-ins
  Edit a plug-in to specify additional custom attributes, upload files such as image, CSS and JavaScript files, or add events.
• Deleting a Plug-in
  Delete plug-ins on the Edit page.
• Viewing the Plug-in Repository
  The Plug-in Repository provides a central location where developers can share and download plug-ins.
• Exporting and Importing Plug-ins from Shared Components
  Export and import plug-ins from Shared Components.
• Resetting the Plug-in Interactive Report
  Reset the plug-in interactive report to clear all current filters applied to the report.
• Viewing the Plug-in Utilization Page
  The Plug-in Utilization page displays which pages, components, and regions use each plug-in.
• Viewing the Plug-in History
  The Plug-in History page shows the actions taken on each plug-in, the developer that performed the action and the date of each action.

19.2.1 Exporting and Importing Plug-ins from Shared Components

Export and import plug-ins from Shared Components.

• Exporting a Plug-in from the Plug-in Page
  Export a plug-in definition to a file.
• Importing a Plug-in from the Plug-in Page
  Import the Plug-in Export on the Import page.

19.2.1.1 Exporting a Plug-in from the Plug-in Page

Export a plug-in definition to a file.

Plug-in export files can be imported into any Oracle APEX application. You can access the Export page from the Shared Components, Plug-ins page as described in this topic or from the Export page.

To export a plug-in from the Plug-in page:

1. Navigate to the Shared Components page:
   1. On the Workspace home page, click App Builder.
   2. Select an application.
   3. On the Application home page, click Shared Components.

      The Shared Components page appears.

2. Under Other Components, click Plug-ins.
3. Under Tasks, click Export Plug-in.

   The Export page appears with the Plug-ins tab selected.

4. Under Export Plug-in:
   1. Application - Identifies the current application
   2. Plug-in - Select the plug-in to export.
   3. File Character Set - Indicates the character set in which the export file will be encoded.
   4. Click Export.
5. Import the Plug-in Export into the target instance.

See Also:

Exporting Plug-ins

19.2.1.2 Importing a Plug-in from the Plug-in Page

Import the Plug-in Export on the Import page.

To import a Plug-in Export:

1. Navigate to the Shared Components page:
   1. On the Workspace home page, click App Builder.
   2. Select an application.
   3. On the Application home page, click Shared Components.

      The Shared Components page appears.

2. Under Other Components, click Plug-ins.
3. Click Import.
4. On Import:
   1. Drag and drop, or navigate to the file.
   2. File Type - Select Plug-in.
   3. File Character Set - Verify that File Character Set is correct.
   4. Click Next.

      Once you import a file, you have the option to install it. You can also install this file at a later time by navigating to the Export Repository.

5. To install an imported file, click Next.
6. On Install Plug-in:
   1. Install Into Application - Select the target application. You can install the plug-in into the same application or into a different application.

      Tip:

      When you install a plug-in into the current application, the new plug-in will overwrite an existing plug-in having the same plug-in name. If the installation succeeds, the installation of the plug-in becomes permanent. If any errors are encountered, the actions are rolled back, resulting in no permanent changes.
   2. Click Install Plug-in.

See Also:

Importing Plug-ins