Prev Next

Select <Item> Dialog

The 'Select <Item>' dialog is a multi-purpose browser and search tool for locating model items such as Classifier elements, properties, attributes and behaviors. The <Item> in the dialog title changes to represent the type of item the original operation is working on.

The dialog is called in a range of operations; for example, setting:

  • The base type or classifier for an Object, Swimlane or Lifeline
  • Classifiers for the return types for operations
  • Classifiers for generalization sets
  • The Composite diagram for an element
  • The Information Item or classifier elements conveyed or realized on an Information Flow
  • The associated behavior for a behavior call
  • The type and return type for operation parameters
  • Activities for State transitions
  • Use Case Scenarios
  • Pattern element defaults
  • Activities from which to generate code
  • The values of Tagged Values

Multiple Selection

Where an operation permits the selection of multiple items, the 'Select <Item>' dialog is automatically enabled to support this; to select the items, press the Ctrl key as you click on each item.

If you want to cancel a selected item, press the Ctrl key and click on the item. If you want to cancel selection of all items, just click on any item without pressing the Ctrl key

Having selected an item, you can continue to expand and browse the hierarchy, and/or search for items; the dialog retains the existing selections until you click on the OK button.

Select a required item

Step

Action

See also

1

During an operation, when it is necessary to locate an element or feature, click on the button.

The 'Select <Item>' dialog displays.

2

If required, in the 'Go To Namespace' field select a namespace to reduce the scope of the displayed hierarchy.

The dialog opens the section of the hierarchy associated with that namespace, and closes all previously-open sections associated with other namespaces.

3

You can either:

  • Expand the selected area of the hierarchy on the 'Browse' tab, or any other Package, and locate the required item (go to step 5) or
  • Click on the 'Search' tab and, in the 'Find' field, type a partial or complete text string to search for the item

4

On the 'Search' tab, you can filter the search further by selecting the 'Whole Word' and 'Match Case' checkboxes.

Each list entry shows the name of the item, the type, any stereotype the item has, the immediate Package in which the item is held, and any successive parent Packages (the Package path).

You can either:

  • Select the item immediately on the 'Search' tab or
  • Right-click on one item or a group of items and select the 'Locate item(s) in tree' option; this redisplays the 'Browse' tab and highlights each selected item in the <namespace> hierarchy

5

Click on the required item.

6

Click on the OK button.

Notes

  • When you have selected an item, the 'Select <Item>' dialog retains the context and item; next time you display the dialog, if the context is similar the dialog opens to the same Namespace and item - for example, if you have selected an activity for a State transition and you start to do the same for another transition, the dialog opens to the activity you previously selected
  • If the context is totally dissimilar, the dialog opens with the Namespace < any > and a collapsed model hierarchy
  • If the available items do not meet your requirements, you can create a new item and define the appropriate properties - click on the Add New button; the appropriate 'Add <Item>' dialog displays, on which you define the required item
  • The Add New button is not always available, depending on the context and the type of item being searched for