Adding a module

From the Configure menu, you can add a module to your workspace.

Procedure

  1. Click Configure and select Modules. The list of modules is displayed in the workspace area.
  2. Click Add Module. The Add Module page is displayed.
  3. Specify the attribute values for the module.
    • Name: Type a name for the attribute. This name is visible in the attribute list for all elements.
    • Add Button Name: Type the name to be displayed on the Add button, which you can use to add elements to this module.
    • Alias: When you integrate with other tools by using Web Services 2.0, you can use an alias instead of the IBM® Rational® Focal Point™ IDs. The default alias is an auto-generated random Universally Unique Identifier (UUID). You can change the alias, but it must be unique.
    • Description: Type a description for the module.
    • Position in Module List: Select where the module is to be displayed in the Modules menu.
    • Prefix Attribute: Specify the text that is displayed before the title of the element in the tree structure and in the charts. You can choose one of the following types of attributes: Text, Unique Id, Integer, Float, or Choice.
    • Icon Attribute: Choose the icon that is displayed to the left of the elements in the tree structure. You can choose any Choice attribute in the module. If you select None, the default icon is displayed.
    • Sort Attribute: Select the attribute by which to sort the elements in the module. You can choose from the following types of attributes: Text, Unique ID, Integer, Float, Choice, Check Box, and Date, Created Date, and Last Changed Date.
      • If you sort elements by a Choice attribute, you can sort either according to the order of the choice items or in alphabetical order, which is the default.
      • If you sort the elements based on a Unique ID attribute, the elements are sorted as Text and not Integers. For example, 001, 010, 011, 012, 002, 020, 003, not 001, 002, 003, 010, 011, 012, 020. If two or more elements have the same value for the sort attributes, they are sorted based on the unique ID of the elements.
        Note: If you specify a sort attribute, you cannot drag elements within a folder. You can only drag elements from one folder to another.
    • Display Folder Icons: Select this check box to display folders as the standard folder icon. If the check box is cleared, the selected icon attribute or the default icon is displayed as icon for folders.
    • Default Icon: If you do not select an icon attribute, this icon is displayed to the left of the elements in the tree structure.
    • May Be Configured By: Select the workspace administrators who can access the module and set up the attributes for the module. If you do not select any members, all workspace administrators can modify this module.
    • Disable Delete: Select this check box to disable the Delete buttons in the modules, tree views, and in windows and menus of the elements. When the Delete buttons are disabled, the elements in the module cannot be removed from the database.
    • Hide Add Views in Menu: If this check box is selected, all the Add views that adds elements to this module are not in the navigation bar. You can add elements from Display views by using the Add button.
    • Hide Module: Select this check box if you do not want to list this module in the Modules menu. This setting affects the list of modules that are visible to administrators when they create views and link elements.
    • Baseline Version Control: Select the baseline version attributes in this module:
      • None: Select this option if the version attribute remains the same even if you create a baseline.
      • Next Major Version: Select this option if the version attribute increases to the next major version number when you create a baseline.
      • Common Major Version: Select this option if more than one version attribute is in the module and you want to increase to the next major version number often. For example, if one version attribute has the number 1.2 and another attribute has the number 3.2, the new version number for the baseline is 4.0 for both attributes. This new number increases based on the highest version number of the two values.
    • Origin Link Attribute: Select the link attribute to use when users copy elements by using the Create Element From option.
    • Add to Other Modules: You can create elements from one module in another module. For example, you want to use the Requirements module to create both requirements and bugs, which are elements of the Bugs module. To create bugs from the Requirements module, select the Bugs check box. From the Set/Add Link lists, select the link with which to automatically connect the modules.
      Note:
      • The Add to Other Modules feature overrides link targets.
      • The value in the Set/Add Link field overrides the constraints that are set by view access, the Lock attribute, and the Allowed Modules for the attribute.
      • When you link modules by using the Add to Other Modules feature, an Add button for the elements is displayed in both modules. To place Add buttons in views, you must have an Add view for each module to add elements to.
      • You cannot use this feature for the Views and Criteria pages in the Criteria menu or for the following modules: Saved Charts, Saved Plans, Baselines.
    • Enable Assign a CR to Change: If you integrate with IBM Rational Change, select this option to synchronize the module with data in Rational Change. For more information, see “Change integration settings.”
  4. Click OK. The module is added.

What to do next

Define attributes for the module. For more information, see “Configuring attributes.”

Feedback