The RTC Work Item shall guide the user to the component, where the fix needs to be done. Is it possible to implement this requirement in RTC?
This was basically a requirement that I was asked for how to implement this with RTC. I also remember it being asked in the Jazz.net forum some time ago. I remember this, because my immediate thought was, this is only going to work using customization or extending RTC. I was quite surprised when a colleague monitoring the forum came up with a simple solution. I tried it out and it is really simple. However, it is quite hard to spot how this can be done. Therefore this post summarizes how you can easily do this yourself.
If you are just starting with customizing RTC Work Items, have a look at Process Enactment Workshop for the Rational solution for Collaborative Lifecycle Management 2012 especially Lab 3-5.
This was done with RTC 4.0.5 but it should work with earlier versions of RTC 4.x.
Create a New Attribute of Type Item
First you need to create a new attribute that will contain the information you want. There are a lot of attribute types you can choose from. There are special types that allow to select RTC Data such as users, team areas and the like. All these are for data related to the work item model. There is a special type for RTC data that is not work Item data from the RTC process model. It is easy to overlook. The type can be used as single selection or as a list. When creating the Attribute use
dependent upon your needs to select one or multiple elements.
If you select a ItemList, the work item UI supports selecting multiple items.
Configure the Editor Presentation
Once you have added the attribute, you need to configure the editor presentations to show the attribute as usual. You select
- The Attribute
- The Kind of the presentation
The available presentation kinds depend on the attribute type you selected. For the type ItemList, select Item List as kind.
The type Item or ItemList is more flexible and allows you to select any of these kinds and additional types that are not available in special attribute types such as SCM Component.
In the ItemList, you could have various objects that are interesting in this context. For example if you want to express what is affected by a work item.
You can select
- Let the user choose
- A specific item type
for the item type type be selectable in the presentation.
Save your changes, to make them available in the process.
Create a Work Item
Now you can create a new work item of the type you modified and select the new attribute. The presentation allows you to choose or add an element. The Select Component Dialog provides you with search and filter mechanisms to find what you need.
You can use RTC work items to express relationships of a work item to other objects using special attribute types.
You can then use these new attributes and their values to drive new automation, e.g. check if a change set is actually for the component the related work item claims it to be. I shall see, if I can publish an article about such an advisor soon.