How to get list of change sets from DNG stream using OSLC APIs
Hi Team,
Is there any OSLC API to get list of undelivered change sets from DNG stream?
Thanks
|
Accepted answer
Ian Barnard (1.9k●6●13)
| answered May 10 '22, 6:13 a.m.
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER edited May 10 '22, 6:22 a.m. Hi
As David says, changesets aren't part of the OSLC specifications. DOORS Next does expose them as a small addition to the OSLC CM API support. For each configuration there can be a <rm_config:changesets> tag (rm_config is http://jazz.net/ns/rm/dng/config#) with the URL which will list the changesets and (AFAIK) their status.
This tag is alongside the <oslc_config:baselines and oslc_config:streams tags which point to the components baselines and streams.
An example for a stream is:
<rdf:RDF
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:jfs="http://jazz.net/xmlns/foundation/1.0/"
xmlns:acc="http://open-services.net/ns/core/acc#"
xmlns:rmTypes="http://www.ibm.com/xmlns/rdm/types/"
xmlns:process="http://jazz.net/ns/process#"
xmlns:rmWorkflow="http://www.ibm.com/xmlns/rdm/workflow/"
xmlns:dcterms="http://purl.org/dc/terms/"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:h="http://www.w3.org/TR/REC-html40"
xmlns:xs="http://schema.w3.org/xs/"
xmlns:oslc="http://open-services.net/ns/core#"
xmlns:oslc_config="http://open-services.net/ns/config#"
xmlns:rm="http://www.ibm.com/xmlns/rdm/rdf/"
xmlns:j.0="http://jazz.net/ns/rm/dng/config#">
<oslc_config:Stream rdf:about="https://jazz.ibm.com:9443/rm/cm/stream/KSrEEB6Eeuh3Iiax2L3Ow">
<oslc_config:component rdf:resource="https://jazz.ibm.com:9443/rm/cm/component/J_JEEB6Eeuh3Iiax2L3Ow"/>
<rdf:type rdf:resource="http://open-services.net/ns/config#Configuration"/>
<dcterms:title rdf:parseType="Literal">rm_optout_p1 Initial Stream</dcterms:title>
<oslc_config:selections rdf:resource="https://jazz.ibm.com:9443/rm/configSelections/stream/KSrEEB6Eeuh3Iiax2L3Ow"/>
<j.0:changesets rdf:resource="https://jazz.ibm.com:9443/rm/cm/stream/KSrEEB6Eeuh3Iiax2L3Ow/changesets"/>
<oslc:serviceProvider rdf:resource="https://jazz.ibm.com:9443/rm/oslc_rm/-_28tkB6Eeuh3Iiax2L3Ow/services.xml"/>
<dcterms:description></dcterms:description>
<process:projectArea rdf:resource="https://jazz.ibm.com:9443/rm/process/project-areas/-28tkB6Eeuh3Iiax2L3Ow"/>
<oslc_config:acceptedBy rdf:resource="http://open-services.net/ns/config#Configuration"/>
<dcterms:identifier>KSrEEB6Eeuh3Iiax2L3Ow</dcterms:identifier>
<oslc_config:baselines rdf:resource="https://jazz.ibm.com:9443/rm/cm/stream/KSrEEB6Eeuh3Iiax2L3Ow/baselines"/>
<dcterms:creator rdf:resource="https://jazz.ibm.com:9443/jts/users/ibm"/>
<dcterms:created rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime"
>2020-12-17T15:17:33.392Z</dcterms:created>
<acc:accessContext rdf:resource="https://jazz.ibm.com:9443/rm/acclist#-_28tkB6Eeuh3Iiax2L3Ow"/>
</oslc_config:Stream>
</rdf:RDF>
An example of the results from the changesets URL, with one rdfs:member for each CS (there can be a LOT!) - my example below only shows delivered changesets, not sure how undelivered changesets differ, you can check that on your server:
<rdf:RDF
xmlns:dcterms="http://purl.org/dc/terms/"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:oslc="http://open-services.net/ns/core#"
xmlns:oslc_config="http://open-services.net/ns/config#"
xmlns:ldp="http://www.w3.org/ns/ldp#"
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
xmlns:acc="http://open-services.net/ns/core/acc#"
xmlns:process="http://jazz.net/ns/process#">
<ldp:DirectContainer rdf:about="https://jazz.ibm.com:9443/rm/cm/stream/_B5n79td8EeqV5_5cfWW9rw/changesets">
<rdfs:member>
<oslc_config:ChangeSet rdf:about="https://jazz.ibm.com:9443/rm/cm/changeset/_RZAU0I_REeyEDflBVqwSHg">
<dcterms:description>There is limited information available for this Change Set as it has been delivered.</dcterms:description>
<dcterms:identifier>_RZAU0I_REeyEDflBVqwSHg</dcterms:identifier>
<oslc_config:acceptedBy rdf:resource="http://open-services.net/ns/config#Configuration"/>
<dcterms:created rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime"
>2022-02-17T09:09:11.965Z</dcterms:created>
<rdf:type rdf:resource="http://open-services.net/ns/config#Configuration"/>
<oslc_config:overrides rdf:resource="https://jazz.ibm.com:9443/rm/cm/stream/_B5n79td8EeqV5_5cfWW9rw"/>
<oslc_config:component rdf:resource="https://jazz.ibm.com:9443/rm/cm/component/_B5LQANd8EeqV5_5cfWW9rw"/>
<dcterms:title rdf:parseType="Literal">Update module AMR Stakeholder Requirements Specification_UPDATED_UPDATED (delivered)</dcterms:title>
<rdf:type rdf:resource="http://open-services.net/ns/config#Baseline"/>
</oslc_config:ChangeSet>
</rdfs:member>
<rdfs:member>
<oslc_config:Configuration rdf:about="https://jazz.ibm.com:9443/rm/cm/changeset/_M0JgcI9LEeyEDflBVqwSHg">
<oslc_config:acceptedBy rdf:resource="http://open-services.net/ns/config#Configuration"/>
<dcterms:created rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime"
>2022-02-16T17:09:28.695Z</dcterms:created>
<oslc_config:overrides rdf:resource="https://jazz.ibm.com:9443/rm/cm/stream/_B5n79td8EeqV5_5cfWW9rw"/>
<dcterms:description>There is limited information available for this Change Set as it has been delivered.</dcterms:description>
<rdf:type rdf:resource="http://open-services.net/ns/config#ChangeSet"/>
<oslc_config:component rdf:resource="https://jazz.ibm.com:9443/rm/cm/component/_B5LQANd8EeqV5_5cfWW9rw"/>
<rdf:type rdf:resource="http://open-services.net/ns/config#Baseline"/>
<dcterms:identifier>_M0JgcI9LEeyEDflBVqwSHg</dcterms:identifier>
<dcterms:title rdf:parseType="Literal">Update module AMR Stakeholder Requirements Specification. (delivered)</dcterms:title>
</oslc_config:Configuration>
</rdfs:member>
<rdfs:member>
<oslc_config:ChangeSet rdf:about="https://jazz.ibm.com:9443/rm/cm/changeset/_Mat14I_REeyEDflBVqwSHg">
<dcterms:description>There is limited information available for this Change Set as it has been delivered.</dcterms:description>
<dcterms:title rdf:parseType="Literal">Update module AMR Stakeholder Requirements Specification_UPDATED (delivered)</dcterms:title>
<oslc_config:component rdf:resource="https://jazz.ibm.com:9443/rm/cm/component/_B5LQANd8EeqV5_5cfWW9rw"/>
<oslc_config:overrides rdf:resource="https://jazz.ibm.com:9443/rm/cm/stream/_B5n79td8EeqV5_5cfWW9rw"/>
<dcterms:identifier>_Mat14I_REeyEDflBVqwSHg</dcterms:identifier>
<dcterms:created rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime"
>2022-02-17T09:08:38.59Z</dcterms:created>
<rdf:type rdf:resource="http://open-services.net/ns/config#Configuration"/>
<rdf:type rdf:resource="http://open-services.net/ns/config#Baseline"/>
<oslc_config:acceptedBy rdf:resource="http://open-services.net/ns/config#Configuration"/>
</oslc_config:ChangeSet>
....
</rdf:RDF>
You can create a changeset by POST to the changesets URL with good content - see previous answer https://jazz.net/forum/questions/255173/dng-oslc-api-documentation?page=1&focusedAnswerId=255183#255183
HTH
Ian
CLM _User selected this answer as the correct answer
Comments FYI I just found that there's a defect around the list of changesets returned by these GETs, that at the moment it lists all changesets but should only list undelivered changesets - look out for this being resolved in a future version. Defect is https://jazz.net/jazz03/web/projects/Requirements%20Management#action=com.ibm.team.workitem.viewWorkItem&id=139590 APAR PH34390 The defect was resolved in 7.0.2 iFix003
|
2 other answers
David Honey (1.8k●1●7)
| answered May 09 '22, 3:56 a.m.
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER The OSLC Configuration Management specification does not define any mechanism for this. So any solution will not be OSLC based. I will leave it to someone from DOORS Next development to respond if there is any proprietary API for this.
|
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.