The Append activity within Number Gallery Tutorial HOWTO: Send and receive a Signal via Ports in SysML and Cameo Simulation Toolkit Section Slide kind SysML Activity Diagram
HOWTO set a ValueSpecificationAction to use the * LiteralUnlimitedNatural to drive an 'insertAt' InputPin on an AddStructuralFeatureValueAction in Cameo Simulation Toolkit and Cameo Systems Modeler
The semantics are undefined for adding a value that violates the upper multiplicity of the StructuralFeature, and for adding a new value to a StructuralFeature with isReadonly=true after initialization of the object that would have the value. Source Unified Modeling Language 2.5.1
The insertion point is ignored if it is used when isReplaceAll=true. Source Unified Modeling Language 2.5.1
Reinserting an existing value at a new position in an ordered, unique StructuralFeature moves the value to that position (this works because such StructuralFeature values are ordered sets). Source Unified Modeling Language 2.5.1
The semantics are undefined for a value of 0 or an integer greater than the number of existing values Source Unified Modeling Language 2.5.1
A value of unlimited (“*”) for the insertion point means to insert the new value at the end of the sequence. Source Unified Modeling Language 2.5.1
An insertion point that is a positive integer less than or equal to the current number of values means to insert the new value at that position in the sequence of existing values, with the integer 1 meaning the new value will be first in the sequence. Source Unified Modeling Language 2.5.1
If the insertAt InputPin is present, it has type UnlimitedNatural and multiplicity 1..1 Source Unified Modeling Language 2.5.1
UML-2.5.1: Statement about 'Adding a value to an ordered StructuralFeature requires an insertion point' contradictory. First it says 'insertAt' is 'required', then it says it is not always 'required'. The 'insertAt' attribute is [0..1].
Adding a value to an ordered StructuralFeature requires an insertion point for the new value given in the insertAt InputPin, which is required for ordered StructuralFeatures when isReplaceAll is false and omitted for unordered StructuralFeatures. Source Unified Modeling Language 2.5.1
