Interface RemoteBuildServer


  • public interface RemoteBuildServer
    Implementation of the interface is registered in XmlRpc at TeamCity server side. Java clients are encouraged to use RemoteBuildServerFacade 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 id
      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.
      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 id
      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
      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.
      java.util.Vector getBuildInstanceLogMessages​(java.lang.String buildId, int skipMessages)
      Returns messages logged for the specified build instance
      java.util.Vector getBuildInstanceLogMessages​(java.lang.String buildId, int skipMessages, int maxCount)
      Returns limited number of messages logged for the specified build instance
      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
      java.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 run
      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
      java.util.Vector getCompilationErrors​(java.lang.String buildInstanceId)
      Returns compilation errors of the specified build
      byte[] 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 made
      byte[] getContentBefore​(java.lang.String modificationId, java.lang.String fileName)
      Returns file content, which corresponded to file before specified modification has been made
      byte[] getFileContent​(java.lang.String relativePath, java.lang.String buildId)
      Returns specified file content at the moment when specified build has been run
      java.util.Vector getFinishedBuilds​(java.lang.String buildTypeId)
      Returns all finished build instances in the specified configuration
      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.
      java.lang.String getLastFinished​(java.lang.String buildTypeId)
      Returns last finished build in the specified configuration
      java.lang.String getLastSuccessfullyFinished​(java.lang.String buildTypeId)
      Returns last successful finished build instance for the specified configuration
      java.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 run
      java.lang.String getNewFinishedBuilds​(java.util.Vector buildIds, java.util.Vector buildTypeIds)
      Returns newly finished builds
      java.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 configuration
      byte[] 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 change
      byte[] getPersonalContentBefore​(java.lang.String modificationId, java.lang.String fileName)
      Returns file content, which corresponded to file before specified modification has been made for personal change
      java.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 committers
      java.util.Vector getRegisteredAgents()
      Returns all agents registered on the server
      java.util.Vector getRegisteredProjects​(boolean loadInstances)
      Returns snapshots for all projects registered on the server
      java.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 responsibility
      java.util.Vector getRunningBuilds​(java.lang.String buildTypeId)
      Returns all running build for the specified configuration
      java.util.Vector getUsers()
      Returns all users
      java.lang.Boolean haveCommitDecision​(java.util.Vector personalChangeIds)
      Returns true if at least one of the specified personal changes has non-UNKNOWN commit decision
      java.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 history
      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
      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
      java.lang.Boolean schedulePersonalChangeForDeletion​(java.lang.String changeId, java.lang.String userId)
      Mark personal change as deleted and makes it invisible for user
      java.lang.Boolean setPersonalChangeStatus​(java.lang.String changeId, int statusPriority)
      sets status of personal change
      java.lang.Boolean stopBuild​(java.lang.String buildId, java.lang.String userId, java.lang.String reason)
      Schedules specified build to be stopped
      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
      java.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

    • 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 id
        skipMessages - 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 id
        skipMessages - how many messages should be skipped
        maxCount - 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 id
        startFromIdx - how many tests should be skipped
        maxTestsToLoad - 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 id
        policyId - policy id, see jetbrains.buildServer.vcs.SelectPrevBuildPolicy
        includeModificationsIfPreviousBuildIsAbsent - - 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 id
        fileName - 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 id
        fileName - 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 id
        fileName - 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 id
        fileName - 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 serialized AddToQueueRequest objects.
        Parameters:
        addToQueueRequests - vector of serialized AddToQueueRequest objects
        rawTriggeredBy - triggered by text (see also TriggeredByBuilder)
        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 path
        testNames - 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 path
        testNames - 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 item ids
        unmuteWhenFixed - true, if items must be unmuted automatically when fixed
        unmuteTimestamp - date of unmute in milliseconds, "-1" to not unmute by date
        buildTypeIds - build type ids to mute items in
        buildIds - build ids to mute items in
        userId - id of the user
        comment - 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 item ids
        userId - id of the user
        comment - 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 item ids
        newStateName - name of the new responsibility state
        responsibleUserId - id of the responsible user
        reporterUserId - id of the reporter user
        comment - comment
        removeMethodName - 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 id
        userId - 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 id
        buildTypeId - build type id
        userId - current used id
        reason - 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 id
        buildTypeId - 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 id
        buildTypeId - 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 id
        buildTypeId - 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 id
        selectPrevBuildPolicy - - 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 root
        buildId - 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 id
        userId - 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 id
        statusPriority - 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 id
        includeDisabled - 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 id
        includeDisabled - 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 modification
        personalChange - 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 id
        runnerType - 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