Issues (Defects)

In your modeling  issues concerning, or defects in, the development of the system or model might arise; more formally, you encounter a failure to meet defined requirements for the current system. You can represent this failure using an Issue (or Defect) element, which is a structured comment containing information about the issue and the measures taken to manage it. The element is rendered as shown.

d_IssueElement

You can link Issues to model elements that are responsible for the defect, using Realize connectors. You can also create a hierarchy of related Issues using Aggregation connectors. Each Issue element has a status band at the left end, which is color coded to visually represent the value of the Status field in the element properties. The element has an identifying I in the top right corner, which you can hide if you prefer not to show it.

You can create Issue elements on most types of diagram, although the Maintenance diagram is specifically designed for displaying and managing them. You can also create your own issue-management diagram as a Custom diagram. You can add the Issue (and other) elements to the diagram from the Diagram Toolbox, or directly to a package in the Project Browser.

Add an Issue to the model using the Toolbox

Step

Action

See also

1

Open the Maintenance or Custom (or other) diagram to depict the problem.

 

 

2

From the Custom pages or Common page of the Diagram Toolbox, drag the Issue icon onto the diagram.

Custom Toolbox

Common Page

 

3

If the Properties dialog does not automatically display, double-click on the element. Record the name and details of the Issue, in the Properties dialog.

Properties Dialog

Create Maintenance Items

 

Add an Issue to the model using the New Element dialog

Step

Action

See also

1

Identify the package in which to record the Issue, in the Project Browser.

Right-click on this package and select the Insert | New Element context menu option.

 

 

2

Complete the fields on the New Element dialog - in the Type field, click on the drop-down arrow and select Issue.

Add Elements Directly To Packages

 

3

When you have created the element, double-click on it. Record the name and details of the Issue, in the Properties dialog.

Properties Dialog

Create Maintenance Items

 

Notes

To toggle display of the letter I in the top right corner of the element, select or deselect the Show stereotype icon for requirements checkbox on the Options dialog, Objects page
 

Learn more