RTC API - Related Change Requests - ServerSide
Hi Guys,
So I've set up an RTC server to be able to communicate with a ClearQuest Web Client. I'm able to use RTC's web GUI to create Related Change Requests linking to that server. RTC, given a ClearQuest user with sufficient modify privileges, is able to automatically link the ClearQuest Item back to RTC (So we end up with a 2-way linkage).
Now what I'd like to do is I'd like to be able to this programmatically using RTC's API. The furthest that I've gone so far is creating Related Artifacts and adding external links to them.
In pseudo code. This is what it would ideally look like:
Edit: I need to be able to do this programmatically but I don't know where to find documentation on the API that does this. How should I go about doing this?
(create Related change requests on a serverside plugin)
This is done in an Operation Participant during a Deliver Operation.
Thanks,
RTC : 4.0.7
References: http://rsjazz.wordpress.com/2013/11/06/creating-clm-links-with-back-link/
https://jazz.net/forum/questions/157350/adding-a-related-change-request-between-work-items-using-the-rtc-java-api
So I've set up an RTC server to be able to communicate with a ClearQuest Web Client. I'm able to use RTC's web GUI to create Related Change Requests linking to that server. RTC, given a ClearQuest user with sufficient modify privileges, is able to automatically link the ClearQuest Item back to RTC (So we end up with a 2-way linkage).
Now what I'd like to do is I'd like to be able to this programmatically using RTC's API. The furthest that I've gone so far is creating Related Artifacts and adding external links to them.
In pseudo code. This is what it would ideally look like:
Create Link Object of Type Related_Change_Request
Object.setDataBase (<nameOfDatabaseAtClearQuest>)
Object.setLinkToExistingItem(true)
Object.setTargetIdAtClearQuestDatabase(TargetIdAtClearQuestDatabase)
targetReferences.add(ObjectEndpoint, Object); Set additionalParams = new HashSet(); additionalParams.add(IAdditionalSaveParameters.UPDATE_BACKLINKS); // Save the trigger work item with the links we created IStatus saveStatus = fWorkItemServer.saveWorkItem3(currentItem, currentReferences, null, additionalParams);As you can see the pseudo code is only listing the steps required (from my understanding) to manually create a Related Change Request through RTC's web GUI
Edit: I need to be able to do this programmatically but I don't know where to find documentation on the API that does this. How should I go about doing this?
(create Related change requests on a serverside plugin)
This is done in an Operation Participant during a Deliver Operation.
Thanks,
RTC : 4.0.7
References: http://rsjazz.wordpress.com/2013/11/06/creating-clm-links-with-back-link/
https://jazz.net/forum/questions/157350/adding-a-related-change-request-between-work-items-using-the-rtc-java-api
One answer
Zaid,
the question is first, what kind of server extension. And then, how to proceed.
I tried to help as good as I am able to on my blog. Start here: http://rsjazz.wordpress.com/2013/02/28/setting-up-rational-team-concert-for-api-development/
Please read it carefully and follow the enclosed links. It should enable you to start doing what you want. It is not trivial though, so don't try to rush it. Really, familiarize yourself with the material available and then start doing your work.
http://rsjazz.wordpress.com/2013/03/14/what-apis-are-available-for-rtc-and-what-can-you-extend/
The code you refer to can be used in any server side plugin. Most common are follow up actions as described in the material and the workshop liked within https://jazz.net/library/article/1000
the question is first, what kind of server extension. And then, how to proceed.
I tried to help as good as I am able to on my blog. Start here: http://rsjazz.wordpress.com/2013/02/28/setting-up-rational-team-concert-for-api-development/
Please read it carefully and follow the enclosed links. It should enable you to start doing what you want. It is not trivial though, so don't try to rush it. Really, familiarize yourself with the material available and then start doing your work.
http://rsjazz.wordpress.com/2013/03/14/what-apis-are-available-for-rtc-and-what-can-you-extend/
The code you refer to can be used in any server side plugin. Most common are follow up actions as described in the material and the workshop liked within https://jazz.net/library/article/1000
Comments
Ralph Schoon
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER Dec 23 '14, 4:06 p.m.Zaid Al-Khishman
Dec 23 '14, 4:31 p.m.