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 below 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 Element | Action Pin menu option. (You can also assign Action Pins, to define specific properties of the Action.)
The Properties dialog of an Action Pin has a Pin page 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 page 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 page 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:
|1.||Create an Activity element and give it an Activity Parameter (right-click on it and select New Element | Activity Parameter).|
|2.||Create an Action and set the kind property to CallBehavior (on the Advanced page of the element's Properties dialog).|
|3.||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).|
|4.||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 Close button.|
|5.||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 page of the element Properties dialog.