IBM Support

How to add custom properties to Rhapsody using various options

Question & Answer


Question

How do I add custom properties to IBM Rational Rhapsody using various options?

Cause

You have been instructed by technical support to add a property that does not currently exist or you wish to add your own properties for other reasons.

Answer

There are several ways to do add custom properties to IBM Rational Rhapsody, each method having advantages and disadvantages depending on the requirements of your current task:

  • Manually editing the property files
    You can manually add custom properties to the site.prp file in the Rhapsody\Share\Properties folder.
    Rhapsody Documentation : Adding customized properties

    Advantages and disadvantages:
    • These will be applicable to all projects in the future (+)
    • Does not require knowledge of Rhapsody API (+)
    • The properties must be added manually (-)
    • Rhapsody must be restarted to take effect (-)
  • Enable the ShowPropertiesButtonFromPropertiesPage feature
    This does not modify the property files as mentioned in the previous step, but instead adds them to the project .rpy file.
    Technote 1667385: How to create custom properties in the Rational Rhapsody User Interface

    Advantages and disadvantages:
    • provides a convenient method for adding properties via the Rhapsody user interface. (+)
    • Rhapsody does NOT require restart to take effect (+)
    • Does not provide a similar method for removal via the Rhapsody user interface. See option below (-)
    • Only adds the property to the current project. (-)
  • Use the Rhapsody API
    This allows you to automate the creation/modification/removal of custom properties to the loaded project.
    Technote 1973545 : How to create custom Predefined Keywords in IBM Rational Rhapsody

    Advantages and disadvantages:
    • Can be easily applied to any project using a plugin or .hep file (+)
    • API can be used to remove unwanted properties from the project. For example, when added using option with enabling ShowPropertiesButtonFromPropertiesPage feature. (+)
    • Rhapsody does NOT require restart to take effect (-)
    • Requires basic knowledge and experience in using the Rhapsody API (-)

[{"Product":{"code":"SSB2MU","label":"IBM Engineering Systems Design Rhapsody"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"General Information","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.0;8.0.1;8.0.2;8.0.3;8.0.4;8.0.5;8.0.6;8.1;8.1.1;8.1.2;8.1.2.1;8.1.3;8.1.4","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Rhapsody

Document Information

Modified date:
27 May 2022

UID

swg21976121