Using Reference Presentations to Create Links and Show Linked Work Items in RTC

I recently complained to our development that creating and displaying links between work items is too complex. I wanted a special presentation for that purpose. To my excitement I was instructed, that we have such a feature. Joy! This post explains how you use it.

I have done so much customization in RTC, that I was convinced I knew all of it already. Hubris! My bad. So there are things I haven’t done in RTC. I assume others also have not spotted this and I think it is worth blogging about.

Add a Presentation of Type References

To be able to show specific references (aka links) from the current work item to other items you basically have to add a new presentation to your editor presentation. On the Editor presentation editor select the section where you want to show the presentation and click Add Presentation….

The Presentation you want is a Non-Attribute-based Presentation. Choose this option and select References from the available set of choices.

In the Link Type selection drop down, select the reference (aka link type) you want to see and maintain here.

The image below shows the steps.

Add Reference Presentation

Use a Presentation of Type References

Once you have done that, you have a new presentation that will show only the references/links that qualify. It will also allow you to create new references/links from that dialog. The image below shows what you can do:

Use Reference PresentationSummary

This kind of presentation allows you to view and modify relationships in a more organized way on the work item editor and can help you understanding the relationships better, especially if the relationship represents important information in your object model.

As always I hope this information is useful to someone out there and helps using RTC more effective.


8 thoughts on “Using Reference Presentations to Create Links and Show Linked Work Items in RTC

  1. I was knowing this because I developed a new process from scratch. But just now I got the idea to have e.g. a tab with multiple presentations for the links we defined to use. E.g. parent/child and resolves/resolved by.
    Also the idea to have an own presentation for the link to CQ is a very good idea. But there I have an issue, how can I separate defects managed in CQ from defects managed in the project area itself. Our process has defines the enterprise defects in CQ (e.g. your APAR’s), but the team defects (more informal within a sprint) in a workitem.. Both have today the affected by defect link type.
    Another remark I have in this area since years (its one of my highest ranked topic at each conference): The link presentation should allow to display OSLC attributes from the linked object. E.g. status, priority, owner. This means there should be an enhanced presentation available. But development tells me always this is difficult and it harms performance to much etc..
    Is there somewhere n example how to write such an own presentation? If yes maybe I can build something by my own.

    • Guido, I think the link types for WI and CQ links are different.

      With respect to the attributes – I have seen this request with other customers. I am not sure what the status is though. I would create an enhancement request.

      My responses will be slow the next few weeks, as I am out of office.

  2. Hi Ralph,

    I have added this presentation for adding children & it works in the eclipse client fine. However in the RTC web client I am unable to see this presentation itself. I am using RTC 4.0. Does this presentation hold good only for eclipse client & not web ?

    Vishnu M

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.