Previous UML Classes Table of Contents UML Packages Next


11.3.38 ReadVariableAction

StructuredActions


   ReadVariableAction is a variable action that retrieves the values of a variable.

*Generalizations

   

    VariableAction (from StructuredActions ) on page 302.

*Description

   This action reads the values of a variable in order if the variable is ordered.

*Attributes

   No additional attributes

*Associations

   • result : OutputPin [1..1] Gives the output pin on which the result is put. (Subsets Action::output)

*Constraints

   [1] The type and ordering of the result output pin of a read-variable action are the same as the type and ordering of the variable.

   self.result.type =self.variable.typeand self.result.ordering = self.variable.ordering

   [2] The multiplicity of the variable must be compatible with the multiplicity of the output pin.

   self.variable.multiplicity.compatibleWith(self.result.multiplicity)

*Semantics

   Issue 8036 - Clarify semantics of read actions; specify that the order of retrieved collections is preserved in the values of the output pin.

   The values of the variable are placed on the output pin of the action. The type and ordering of the output pin are the same as the specified variable. The order of the retrieved values in the output pin is the same as the ordering of the values of the variable. The multiplicity of the variable must be compatible with the multiplicity of the output pin. For example, the modeler can set the multiplicity of this pin to support multiple values even when the variable only allows a single value. This way the action model will be unaffected by changes in the multiplicity of the variable.

*Notation

   No specific notation

   ReadVariableAction is introduced to retrieve the values of a variable.

*Changes from previous UML

   ReadVariableAction is unchanged from UML 1.5.