Creating IBM Rational Team Concert work items from modeling errors, warnings, and messages

When you validate a UML model or diagram, validation markers such as errors, warnings, and informational messages are displayed in the Problems or Tasks view. You can create Rational® Team Concert work items from these markers so that your team can track and manage modeling work that must be addressed in the Rational UML modeling products.

Before you begin

You can create work items based on the following three levels of model validation severity:

Before you can create work items from error, warning, or informational messages, you must install the Rational Team Concert - Client feature by using IBM® Installation Manager.

About this task

The following high-level steps outline how to set up your environment so that you can create work items from UML modeling validation markers:
  1. Install or update the product with the Rational Team Concert - Client check box selected so the Rational Team Concert integration is installed and enabled.
  2. Connect to the Rational Team Concert repository.
  3. To avoid an error in Rational Team Concert, specify a category before you commit a work item.

Contact your Rational Team Concert administrator for information about how to install the product and how to connect to a repository. You can also consult the documentation in the Rational Team Concert information center for additional information.

If at least one validation marker is displayed in the Problems or Tasks view, you can create Rational Team Concert work items to track and manage work that you must complete in one of the Rational UML modeling products.

To create work items from model validation markers in one of the Rational UML modeling products:
  1. In the Problems or Tasks view, right-click an error, warning, or informational message; then click Create work item.
  2. In the Create New Work Item wizard, select a project area, and click Next.
    Note: This page is displayed only if multiple projects are defined in Rational Team Concert.
  3. On the Work item type page, select the kind of work item, such as Defect, Story, or Task, and click Finish.

A work item is created in the Rational Team Concert project area. The work item editor opens automatically, and the title of the work item is identical to the validation marker message in the Problems or Tasks view. The work item description contains the validation marker details, the involved resource, and one or more validation targets.

Tip: In addition to creating a single work item from a single validation marker, you can also create multiple work items from multiple validation markers. Conversely, you can also create a single work item from multiple validation markers. All of these commands are available when you select and right-click several validation markers in the Problems or Tasks view.
Tip: To understand the reason for an error, warning, or informational message, right-click a marker in the Problems view or Tasks view; then click Constraint definition. To view the subject of a validation error or warning, in the Problems view, right-click a validation marker; then click Go To.

Feedback