Managing elements

This page outlines the basic common procedures regarding element management.

Useful information for element management

• For more information on working with the Textual Editor and textual notation, see the Working with Textual Editor section.
• For a comprehensive list of SysML v2 elements, their textual notation keywords, and relevant procedures, see the Model composition section. 

Declaring a root namespace

A root namespace contains the model elements. It does not have textual representation. For more information, see the Key concepts page.

To declare a root namespace

1. In the Containment tree, right-click the global namespace (by default, the global namespace name is the same as the project name).
2. In the shortcut menu, select Create Namespace.

Creating an element

The procedures below describe the basic options for creating the majority of the model elements. For more information, see the Key concepts page.

Creating an element via the Textual Editor

To create an element via the Textual Editor

1. In the Textual Editor, type the keyword for the element you want to create followed by its name.

   part flashlight;

2. Click the Synchronize button. 

Creating an element via the Create Element command

To create an element via the Create Element command

1. In the Containment tree, right-click an element, and in the shortcut menu, click Create Element. The Create Element dialog is displayed.

2. In the Create Element dialog, select the element you want to create.
3. Type the name for the newly created element.

Creating an element via the view palette

To create an element via the view palette

1. In the View Palette, click on the element you want to create.

2. Hover the cursor over the View Pane and click on the location where you want the new element to be created.
3. Type the name for the newly created element.

Creating an element via the smart manipulator in a view

Creating an element via the smart manipulator is only available for a limited selection of elements (e.g., ports, connectors).

To create an element via the smart manipulator in a view

• In a view, select a symbol, and in its smart manipulator, click the command for the needed element.

Creating an element via the symbol compartment in a view

To create an element via the symbol compartment in a view

• See the procedure Creating elements via compartments on the Compartments page. 

Creating an element via the Specification panel

To create an element via the Specification panel

• Do one of the following:
  • See the procedure Creating an element via the Specification panel on the Specification panel page. 
  • See the procedure Creating an element via the compartment in the Specification panel on the Specification panel page. 

Creating an element via the Drag and Drop handler In a view

To create an element via the Drag and Drop handler in a view

• See the Drag and Drop handler page.

Auto-creating a definition element via the Extract Definition command

To auto-create a definition element via the Extract Definition command

• See the Extract Definition and Usage page.

Creating a relationship element via the Create Relationship command

To create a relationship element via the Create Relationship command

1. Right-click element(s) or element symbol(s) for which you want to create relationship(s).
2. In the shortcut menu, click Create Relationship, then in the submenu, click either Outgoing or Incoming, and then in the submenu, click the relationship you want to create. The Element Picker dialog opens.
3. In the Element Picker dialog, do one of the following:
   1. In a view, click the element symbol. Hold Shift to select multiple elements. 
   2. Click the Add button. The element selection dialog opens. In the element selection dialog, select the element(s) and click OK.
   3. Drag and drop the needed element(s) from the Containment tree onto the Element Picker.
4. In the Element Picker dialog, click OK. The specified relationship is created between the selected elements.

Copying, pasting, and cutting an element

Elements cannot be copied and pasted between separate SysML v2 projects.

Copying an element via the Textual Editor

To copy an element via the Textual Editor

1. In the Textual Editor, select the element you want to copy and do one of the following:
   1. Right-click the selection and in the shortcut menu click the Copy command.
   2. Press Ctrl+C on the keyboard.

Copying an element via the Containment tree

To copy an element via the Containment tree

1. In the Containment tree, select an element you want to copy and do one of the following:
   1. Right-click the element and in the shortcut menu click the Copy command.
   2. In the main menu, click Edit > Copy.
   3. Press Ctrl+C on the keyboard.
   4. Press Ctrl, then drag and drop the selected element to the element where you want the selected one to be copied and pasted.

Copying an element symbol in a view 

To copy an element symbol in a view 

1. In a view, select an element symbol you want to copy and do one of the following:
   1. In the view toolbar, click the Copy button.
   2. In the main menu, click Edit > Copy.
   3. Press Ctrl+C on the keyboard.

Pasting an element via the Textual Editor

To paste an element via the Textual Editor

1. In the Textual Editor, place the cursor where you want to paste the copied notation and do one of the following:
   1. Right-click and in the shortcut menu click the Paste command.
   2. Press Ctrl+V on the keyboard.

Pasting an element via the Containment tree

To paste an element via the Containment tree

1. In the Containment tree, select an element where you want to paste the copied element and do one of the following:
   1. Right-click the element and in the shortcut menu click the Paste command.
   2. In the main menu, click Edit > Paste.
   3. Press Ctrl+V on the keyboard.

Pasting an element or its symbol via a view

To paste an element or its symbol via a view

1. In a view, select an element symbol for which you want to paste the copied element symbol and do one of the following:
   1. In the view toolbar, click the Paste button to paste the copied symbol without creating a new element.
   2. In the main menu, click one of the following:
      1. Click Edit > Paste to paste the copied symbol without creating a new element.
      2. Click Edit > Paste with New Element to paste the copied symbol and create a new element for it.
   3. Press one of the following shortcut keys:
      1. Press Ctrl+V to to paste the copied symbol without creating a new element.
      2. Press Ctrl+E to paste the copied symbol and create a new element for it.

Cutting an element via the Textual Editor

To cut an element via the Textual Editor

1. In the Textual Editor, select the element you want to cut and do one of the following:
   1. Right-click the selection and in the shortcut menu click the Cut command.
   2. Press Ctrl+X on the keyboard.

Cutting an element via the Containment tree

To cut an element via the Containment tree

1. In the Containment tree, select an element you want to cut and do one of the following:
   1. Right-click the element and in the shortcut menu click the Cut command.
   2. In the main menu, click Edit > Cut.
   3. Press Ctrl+X on the keyboard.

Deleting an element

Deleting an element via the Textual Editor

To delete an element via the Textual Editor

1. In the Textual Editor, select the element keyword and its notational text.

   part flashlight;

2. On the keyboard, press either one of the following keys:
   1. Delete key.
   2. Backspace key.
3. Click the Synchronize button. 

Deleting an element via the Containment tree

To delete an element via the Containment tree

1. In the Containment tree, select an element you want to delete and do one of the following:
   1. Right-click the element and in the shortcut menu click the Delete command.
   2. In the main menu, click Edit > Delete.
   3. Press Delete key or Ctrl+D on the keyboard.

Deleting an element or its symbol via a view 

To delete an element or its symbol via a view

1. In a view, select an element symbol you want to delete and do one of the following:
   1. In the view toolbar, click one of the following:
      1. Delete button to delete the element from the model.
      2. Remove from Diagram button to remove the element symbol from the view.
   2. In the main menu, click one of the following:
      1. Click Edit > Delete to delete the element from the model.
      2. Click Edit > Remove from Diagram to remove the element symbol from the view.
   3. Press one of the following shortcut keys:
      1. Press Ctrl+D to delete the element from the model.
      2. Press Delete to remove the element symbol from the view.

Deleting an element via the compartment in the Specification panel

To delete an element via the compartment in the Specification panel

• See the procedure Deleting an element via the compartment in the Specification panel on the Specification panel page.