Jazz Forum Welcome to the Jazz Community Forum Connect and collaborate with IBM Engineering experts and users

How to fix "CRRRS6546E The specified configuration cannot be found" error when calling DNG Comparison API

Questions
Tags
Users
Badges
Joshua Baxter
(66●3●14●21) Sep 30, 9:27 a.m.

We are using Doors Next Generation 7.0.3 (we are using it with ELM) and I am trying to call it's Comparison API since I will eventually use it within a custom widget. I found this example: https://www.ibm.com/support/pages/how-compare-two-configurations-rest-api-ibm-engineering-requirements-management-doors-next . However when I call the API, I get a ""CRRRS6546E The specified configuration cannot be found" error. For example:



If I access the soucrceConfigUri (https://server.url/gc/configuration/1343) and targetConfigUri (https://server.url/gc/configuration/1326) on the browser, I am taken to the streams in GCM so I don't see how the URIs I'm using are incorrect. Is there a particular method that has to be done to get the URIs so that they will work in the comparison API? The example document above did not explain how to get the URIs. I'm trying to get the URIs manually right now, but is there also a way to get them programmatically?

0 votes

1 answer
292 views
0 votes

Accepted answer

Permanent link
Ian Barnard
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER (2.4k●7●14) edited
Sep 30, 12:30 p.m.

AFAIK the comparison API does comparison between two configurations in the same DOORS Next component - so first: use local configuration urls, i.e. not GC urls; second: make sure to URL encode query parameter values, i.e. the configuration urls. For example your URL should look like: https://server.url/rm/publish/diff?sourceConfigUri=https%3A%2F%2Fserver.url%2Fgc%2Fconfiguration%2F1343&targetConfigUri=https%3A%2F%2Fserver.url%2Fgc%2Fconfiguration%2F1326&includeItems=artifacts


You can find DOORS Next configuration URLs by discovery using the Process and OSLC APIs - there's a walkthrough of discovery here https://jazz.net/forum/questions/266334/dng-oslcfetch-components-from-project-area/266667

FYI The GC application has an OSLC Query API which will make it easier to find e.g. the GC URL for a configuration with a specific name. DOORS Next doesn't have this - you have to do the discovery sequence like above checking the dcterms:title of configurations for the one you want. The GC APIs are documented on your http://SERVER:PORT/gc/doc/scenarios

For an overview of all APIs start here https://jazz.net/wiki/bin/view/Deployment/ELMProductAPILanding

Joshua Baxter selected this answer as the correct answer

1 vote

Comments
Joshua Baxter
Sep 30, 5:29 p.m.

I didn't know i had to use the local configuration URLS and not the GC URLS. I used the local configuration URLS and that worked, thanks! I honestly don't understand what the difference is between local configuration and global configuration other than the fact that working off the global configuration in ELM allows you to link to different project areas, and that you have to use local configuration URLs and not GC URLS for the comparison API. Are those the only 2 differences?

Ian Barnard
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER Sep 30, 6:53 p.m.

There are many differences. I guess one difference is that a GC can include multiple contributions from DOORS Next local configurations, so trying to use a GC URL would be ambiguous - isn't specific about which actual local configs should be compared.

1 vote

Ian Barnard
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER Oct 01, 8:25 a.m.

I updated the comparison API doc on jazz.net wiki to say that both configs must be local. See https://jazz.net/wiki/bin/view/Main/DNGReportableRestAPI

1 vote

Joshua Baxter
Oct 09, 3:26 p.m.
  1. Are there existing examples for how to parse through the XML results returned by the comparison API?
  2. I know you can manually compare streams in DNG via the "Compare Configuration..." option. Is that functionality using the comparison API? If not, what API is it using?

Ian Barnard
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER Oct 10, 3:45 a.m.

Sorry don't know to both questions, except that there is only one public supported comparison API.

Your answer

Register or log in to post your answer.

Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.

Ask a question
Guidelines
FAQ
Search context
Follow this question

By Email: 

Once you sign in you will be able to subscribe for any updates here.

By RSS:

Answers
Answers and Comments
Question details
× 10,938

Question asked: Sep 30, 9:27 a.m.

Question was seen: 292 times

Last updated: Oct 10, 3:45 a.m.

Confirmation Cancel Confirm