Access DOORS NG cloud trial through REST API
Hello together,
I've just registered for the cloud trial period and wanted to evaluate the DOORS NG REST API access capabilities for a customer project. I'm currently stuck at the point that I'm not able to figure out the correct REST endpoint URL under which I can access my project.
Is there a link or button that gives me the API endpoint URLs or is there a scheme of how to build these URLs?
Thanks in advance!
Accepted answer
Please see https://jazz.net/library/article/1197 . You should be able to access the rootservices document e.g. https://clm.example.com:9443/rm/rootservices from there you can find the service provider catalog https://clm.example.com:9443/rm/oslc_rm/catalog and there the service provides (for the project ares).
https://github.com/eclipse/lyo.client provides a way to use Java and an example to access RM.
One other answer
For completeness, the DNG public API's that are available are:
-
RRC Reportable API - creating custom reports to be run from DNG or RPE, read only.
-
OSLC RM V2 API - the open standard way to programmatically integrate with DOORS Next Generation, there is an elaborate workshop to get you started here OSLC Workshop article. These programs can be from any language that support HTTP REST calls, e.g. Java, C# etc. Hence these are more flexible to run and can read and update DNG data, as part of a web server, or standalone, but have some limitations set by the current OSLC standard, for example module support. In release 6.0.5 extension have been added for modules.
-
DNG Server API - starting with version 6.x, various public RM server API's have been added, for configuration management, task tracker, modules, ReqIF, and type import.
- TRS 2.0 - the OSLC Tracked Resource Set open standard REST API to hook into the stream of low level changes done to resources in the DNG application (and other Jazz apps as well); read only.
- and as mentioned above, there is the client extension capability, these are Javascript extension that generally added as widgets you can run from the dashboard, and can be used to view and edit DNG data. It's more tailored to DNG, so has better module support, but is limited to run in a browser/javascript environment.
And there is the private REST API, which you could reverse engineer looking at the requests/responses, but it isn't documented and supported, and can change over time, so usage at your own risk.