A perform action usage specifies that an action is performed by the owner of the performed action usage. A perform action usage is referential, which allows the performed action behavior to be defined in a different context than that of the performer.

A perform action usage can be a feature of:

  • a part definition or usage, specifying that the referenced action is performed by the containing part. 
  • an action definition or usage, whereby the perform action usage represents a referential "call" from the containing action to the performed action.

There are two ways an action can be performed by another element:

Performing an action by referencing an action usage defined elsewhere in the model

Performing actions via the Textual Editor

To perform actions via the Textual Editor

  1. In the Textual Editor, within the body of the element that you want to perform an action, do one of the following:
    1. For an unnamed perform action, declare the perform keyword followed by the name of the performed action. 
    2. For a named one, declare the perform action keyword, specify the element name, then reference subset the performed action.
  2. Click the Synchronize button.

action 'run mission';   // referenced action

part 'drone in any mission' {

// unnamed perform action referencing an action defined elsewhere in the model
    perform 'run mission';

// named perform action referencing an action defined elsewhere in the model
    perform action 'run delivery mission' references 'run mission';
    perform action 'run delivery mission' ::> 'run mission';

}

Performing actions via the Drag and Drop handler in a view 

To perform actions via the Drag and Drop handler in a view

  • Drag an action element from the Containment tree or use its symbol's Drag and Drop handler and drop it on:
    • the target element symbol that you want to perform the action by referencing it using the Create Perform Action command. 
    • the perform action usage symbol that you want to perform the action by referencing it using the Set Performed Action command. 

Performing actions via the Specification panel

To perform actions via the Specification panel

  • Drag and drop an action element from the Containment tree or use its symbol's Drag and Drop handler and drop it on the Performed Action field in the Properties section of the Specification panel for the perform action element. 
    The appropriate action is specified for the element.

Performing an action via the owned perform action usage itself as the performed action 

Performing actions via the Textual Editor

To perform actions via the Textual Editor

  1. In the Textual Editor, within the body of the element that you want to perform an action, declare the perform action keyword followed by its name.
  2. Click the Synchronize button.

part 'drone in any mission' {

// performed action is the defined perform action usage itself contained by the parent
    perform action 'run mission';

}

Performing actions via the Create Element command

To perform actions via the Create Element command

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

  2. In the Create Element dialog, select the perform action element.
  3. Name the element.
  4. Specify the perform action's features.

Performing actions via the view palette

To perform actions via the view palette

  1. In the view palette, under the Actions group, click the perform action button.
  2. Click in the view pane where you want to create the perform action symbol.
  3. Name the element.
  4. Specify the perform action's features.