Unit Editor

Overview

This helper provides an easy way to change the language, read write-status and load status of multiple units.

Applicable To	Units*
Menu Entry	Power Pack  Unit Tools  Change Unit Language
Demonstration	Watch the Video

*The Rhapsody HEP applicableTo mechanism does not understand unit and so the helper is applicable to all element types that could be units. The dialog processes the selection and only shows units.

The Rhapsody Unit Information Dialog

Changing the language / read write status / include in next load status of one unit is relatively easy (Unit  Edit Unit) then change the language / status and click OK:

Changing these options for more than one unit is laborious as the above dialog is modal and only works for a single element. The Power Pack version may be launched on either a single model element or multiple model elements (the helper automatically checks and filters out any selected model elements that are not units).

If launched from a single unit then the dialog is populated with that unit and all its child units recursively (very useful if you launch it from the project). If launched from multiple selection, then only those selected units are presented. Note that profiles are automatically excluded.

The look and feel of the dialog may be controlled using Themes.

The table may be sorted by clicking the header columns.

Items may be located by first selecting a row and then right-clicking and selecting Locate in Browser.

The Filter field allows filtering of the table using a regular expression (note that the Select All and Deselect All buttons only apply to the currently visible items – that is those that have not been filtered out)

Changing Units Individually

Individual units may have their language changed simply by selecting the new language in the Language column:

Individual units may have their Read Only / Include in next load status changed simply by clicking the appropriate checkbox:

Changing Units in Bulk

The options at the top of the form allow bulk editing. Note that clicking Apply will apply the changes to all rows that have their Selected checkbox set to true (not necessarily those that are visible). If you have applied a filter, selected items are still affected even if you cannot see them.

Note that changing the Language status requires that the unit be read-write however changing the Include in Next Load status does not. If you change the Language and Read Only Status at the same time, then the helper is smart enough to perform the actions in the correct order so that both take effect. If the new Read Only Status is “Read Only” then that change happens last, if the new Read Only Status is “Read Write” then that change happens first.

Loading and Unloading

Clicking Unload will load any Selected units (except the project).

Clicking Load will load any Selected units without loading their children.

Clicking Load with Subunits will load any Selected units along with their children.

Tools

The Tools menu has two useful features described below.

Remove Unit Status

This sets the Store in separate file status for all Selected units to false (in addition they will be removed from the table as they are no longer units)

Touch Selected Units

This action makes a minor, non-persistent edit to all currently Selected units (provided they are not read-only). It temporarily modifies the description by adding and removing a character, ensuring no actual change is made, but causing Rhapsody to flag the unit as modified. As a result, Rhapsody updates the file content, which includes (for example) refreshing names from GUIDs, re-indexing RMM files, updating potentially outdated unit paths, and performing other necessary updates.