Remove structural feature value action (dictionary item)
For automation interface information about a Remove Structural Feature Value Action, see
Action node (automation interface). For automation interface purposes, a Remove Structural Feature Value Action is an Action Node that has its Node Type set to Remove Structural Feature Value Action.
A Remove Structural Feature Value Action is a write structural feature action that removes values from structural features.
Create a Remove Structural Feature Value 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
Remove Structural Feature Value Action button, and then click in free space or inside an Activity Partition, Interruptible Activity Region or Structured Activity Node.
To access the
Remove Structural Feature Value Action button, click the arrow next to the
Read Self Action button and then select the
Remove Structural Feature Value Action button.
When you create a Remove Structural Feature Value Action, you are prompted to select the Attribute or Role for which the value is removed. After creating a Remove Structural Feature Value Action you cannot link that Remove Structural Feature Value Action to a different Attribute or Role. You can view which Attribute or Role is linked to a Remove Structural Feature Value Action through the Remove Structural Feature Value Action's property pages: on the Items tab, select Linked Item.
| If you select a Package scoped Attribute, the consistency report will record the following errors for the Remove Structural Feature Value Action and its Object Pin: |
• For the Remove Structural Feature Value Action: The structural feature must not be static (C20083).
• For the Object Pin: The type of the input object pin must be the same as the classifier of the structural feature (C20082).
On creation of a Remove Structural Feature Value Action, Modeler creates the following Input Pins and Output Pins:
• Object Pin - the type of this Input Pin is the Class, Data Type, Interface or Signal that owns the Linked Item (Attribute or Role).
• Remove At Pin - the type of this Input Pin is a Basic Type named UnlimitedNatural. This Input Pin is created only when the linked Attribute or Role is not unique.
• Result Pin - the type of this Output Pin is the Class, Data Type, Interface or Signal that owns the Linked Item (Attribute or Role).
• Value Pin - the type of this Input Pin is the type of the Linked Item (Attribute or Role).
You cannot add any other Input Pins or Output Pins to a Remove Structural Feature Value Action.
When used on an Activity Diagram, a Remove Structural Feature Value 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 Type. By default, the Action Type and Linked Item Name are shown. The view options are set through the Action Node entry. See
Action node view options - activity diagram.
On an Activity Diagram, you can populate a Remove Structural Feature Value Action's missing Activity Flows, Pins, Comments and Constraints: right-click the Remove Structural Feature Value Action, select Populate, and then click the appropriate command.
In the Dictionary pane, Remove Structural Feature Value Actions are listed in the UML\Action Nodes folder.
In the Modeler panes, a short-cut symbol
on the Remove Structural Feature Value Action's icon indicates that the item is a stub.
The following sections provide information about how a Remove Structural Feature Value Action is used in the model.
Properties
In addition to the standard properties a Remove Structural Feature Value Action has these properties:
Remove Duplicates (Is Remove Duplicates through the automation interface)
Owned by
Activity - The Activity that scopes the Remove Structural Feature Value Action.
Structured Activity Node - Applies only when the Remove Structural Feature Value Action is scoped directly to a Structured Activity Node.
Owns
Control Flow - The Control Flow is owned jointly by the Remove Structural Feature Value 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 Remove Structural Feature Value 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 Remove Structural Feature Value 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, Remove At Pin and Value Pin input pins that Modeler creates on creation of the Remove Structural Feature Value Action.
IO Flow - The IO Flow is owned jointly by the Remove Structural Features Action, the IO Flow's other linked item and the IO Flow's IO Item.
Output Pin - Only the Result Pin that Modeler creates on creation of the Remove Structural Feature Value Action.
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 Remove Structural Feature Value Action can be linked to the following items.
Stereotype - To make a Remove Structural Feature Value Action valid for a Stereotype, set up Action Node a valid item type.