2.7 Managing Links on the Extension Menu

Workspace administrators can add custom links to the Extensions menu on the APEX menu bar.

• About the Extension Menu
  Learn about the Extensions menu.
• Adding Links to the Extension Menu
  Add links to the Extension menu in Workspace Administration on the Manage Service, Links page.
• Editing Extension Menu Links
  Edit links on the Extension menu in Workspace Administration on the Manage Service, Links page.
• Deleting Extension Menu Links
  Delete links on the Extension menu on the Create / Edit Link page.

2.7.1 About the Extension Menu

Learn about the Extensions menu.

The Extension menu only appears if a Workspace Administrator adds links to it on the Manage Extension Links page in Workspace Administration. When configured, the Extension menu displays on the APEX menu bar between the Global Search field (also known as Spotlight Search) and the Administration menu.

Description of the illustration extensions_menu.png

In the previous example, the Extensions menu displays three entries: APEX Discussion Forum, APEX Events, and APEX Office Hours.

Supported Link Substitution Strings

Links added to the Extension menu must point to a valid URL and can include substitution strings for the workspace name, workspace ID, username, session session ID, current application and current page as described in the following table. The link substitution strings described in this topic can only be used when defining URLs in the Extension menu and support Session State Substitution syntax (also called &ITEM. syntax). No other documented substitution variables will work in this context.

Tip:

To learn more about Session State Substitution syntax, see About Using Substitution Strings in Oracle APEX App Builder User’s Guide.

Substitution String	Description
EXT_WORKSPACE_NAME	Name of the workspace from where the link is opened.
EXT_WORKSPACE_ID	Workspace ID (or Security Group ID) of the workspace from where the link is opened.
EXT_APP_ID	Application ID of the app that the developer currently has open. If no application is open in session state, this value is empty.
EXT_APP_NAME	The Application Name of the app that the developer currently has open. If no application is open in session state, this value is empty.
EXT_APP_ALIAS	The Application Alias of the app that the developer currently has open. If no application is open in session state, this value is empty.
EXT_PAGE_ID	The Page ID of the app that the developer currently has open in the App Builder. If no page is open in session state, this value is empty.
EXT_PAGE_NAME	The Page Name of the app that the developer currently has open in the App Builder. If no application is open in session state, this value is empty.
EXT_PAGE_ALIAS	The Page Alias of the app that the developer currently has open in the App Builder. If no application is open in session state, this value is empty.
APP_USER	The current user (or developer).
APP_SESSION_ID	The current session state ID.

See Also:

Using Substitution Strings

2.7.2 Adding Links to the Extension Menu

Add links to the Extension menu in Workspace Administration on the Manage Service, Links page.

Note:

The Extension menu only appears on the menu bar if if a Workspace Administrator adds links to it.

To add links to the Extension menu:

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

   The Links page appears.

2. Click Create Link.
   The the Create / Edit Link page appears.
3. On the Create / Edit Link page:
   1. Name - Enter the label for the link to display in the Extensions menu.
   2. Display Sequence - Specify the display sequence for the link entry. The sequence determines the display order in the Extensions menu.
   3. URL - Enter a valid URL target for this link. Links can include substitutions. See About the Extension Menu.
   4. Description - Enter informational comments about the link.
   5. Click Create.

   The link appears on the Links page.

   Tip:

   You can also add a new link by adding a row manually. See Adding a Row in an Editable Interactive Grid in Oracle APEX End User’s Guide.

2.7.3 Editing Extension Menu Links

Edit links on the Extension menu in Workspace Administration on the Manage Service, Links page.

To edit links on the Extension menu:

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

   The Links page appears.

2. Find the row and click the Edit icon.
3. On the Create / Edit Link page:
   1. Name - Enter the label for the link to display in the Extensions menu.
   2. Display Sequence - Specify the display sequence for the link entry. The sequence determines the display order in the Extensions menu.
   3. URL - Enter a valid URL target for this link. Links can include substitutions. See About the Extension Menu.
   4. Description - Enter informational comments about the link.
   5. Click Apply Changes.

   Tip:

   To learn more about editing rows in an interactive grid, see Editing Rows in an Interactive Grid in Oracle APEX End User’s Guide.

2.7.4 Deleting Extension Menu Links

Delete links on the Extension menu on the Create / Edit Link page.

To delete links on the Extension menu:

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

   The Links page appears.

2. Find the row for the link to be deleted and click the Edit icon.
3. On the Create / Edit Link page, click Delete.

   Tip:

   You can also delete individual rows by selecting Delete on the Row Action menu. See Deleting a Row in an Interactive Grid in Oracle APEX End User’s Guide.