Will APIs used in Doors Next Generation 7.0.3 work in 7.0.2?
I am developing a widget for Doors Next and I am using the Reportable REST API and OSCL API. For the OSLC API I am specifically doing a query where I am retrieving artifacts within a specified module where a custom attribute has a specific value. For example, the query below is retrieving artifacts that are within the module 1294667, and they have a custom attribute named "pvVariants" that has the value "OPT1":
Accepted answer
Nothing in life is certain.
However, for supported APIs (can be found from https://jazz.net/wiki/bin/view/Deployment/ELMProductAPILanding) the goal is, to not break it. If there is a need to break it, it should be documented. You can see the changes over time for the Reportable REST API in the documentation.
Usually, you would develop for the lowest version number and then see, if there is change in the API, which should be documented.
Comments
Ian Barnard
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER Jan 15, 4:01 a.m.Basically yes except where an API or a feature of an API is described as e.g. 'new in 7.1', but as Ralph says you would be best to develop for the oldest version, e.g. 7.0.2 to ensure the functionality is good for 7.0.2, and forward port to newer versions.
Joshua Baxter
Jan 15, 8:57 a.m.So for the Reportable REST API I don't see anything in the documentation indicating that any functionality is specific to 7.0.3 and beyond, so I'm not too worried about that. However, do you know if there is documentation online somewhere for Doors Next that confirms that can use the oslc_rm:uses in the oslc.select and oslc.where parameters in OSLC queries in 7.0.2 like I am doing in the example in my question? The only OSLC documentation I found for Doors Next is Using OSLC capabilities in the RM application. However, that documentation was last updated on 1/17/2013.
Ralph Schoon
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER Jan 15, 9:21 a.m.OSLC is an open standard that is documented someplace else. E.g. https://docs.oasis-open-projects.org/oslc-op/rm/v2.1/requirements-management-spec.html . Try to follow the public specification.
1 vote
Joshua Baxter
Jan 15, 9:27 a.m.Since OSLC is an open standard, if an OSLC query works in Doors Next 7.0.3, then in theory since Doors Next 7.0.2 also follows the OSLC standard the same query should also work in Doors Next 7.0.2?
Ian Barnard
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER Jan 15, 9:37 a.m.AFAIK that's covered by my "basically yes" comment :-) But please try it to confirm.
1 vote