SysMLv1.x: Customizing the ElementGroup extensions for the Webel Parsing Analysis recipe (simplified)

Gallery
Tutorial
TRAIL: Webel's ultimate guide to Systems Modeling Language (v1) with MagicDraw/Cameo
Section
18:01: Logical grouping with the ElementGroup extension of Comment in SysMLv1.x
Topic level
ADVANCED
UML keywords
Comment
Comment::body
MD:Customization
custom Stereotype
stereotype Property
user defined Stereotype
Profile
tagged value
SysML keywords
ElementGroup
ElementGroup::/criterion
ElementGroup::/member
ElementGroup::/size
ElementGroup::name
ElementGroup::orderedMember
Keywords
Slide kind
UML Profile Diagram
This content has been marked as discussing an ADVANCED topic!
This topic is now also covered in more detail in a separate dedicated tutorial trail:
NEWS: New detailed tutorial: TRAIL: Theory and best practices for the Webel Parsing Analysis recipe for SysMLv1.6+

For completeness, this disclaimer and disclosure once again:

The UML Artifact and its UML standard profile extensions such as «document» Document and «file» File are NOT included in UML4SysML.
Dr Darren of Webel has always opposed the exclusion of the obviously useful UML Artifact from SysML (but in MagicDraw and Cameo you can sneak it in anyway). After all, systems engineers do use documents quite a bit.
Click on the image to view it full size
Full details on how to use Customizations in MagicDraw SysML Plugin and Magic Cyber-Systems Engineer ® (Cameo Systems Modeler®) are beyond the scope of this ElementGroup trail section, but we'll look quickly at the main tricks:
MagicDraw/Cameo: Use a Customization to set the «keyword» on a custom Stereotype. Make sure to save, close, then re-open the project afterwards!
Note also how «invisibleStereotype» has been applied to the verbose properties we wish to (by default) hide from the tagged values display on the comment symbol.

The Customizations also have hideMetatype set TRUE so that the custom Stereotypes will be treated as new Elements. Some 'possibleOwners' have been assigned. And a 'category' has been set so that «snippet» and «document» can be chosen as elements under the Create Element context menu item in the model browser under a category Parsing Analysis.

— END OF TRAIL —
NEWS: New detailed tutorial: TRAIL: Webel SysML Parsing Analysis example: A particle physics taxonomy from Wikipedia
NEWS: New detailed tutorial: TRAIL: Webel SysML Parsing Analysis example: Optical telescopes from Wikipedia: Structure and port-based light flow model
If you have been following this trail section as a prerequisite to the  Webel Parsing Analysis recipe for SysML® tutorials please return here.

You may wish to visit one of these tutorials next:

