Question & Answer
Question
How do you add a custom menu to modules in IBM Engineering Requirements Management DOORS?
Cause
You can create your own menus to display in DOORS that provide functionality from menu items you define and associate with DXL scripts.
Answer
Here is an example of how to create a menu and add the functional components to display the menu in a DOORS module. Menu components are stored in a folder in the addins directory.
It is also worth mentioning that the comments must appear in that order, and that they don't need to be in the script heading. Because of that, a script placed in a menu directory, not referenced in the idx file (for example, a library used by an actual menu entry) can appear in the menu anyway.
How to Create a menu:
When you open a module the new menu is displayed
As an example you have two DXL scripts "makeattr.dxl" and "archive.dxl" that need to be available from a menu Titled "MyMenu" that will display a menu item for each script that you click to activate.
- Note: your DXL scripts must contain both forms of comment delimiters ""//" and "/* */" otherwise, the menu item will not display. Below are examples of the two required comments
-
-
- // this is the first form of comment required in your script
- /* this is the second form of comment required */
- // this is the first form of comment required in your script
-
-
Please input your comments *:
It is also worth mentioning that the comments must appear in that order, and that they don't need to be in the script heading. Because of that, a script placed in a menu directory, not referenced in the idx file (for example, a library used by an actual menu entry) can appear in the menu anyway.
How to Create a menu:
- Navigate to $DOORSHOME/lib/dxl/addins
- Create a folder for the menu you are creating
For example: MyMenu
- Copy and paste two files from the addins directory into the MyMenu folder
- addins.hlp
- addins.idx
- Rename the files with the new folder name MyMenu
- MyMenu.hlp
- MyMenu.idx
Note: Adding addins.idx and renaming it to MyMenu.idx is an optional step.
- Edit the MyMenu.idx file to create the menu items
All comment information in the idx file is prefaced with two forward slashes
Below the comment information are the menu item lines
BEFORE:
user U _ User
AFTER:
makeattr M _ Create Custom Attributes
--------
archive A _ Archive Closed Items
Explanation:- Line 1 has two parts:
1. makeattr is the name of the dxl script to execute when the Hotkey M is pressed
2. Create Custom Attributes is the name of the menu item label that is to be displayed
- Line 2 "--------" is a menu item separator
- Line 3 is the second menu item use the same syntax as line 1 for other menu item
- Line 1 has two parts:
- Put the dxl files listed above into the same directory as the .idx file
- Save and Exit DOORS
When you open a module the new menu is displayed
Internal Use Only
This technote was generated by Technote Kickstart based off of Rational Customer Support PMR #89616,227,000
Related Information
[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"ARM Category":[{"code":"a8m50000000L3D6AAK","label":"DOORS"}],"ARM Case Number":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"All Version(s)"}]
Was this topic helpful?
Document Information
Modified date:
04 June 2021
UID
swg21396989