29.1 ADD_MENU_ENTRY Procedure

This procedure adds a builder extension menu link. Requires the APEX_ADMINISTRATOR_ROLE.

Syntax

APEX_EXTENSION.ADD_MENU_ENTRY (
    p_label            IN VARCHAR2,
    p_url              IN VARCHAR2,
    p_display_sequence IN NUMBER    DEFAULT NULL,
    p_description      IN VARCHAR2  DEFAULT NULL,
    p_is_public        IN BOOLEAN   DEFAULT FALSE,
    p_workspace        IN VARCHAR2  DEFAULT NULL )

Parameters

Parameter Description
p_label Menu entry label. Must be unique within a workspace.
p_url The menu entry's URL.
p_display_sequence

(Optional) Display sequence for sorting menu entry.

Default NULL: the value is calculated and the entry is appended as last.

p_description (Optional) Description.
p_is_public

Default FALSE.

If TRUE, the entry is available for subscribing workspaces. The value TRUE can only be set for extension workspaces.

If the given workspace is not enabled for hosting extensions, the flag is set to FALSE.

p_workspace Default NULL, which means the menu entry is created for the current workspace. Value can be set to any existing workspace name.

Example

The following example adds an extension menu link in workspace MY_WORKSPACE with label "Example."

BEGIN
    apex_extension.add_menu_entry(
        p_label       => 'Example',
        p_url         => 'https://example.com'
        p_description => 'This is an example'
        p_workspace   => ' MY_WORKSPACE' );
END;