Group Properties

To view or edit a group's properties, double-click its diagram symbol or Browser or list entry. The property sheet tabs and fields listed here are those available by default, before any customization of the interface by you or an administrator.

The General tab contains the following properties:

Property

Description

Name/Code/Comment

Identify the object. The name should clearly convey the object's purpose to non-technical users, while the code, which is used for generating code or scripts, may be abbreviated, and should not normally include spaces. Neither the name nor code should contain colons. You can optionally add a comment to provide more detailed information about the object. By default the code is generated from the name by applying the naming conventions specified in the model options. To decouple name-code synchronization, click to release the = button to the right of the Code field.

Name and Code are read-only for references to groups.

Stereotype

Extends the semantics of the object. You can enter a stereotype directly in this field, or add stereotypes to the list by specifying them in an extension file.

Reference

[for references to groups only] Name of a group in the current model or another model opened in the workspace, which must be a qualified name. A reference allows you to reuse a group with all its properties without having to define it again. Use the list to select a group in the current model. Use the Browse tool to select a group from any model opened in the workspace. If you select a group from another model, a shortcut is created with the referencing group. When a reference is defined, the name and code are those of the target group, and the properties are grayed.

Once you have defined the reference of a referencing group, you can locate the referenced group in the diagram by right-clicking the referencing group symbol and selecting Find Referenced Group in the contextual menu. The referenced group is displayed with handles in the diagram.

Group type

[unavailable to references to groups] Specifies how child elements are to be used within the group. You can choose between:
  • all

  • choice

  • sequence

For more information, see Group Particles (XSM).

Minimum

Minimum number of times the group can occur. To specify that the group is optional, set this attribute to zero.

Maximum

Maximum number of times the group can occur. For an unlimited number of times, select unbounded.

ID

ID of the group. Its value must be of type ID and unique within the model containing this group.

Keywords

Provide a way of loosely grouping objects through tagging. To enter multiple keywords, separate them with commas.

You can access the Preview tab of a group property sheet directly, by right-clicking the group symbol in the diagram and selecting Preview.