Menu Button Maintenance Menu Button Maintenance lets administrators set up and configure the QAD CSS menu bar displayed at the top of every page. Through this function, administrators are able to create and apply appropriate security settings to each option. Administrators can also modify, delete, and reorder the menu bar options available. This function is an important aspect of customizing QAD CSS. Note: Advanced technical expertise is required to further extend the functionality and customization options of QAD CSS. Menu bars may not appear as shown. Actual appearance is controlled through the QAD CSS style sheet; check with the Web master for more details. Even though the appearance may be different, the functionality is identical. QAD CSS Menu Bar The menu location of Menu Button Maintenance is Home Menu|Administration Menu|Menu Button Maintenance. Clicking the Menu Button Maintenance menu option displays the screen in Menu Button Maintenance. Menu Button Maintenance Menu Button Maintenance Navigation summarizes the contents of the Menu Button Maintenance navigation screen. Menu Button Maintenance Navigation Column Search Search Type Sort Description Link Button Order Y Exact Y Relative location of the button on the menu bar (left to right). Y Menu Name Y Begins Y Unique text for the menu button. N Button Image N n/a N Complete file name, including relative path, of the associated image that appears on the menu button. N Alt Text N n/a N Mouse-over text associated with this menu button. N Note: Avoid using spaces when creating button names. This will avoid possible conflicts with certain operating system configurations. Related QAD CSS functions: • Security Group Maintenance • User Maintenance • System Module Maintenance Deleting a Button from the Menu Button Bar The Delete function of Menu Button Maintenance lets an administrator permanently delete menu button records. Important: QAD CSS physically deletes this record from the database. There is no undo function to recover deleted records. To delete a menu function: 1 Click the Button Order link in the row of the function to delete. 2 Print this screen and save it as a hard copy. This will allow the function to be re-created in the future. 3 Click the Cancel button to close the Menu Button edit screen. 4 Click the Delete link in the row of the function to delete. 5 Click OK to confirm the deletion of the selected function. Click Cancel to prevent the function from being deleted. Note: Consider deactivating a menu bar function by assigning no security groups for this function. Adding a Button to the Menu Button Bar The Add function of Menu Button Maintenance lets an administrator add custom buttons and functions to the menu bar. The following information is required to complete this process: • The name of the button to create • The display text associated with the button • The URL or JavaScript function to execute when the button is clicked • The security groups to which this function will be available • Optionally, any icon image associated with this function To create a new menu bar function: 1 Click Add in the navigation window to display the edit screen in Add mode. 2 Enter data into the appropriate fields. 3 Select each security group that will have access to this function on the menu bar. Users assigned to selected security groups will see this option. Users not assigned to selected security groups will not see this option. 4 Click Add in the edit window to save the record. Detail Menu Button Maintenance Menu Widget Name Name must be plain character and unique among menu buttons. Spaces are not allowed in the name. If this value is set as LaunchButton, ViewOrderButton, HelpButton, or Documentation, the Form Action field is ignored. These values are not case-sensitive. Button Image Name must match a physical image name stored in one or more image directories. Does not have to be unique and can be left blank. Button Order Value must be 0 (zero) or a positive integer. This represents (in ascending order) the button’s position relative to the existing buttons (after the security filter has been applied). Duplicated numbers result in a sort based on Progress database logic. Note: The order that a particular user sees depends on the user’s security group. Image Alt Text The text that appears when the image is not available. Image Height/Width When set to 0 (zero), the loading optimization of the menu bar is not enabled. These values adjust the display size of the image and do not alter the actual image file. Note: Current browsers handle image sizing in unpredictable ways. Set this field with a correct value for optimized Web page loading. Display Text Plain text that you want to display on the new button to the right of the image. Form Action It is the value of the form action variable, which is interpreted by the newHeaderSubmit function in the standard JavaScript library. Some form actions are coded in the JavaScript. If one of these standard format actions is not used (LaunchButton, ViewOrderButton, HelpButton, or Documentation), specify either: • A valid QAD CSS module as set in Module Maintenance. Typically, it should be a module that is defined as being on the menu. • A valid URL. In this case, a new browser window is opened displaying the URL address. Note: The default configuration of QAD CSS has several uses of form action instances. They can serve as examples to demonstrate the various implementations of form actions. Allowed Security Groups It is a list of the current security group, which have been set through Security Group Maintenance. A check indicates permission to see and execute this button. Clicking a command button executes one of the following actions: • Add saves the new record to the database. All required fields—indicated with alternate field color—must be populated before saving a record. Before saving, the system verifies that the record is unique and displays an error if it is not. • Cancel closes the window without adding the record. Modifying a Button on the Menu Button Bar The Modify function of Menu Button Maintenance lets an administrator modify existing menu button entries. Requirements for adding a record are the same as for editing a record. Common tasks are the maintenance of icon images, translated data elements, and adjusting security group assignments. The following information is required to complete this process: • The display text associated with the button • The URL or JavaScript function that executes when this button is clicked • The security groups for which this function is available • Optionally, any icon image associated with this function To modify a menu bar function: 1 Display the record to modify. 2 Click the Button Order link in the row of the function that you want to modify. 3 Enter data into the appropriate fields. Fields that do not allow change are indicated by a second alternate color. 4 Select each security group that will have access to this function on the menu bar. Users assigned to selected security groups will see this option. Users not assigned to selected security groups will not see this option. 5 Click Save to commit the changes.
