The element Selection dialog is used for selecting elements from available contents and adding them to a certain destination scope. The title of the dialog varies depending on the way it is invoked. Depending on the content, the element Selection dialog is used for selecting an element, diagram, or owner. The types of elements available for selection determine the presence of the specific element type filters in the dialog. 

Teamwork Cloud projects

The following message indicates that the representation text indexing is not complete. It is not recommended that you perform element searches while the indexing is in progress. Otherwise, depending on the project size, the search operation might be slow, and the memory consumption might increase.

The element Selection dialog also opens when assigning a property value - the particular element or elements. For example, the element Selection dialog opens when assigning the base classifier in the element Specification window.

In the element Selection dialog, you can perform the following actions:

  • Select one or more elements to assign them as property values.
  • Search for an element.
  • Create elements.
  • Clone a selected element.

The Select Element dialog.

The table below describes the components of the Select Element dialog.

Dialog element name/imageDescription

Search for:

  • Type and Package
  • Property
  • Any Element

Select one of the predefined element type filters to narrow down the search results:

  • Type and Package - select to search for types and packages only.
  • Property - select to search for properties only.
  • Any Element - select to search among all the elements in the model.

Click to customize the search options to optimize the search operation.

Match Text Anywhere

  • To search for a matching phrase in any part of the element name, click the command to add the check mark.
  • To explicitly search from the beginning of the element name, click the command to remove the check mark.

Use Camel Case

  • To search for a matching phrase typed in a camel case, click the command to add the check mark.
  • To search for a matching phrase typed in a regular case, click the command to remove the check mark.

You can use camel case as follows:

  • Type only the first letters (either capitalized or not) of each word, for example, “and” or “AND” to find “Analysis and Design”.
  • Type skipping spacers, for example, “cv3” to find “CV-3”.
  • Perform a partial search, for example, “ibd” to find SysML Internal Block diagram. Be sure the Match Text Anywhere command is checked!

More

Click the button to load the next 100 matches. By default, the first 100 matches are shown in the dialog.

Previous

Next

Available in the Tree view only.

Click to navigate to a previous or next result.

Alternatively, you can press the Shift + F3 keyboard shortcut to select the previous match or press F3 to select the next match.

Switch to Tree

Click to switch from the List to Tree view.

Alternatively, press the Alt+B keyboard shortcut.

Apply Filter
(Ctrl+Space)

Click to clear the check box if you need to remove the search scope filter. If you clear the Apply Filter check box once, your selection is remembered for the next time.

Filter Options

Select to customize the filter options to narrow down the search scope.

  • Hide Uncommon Elements - reduces the search results list by hiding uncommon elements, keeping elements such as Interface, Association Class, Class, and Component in the list.
  • Exclude Auxiliary Resources - reduces the search results list by excluding elements marked as auxiliary. By default, elements in the standard/system profiles are marked as auxiliary. This option does not hide the following:
      1. UML datatypes (placed under MagicDraw Profile) and UML2 Metamodel (placed under UML Standard profile) only for UML project.
      2. UML2 Metamodel,  SysML value types, and stereotypes for SysML project.
      3. Elements with <<ignoreAuxFilter>> stereotype applied and all its elements recursively. How to apply stereotype >>

  • Filter by Package Imports - reduces the search results list by showing elements from the imported packages only.

    Available for the usage element only, i.e., when selecting the type/behavior for properties/actions.

Creation Mode

Click to turn on the element creation mode.
Create Click to create a new element.
CloneClick to clone the selected element.

Single Selection/Multiple Selection

Click to expand or collapse to select a single element or multiple elements.


When searching for an element, type the search phrase in the Search By Name box. The following table describes the search types that can be used.

Search TypeDescription

Simple search in the

List and Tree views

In the Search by Name box, type a phrase to search for element names. Elements matching the search phrase will be displayed in the List or Tree view.

When switching between element selection views, the selected elements are remembered. That is, if the element is selected in the Tree view, it will be selected in the List view as well.

Search using wild cards

In the Search by Name box, type a phrase using the following wildcard characters:

  • “*” substitutes any range of characters. So if your search phrase is “*dd”, all the elements containing “dd” in their names can be found. For example, “Address” and “ThreadDeath”.
  • “?” substitutes exactly one character. So if your search phrase is “?dd”, only the elements with “dd” in their names starting from the second character can be found. For example, “Address”. “ThreadDeath” cannot be found in this case, because it contains more than one character before the search phrase “dd”.

Match Text Anywhere command

Be sure the Match Text Anywhere command is unchecked, when using wildcard characters! Click to find the command.


 

Related pages