▪Where reference is made to a Display Mode property, any property can be given that legend and so become a controlling property by the following form of usrprops entry if the property name does not match the required name:
▪If the definition defines interfaces and the Show interface indicators symbol property is configured to show the indicators and the Display Mode data is set to present the Realized Interfaces and Required Interfaces properties then they can appear like this:
The complete circle indicates there are realized interfaces, the incomplete circle indicates there are required interfaces. The positions of these indicators do not change, but they point away from the symbol the port is attached to.
▪The SysML Flow Property indicator is controlled by the Show Flow Indicator symbol property along with the FlowProperty Display Mode property.
This is based on a format script (_FmtSysMLFlowProperty) so that this can be changed to build an in/out/inout value based on other properties if required. It currently expects a property with an in/out/inout text value.
If presented, you get a horizontal line in the symbol pen if the port is on a vertical host edge, or a vertical line if the port is on a horizontal host edge. Taking the vertical edge as an example, with the port on the left vertical edge of the host, if the property is set to in you get a -> indicator, out gives you <- and inout gives you <->. If you set the property to in and move the port around the host, the arrow will always point towards the host. Likewise for out, the arrow will always point away from the host.
▪The presentation of the ‘UML Behavior’ Port indicator is controlled by the Show isBehavior indicator symbol property and the isBehavioral Display Mode property.
The behavior indicator is a rounded rectangle connected to the port with a line. This is always just a little wider and a little narrower in height than the minimum size of the port symbol.
▪Scripted name.
For a new port definition, the properties are set up so that only the name will show, even though the presentation of the scripted name is enabled by default.
The Present scripted name symbol property controls whether the scripted name is shown.
The _FmtSysMLPortName format script defines the name content:
[ ... ] denotes optional content.
Format: [<<stereotype>> ][name][ : [~]type]
stereotype comes from the Stereotype definition property.
name can be suppressed – based on the Suppress Name symbol property.
type comes from the Type definition property.
~ denotes conjugation based on the isConjugated definition property.
Behavior
▪The user is not allowed to move a port from one host symbol to another. It is believed that this will be of use in complex diagrams where users want to reposition the port on the same host. If they want to change host they can delete without purging and redraw it.
▪Displayable properties are shown if the symbol property Show displayable properties is ticked.
▪Port Symbols of the same name can be drawn more than once.
▪A message is presented if you try to draw a port when a potential host is not present.
▪The symbol is not resizable by default, but it can be made resizable through a keyword.
▪The user is allowed to drop a definition (by drag drop) that is only defined or represented by a port symbol.
▪A port can be drawn on any symbol or the programmed set of symbol types.
▪A port definition can have a reference to the host definition. See the keyword PORT_HOST_REF_PROP below.
▪Port symbols are added to a Host symbol when it is created, provided that a Ports property exists in the host definition and references definitions. This should be set up to mirror the host reference property in the port definition. If either are not wanted then they can be made to be invisible, but they must both be defined in order for the behavior to work.
▪The refresh for representational consistency performed on drawing the host also adds any lines associated with the ports.
▪Port symbols are removed when the host symbol is removed.
▪Port symbols can be specified to attach to the inside or the outside edge of the host symbol as opposed to straddling it in the example above. See the keywords POSITION_RESTRICT_EDGE_INSIDE and POSITION_RESTRICT_EDGE_OUTSIDE.
Keywords
POSITION_RESTRICT_RESET_TYPES
Resets the list of host symbol types for a port symbol.
Specifies that the port should attach to the inside edge of the host symbol. Cancels the OUTSIDE specification.
POSITION_RESTRICT_EDGE_OUTSIDE
Specifies that the port should attach to the inside edge of the host symbol. Cancels the INSIDE specification.
SIZE_RESTRICT_ALLOW_RESIZE
Registers that a symbol type can be resized (this is intended to be used to allow resizing where resizing has been disallowed through the DISALLOW keyword).
SIZE_RESTRICT_DISALLOW_RESIZE
Registers that a symbol type already allowed to be resized cannot be resized.
PORT_HOST_REF_PROP "propertyname"
Registers a reference property from the port to the host, to be populated only on drawing the port. A property supporting single or multiple references is allowed.
