Interface RemoteBuildServer
-
public interface RemoteBuildServer
Implementation of the interface is registered in XmlRpc at TeamCity server side. Java clients are encouraged to useRemoteBuildServerFacade
instead, which provides more high-level API.
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
REMOTE_BUILD_SERVER
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.String
addToQueue(java.util.Vector addToQueueRequests, java.lang.String rawTriggeredBy)
Adds one or more builds in the queue.byte[]
fetchData(java.lang.String userId, java.lang.String buildId, java.lang.String sourceId, java.lang.String whatToFetch)
Fetches binary data from the server.java.lang.String
findBuildInstanceById(java.lang.String id)
Returns build instance data for the specified idjava.lang.String
findBuildRunnerByType(java.lang.String buildTypeId, java.lang.String runnerType)
Returns the first found build runner of the specified type in the specified build configuration.java.lang.String
findFailedTests(java.lang.String fileFullPath, java.util.Vector testNames)
Looks for the failed tests with the specified names in the build configurations, suitable with the specified file.java.lang.String
findTests(java.lang.String fileFullPath, java.util.Vector testNames)
Looks for the tests (both failed and successful) with the specified names in the build configurations, suitable with the specified file.java.lang.String
findUserById(java.lang.String userId)
Returns user for the specified idjava.lang.Boolean
finishRemoteDebugSession(java.lang.String personalChangeId, java.lang.String buildTypeId)
Finishes the current remote debug session on the certain agent, which is determined by personal change id and build type idjava.util.Vector
getBuildFailedTests(java.lang.String buildId, int startFromIdx, int maxTestsToLoad)
Returns failed tests in the specified build instance, for running build currently executing test will be added to the list too.java.util.Vector
getBuildInstanceLogMessages(java.lang.String buildId, int skipMessages)
Returns messages logged for the specified build instancejava.util.Vector
getBuildInstanceLogMessages(java.lang.String buildId, int skipMessages, int maxCount)
Returns limited number of messages logged for the specified build instancejava.util.Vector
getBuildInstanceModifications(java.lang.String buildId, int policyId, boolean includeModificationsIfPreviousBuildIsAbsent)
Returns modifications detected between the specified build instance and previous build, selected according to the specified policyjava.lang.String
getBuildParameter(java.lang.String buildTypeId, java.lang.String key)
Returns build parameter by parameter name.java.lang.String
getBuildParameters(java.lang.String buildTypeId)
Returns the serialized build parameters map of build type specified.java.lang.String
getBuildRunners(java.util.Vector buildTypeIds)
Returns map from build type ids to lists of enabled build runners for the specified build types.java.lang.String
getBuildsWithArtifacts(java.util.Vector paths, java.util.Vector buildTypeIds)
Returns last finished builds those contain given artifact files.java.util.Vector
getBuildTypesWithArtifactDependencies(java.util.Vector buildTypeIds)
Returns the list of build types that have artifact dependencies.java.util.Vector
getBuildTypesWithTests(java.util.Vector buildTypeIds)
Returns the list of build types those have tests.java.util.Vector
getCanRunAndCompatibleAgents(java.lang.String builtTypeId, boolean includeDisabled)
Returns the agents those are compatible with the specified build type, and on those specified build type can be runjava.util.Vector
getCommitters(java.lang.String buildId, int selectPrevBuildPolicy)
Returns list of committers who made changes between the previous build selected according to the policy, and the specified onejava.util.Vector
getCompilationErrors(java.lang.String buildInstanceId)
Returns compilation errors of the specified buildbyte[]
getContentAfter(java.lang.String modificationId, java.lang.String fileName)
Returns file content, specified by the VcsChange, at the moment right after specified modification has been madebyte[]
getContentBefore(java.lang.String modificationId, java.lang.String fileName)
Returns file content, which corresponded to file before specified modification has been madebyte[]
getFileContent(java.lang.String relativePath, java.lang.String buildId)
Returns specified file content at the moment when specified build has been runjava.util.Vector
getFinishedBuilds(java.lang.String buildTypeId)
Returns all finished build instances in the specified configurationjava.util.Vector
getGroupedByPoolCanRunAndCompatibleAgents(java.lang.String builtTypeId, boolean includeDisabled)
Returns the grouped by pool agents those are compatible with the specified build type, and on those specified build type can be run.java.lang.String
getLastFinished(java.lang.String buildTypeId)
Returns last finished build in the specified configurationjava.lang.String
getLastSuccessfullyFinished(java.lang.String buildTypeId)
Returns last successful finished build instance for the specified configurationjava.util.Vector
getModificationFiles(java.lang.String modId, boolean personalChange)
Returns list of VcsChange structures (changed files) corresponding to modification with specified id.java.util.Vector
getModificationsSinceLastSuccessful(java.lang.String buildTypeId)
Returns all modifications detected since last successfully finished build has been runjava.lang.String
getNewFinishedBuilds(java.util.Vector buildIds, java.util.Vector buildTypeIds)
Returns newly finished buildsjava.lang.String
getParameters(java.lang.String buildTypeId)
Returns the serialized build and config parameters map of build type specified.java.util.Vector
getPendingChanges(java.lang.String buildTypeId)
Returns all changes detected but not run for the specified configurationbyte[]
getPersonalContentAfter(java.lang.String modificationId, java.lang.String fileName)
Returns file content, specified by the VcsChange, at the moment right after specified modification has been made for personal changebyte[]
getPersonalContentBefore(java.lang.String modificationId, java.lang.String fileName)
Returns file content, which corresponded to file before specified modification has been made for personal changejava.lang.String
getProblemRelatedEventCounters(java.util.Vector projectIds)
Returns problem related event counters for specified projects.java.util.Vector
getProjectCommitters(java.lang.String projectId)
Returns list of project committersjava.util.Vector
getRegisteredAgents()
Returns all agents registered on the serverjava.util.Vector
getRegisteredProjects(boolean loadInstances)
Returns snapshots for all projects registered on the serverjava.util.Vector
getRelatedProjects(java.util.Vector buildTypeIds)
Returns projects of specified build configurations and all their parents in project hierarchy.java.lang.String
getResolvedArtifactDependencies(java.util.Vector buildTypeIds)
Resolves artifact dependencies for the specified build types.java.util.Vector
getResponsibilityIds(java.lang.String userId)
Returns id list of all the configuration which are under specified user responsibilityjava.util.Vector
getRunningBuilds(java.lang.String buildTypeId)
Returns all running build for the specified configurationjava.util.Vector
getUsers()
Returns all usersjava.lang.Boolean
haveCommitDecision(java.util.Vector personalChangeIds)
Returns true if at least one of the specified personal changes has non-UNKNOWN commit decisionjava.lang.Boolean
isSequenceBuildType(java.lang.String buildTypeId)
Returns whether the build type is a sequence one (has snapshot dependencies)java.lang.String
lookUpBuildsWithArtifacts(java.util.Vector paths, java.util.Vector buildTypeIds)
Returns last finished builds those contain given artifact files.java.lang.Boolean
muteProblems(java.util.Vector itemIds, boolean unmuteWhenFixed, java.lang.String unmuteTimestamp, java.util.Vector buildTypeIds, java.util.Vector buildIds, java.lang.String userId, java.lang.String comment)
Mutes the specified items.java.lang.Boolean
removeBuild(java.lang.String buildId)
Removes build instance from the server historyjava.lang.Boolean
repeatRemoteDebugSession(java.lang.String personalChangeId, java.lang.String buildTypeId)
Repeats the current remote debug session on the certain agent, which is determined by personal change id and build type idjava.lang.Boolean
repeatRemoteDebugSessionWithNewChanges(java.lang.String personalChangeId, java.lang.String buildTypeId, java.lang.String newChangesPersonalPatchId)
Applies new personal patch and repeats the current remote debug session on the certain agent, which is determined by personal change id and build type idjava.lang.Boolean
schedulePersonalChangeForDeletion(java.lang.String changeId, java.lang.String userId)
Mark personal change as deleted and makes it invisible for userjava.lang.Boolean
setPersonalChangeStatus(java.lang.String changeId, int statusPriority)
sets status of personal changejava.lang.Boolean
stopBuild(java.lang.String buildId, java.lang.String userId, java.lang.String reason)
Schedules specified build to be stoppedjava.lang.Boolean
stopPendingPersonalBuild(java.lang.String personalChangeId, java.lang.String buildTypeId, java.lang.String userId, java.lang.String reason)
Removes the specified personal build from the queuejava.lang.Boolean
unmuteProblems(java.util.Vector itemIds, java.lang.String userId, java.lang.String comment)
Unmutes the specified items.java.lang.Boolean
updateResponsibility(java.util.Vector itemIds, java.lang.String newStateName, java.lang.String responsibleUserId, java.lang.String reporterUserId, java.lang.String comment, java.lang.String removeMethodName)
Updates responsibility for the specified items.
-
-
-
Field Detail
-
REMOTE_BUILD_SERVER
static final java.lang.String REMOTE_BUILD_SERVER
- See Also:
- Constant Field Values
-
-
Method Detail
-
getRegisteredAgents
java.util.Vector getRegisteredAgents()
Returns all agents registered on the server- Returns:
- Vector of strings. Each string is serialized with XStream object of class BuildAgentData
-
getRegisteredProjects
java.util.Vector getRegisteredProjects(boolean loadInstances)
Returns snapshots for all projects registered on the server- Parameters:
loadInstances
- should returned data contain running and last finished builds data or not- Returns:
- Vector of strings. Each string is serialized with XStream object of class ProjectData @param loadInstances
-
getRelatedProjects
java.util.Vector getRelatedProjects(java.util.Vector buildTypeIds)
Returns projects of specified build configurations and all their parents in project hierarchy.- Parameters:
buildTypeIds
- Ids of build configuration- Returns:
- Vector of strings. Each string is serialized with XStream object of class ProjectData. No running and last finished builds data is provided.
- Since:
- 8.0
-
getBuildInstanceLogMessages
java.util.Vector getBuildInstanceLogMessages(java.lang.String buildId, int skipMessages)
Returns messages logged for the specified build instance- Parameters:
buildId
- build instance idskipMessages
- how many messages should be skipped- Returns:
- Vector of strings.
-
getBuildInstanceLogMessages
java.util.Vector getBuildInstanceLogMessages(java.lang.String buildId, int skipMessages, int maxCount)
Returns limited number of messages logged for the specified build instance- Parameters:
buildId
- build instance idskipMessages
- how many messages should be skippedmaxCount
- returns no more messages than this parameter value- Returns:
- Vector of strings.
-
getRunningBuilds
java.util.Vector getRunningBuilds(java.lang.String buildTypeId)
Returns all running build for the specified configuration- Parameters:
buildTypeId
- configuration id- Returns:
- Vector of strings. Each string is serialized with XStream object of class BuildInstanceData
-
getFinishedBuilds
java.util.Vector getFinishedBuilds(java.lang.String buildTypeId)
Returns all finished build instances in the specified configuration- Parameters:
buildTypeId
- configuration id- Returns:
- Vector of strings. Each string is serialized with XStream object of class BuildInstanceData
-
getBuildFailedTests
java.util.Vector getBuildFailedTests(java.lang.String buildId, int startFromIdx, int maxTestsToLoad)
Returns failed tests in the specified build instance, for running build currently executing test will be added to the list too.- Parameters:
buildId
- build instance idstartFromIdx
- how many tests should be skippedmaxTestsToLoad
- how many tests to load, -1 to load all tests- Returns:
- Vector of strings.
-
getBuildInstanceModifications
java.util.Vector getBuildInstanceModifications(java.lang.String buildId, int policyId, boolean includeModificationsIfPreviousBuildIsAbsent)
Returns modifications detected between the specified build instance and previous build, selected according to the specified policy- Parameters:
buildId
- build instance idpolicyId
- policy id, see jetbrains.buildServer.vcs.SelectPrevBuildPolicyincludeModificationsIfPreviousBuildIsAbsent
- - should method return something if build, selected according to policy, is absent- Returns:
- Vector of strings. Each string is serialized with XStream object of class VcsModificationData
-
getContentAfter
byte[] getContentAfter(java.lang.String modificationId, java.lang.String fileName) throws VcsException
Returns file content, specified by the VcsChange, at the moment right after specified modification has been made- Parameters:
modificationId
- modification idfileName
- file name, from VcsChange- Returns:
- byte content of a specific file version after modification
- Throws:
VcsException
- error while receiving content from the vcs server.
-
getContentBefore
byte[] getContentBefore(java.lang.String modificationId, java.lang.String fileName) throws VcsException
Returns file content, which corresponded to file before specified modification has been made- Parameters:
modificationId
- modification idfileName
- file name, from VcsChange- Returns:
- byte content of a specific file version before modification
- Throws:
VcsException
- error while receiving content from the vcs server.
-
getPersonalContentAfter
byte[] getPersonalContentAfter(java.lang.String modificationId, java.lang.String fileName) throws VcsException
Returns file content, specified by the VcsChange, at the moment right after specified modification has been made for personal change- Parameters:
modificationId
- modification idfileName
- file name, from VcsChange- Returns:
- byte content of a specific file version after modification
- Throws:
VcsException
- error while receiving content from the vcs server.
-
getPersonalContentBefore
byte[] getPersonalContentBefore(java.lang.String modificationId, java.lang.String fileName) throws VcsException
Returns file content, which corresponded to file before specified modification has been made for personal change- Parameters:
modificationId
- modification idfileName
- file name, from VcsChange- Returns:
- byte content of a specific file version before modification
- Throws:
VcsException
- error while receiving content from the vcs server.
-
addToQueue
java.lang.String addToQueue(java.util.Vector addToQueueRequests, java.lang.String rawTriggeredBy)
Adds one or more builds in the queue. The information about builds to add in queue is passed as Vector of serializedAddToQueueRequest
objects.- Parameters:
addToQueueRequests
- vector of serializedAddToQueueRequest
objectsrawTriggeredBy
- triggered by text (see alsoTriggeredByBuilder
)- Returns:
- serialized
AddToQueueResult
-
getResolvedArtifactDependencies
@NotNull java.lang.String getResolvedArtifactDependencies(@NotNull java.util.Vector buildTypeIds)
Resolves artifact dependencies for the specified build types.- Parameters:
buildTypeIds
- Ids of build types to resolve artifact dependencies for.- Returns:
- serialized Map<String, List<ArtifactDependencyInfo>> (build type id -> list of resolved dependencies).
- Since:
- 6.5
-
getBuildTypesWithArtifactDependencies
@NotNull java.util.Vector getBuildTypesWithArtifactDependencies(@NotNull java.util.Vector buildTypeIds)
Returns the list of build types that have artifact dependencies.- Parameters:
buildTypeIds
- Ids of build types to check. Pass empty vector to check all build types.- Returns:
- vector of build type ids.
- Since:
- 6.5
-
getBuildTypesWithTests
@NotNull java.util.Vector getBuildTypesWithTests(@NotNull java.util.Vector buildTypeIds)
Returns the list of build types those have tests.- Parameters:
buildTypeIds
- Ids of build types to check. Pass empty vector to check all build types.- Returns:
- vector of build type ids.
- Since:
- 7.1
-
getBuildsWithArtifacts
@NotNull java.lang.String getBuildsWithArtifacts(@NotNull java.util.Vector paths, @NotNull java.util.Vector buildTypeIds)
Returns last finished builds those contain given artifact files. This method only checks last finished builds. No history lookup is performed to find older build that may have contained the path.- Parameters:
paths
- vector of artifact paths that should be in the finished build.buildTypeIds
- Ids of build types to check builds in. Pass empty vector to check all build types.- Returns:
- List<BuildInstanceData>.
- Since:
- 6.5
-
lookUpBuildsWithArtifacts
@NotNull java.lang.String lookUpBuildsWithArtifacts(@NotNull java.util.Vector paths, @NotNull java.util.Vector buildTypeIds)
Returns last finished builds those contain given artifact files. Performs history lookup to find older build that may have contained the path.- Parameters:
paths
- vector of artifact paths that should be in the finished build.buildTypeIds
- Ids of build types to check builds in. Pass empty vector to check all build types.- Returns:
- List<BuildInstanceData>.
- Since:
- 6.5.6
-
getLastFinished
@Nullable java.lang.String getLastFinished(java.lang.String buildTypeId)
Returns last finished build in the specified configuration- Parameters:
buildTypeId
- configuration id- Returns:
- serialized with XStream object of class BuildInstanceData
-
getNewFinishedBuilds
java.lang.String getNewFinishedBuilds(java.util.Vector buildIds, java.util.Vector buildTypeIds)
Returns newly finished builds- Parameters:
buildIds
- For each build from this list this method will find later last finished build in the same build type. If it exists it will be added to result.buildTypeIds
- Last finished build from each of these build types will be added to the result (if exists).- Returns:
- Serialized with XStream List of BuildInstanceData
-
getCompilationErrors
java.util.Vector getCompilationErrors(java.lang.String buildInstanceId)
Returns compilation errors of the specified build- Parameters:
buildInstanceId
- build id- Returns:
- Vector of strings
-
getPendingChanges
java.util.Vector getPendingChanges(java.lang.String buildTypeId)
Returns all changes detected but not run for the specified configuration- Parameters:
buildTypeId
- configuration id- Returns:
- Vector of strings. Each string is serialized with XStream object of class VcsModificationData
-
getModificationsSinceLastSuccessful
java.util.Vector getModificationsSinceLastSuccessful(java.lang.String buildTypeId)
Returns all modifications detected since last successfully finished build has been run- Parameters:
buildTypeId
- configuration id- Returns:
- Vector of strings. Each string is serialized with XStream object of class VcsModificationData
-
findBuildInstanceById
java.lang.String findBuildInstanceById(java.lang.String id)
Returns build instance data for the specified id- Parameters:
id
- buildId build instance id- Returns:
- serialized with XStream object of class BuildInstanceData
-
getBuildParameters
java.lang.String getBuildParameters(java.lang.String buildTypeId)
Returns the serialized build parameters map of build type specified.- Parameters:
buildTypeId
- the build type id- Returns:
- serialized with XStream object of Map<String, String>
- Since:
- 5.1
- See Also:
BuildType.getBuildParameters()
-
getParameters
java.lang.String getParameters(java.lang.String buildTypeId)
Returns the serialized build and config parameters map of build type specified.- Parameters:
buildTypeId
- the build type id- Returns:
- serialized with XStream object of Map<String, String>
- Since:
- 6.5
- See Also:
BuildType.getParameters()
-
findFailedTests
@NotNull java.lang.String findFailedTests(java.lang.String fileFullPath, java.util.Vector testNames)
Looks for the failed tests with the specified names in the build configurations, suitable with the specified file.- Parameters:
fileFullPath
- full VCS file pathtestNames
- test names- Returns:
- serialized with XStream object of Map<String, List<BuildTestsData>> (build type id -> list of build tests datas)
- Since:
- 8.0
-
findTests
@NotNull java.lang.String findTests(java.lang.String fileFullPath, java.util.Vector testNames)
Looks for the tests (both failed and successful) with the specified names in the build configurations, suitable with the specified file.- Parameters:
fileFullPath
- full VCS file pathtestNames
- test names- Returns:
- serialized with XStream object of Map<String, List<BuildTestsData>> (build type id -> list of build tests datas)
- Since:
- 8.0
-
isSequenceBuildType
java.lang.Boolean isSequenceBuildType(java.lang.String buildTypeId)
Returns whether the build type is a sequence one (has snapshot dependencies)- Parameters:
buildTypeId
- the build type id- Returns:
- true iff build type is a sequence one
- Since:
- 5.1
-
muteProblems
java.lang.Boolean muteProblems(java.util.Vector itemIds, boolean unmuteWhenFixed, java.lang.String unmuteTimestamp, java.util.Vector buildTypeIds, java.util.Vector buildIds, java.lang.String userId, java.lang.String comment)
Mutes the specified items. If both buildTypeIds and buildIds are empty, mutes items in projects.- Parameters:
itemIds
- list of the itemids
unmuteWhenFixed
- true, if items must be unmuted automatically when fixedunmuteTimestamp
- date of unmute in milliseconds, "-1" to not unmute by datebuildTypeIds
- build type ids to mute items inbuildIds
- build ids to mute items inuserId
- id of the usercomment
- comment- Returns:
- fake
- Since:
- 7.1
-
unmuteProblems
java.lang.Boolean unmuteProblems(java.util.Vector itemIds, java.lang.String userId, java.lang.String comment)
Unmutes the specified items.- Parameters:
itemIds
- list of the itemids
userId
- id of the usercomment
- comment- Returns:
- fake
- Since:
- 7.1
-
updateResponsibility
java.lang.Boolean updateResponsibility(java.util.Vector itemIds, java.lang.String newStateName, java.lang.String responsibleUserId, java.lang.String reporterUserId, java.lang.String comment, java.lang.String removeMethodName)
Updates responsibility for the specified items.- Parameters:
itemIds
- list of the itemids
newStateName
- name of the newresponsibility state
responsibleUserId
- id of the responsible userreporterUserId
- id of the reporter usercomment
- commentremoveMethodName
- remove method name- Returns:
- fake
- Since:
- 6.0
-
getResponsibilityIds
java.util.Vector getResponsibilityIds(java.lang.String userId)
Returns id list of all the configuration which are under specified user responsibility- Parameters:
userId
- TeamCity user id- Returns:
- Vector of strings. Each string is serialized with XStream object of class ResponsibilityInfoData
-
findUserById
java.lang.String findUserById(java.lang.String userId)
Returns user for the specified id- Parameters:
userId
- TeamCity user id- Returns:
- serialized with XStream object of class User
-
getUsers
java.util.Vector getUsers()
Returns all users- Returns:
- serialized with XStream vector of UserData
- Since:
- 6.0
-
getProjectCommitters
java.util.Vector getProjectCommitters(java.lang.String projectId)
Returns list of project committers- Parameters:
projectId
- TeamCity project id- Returns:
- serialized with XStream vector of UserData
- Since:
- 6.0
-
stopBuild
java.lang.Boolean stopBuild(java.lang.String buildId, java.lang.String userId, java.lang.String reason)
Schedules specified build to be stopped- Parameters:
buildId
- build instance iduserId
- current used id.reason
- reason why build is stopped.- Returns:
- fake return value.
-
stopPendingPersonalBuild
java.lang.Boolean stopPendingPersonalBuild(java.lang.String personalChangeId, java.lang.String buildTypeId, java.lang.String userId, java.lang.String reason)
Removes the specified personal build from the queue- Parameters:
personalChangeId
- personal change idbuildTypeId
- build type iduserId
- current used idreason
- reason why build is stopped- Returns:
- fake return value
-
repeatRemoteDebugSession
java.lang.Boolean repeatRemoteDebugSession(java.lang.String personalChangeId, java.lang.String buildTypeId)
Repeats the current remote debug session on the certain agent, which is determined by personal change id and build type id- Parameters:
personalChangeId
- personal change idbuildTypeId
- build type id- Returns:
- fake return value
-
repeatRemoteDebugSessionWithNewChanges
java.lang.Boolean repeatRemoteDebugSessionWithNewChanges(java.lang.String personalChangeId, java.lang.String buildTypeId, java.lang.String newChangesPersonalPatchId)
Applies new personal patch and repeats the current remote debug session on the certain agent, which is determined by personal change id and build type id- Parameters:
personalChangeId
- personal change idbuildTypeId
- build type id- Returns:
- fake return value
-
finishRemoteDebugSession
java.lang.Boolean finishRemoteDebugSession(java.lang.String personalChangeId, java.lang.String buildTypeId)
Finishes the current remote debug session on the certain agent, which is determined by personal change id and build type id- Parameters:
personalChangeId
- personal change idbuildTypeId
- build type id- Returns:
- fake return value
-
fetchData
byte[] fetchData(java.lang.String userId, java.lang.String buildId, java.lang.String sourceId, java.lang.String whatToFetch)
Fetches binary data from the server.- Parameters:
userId
- current user id.buildId
- build id to fetch data for.sourceId
- data provider id ("Inspection", "Duplicator" e.t.c)whatToFetch
- specified path to fetch data for.- Returns:
- data binary array.
-
getCommitters
java.util.Vector getCommitters(java.lang.String buildId, int selectPrevBuildPolicy)
Returns list of committers who made changes between the previous build selected according to the policy, and the specified one- Parameters:
buildId
- build instance idselectPrevBuildPolicy
- - SelectPrevBuildPolicy enum element id- Returns:
- Vector of strings. Each string is serialized with XStream object of class User
-
getFileContent
byte[] getFileContent(java.lang.String relativePath, java.lang.String buildId)
Returns specified file content at the moment when specified build has been run- Parameters:
relativePath
- file path relative to project rootbuildId
- build instance id- Returns:
- byte content of specific file in specific build
-
getLastSuccessfullyFinished
java.lang.String getLastSuccessfullyFinished(java.lang.String buildTypeId)
Returns last successful finished build instance for the specified configuration- Parameters:
buildTypeId
- build instance id- Returns:
- serialized object of type BuildInstanceData
-
removeBuild
java.lang.Boolean removeBuild(java.lang.String buildId)
Removes build instance from the server history- Parameters:
buildId
- finished build instance id- Returns:
- fake
-
schedulePersonalChangeForDeletion
java.lang.Boolean schedulePersonalChangeForDeletion(java.lang.String changeId, java.lang.String userId)
Mark personal change as deleted and makes it invisible for user- Parameters:
changeId
- personal change iduserId
- current user id.- Returns:
- fake
-
getBuildParameter
java.lang.String getBuildParameter(java.lang.String buildTypeId, java.lang.String key)
Returns build parameter by parameter name.- Parameters:
buildTypeId
- configuration id.key
- param name.- Returns:
- serialized with XStream object of class String
-
setPersonalChangeStatus
java.lang.Boolean setPersonalChangeStatus(java.lang.String changeId, int statusPriority)
sets status of personal change- Parameters:
changeId
- personal change idstatusPriority
- status priority (see Status.getPriority())- Returns:
- Ignored. Used for XmlRpc
-
getCanRunAndCompatibleAgents
java.util.Vector getCanRunAndCompatibleAgents(java.lang.String builtTypeId, boolean includeDisabled)
Returns the agents those are compatible with the specified build type, and on those specified build type can be run- Parameters:
builtTypeId
- Build type idincludeDisabled
- includeDisabled- Returns:
- Vector of serialized BuildAgentData objects
-
getGroupedByPoolCanRunAndCompatibleAgents
java.util.Vector getGroupedByPoolCanRunAndCompatibleAgents(java.lang.String builtTypeId, boolean includeDisabled)
Returns the grouped by pool agents those are compatible with the specified build type, and on those specified build type can be run. If there is only one pool in the system, then result contains only one pair, and the pool data in that pair is null.- Parameters:
builtTypeId
- Build type idincludeDisabled
- includeDisabled- Returns:
- Vector of serialized Pair<AgentPoolData, List<BuildAgentData>> objects
-
haveCommitDecision
java.lang.Boolean haveCommitDecision(java.util.Vector personalChangeIds)
Returns true if at least one of the specified personal changes has non-UNKNOWN commit decision- Parameters:
personalChangeIds
- personal change ids- Returns:
- see above
-
getModificationFiles
java.util.Vector getModificationFiles(java.lang.String modId, boolean personalChange)
Returns list of VcsChange structures (changed files) corresponding to modification with specified id.- Parameters:
modId
- id of VCS modificationpersonalChange
- if true then files from personal change will be returned- Returns:
- see above
-
findBuildRunnerByType
java.lang.String findBuildRunnerByType(java.lang.String buildTypeId, java.lang.String runnerType)
Returns the first found build runner of the specified type in the specified build configuration.- Parameters:
buildTypeId
- build configuration idrunnerType
- type of the runner- Returns:
- the first found runner
- Since:
- 6.0
-
getBuildRunners
java.lang.String getBuildRunners(java.util.Vector buildTypeIds)
Returns map from build type ids to lists of enabled build runners for the specified build types.- Parameters:
buildTypeIds
- build configuration ids- Returns:
- serialized object of type Map<String, List<BuildRunnerData>>
- Since:
- 8.0
-
getProblemRelatedEventCounters
java.lang.String getProblemRelatedEventCounters(java.util.Vector projectIds)
Returns problem related event counters for specified projects.- Parameters:
projectIds
- project ids- Returns:
- serialized map (project id -> counter)
- Since:
- 7.1
-
-