TeamCity Kotlin DSL/jetbrains.buildServer.configs.kotlin.vcs/TfsVcsRoot

TfsVcsRoot

Example. Adds a TFS VCS root with the TeamCity server user account access to Azure DevOps.

project {
    vcsRoot(TFSRoot)
    // ...
}

object TFSRoot : TfsVcsRoot({
    name = "TFSRoot"
    url = "https://dev.azure.com/organization"
    root = "${'$'}/path"
})

Example. Adds a TFS VCS root with specified Azure DevOps credentials (token) enforced overwriting all files in the workspace while Agent-Side Checkout and custom minimum polling interval in seconds.

project {
    vcsRoot(TFSRoot)
    // ...
}

object TFSRoot : TfsVcsRoot({
    name = "TFSRoot"
    pollInterval = 120
    url = "https://dev.azure.com/organization"
    root = "${'$'}/path"
    userName = "username"
    password = "credentialsJSON:******"
    forceOverwrite = true
})

Constructors

TfsVcsRoot

constructor(init: TfsVcsRoot.() -> Unit)

constructor()

Properties

forceOverwrite

var forceOverwrite: Boolean?

When set to true, TeamCity will call TFS to update workspace rewriting all files

open override var id: Id?

VCS root id. It appears in the web UI and is used in urls. If the VCS root has a uuid specified, then the id can be changed at any time. If uuid is omitted, then TeamCity treats a VCS root with a changed id as a new VCS root, all data associated with the old root will be lost (e.g. a commits graph). Id can also be used by some settings, e.g. as a part of parameter reference. If you change the id, you should find all its occurrences in the current project and change them too. Id must be unique across all VCS roots on the server. If id is missing, it will be generated from the class name (if the class is not from the jetbrains.buildServer.configs.kotlin package).

name

var name: String

VCS root name

paramRefs

open val paramRefs: VcsRootRefs

Helper for creating references to parameters of this VCS root

params

val params: List<Parameter>

password

var password: String?

A password for TFS connection

pollInterval

var pollInterval: Int?

VCS root polling interval, in seconds

root

var root: String?

TFS path to checkout. Format: $/path.

type

var type: String

VCS type

url

var url: String?

URL format:

userName

var userName: String?

A username for TFS connection

uuid

var uuid: String

VCS root uuid. TeamCity uses it to identify the VCS root. If uuid changes, TeamCity considers it to be a new entity. If uuid is missing, it is reconstructed from VCS root id. Uuid must be unique across all entities on the server.

Functions

booleanParameter

fun booleanParameter(customName: String? = null, trueValue: String? = "true", falseValue: String? = "false"): DelegateProvider<Boolean?>

clear

fun clear()

compoundParameter

fun <T : CompoundParam<T>> compoundParameter(customName: String? = null): DelegateProvider<T>

copyParamsTo

fun <T : Parametrized> copyParamsTo(target: T): T

Copies parameters of this object to the specified target

create

open fun create(): VcsRoot

Creates an instance of this VCS root via reflection using a no argument constructor, used during copying. Throws an error if this class doesn't have a default constructor. Subclasses can override it to create an instance without using a default constructor.

doubleParameter

fun doubleParameter(customName: String? = null): DelegateProvider<Double>

enumParameter

fun <E : Enum<E>> enumParameter(customName: String? = null, mapping: Map<E, String?>? = null): DelegateProvider<E>

equals

open operator override fun equals(other: Any?): Boolean

findRawParam

fun findRawParam(paramName: String): Parameter?

hashCode

open override fun hashCode(): Int

hasParam

fun hasParam(paramName: String): Boolean

fun id(id: String)

Sets the id to the specified value. Type of the id depends on the context in which DSL is executed: it is RelativeId when DSL context is relative, otherwise it is AbsoluteId.

intParameter

fun intParameter(customName: String? = null): DelegateProvider<Int>

param

fun param(name: String, value: String)

Adds parameter with specified name and value

removeRawParam

fun removeRawParam(paramName: String)

stringParameter

open fun stringParameter(customName: String? = null): DelegateProvider<String>

toString

open override fun toString(): String

validate

open override fun validate(consumer: ErrorConsumer)

Validates this object and reports found errors to the provided consumer