Clear association action (dictionary item)
For automation interface information about a Clear Association Action, see
Action node (automation interface). For automation interface purposes, a Clear Association Action is an Action Node that has its Node Type set to Clear Association Action.
A Clear Association Action is an action that destroys all links of an association in which a particular object participates. This action destroys all links of an association that have a particular object at one end.
Create a Clear Association Action through a Modeler explorer pane or an Activity Diagram:
• In a Modeler pane, right-click an Activity or Structured Activity Node, and select > > .
• On an Activity Diagram: click the
Clear Association Action button, and then click in free space or inside an Activity Partition, Interruptible Activity Region or Structured Activity Node.
To access the
Clear Association Action button, click the arrow next to the
Read Self Action button and select
Clear Association Action.
When you create a Clear Association Action, you are prompted to select the Association that is cleared by the action. After creating a Clear Association Action you cannot link that Clear Association Action to a different Association. You can view which Association is linked to a Clear Association Action through the Clear Association Action's property pages: on the Items tab, select Linked Item.
On creation of a Clear Association Action, Modeler creates an Input Pin named Object Pin. The Input Pin's type is the source item of the Association that is linked to the Clear Association Action. You cannot delete this Input Pin, and you cannot create any other Input Pins or Output Pins on a Clear Association Action.
When used on an Activity Diagram, a Clear Association Action's notation is as follows.
The View Options on an Activity Diagram allow you to show or hide the Name, Action Type and Linked Item Name. By default, the Action Type and Linked Item Name are shown. The view options are set through the Action Node entry. For more information, see
Action node view options - activity diagram.
On an Activity Diagram, you can populate a Clear Association Action's missing Activity Flows, Output Pins, Comments and Constraints: right-click the Clear Association Action, point to Populate, and then click the appropriate command.
In the Dictionary pane, Clear Association Actions are listed in the UML\Action Nodes folder.
In the Modeler panes, a short-cut symbol
on the Clear Association Action's icon indicates that the item is a stub. For more information, see
Stubs.
The following sections provide information about how a Clear Association Action is used in the model.
Properties
In addition to the
standard properties a Clear Association Action has these properties:
Owned by
Activity - The Activity that scopes the Clear Association Action.
Structured Activity Node - Applies only when the Clear Association Action is scoped directly to a Structured Activity Node.
Owns
Control Flow - The Control Flow is owned jointly by the Clear Association Action and the associated item. The access permissions you have to a Control Flow are determined by the access permissions you have to its source item.
Dependency - The Dependency is owned jointly by the Clear Association Action and the other associated item. The access permissions you have to a Dependency are determined by the access permissions of the dependent item.
Exception Handler - The Exception Handler is owned jointly by the Clear Association Action and the associated item. The access permissions you have to an Exception Handler are determined by the access permissions you have to its source item.
Input Pin - Only the Object Pin that Modeler creates on creation of the Clear Association Action.
IO Flow - The IO Flow is owned jointly by the Clear Association Action, the IO Flow's other linked item and the IO Flow's IO Item.
Defined in these parts of the model
Shown on these diagrams
Can be linked to these dictionary items
In addition to the owning Activity or Structured Activity Node, a Clear Association Action can be linked to the following items.
Stereotype - To make a Clear Association Action valid for a Stereotype, set up Action Node a valid item type.