2.7.3 Managing Extension Subscriptions

Create a subscription to utilize an Extension menu created in another workspace.

Tip:

Use the Builder Extension Sign-in authentication scheme to enable developers to open the extension app from a Builder session without having to sign-in with username/password. See About Builder Extension Sign-In in Oracle APEX App Builder User’s Guide.

• Enabling Extension Menu Subscriptions
  Before you can subscribe to an Extension menu in another workspace, you must enable the Allow Hosting Extension attribute in Administration Services and make the links public.
• Subscribing to Extension Menu Links
  Subscribe to Extension menu links in another workspace.
• Editing or Unsubscribing to Extension Subscriptions
  Learn how to edit or unsubscribe to an Extension subscriptions.

2.7.3.1 Enabling Extension Menu Subscriptions

Before you can subscribe to an Extension menu in another workspace, you must enable the Allow Hosting Extension attribute in Administration Services and make the links public.

To enable Extension menu subscriptions:

1. Enable the Allow Hosting Extension attribute:
   1. Sign in to Administration Services.
   2. Navigate to Manage Workspaces, Existing Workspaces, and click the workspace name.
   3. Find Component Availability, Allow Hosting Extension - Select one of the following:
      • Yes - Manual Subscription - The workspace can host and publish extensions. Manual Subscriptions require a Workspace Administrator to grant read access manually.
      • Yes - Automatic Subscription - The workspace can host extensions and extension menu entries are automatically published to all other workspaces in the instance, without the need to subscribe and grant read access manually.
   4. To save your changes, click Apply Changes.

      Note:

      For more details on editing the Allow Hosting Extension attribute, see Viewing Existing Workspace Information.
2. Edit the links to be included in the subscription and make them public.
   1. Sign in to the hosting workspace.
   2. On Workspace home page, click the Administration menu and select Manage Service and then Manage Extension Links.

      The Links page appears.

   3. For each link to be included in the subscription, click the Edit icon.
   4. Public - Select Yes.
   5. Click Apply Changes.

2.7.3.2 Subscribing to Extension Menu Links

Subscribe to Extension menu links in another workspace.

Note:

Before you can create a subscription, the administrator hosting the Extension menu links, must complete the tasks described in Enabling Extension Menu Subscriptions.

To subscribe to Extension menu links in another workspace:

1. Navigate to the Links page:
   1. Sign in to the workspace.
   2. On Workspace home page, click the Administration menu and select Manage Service and then Manage Extension Links.

   The Links page appears.

2. Click the Subscriptions tab.
3. Click Add Subscription.
4. On Subscribe to Extension Workspace:
   1. Extension Workspace - Specify the workspace with published links you want to include in the Extension menu of your workspace.
   2. Menu Label Overwrite - By default, the name of the extension workspace becomes the parent menu item of all published links. Use this attribute enter a different label for the parent menu item here.
   3. Has Read Access - Indicate whether the specified extension workspace is allowed to access the metadata of your workspace through the APEX repository views.

      If read access is granted by the invoking workspace, you can also access the application metadata (views) of the invoking workspace.

   4. Click Subscribe.

Tip:

Use the APEX_EXTENSION.SET_WORKSPACE package to access repository data of workspaces that have granted read access to an Extension workspace in Automations or PL/SQL in APEX session context. See APEX_EXTENSION in Oracle APEX API Reference.

2.7.3.3 Editing or Unsubscribing to Extension Subscriptions

Learn how to edit or unsubscribe to an Extension subscriptions.

To edit or unsubscribe to an Extension subscription:

1. Navigate to the Links page:
   1. Sign in to the workspace.
   2. On Workspace home page, click the Administration menu and select Manage Service and then Manage Extension Links.

   The Links page appears.

2. Click the Subscriptions tab.
3. To edit the Extension subscription:
   1. Click workspace name.
   2. Menu Label Overwrite - By default, the name of the extension workspace becomes the parent menu item of all published links. Use this attribute enter a different label for the parent menu item here.
   3. Has Read Access - Indicate whether the specified extension workspace is allowed to access the metadata of your workspace through the APEX repository views.
   4. Click Apply Changes.
4. To delete the Extension subscription:
   1. Click workspace name.
   2. Click Unsubscribe.