An Action Pin is used to define the data values passed out of and into an Action. An input pin provides values to the Action, whereas an output pin contains the results from that Action.
Action Pins are used here to connect two Actions:
Action Pins can be further characterized as defining exception parameters, streams, or states. Associating a state with a Pin defines the state of input or output values. For instance, the Pin could be called 'Orders', but the state could be 'Validated' or 'Canceled'.
To add an Action Pin to an Action, right-click on the Action to display the context menu and select the 'New Child Element | Action Pin' option. (You can also assign Action Pins, to define specific properties of the Action.)
The 'Properties' dialog of an Action Pin has a 'Pin' tab on which you define the specific actions of the Pin.
A Pin serves as an argument for Call Behavior Actions and Call Operation Actions - the Pin name and parameters are shown on the 'Arguments' tab of the Action 'Properties' dialog. When an Action is associated with a valid behavior in the model, the associated behavior's parameters are listed in the 'Parameter' field drop-down list to facilitate a one-to-one mapping between the argument and the parameter. The fields in the 'Argument' panel of the 'Pin' tab are enabled only for Pins belonging to Call Actions, and only when the Action is associated with a valid behavior with valid parameters. To observe this:
- Create an Activity element and give it an Activity Parameter (right-click on it and select 'New Child Element | Activity Parameter').
- Create an Action and set the 'kind' property to 'CallBehavior' (on the 'Advanced' tab of the element's 'Properties' dialog).
- Make the Activity element the classifier for the Action (right-click on the Action element and select 'Advanced | Set Behavioral Classifier'; then locate and select the Activity on the 'Select <Item>' dialog).
- The 'Structural Elements' dialog immediately displays. Select the 'Show Owned/Inherited' checkbox; when this is selected, the Activity Parameter is listed in the 'Defined Elements' panel. Select the checkbox against the Activity Parameter, and click on the .
- The Action element now has an Action Pin representing an argument, with the Activity Parameter as the parameter of the argument.
You can also change the objectState property of an Action Pin on the 'Advanced' tab of the element 'Properties' dialog.