Create object action (dictionary item)
For automation interface information about a Create Object Action, see
Action node (automation interface). For automation interface purposes, a Create Object Action is an Action Node that has its Node Type set to Create Object Action.
A Create Object Action is an action that creates an object that conforms to a statically specified classifier and puts it on an output pin at runtime. This action instantiates a classifier.
Create a Create Object 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
Create Object Action button, and then click in free space or inside an Activity Partition, Interruptible Activity Region or Structured Activity Node.
To access the
Create Object Action button, click the arrow next to the
Read Self Action button and then click
Create Object Action.
When you create a Create Object Action, you are prompted to select or create the Class, Data Type or Signal that is created by the action. After creating a Create Object Action you cannot link that Create Object Action to a different Class, Data Type or Signal. You can view which Class, Data Type or Signal is linked to a Create Object Action through the Create Object Action's property pages: on the Items tab, select Linked Item.
On creation of a Create Object Action, Modeler creates an Output Pin named Result Pin. The Output Pin's data type is the item that is linked to the Create Object Action. You cannot delete this Output Pin, and you cannot create any other Output Pins or Input Pins on a Create Object Action.
When used on an Activity Diagram, a Create Object 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. See
Action node view options - activity diagramOn an Activity Diagram, you can double-click a Create Object Action to open child diagrams of the linked Class, Data Type or Signal.
On an Activity Diagram, you can populate a Create Object Action's missing Activity Flows, Output Pins, Comments and Constraints: right-click the Create Object Action, point to Populate, and then click the appropriate command.
In the Dictionary pane, Create Object Actions are listed in the UML\Action Nodes folder.
In the Modeler panes, a short-cut symbol
on the Create Object Action's icon indicates that the item is a
stub.
The following sections provide information about how a Create Object Action is used in the model.
Properties
In addition to the
standard properties a Create Object Action has these properties:
Owned by
Activity —The Activity that scopes the Create Object Action.
Structured Activity Node —Applies only when the Create Object Action is scoped directly to a Structured Activity Node.
Owns
Control Flow —The Control Flow is owned jointly by the Create Object 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 Create Object 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 Create Object 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.
IO Flow —The IO Flow is owned jointly by the Create Object 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 Clear Object 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 Create Object Action can be linked to the following items.
Stereotype —To make a Create Object Action valid for a Stereotype, set up Action Node a valid item type.