TRAIL: The SysML-1.6 Hybrid SUV sample and specification diagrams in MagicDraw/Cameo (with annotations) [UNDERGOING UPDATE to SysML1.7]
HOWTO simulate UML-2.5.1 'Figure 14.7 Composite State with two States' in Cameo Simulation Toolkit - Operation-driven Transition case study
HOWTO invoke an operation as a Transition guard in Cameo Simulation Toolkit
TRAIL: UML Behavior: Activities and Actions
Visit more Systems Modeling Language v1 (SysML®) tutorial trails here.
Visit also these screencast tutorial videos
Please email or phone Webel IT Australia on +61 405 029 008 to arrange On-Site, Off-Site, or Live Online remote web training seminars and workshops.
Up next
08:01: The building Blocks of SysML
Notes
[OPTION]{OPTION} Do not feel obliged to use the 'name' property of an ElementGroup if you don't feel it adds value.
[OPTION]{OPTION} The default display of all tagged values on the comment symbol for an ElementGroup can make diagrams cluttered, but you can extend it with a custom stereotype and customise the default visible tagged values.
[TIP]{INFORMATIVE} The Webel Parsing Analysis recipe for SysML1.x does not use the ElementGroup directly, it extends it as a user-defined Snippet stereotype with keyword «snippet» and with MagicDraw Customization.
[TOOL]{INFORMATIVE} In MagicDraw/Cameo the dashed line symbol from a UML Comment or SysMLv1.x ElementGroup to an annotatedElement is called an 'anchor'.
[TIP]{INFORMATIVE} An ElementGroup comment symbol may appear on more than one diagram type and may collect different kinds of anchored annotatedElement members from more than diagram.
[PROPOSAL]{STRONG} Dr Darren of Webel has always opposed the exclusion of the obviously useful UML Artifact from SysML (but in MagicDraw and Cameo you can sneak it in anyway). After all, systems engineers do use documents quite a bit.
[ASSERTION, CAVEAT]{INFORMATIVE} The UML Artifact and its UML standard profile extensions such as «document» Document and «file» File are NOT included in UML4SysML.
[CONVENTION, TIP]{STRONG} Webel Parsing Analysis: typically the quoted extract text (body) of a «snippet» is a short phrase, a sentence, or a couple of short sentences (but not dozens of sentences).
[CAPABILITY, TIP, TOOL] MagicDraw/Cameo: Use a Customization to set the «keyword» on a custom Stereotype. Make sure to save, close, then re-open the project afterwards!
Snippets (quotes/extracts)
  [SysML-1.6] The ElementGroup stereotype provides a lightweight mechanism for grouping various and possibly heterogeneous model elements by extending the capability of comments to refer to multiple annotated elements.
  [SysML-1.6] For example, it can group elements that are associated with a particular release of the model, have a certain risk level, or are associated with a legacy design.
  [SysML-1.6] The semantics of ElementGroup is modeler-defined. In particular, the body text is not restricted. It can describe the grouped elements as well as elements or values related to the grouped elements.
  [SysML-1.6] Element groups are named using the name property.
  [SysML-1.6] The criterion for membership in an element group is specified by the body of the comment the stereotype is applied to. By grouping elements, the modeler asserts that the criterion of the group applies to the member.
  [SysML-1.6] Optionally, members of an element group can be ordered using its orderedMember property.
  [SysML-1.6] ElementGroup::/criterion : String [0..1] Specifies the rationale for being member of the group. Adding an element to the group asserts that the criterion applies to this element. Derived from Comment::body. (derived)
  [SysML-1.6] ElementGroup::/member : Element [0..*] Set specifying the members of the group. Derived from Comment::annotatedElement. (derived)
  [SysML-1.6] ElementGroup::name : String [1] Name of the element group
  [SysML-1.6] ElementGroup::orderedMember : Element [0..*] Organize member according to an arbitrary order. Optional. (subsets: ElementGroup::member)
  [SysML-1.6] ElementGroup::/size : Integer [1] Number of members in the group. Derived. (derived)
  [UML-2.5.1] A Comment is shown as a rectangle with the upper right corner bent (this is also known as a “note symbol”). The rectangle contains the body of the Comment. The connection to each annotatedElement is shown by a separate dashed line.
  [UML-2.5.1] Just like a Class, a Stereotype may have Properties, which have traditionally been referred to as Tag Definitions. When a Stereotype is applied to a model element, the values of the Properties have traditionally been referred to as tagged values.
Visit also
Screencast: MagicDraw SysML/Cameo: Pros and Cons of custom stereotypes in combination with Block inheritance and Part Property structures
Screencast: MagicDraw SysML/Cameo analysis: Possible "gotchas" when extending the SysML Block stereotype
Visit also (backlinks)
TRAIL: Theory and best practices for the Webel Parsing Analysis recipe for SysMLv1.6+
Webel Parsing Analysis: The absolute basics of the process (SysMLv1.x form)
Webel Parsing Analysis for SysML: Requirements for the Parsing Analysis Container (a.k.a. Snippet)
SysMLv2: On the v2 Comment extension of the v2 AnnotatingElement as a candidate Parsing Analysis Container
SysMLv1.x: Q: Why can't a Package with PackageImports be used as a Parsing Analysis text container? Why is the SysML1.6 ElementGroup (extended and customised as the Webel «snippet») far better suited for text-driven model element elicitation?
Webel Parsing Analysis for SysML - simplified profile
TRAIL: Webel SysML Parsing Analysis example: Optical telescopes from Wikipedia: Structure and port-based light flow model
TRAIL: Webel SysML Parsing Analysis example: A particle physics taxonomy from Wikipedia
The Webel Parsing Analysis recipe for SysML
Related slides (includes other tutorials)
Related slides (backlinks, includes other tutorials)
Containment tree view of members of a «snippet» ElementGroup in MagicDraw/Cameo
Simplified profile for Webel Parsing Analysis for SysML1.6+ in MagicDraw/Cameo (adapt as required)