A Role is one end of an Association. A binary Association has a Role at each end. Roles can be identified by a Name, else the name of the associated item is used. Role names are similar to association direction names, except that a noun rather than a verb is used.

A Role can be shown on a Composite Structure Diagram as a part (Port check box cleared) or port (Port check box selected). For more information about parts and ports, see Overview of parts and Overview of ports.

Modeler create two Roles (start and end) when an Association is created in the model. Initially the Roles are unnamed, but you can rename the Roles through either the Dictionary pane, or through the In Role boxes on the Start Role and End Role tabs of an Association's Property Pages. An Association is always linked to a Start Role and an End Role.

You can create a composite Role through the Part and Port buttons on the Composite Structure Diagram tab.

In the Packages and Parts pane, a Role's name is shown as follows:

When used on a Class Diagram, a Role's notation is as follows:

For information about the View Options available for this symbol, see Association view options - class diagram.

When used on a Composite Structure Diagram, a composite Role's notation is as follows:

If a Part contains a Part that has had its Default Value changed in context, on a Composite Structure Diagram the type of the containing Part is shown in brackets. In the following example, the tire part in context has a Default Value that is different from the tire part on the type, that is, the Wheel Class.

The View Options of a Part or Port allow you to snap a Part or Port inside the boundary, on the boundary or outside the boundary of the owning Part or Port. In addition, you can show a Part's Name and associated text outside of the Part through the View Options - select the Show Text As Floating Attachment check box.

For more information about the View Options available for this symbol, see the following topics:

On a Composite Structure Diagram, top-level Parts can be shown as frames through the Part's View Options.

When used on a Sequence Diagram, a composite Role's (Part or Port instance) notation is as follows.

The full name of a role is derived as follows:

<role name> [<item name at role end of association> - <role/item name at other end of association>]

The following sections provide information about how a Role is used in the model. For more information about a property, item, model part or diagram, click it.

In addition to the standard properties, a Role has these properties:

Behavior - applies only when the Role is a Port. (Is Behavior through the automation interface.)

Composite (Is Composite through the automation interface)

Conjugated - applies only when the Role is a Port. (Is Conjugated through the automation interface.)

Default (Default Value through the automation interface)

Derived (Is Derived through the automation interface)

Multiplicity (My Multiplicity through the automation interface)

Port (Is Port through the automation interface)

Read Only

Service - applies only when the Role is a Port. (Is Service through the automation interface.)

Storage

Unique (Is Unique through the automation interface)

Visibility (Access through the automation interface)

An instance of an Attribute (Part or Port instance on Sequence Diagram) can have these additional Properties:

Anonymous

Name

For information about how the View Options affect the presentation of Roles, see the following topics: