It's all about the answers!

Ask a question

How to get list of change sets from DNG stream using OSLC APIs


CLM _User (2113) | asked May 09 '22, 12:53 a.m.

Hi Team,


Is there any OSLC API to get list of undelivered change sets from DNG stream?

Thanks


Accepted answer


permanent link
Ian Barnard (1.9k613) | 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:process="http://jazz.net/ns/process#"
    xmlns:rmWorkflow="http://www.ibm.com/xmlns/rdm/workflow/"
    xmlns:dcterms="http://purl.org/dc/terms/"
    xmlns:xs="http://schema.w3.org/xs/"
    xmlns:oslc_config="http://open-services.net/ns/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"/>
    <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:oslc_config="http://open-services.net/ns/config#"
    xmlns:ldp="http://www.w3.org/ns/ldp#"
    xmlns:process="http://jazz.net/ns/process#">
    <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
Ian Barnard commented May 12 '22, 6:26 a.m.
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER

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


Ian Barnard commented Jun 02 '23, 6:06 a.m.
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER

The defect was resolved in 7.0.2 iFix003

2 other answers



permanent link
David Honey (1.8k17) | 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.


Comments
CLM _User commented May 09 '22, 4:43 a.m. | edited May 09 '22, 4:43 a.m.

Thanks David, 

Any proprietary API will also work, please anyone respond.


permanent link
sophia Abigail (9) | answered May 10 '22, 8:18 a.m.

 Hi Team, Is there any OSLC API to get list of undelivered change sets from DNG stream? Thanks.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 ...reate a changeset in a Global stream in an RM project. 2. Get the URI of the changeset. 3. Open rest-client and perform a delete operation ...


Comments
Ian Barnard commented Jun 22 '22, 5:35 a.m.
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER

Hi Sophia


See my answer for how to see changesets and the additional note I added about a defect: with the defect fixed you only see undelivered changesets when using the CM API..

HTH
Ian 

Your answer


Register or 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.