---
title: Menu Link Options
slug: menu-link-options
createdAt: 2025-06-11T20:26:19.223Z
---

MenuLink is the base class for RibbonButton and FormButton's and controls all routing in Activate.

The main settings controlling the link are the 'Link' and 'Task' properties.

The Link property is the main link controlling the target of the MenuLink and the Task specifies the Task to run for the Link Object.

If the Task is not set then generally the properties for the object are shown for Leaf nodes and a browse page is shown for containers.

## If Task is specified

| Link Type                | Default Rights | Description                                                                                                                                                            |
| ------------------------ | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Web Form                 | READ           | Start Task with the WebForm as the start Page Note: If the Task is NULL or the Task is the same as the CurrentJobs task then the page is opened with the existing job. |
| Service                  | ADD            | Start Task with the Service selected                                                                                                                                   |
| ServiceInstance          | VIEW           | Start Task with service instance selected.                                                                                                                             |
| Job                      | VIEW           | Start Task with the job bound into it.                                                                                                                                 |
| Parameter                | READ           | Start Task with the parameter                                                                                                                                          |
| Other ProvisioningObject | READ           | Start Task with the object bound as below                                                                                                                              |

If starting a Task and a Job is set and the Task == Job.Task and a StartPage is specified then the current Job is shown with the specified StartPage otherwise a New Job is started with the specified Task.

## If Task is not set

| Link Type                | Default Rights | Other Conditions         | Description                                                                                       |
| ------------------------ | -------------- | ------------------------ | ------------------------------------------------------------------------------------------------- |
| String                   |                |                          | This will just navigate to the specified URL.                                                     |
| Task                     | VIEW           | Browse \|\| !Task.IsLeaf | Show Properties                                                                                   |
| Task                     | EXECUTE        | Task.IsLeaf              | Start Task                                                                                        |
| Web Form                 | READ           |                          | Show Form with the current Job set                                                                |
| Service                  | ADD            |                          | Show properties                                                                                   |
| ServiceInstance          | VIEW           |                          | Show Properties                                                                                   |
| Job                      | VIEW           |                          | If StartPage is set Show the specified Page in the Job or Show Job Details                        |
| Parameter                | READ           |                          | If Value is an ImageValue then download the image If Value is a WebForm then display the web form |
| Other ProvisioningObject | READ           |                          | Show Properties                                                                                   |

## Default Bindings

When a task is specified and the Link is bound into the Job Arguments it is bound to the LinkBindPath. The default values if not specified are:

| Link Type              | Default Bind Path                      |
| ---------------------- | -------------------------------------- |
| Service                | service                                |
| Service Instance       | services/instance and user = Link.User |
| Job                    | job                                    |
| Role                   | roles/role                             |
| Asset                  | asset                                  |
| Asset Instance         | assets/instance                        |
| Article                | article                                |
| DLResource             | distributionLists/dl                   |
| TeamResource           | teams/team                             |
| ConnectorSyncProvider  | connector                              |
| GroupResource          | securityGroups/securityGroup           |
| MailboxResource        | mailboxes/mailbox                      |
| MailboxPermission      | mailboxes/access/ace                   |
| FolderResource         | folder                                 |
| FolderAce              | folders/ace                            |
| CloudFolderResource    | cloudFolder                            |
| CloudFolderAce         | cloudFolders/ace                       |
| PrivilegedAccount      | accounts/account                       |
| UserDirectoryEntry     | user                                   |
| GroupDirectoryEntry    | group                                  |
| ContactDirectoryEntry  | contact                                |
| ComputerDirectoryEntry | computer                               |
| ServiceDeskTicket      | ticket                                 |
| Resource               | resource                               |
| Task                   | selectedTask                           |
| Parameter              | parameter                              |

## Extended Rights

The AccessRights property controls the standard Activate Rights that the user must have to view the Link object. The default rights are normally 'READ' or 'EXECUTE' for Tasks. The following are additional extended rights that can be checked. If the user does not have rights then the MenuLink is hidden.

These rights can be combined with a , ; & characters and are an 'AND' - All rights must be true.

Each right can also be prefixed with a ! character to indicate a NOT condition.

| Right           | Applies To                                 | Description                                                                                       |
| --------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| Existing        | All Provisioning Objects                   | The Link object has already been created. (ie ID>0)                                               |
| OrderSelf       | Service                                    | Can the user order this service for themselves                                                    |
| CanOrder        | Service                                    | Can the user order this service                                                                   |
| SupportsUpdate  | Service / ServiceInstance                  | Does the Service support update (ServiceFlags.SupportsUpdate)                                     |
| SelfOnly        | UserDirectoryEntry                         | Is the current user the same as * Link 
* User Property
* Job.Arguments("user")                   |
| SelectUser      | Task                                       | Can the user select someone for this task - ie does AvailableUsers return a value                 |
| BrowseItems     | Web Site Page                              | Is the current page BrowseItems                                                                   |
| BrowseTree      | Web Site Page                              | Is the current page Browse Tree                                                                   |
| Inline          | Web Site Page                              | Is the current page inline                                                                        |
| Secured         | Folder / CloudFolder                       | Is the folder secured                                                                             |
| LeafOnly        | All Provisioning Objects                   | Is the object a leaf node                                                                         |
| HasSubItems     | All Provisioning Objects                   | Does the object have SubItems                                                                     |
| ManageMembers   | Role/DLResource/TeamResource/GroupResource | Can the user manage other users in the object                                                     |
| ManageInstances | Service                                    | Can the user manage instances of this service                                                     |
| GroupOnly       | DLResource/TeamResource/GroupResource      | Is there a valid group for this object                                                            |
| Published       | All Provisioning Objects                   | Is the object published                                                                           |
| NewTask         | Task                                       | Is the Task different to the current jobs task.                                                   |
| Access:\[RIGHT] | All Provisioning Objects                   | Check the access \[RIGHT] for the specified object OR does any direct descendant have this right. |
| ApproveNow      | Job                                        | Can the user Quick approve this job                                                               |
