retrieve the snapshot name of the last successful build
![]()
Hi,
I want to retrieve the differences between the current build and the last successful build. In order to do this, I need to retrieve the snapshot's name of the last successful build. Can anyone help me how to do this using the plain-java api's? |
7 answers
![]()
Bernd, can you describe why you need to do this, at a higher level? What is the user story? If it's for generating a change log, note that this is now supported in 3.0. See 59822: ANT task to generate text file with change set descriptions.
To list builds and get the snapshot for each, the APIs to use are as follows. com.ibm.team.build.client.ClientFactory.getTeamBuildClient(ITeamRepository) com.ibm.team.build.client.ITeamBuildClient.getBuildDefinition(String, IProgressMonitor) // lookup definition by id com.ibm.team.build.internal.client.ITeamBuildRecordClient.getBuildResultRecords(IBuildDefinitionHandle[], BuildState[], String[], IProgressMonitor) // get builds for given definition(s) com.ibm.team.build.client.ITeamBuildClient.getBuildResultContributions(IBuildResultHandle, String, IProgressMonitor) // get contributions of a given type Use "buildSnapshot" as the contribution type, available as a constant: com.ibm.team.build.common.ScmConstants.EXTENDED_DATA_TYPE_ID_BUILD_SNAPSHOT If a contribution is found, use com.ibm.team.build.common.model.IBuildResultContribution.getExtendedContribution() and cast to IBaselineSetHandle, then fetch the IBaselineSet item using the item manager as usual. This carries the name. Note that personal builds do not carry a snapshot, so they should be skipped. To get the ITeamBuildRecordClient, use: ITeamBuildRecordClient buildClient = (ITeamBuildRecordClient) teamRepository.getClientLibrary(ITeamBuildRecordClient.class); This is the general way to get a client library for a given repository. We should have a convenience for this on ClientFactory like we do for the others though. I've filed a work item for this. You could also have a look at the source code for the 'Changes' link in the build result editor, at /com.ibm.team.build.ui/src/com/ibm/team/build/internal/ui/scm/ChangeContributionProvider.java It uses a custom query to get the previous non-personal build. Regards, Nick |
![]()
Hi Nick,
Thanks for your detailed answer. I indeed want to generate a changelog. As I understand https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/59822, the new anttask accepts Snapshot Name/UUID or build result UUID as a parameter. I want to detect that name and pass it to the anttask. Regards, Bernd. |
![]()
If you give it the build result UUID, the generateChangeLog task lists the changes relative to the previous build (that had a snapshot, and ignoring personal builds).
In your scenario, is the only difference that you want to compare to the previous -successful- build, rather than just the previous build? Maybe we should just make that an option in the task, e.g. previousBuildStatus="OK". We'd probably also need to check the build status as well, e.g. previousBuildState="COMPLETED", if you want it to ignore abandoned builds. |
![]()
Indeed, that's the only difference. These parameters sound like music to my ears :-)
|
![]() |
![]()
Hi,
Currently I'm using: com.ibm.team.build.internal.client.ITeamBuildRecordClient.getBuildResultRecords(IBuildDefinitionHandle[], BuildState[], String[], IProgressMonitor) // get builds for given definition(s) with an empty array of strings for the third parameter. However I would like to know why this parameter can be used for. For: com.ibm.team.build.client.ITeamBuildClient.getBuildResultContributions(IBuildResultHandle, String, IProgressMonitor) // get contributions of a given type I know I can pass ScmConstants.EXTENDED_DATA_TYPE_ID_BUILD_SNAPSHOT as a parameter to retrieve the contributions of type snapshot. What are other valid contribution types? Regards, Bernd. |
![]()
The 3rd argument to getBuildResultRecords is the list of properties to return for the results. Pass null to return them all. If you pass an empty string, you'll get no properties except for the basic ones like itemId and stateId, e.g. the result's label will come back unset. This is similar to the properties list passed to IItemManager.fetchPartialItem.
For getBuildResultContributions, the set of contribution types is open-ended, but see com.ibm.team.build.common.model.IBuildResultContribution for some well-known ones, e.g.:
ScmConstants also has:
|
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.