Jazz Forum Welcome to the Jazz Community Forum Connect and collaborate with IBM Engineering experts and users

Are there any API docs?

 I'm trying to use the JazzRTC Java API but I'm having a lot of difficulty understanding how to use it.  I have found the Javadocs already, and although javadocs are great from a pure technical perspective, they do not explain how things work together from a general perspective.

I found the following blog on the Jazz site Rational Team Concert Plain Java API's which is a good start, but I'm still struggling to understand basic principals.  For example, which classes I need to use to checkin/checkout files from a workspace.  Which classes I need to deliver content to a stream.  Etc.

Is there any additional documentation apart from the javadocs to better understand how Jazz/the API works?

0 votes



2 answers

Permanent link
There is JavaDoc for download, however, I don't think it is very useful.
Start here: Setting up Rational Team Concert for API Development and Understanding and Using the RTC Java Client API and search that blog for more info. Also What API's are Available for RTC and What Can You Extend? and https://rsjazz.wordpress.com/interesting-links/ could be useful.  

0 votes

Comments

 Thanks.  I had found a lot of those sites already.  At the moment, I'm specifically looking for docs relating to creating files/folders via the API and can only find blogs (mostly from non-official Jazz sites) which use parts of the API which are undocumented (ex: IFileItem, IFileContent,Manager, IFile*, etc).


So I'm wondering where the knowledge comes from?  There are no API docs for these classes, and I read somewhere that no javadocs means the classes aren't part of the official API (useable, but can easily change from one version to another).

So how/where do I find out how to manage files & folders?

There is few official documentation available besides the JavaDoc. There is however the SDK and you can basically see the classes and the documentation if you followed  Setting up Rational Team Concert for API Development and Understanding and Using the RTC Java Client API. Even, if available for internal classes.

We who share looked into the SDK how RTC uses this itself. and some like Evan are developers. You will not find other documentation. So go with the posts e.g. https://rsjazz.wordpress.com/2013/10/15/extracting-an-archive-into-jazz-scm-using-the-plain-java-client-libraries/ or http://thescmlounge.blogspot.de/2013/08/getting-your-stuff-using-rtc-sdk-to-zip.html .





Permanent link
the structure of the API for source code mgmt is a lot more complex than the workitem api.

Unless you REALLY REALLY need to use the API, I would suggest using the commandline to build scripts.

additionally you might be able to get some concepts here
https://jazz.net/library/LearnItem.jsp?href=content/docs/client-tour/using-scm.html

note that like the rest of the system, scm is object oriented, so it takes many classes generally to construct an operating piece of logic

0 votes

Comments

 Using the commandline is not an option.  I REALLY, REALLY, need to use the API to embed the solution into another application.


Your answer

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

Search context
Follow this question

By Email: 

Once you sign in you will be able to subscribe for any updates here.

By RSS:

Answers
Answers and Comments
Question details
× 10,936
× 411

Question asked: Aug 27 '15, 2:35 p.m.

Question was seen: 3,569 times

Last updated: Aug 27 '15, 9:51 p.m.

Confirmation Cancel Confirm