Find the default stream URI for a project with a given name. Starting with the rootservices document find the streams and project's service end points. In this example the streams service end point is https://example.com:9435/dm/streams
, and the projects service end point is . https://example.com:9435/dm/projects
.
We need to find the project ID for the project named: "JKE Banking Sample Project".
The projects resource contains information about all the active projects currently hosted by the server. With this resource we can look up the project ID and URI for a project with a given name.
Request:
Headers
GET https://example.com:9435/dm/projects HTTP/1.1
Accept: application/rdf+xml
X-ibm-rmps-internal: true
Response:
Headers
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Last-Modified: Thu, 27 Sep 2012 13:40:03 GMT
Content-Type: application/rdf+xml
Content-Length: 4933
Date: Thu, 27 Sep 2012 13:40:02 GMT
<?xml version="1.0" encoding="UTF-8"?> <rdf:RDF xmlns:j.0="http://jazz.net/xmlns/rmps/groups/1.0/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_zP0Yw_3BEeGn3a-M-_VqvQ"> <j.0:projectName>forElmo</j.0:projectName> <j.0:projectId>_zP0Yw_3BEeGn3a-M-_VqvQ</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_ATqQYvddEeGIbrXzZZZ7PA"> <j.0:projectName>JKE Banking (Design Management)</j.0:projectName> <j.0:projectId>_ATqQYvddEeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_KMb8RPxTEeGn3a-M-_VqvQ"> <j.0:projectName>Project2</j.0:projectName> <j.0:projectId>_KMb8RPxTEeGn3a-M-_VqvQ</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_NaSk4vdcEeGIbrXzZZZ7PA"> <j.0:projectName>Domains</j.0:projectName> <j.0:projectId>_NaSk4vdcEeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_aRbHZQZaEeKn3a-M-_VqvQ"> <j.0:projectName>Marya1</j.0:projectName> <j.0:projectId>_aRbHZQZaEeKn3a-M-_VqvQ</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_u1PvcQfIEeKn3a-M-_VqvQ"> <j.0:projectName>AlexS_Test</j.0:projectName> <j.0:projectId>_u1PvcQfIEeKn3a-M-_VqvQ</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_EjRWUvdbEeGIbrXzZZZ7PA"> <j.0:projectName>[System Defined] Documentation Domains</j.0:projectName> <j.0:projectId>_EjRWUvdbEeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_D-QgYPwfEeGIbrXzZZZ7PA"> <j.0:projectName>Michelle Project</j.0:projectName> <j.0:projectId>_D-QgYPwfEeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_AC5HMAfJEeKn3a-M-_VqvQ"> <j.0:projectName>AlexS_Test2</j.0:projectName> <j.0:projectId>_AC5HMAfJEeKn3a-M-_VqvQ</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_4k9iVfwdEeGIbrXzZZZ7PA"> <j.0:projectName>My Library</j.0:projectName> <j.0:projectId>_4k9iVfwdEeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/__BoSsPdaEeGIbrXzZZZ7PA"> <j.0:projectName>[System Defined] Domains</j.0:projectName> <j.0:projectId>__BoSsPdaEeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_s_Y2UPttEeGIbrXzZZZ7PA"> <j.0:projectName>Architecture Support</j.0:projectName> <j.0:projectId>_s_Y2UPttEeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_FFWvsvdbEeGIbrXzZZZ7PA"> <j.0:projectName>[System Defined] Rational Software Architect Domains</j.0:projectName> <j.0:projectId>_FFWvsvdbEeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_3nVR1PzgEeGn3a-M-_VqvQ"> <j.0:projectName>Test Organization</j.0:projectName> <j.0:projectId>_3nVR1PzgEeGn3a-M-_VqvQ</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_ro-fIPdeEeGIbrXzZZZ7PA"> <j.0:projectName>JKE Banking Sample Project</j.0:projectName> <j.0:projectId>_ro-fIPdeEeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_t1CcMPt-EeGIbrXzZZZ7PA"> <j.0:projectName>JKE Banking Sample Project 1</j.0:projectName> <j.0:projectId>_t1CcMPt-EeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_gLNadf00EeGn3a-M-_VqvQ"> <j.0:projectName>Viz Test</j.0:projectName> <j.0:projectId>_gLNadf00EeGn3a-M-_VqvQ</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_PTK_4ft_EeGIbrXzZZZ7PA"> <j.0:projectName>Test Project 1</j.0:projectName> <j.0:projectId>_PTK_4ft_EeGIbrXzZZZ7PA</j.0:projectId> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/process/project-areas/_hwWvAPxSEeGn3a-M-_VqvQ"> <j.0:projectName>Project1</j.0:projectName> <j.0:projectId>_hwWvAPxSEeGn3a-M-_VqvQ</j.0:projectId> </rdf:Description> </rdf:RDF>
With the projects service document parse it and find the project ID associated with the project name we are interested in. The project URI which is used in other APIs is the URI that the project information is about. In this response we see that the project ID we are interested in is _ro-fIPdeEeGIbrXzZZZ7PA
.
Request:
Query Parameters
GET https://example.com:9435/dm/streams?projectId=_ro-fIPdeEeGIbrXzZZZ7PA HTTP/1.1
HeadersprojectId=_ro-fIPdeEeGIbrXzZZZ7PA
Accept: application/rdf+xml
Response:
Headers
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Last-Modified: Thu, 27 Sep 2012 13:40:04 GMT
Content-Type: application/rdf+xml
Content-Length: 1817
Date: Thu, 27 Sep 2012 13:40:03 GMT
<?xml version="1.0" encoding="UTF-8"?> <rdf:RDF xmlns:j.0="http://purl.org/dc/terms/" xmlns:j.1="https://jazz.net/xmlns/rmps/baselines/1.0/" xmlns:j.2="https://jazz.net/xmlns/rmps/streams/1.0/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> <rdf:Description rdf:about="https://example.com:9435/dm/streams/9"> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/6"/> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/2"/> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/3"/> <j.2:parentSnapshotUri rdf:resource="https://example.com:9435/dm/dm-baselines/7"/> <j.2:projectUri rdf:resource="https://example.com:9435/dm/process/project-areas/_ro-fIPdeEeGIbrXzZZZ7PA"/> <j.1:status>COMPLETED</j.1:status> <j.0:description/> <j.0:title>New Workspace Name</j.0:title> </rdf:Description> <rdf:Description rdf:about="https://example.com:9435/dm/streams/8"> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/8"/> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/6"/> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/2"/> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/3"/> <j.2:ownedSnapshotUri rdf:resource="https://example.com:9435/dm/dm-baselines/7"/> <j.2:projectUri rdf:resource="https://example.com:9435/dm/process/project-areas/_ro-fIPdeEeGIbrXzZZZ7PA"/> <j.1:status>COMPLETED</j.1:status> <j.0:description>JKE Banking Sample Project</j.0:description> <j.0:title>JKE Banking Sample Project</j.0:title> </rdf:Description> </rdf:RDF>
The response includes rdf:Description's about each configuration associated with the project. This includes the name and dependencies on other configurations. These configurations are usually the parent snapshots and snapshots of domain projects that include the resource ontologies of the resources that can be managed in the current project.
If only the default configuration is desired an additional query parameter can be passed to return just the default configuration.
Request:
Query Parameters
GET https://example.com:9435/dm/streams?projectId=_ro-fIPdeEeGIbrXzZZZ7PA&defaultStream=true HTTP/1.1
HeadersprojectId=_ro-fIPdeEeGIbrXzZZZ7PA
defaultStream=true
Accept: application/rdf+xml
Response:
Headers
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Last-Modified: Thu, 27 Sep 2012 13:40:04 GMT
Content-Type: application/rdf+xml
Content-Length: 1105
Date: Thu, 27 Sep 2012 13:40:04 GMT
<?xml version="1.0" encoding="UTF-8"?> <rdf:RDF xmlns:j.0="http://purl.org/dc/terms/" xmlns:j.1="https://jazz.net/xmlns/rmps/baselines/1.0/" xmlns:j.2="https://jazz.net/xmlns/rmps/streams/1.0/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> <rdf:Description rdf:about="https://example.com:9435/dm/streams/8"> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/8"/> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/6"/> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/2"/> <j.0:requires rdf:resource="https://example.com:9435/dm/dm-baselines/3"/> <j.2:ownedSnapshotUri rdf:resource="https://example.com:9435/dm/dm-baselines/7"/> <j.2:projectUri rdf:resource="https://example.com:9435/dm/process/project-areas/_ro-fIPdeEeGIbrXzZZZ7PA"/> <j.1:status>COMPLETED</j.1:status> <j.0:description>JKE Banking Sample Project</j.0:description> <j.0:title>JKE Banking Sample Project</j.0:title> </rdf:Description> </rdf:RDF>
The configuration URI is the subject URI for all the triples in the returned document (https://example.com:9435/dm/streams/8
).