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

Export review comments from DNG review

 I have created a DNG review and I have added a module to be reviewed. Then I have added the reviewers and I set it of to review the module and all the artifacts within the module.


How can I export the review comments on the individual artifacts that the reviewers have introduced? DNG shows that are review comments against the artifacts you can reply to the comments but when you try to produce a reports those comments do not come out.

If it is not possible in DNG directly can it be done in RPE? I have been trying with RPE but I cannot get the REST api to get the specific comments out.

We are using JTS 6.0.6 and RPE 7.0.2

Kind regards,

Costas

0 votes


Accepted answer

Permanent link

For anyone else having the same issue I have raised a case with IBM, so if you want to get the review comment from the module artifact then you need to create a template that the data source is a review and you pass that the review information as


https://<server:port>/rm/publish/reviews?resourceURI=<reviewUUID>

With https://<server:port>/rm/publish/reviews?metadata=schema as schema for the review

Then by going through the attached artifacts of the review when you find the module that you need you can reconfigure the module data source with a dynamic configuration element.

Then you can get the artifacts of the module and reconfigure a comment data source with schema https://<server:port>/rm/publish/comments?metadata=schema

The URI that you need to pass in the comments data source is of the following form:

https://<server:port>/rm/publish/comments?resourceURI=<artifactUUID>&artifactReviewUri=<ReviewURI>;

where artifactUUID can be taken from the about of the context binding from the module data source and the review URI constructed from the initial review data source in the form of https://<server:port>/rm/reviews/<ReviewUUID>

Kind regards,

Costas


Ian Barnard selected this answer as the correct answer

1 vote


4 other answers

Permanent link
Have you used the Reviews report built into DNG? You can use that report to produce a detailed summary for a Review, including comments.

The report is available from the menu in the top right of the Review

0 votes

Comments

 Hi Davyd, 


If you have read my case you would have seen that you only put to review the module and not all the artifact in the module. Then you can add review comments in the artifacts of the module by opening the module from the review. 

If you do that and try to print a report from the DNG option you will see that the comments are not coming out in the report.

OK, so the Module Print Book report is no good for you? Do you want just the comments made in the context of the review or can you accept all of them?

 No what it is I have created a review and as reviewed artifact I have selected a module. The assigned reviewers open the module from the review and within the review have added comments to the artifacts included in the module. Those comments can only been seen within the review and not outside of the review.

Have you opened the module in the review context and then tried to use the Print Module Book report?


Permanent link
Hi Costas,
thanks for your answer regarding the export of review comments from DNG review.

How can I insert an appropriate data source schema for the Review and the artifact Review Comments into the Rational Publishing Engine template (.dta file) or where can I get an appropriate data source schema.

Is there a sample .dta file for this?

Kind regards,
Martin

0 votes

Comments

 Hi Martin,


You need to use 
https://<server:port>/rm/publish/reviews?metadata=schema
for the review schema and then
https://<server:port>/rm/publish/comments?metadata=schema
for the comment schema.
That will give you the 2 data-sources that you need for the review and comments.

Then use the URI described above to get the specific review information

Kind regards,

Costas



Permanent link
Hi Costas,
in the document studio (Data > Add Data Source Schema ) there is no predefined data source schema for "Reviews" and "Comments" (only DNG Text and DNG Module).

Did you use the schema discovery (Data > Schema Discovery > REST Schema Discovery) to get the two schemas (https://<server:port>/rm/publish/reviews?metadata=schema and https://<server:port>/rm/publish/comments?metadata=schema) into the document studio?


Kind regards,
Martin 

0 votes

Comments

Hi Martin,


Sorry, I thought that it was obvious. I used the DNG Text and gave it a name of review with the schema described above to do the discovery, and again the same for comments with the schema for comments.

Kind regards,

Costas

 


Permanent link

Hi Costas,

thank you very much for your answer and your help.

I have now implemented everything so far.

To export only the comments that are review comments (and not the normal artifact comments) I check the review ID of the corresponding comment.

But now I ran into the following problem:
The order of the comments seems to be not correct anymore. So if an artifact has multiple comments, then the comments and the replies to the comments do not occur in the correct order. Do you know about this problem?

Kind regards,
Martin

0 votes

Comments

I would really suggest to create your own question - maybe provide a link to here, instead of asking a question in an answer to this already answered and accepted question.


Thank you very much. 

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.

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
× 12,019
× 7,494
× 1,324

Question asked: Feb 28 '22, 11:35 a.m.

Question was seen: 2,616 times

Last updated: Mar 01 '23, 10:16 a.m.

Confirmation Cancel Confirm