Menu Buttons

menu buttons are used extensively on the home page and toolbars to allow users to perform tasks the ribbonbutton below is an example of the menu button this section describes the options available for setting up these links action properties the following are the basic properties on a menu that are required to specify an action links each button has a 'link' object this object is the target for the button if no other options are set then the button will show the properties form for the object or the browse page if the object has children examples for links link description =//currentuser the properties for the current user would be shown =//resources/distribution lists the browse objects page will be shown for the user to browse distribution lists unless specifed by the 'accessrights' property (specified below) then the user must have at least the following rights to access to the object if they do not have access then the button will be automatically hidden link type default rights description / notes service use;add "use;add" means that the ace entry must grant use and add rights note these cannot be split across multiple ace entries for example, granting 'users'\ use and 'self\ add' would not grant access and show the button adding 'self\ use+add' would grant access task execute the user must have execute rights and the task must be licensed serviceinstance view the user must have view rights on the service instance add other read the user must have read access to the object task each button can also have a 'task' specified if set then the specified task will be run for the 'link' object instead for example, link=//currentuser and task=//tasks/users/disable user then the task 'disable user' would be run the current user the button will be automatically hidden if the user does not have 'execute' rights on the task when executing the task the link object will be saved into the task arguments using the following default binding paths object default bind path userdirectoryentry user computerdirectoryentry computer contactdirectoryentry contact groupdirectoryentry group role roles/role asset asset assetinstance assets/instance article article distribution list distributionlists/dl service instance services/instance service service security group securitygroups/securitygroup folder folder folder ace folders/ace sharepoint object sharepointitem sharepoint ace sharepointitems/ace job job team teams/team connector connector shared mailbox mailboxes/mailbox shared mailbox permission mailboxes/access/ace cloud folder cloudfolder cloud folder permission (ace) cloudfolders/ace service desk ticket ticket task selectedtask generic resource resource other behaviour properties the following properties can also be used to control how the button behaves property description accessrights the current user must have the specified rights on the link object if the user does not have rights then the button is hidden enabled specifies if the button is to be shown but disabled extendedrights extended rights are also checked if the user does not have the specified rights then the button will be hidden please see below for definitions of extended rights target specifies the target window to open when the button is clicked normal options are '' (blank) or 'dialog' to display the link in a dialog user by default the current user is normally set as in the target job as 'user', however, you can override the current user for example, you could specified "=//currentuser/manager" to act upon the users manager by default display properties the following are the common display properties that are used for menu buttons property description text the text to display for the button imageurl the image to display for the button tooltip the tooltip hover to display when the user hovers over the button visible specifies if the button is visible by default or not note access rights on the link and task objects can override this extended rights the following extended rights are available the extended rights that are available depend upon the link object extended right applies to description supportsupdate service, serviceinstance does the associated service have the 'supportsupdate' flag on existing all is the associated object an existing object (ie the id >0) orderself service is canorderself true on the associated service is property is true if the current user can order the service selfonly link = user or user is set the current user matches the selected user (or is the =//job/user) in the current job canorder service is canorder true on the associated service this property is true if the user can order the service for themselves or any other user selectuser task can the user select any user apart from themselves browseitems n/a is the current page browseobjects browsetree n/a is the current page browsing objects by tree secured folders, sharepoint, cloudfolder is the current object secured isleaf all is the current object a leaf node hassubitems all if the subitems count >0 managemembers role, dl, security group, team manageinstances service can the user manage instances of this service grouponly dl, securitygroup only true if the associated object has an ad group published all only should the button if the associated object is published noexisting task must be set is there an existing pending task for this user used to hide a new request button if there is an existing request newtask link must be a task the current job task must be different from the task in the link access \[rights] all does the link object or any it's children have the specified right this allows checking on rights not just on the parent but on the children as well this is useful if the user does not have the specified rights on the parent but only on one of the child nodes role only true for static roles dl user must have adduser rights security group user must have adduser rights team user must have adduser rights can the current user manage the members of the object multiple rights can be combined to more complicated rights '|' = or '&', ',',';' = and '!' = not examples example description !published will display the button if the link object is not published published\&isleaf will only display if the link object is published and a leaf node