Class EditableTemplateCopy
- java.lang.Object
-
- jetbrains.buildServer.serverSide.impl.EditableTemplateCopy
-
- All Implemented Interfaces:
Comparable<BuildTypeTemplate>,BuildTypeIdentity,BuildTypeIdentityEx,BuildTypeOptions,BuildTypeSettings,BuildTypeTemplate,BuildTypeTemplateEx,CleanupSettings,CleanupSettingsInit,CompatibleAgents,DependencySettings,Dependent,BuildTypeSettingsSupport,ParameterSupport,InheritableUserParametersHolder,InheritableUserParametersHolderEx,InternalParameters,ParametersSupport,ReadOnlyUserParameters,SPersistentEntity,UserParametersHolder,VcsLabelingSettings,OptionSupport
public class EditableTemplateCopy extends Object implements BuildTypeTemplateEx
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface jetbrains.buildServer.serverSide.BuildTypeOptions
BuildTypeOptions.BuildConfigurationType
-
Nested classes/interfaces inherited from interface jetbrains.buildServer.serverSide.vcs.VcsLabelingSettings
VcsLabelingSettings.LabelingType
-
-
Field Summary
-
Fields inherited from interface jetbrains.buildServer.serverSide.BuildTypeOptions
BT_ALLOW_EXTERNAL_STATUS, BT_ALLOW_PERSONAL_BUILD_TRIGGERING, BT_ARTIFACT_PUBLISH_CONDITION, BT_ARTIFACT_RULES, BT_BRANCH_FILTER, BT_BUILD_CONFIGURATION_TYPE, BT_BUILD_DEFAULT_BRANCH, BT_BUILD_NUMBER_PATTERN, BT_CHECKOUT_DIR, BT_CHECKOUT_MODE, BT_CLEAN_BUILD, BT_EXCLUDE_DEFAULT_BRANCH_CHANGES, BT_EXECUTION_TIMEOUT, BT_FAIL_IF_TESTS_FAIL, BT_FAIL_ON_ANY_ERROR_MESSAGE, BT_FAIL_ON_EXIT_CODE, BT_FAIL_ON_OOME_OR_CRASH, BT_GENERATED_SETTINGS_CHECKSUM, BT_HANGING_BUILDS_DETECTION_ENABLED, BT_MAX_RUNNING_BUILDS, BT_MAX_RUNNING_BUILDS_PER_BRANCH, BT_SHOW_DEPS_CHANGES, BT_SUPPORT_TEST_RETRY, DEFAULT_BUILD_NUMBER_PATTERN, DEFAULT_MAX_RUNNING_BUILDS_PER_BRANCH, DEFAULT_VCS_LABELING_BRANCH_FILTER, VCS_LABELING_BRANCH_FILTER
-
Fields inherited from interface jetbrains.buildServer.serverSide.CleanupSettings
CLEANUP_PREVENT_DEPENDENCIES_ARTIFACTS_FROM_CLEANUP, DISABLE_CLEANUP_POLICIES
-
Fields inherited from interface jetbrains.buildServer.serverSide.vcs.VcsLabelingSettings
DEFAULT_LABEL_PATTERN
-
-
Constructor Summary
Constructors Constructor Description EditableTemplateCopy(BuildTypeTemplateContext context, ProjectEx project, EntityId<String> entityId, BuildTypeSettingsEx settings, String name, String description, boolean emptyUuid)
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description voidaddArtifactDependency(SArtifactDependency dependency)Adds artifact dependency.SBuildFeatureDescriptoraddBuildFeature(String type, Map<String,String> params)Adds build feature with specified type and parameters to this settings object.voidaddBuildFeature(SBuildFeatureDescriptor feature)Adds build feature descriptor to this settings object.voidaddBuildParameter(Parameter parameter)Adds build parameter to the configuration.SBuildRunnerDescriptoraddBuildRunner(String id, String name, String runnerType, Map<String,String> parameters)Creates a new build runner with the specified id, name, runner type, and parameters, and adds it to the current build settings.SBuildRunnerDescriptoraddBuildRunner(String name, String runnerType, Map<String,String> parameters)Creates new build runner and adds it to these settings.SBuildRunnerDescriptoraddBuildRunner(BuildRunnerDescriptor runner)Adds runner descriptor.BuildTriggerDescriptoraddBuildTrigger(String type, Map<String,String> params)Adds new trigger of specified type and with specified parameters to build configuration settings.booleanaddBuildTrigger(BuildTriggerDescriptor triggerDescriptor)Adds new trigger to build configuration settings.voidaddCleanupPolicy(HistoryRetentionPolicy policy)Sets cleanup policy for this build configurationvoidaddConfigParameter(Parameter param)Adds configuration parameter.voidaddDependency(Dependency dependOn)Add dependency on another build configurationvoidaddParameter(Parameter param)Adds parameter.voidaddRequirement(Requirement requirement)Adds new build requirement to the configuration.booleanaddVcsRoot(SVcsRoot root)Adds VCS root to the build configuration with default checkout rules.voidapplyRunnersOrder(String[] ids)Changes order of build runners in this template and in all of the inherited build configurations.booleanbelongsTo(SProject project)Checks whether this build type or template belongs to the specified project or one of its subprojects, transitively.intcompareTo(BuildTypeTemplate o)booleancontainsOwnVcsRoot(long vcsRootId)Returns true if VCS root with specified id is attached directly and is not inherited via a templatebooleancontainsVcsRoot(long vcsRootId)Returns true if VCS root with specified id is attached directly or is inherited via a templateConfigActioncreateConfigAction(SUser user, String description)Creates a config action instance associated with this entity and having the specified description.BuildPromotioncreateDummyBuildPromotion()BuildTypeTemplateExcreateEditableCopy(boolean fillSettings)voiddispose()SBuildFeatureDescriptorfindBuildFeatureById(String featureId)Returns build feature with specified idSBuildRunnerDescriptorfindBuildRunnerById(String runnerId)Finds build runner by its' idSBuildRunnerDescriptorfindBuildRunnerByType(String runnerType)Finds build runner by its' type.StringfindRunnerParameter(String paramName)Searches runner parameter in all build runners and returns value of the first found parameter with given name.BuildTriggerDescriptorfindTriggerById(String triggerId)Finds build trigger descriptor by its' idCompatibilityResultgetAgentCompatibility(AgentDescription agentDescription)Fetches compatibility information for given agent descriptionCollection<SBuildType>getAllUsages()Same as #getUsages() but also returns configurations that use this template as default templateList<SArtifactDependency>getArtifactDependencies()Returns artifacts this build configuration depending on.StringgetArtifactPaths()Returns build artifact paths.BranchSpecgetBranchSpec(SVcsRoot root)Returns branch specification for specified parent rootList<Requirement>getBuildFeatureRequirements()Returns list of additional agent requirements imposed by configured enabled build features.Collection<SBuildFeatureDescriptor>getBuildFeatures()Returns build features added to this settings object.Collection<SBuildFeatureDescriptor>getBuildFeaturesOfType(String type)Returns all build features of specified type.ContainerWithDisabled<String,SBuildFeatureDescriptor>getBuildFeatureSupport()StringgetBuildNumberPattern()Returns current build number patternStringgetBuildParameter(String key)Returns build parameter by parameter keyMap<String,String>getBuildParameters()Return map of build parameters specified by user.Collection<Parameter>getBuildParametersCollection()Returns build parameters collection.List<SBuildRunnerDescriptor>getBuildRunners()Returns collection of build runners attached to these settingsContainerWithDisabled<String,SBuildRunnerDescriptor>getBuildRunnerSupport()BuildSettingsgetBuildSettings()Collection<BuildTriggerDescriptor>getBuildTriggersCollection()Returns collection of build trigger settingsContainerWithDisabled<String,BuildTriggerDescriptor>getBuildTriggersSupport()Option[]getChangedOptions()Return options with changed values, i.e.StringgetCheckoutDirectory()Returns build checkout directory - if specified explicitly usingBuildTypeSettings.setCheckoutDirectory(String).CheckoutRulesgetCheckoutRules(VcsRoot root)Returns checkout rules configured for the specified VCS root.BuildTypeDescriptor.CheckoutTypegetCheckoutType()Returns method used by agent to retrieve project sources.Collection<SBuildType>getChildDependencies()Returns all child dependencies collected down the chain.Map<String,Boolean>getCleanupOptions()Collection<HistoryRetentionPolicy>getCleanupPolicies()Map<SBuildAgent,CompatibilityResult>getCompatibilityMap()Returns compatibility map, key is an agent and value is compatibility result.Collection<SBuildAgent>getCompatibleAgents()Returns collection of compatible agentsStringgetConfigId()Returns the entity's config identifier.Map<String,String>getConfigParameters()Returns map of configuration parametersCollection<Parameter>getConfigParametersCollection()Returns collection of configuration parameters.FilegetConfigurationFile()Returns the configuration file where this build type or template is persisted (or will be persisted to).FilegetConfigurationFile(File projectsDir)Returns the configuration file where this entity is persisted in custom projects directory<T> TgetDeclaredOption(Option<T> option)Get option value declared in this BuildTypeSettingsList<Dependency>getDependencies()Get existing dependencies, empty collection when no dependencies existStringgetDescription()Container<String,Boolean>getDisabledState()EntityId<String>getEntityId()Returns the instance of the entity identifier.StringgetExternalId()Returns the external identifier.StringgetFullName()Name of the project and name of the identity.StringgetId()Returns the internal identifier (that is used inside the database).List<Requirement>getImplicitRequirements()Get list of non-satisfied implicit requirements for build agents.Map<String,Boolean>getInheritedCleanupOptions()Collection<HistoryRetentionPolicy>getInheritedCleanupPolicies()Collection<Parameter>getInheritedParametersCollection()StringgetInternalId()Returns the internal identifier.List<VcsRoot>getLabelingRoots()List of roots which should be processed by labeling processVcsLabelingSettings.LabelingTypegetLabelingType()StringgetLabelPattern()AuditLogActiongetLastConfigModificationAction()StringgetName()The name of the identity.intgetNumberOfUsages()Returns total number of this template usages (without permissions filtering) in build configurationsintgetNumberOfUsagesAsDefaultTemplate()Returns total number of projects (without permissions filtering) using this template as a default templateintgetNumberOfUsagesAsEnforcedSettings()<T> TgetOption(Option<T> option)Get option value<T> TgetOptionDefaultValue(Option<T> option)Collection<Option>getOptions()ContainerWithInherited<Option<Object>,OptionValue<Object>>getOptionSupport()Map<String,Boolean>getOwnCleanupOptions()Collection<HistoryRetentionPolicy>getOwnCleanupPolicies()ParametergetOwnNonInheritedParameter(String paramName)Own parameter without inherited parameter spec.Collection<Option>getOwnOptions()Return options defined in this object, i.e.ParametergetOwnParameter(String paramName)Map<String,String>getOwnParameters()Collection<Parameter>getOwnParametersCollection()Collection<Parameter>getOwnParametersWithoutInheritedSpec()ParametergetParameter(String paramName)Map<String,String>getParameters()Returns map of build and configuration parameters.Collection<Parameter>getParametersCollection()Returns build and configuration parameters in single collection.ParametersProvidergetParametersProvider()Returns parameters which can be used by value resolver.ContainerWithInherited<String,Parameter>getParametersSupport()StringgetParameterValue(String paramName)SPersistentEntitygetParent()The parent entity.SProjectgetParentProject()Returns project to which this template belongsStringgetParentProjectId()Returns id of the project to which this template belongsProjectExgetProject()Returns the project this build type entity belongs to.StringgetProjectId()Returns internal id of the project to which this template belongsReadOnlyReasongetReadOnlyReason()List<Requirement>getRequirements()Get list of explicit requirements for build agents which can run this build configuration.ContainerWithDisabled<String,Requirement>getRequirementSupport()BuildStepConditionsgetRunnerConditions(SBuildRunnerDescriptor descriptor)String[]getRunnersOrder()Collection<String>getRunnerTypes()Returns types of the runners attached to these settingsList<Requirement>getRunTypeRequirements()Returns list of additional agent requirements imposed by configured runners.BuildTypeSettingsExgetSettings()BuildTypeTemplategetTemplate()Deprecated.StringgetTemplateId()Deprecated.List<String>getTemplateIds()Returns internal ids of the templates this settings are based on, including one of the default templateList<? extends BuildTypeTemplate>getTemplates()Returns templates these settings are based on, including the default template.<T> TypedValue<T>getTypedOption(Option<T> option)Get option extended value.List<String>getUndefinedParameters()Returns collection of parameter names (config and build params) referenced in the build configuration settings but without values provided.Collection<SBuildType>getUsages()Returns collection of build configurations attached to this template.Collection<SProject>getUsagesAsDefaultTemplate()Returns collection of projects where this template is used as a default template.Collection<SProject>getUsagesAsEnforcedSettings()ValueResolvergetValueResolver()Returns value resolver which can be used to resolve references in valuesList<Branch>getVcsBranches(boolean includeDependenciesBranches)All VCS branches from VCS roots attached to this template and VCS branches from dependencies (if parameter includeDependenciesBranches is true).List<VcsRootEntry>getVcsRootEntries()Returns all entries of vcs roots.List<VcsRootInstanceEntry>getVcsRootInstanceEntries()List<SVcsRoot>getVcsRoots()Returns all roots currently attached to this configurationPersistentEntityVersiongetVersion()Returns version of this entity which can be used to check if the entity was edited or persisted.BuildTypeTemplateExinline()Creates a temporary copy of this template with all settings inherited from a project or a template inlined.booleanintersectsWith(Dependent dependent)Returns true if this object dependencies intersect (have same nodes) with specified object dependencies.booleanisAccessibleFrom(SProject project)Returns true if this template is accessible from specified project, i.e.booleanisAgentLessBuildType()booleanisBranchSpecDefined(boolean processDependencies)booleanisCompositeBuildType()booleanisDefaultBranchExcluded()Returns true if any of VCS roots attached to configuration exclude the default branchbooleanisDeployment()booleanisDeploymentBuildType()booleanisEmptyUuid()booleanisEnabled(String parametersDescriptorId)Returns true if descriptor with specified id (runner, trigger or build feature) is enabled and false otherwise.booleanisReadOnly()booleanisTemplateAccessible()Checks accessibility of all attached templates, excluding the default template (if present)booleanisTemplateBased()Returns true if these settings are directly based on a template.voidmarkPersisted(long expectedEditId)Marks entity as persistedvoidmoveToProject(ConfigAction cause, SProject target)Moves this template to the specified project.voidmoveToProject(SProject target)Moves this template to the specified project.voidpersist()Persists this entity instance onto disk.voidpersist(ConfigAction cause)Persists this entity on disk.voidremove()Removes this entity.voidremoveAllBuildRunners()Removes all build runners from these settingsvoidremoveArtifactDependency(SArtifactDependency dependency)Removes artifact dependency.SBuildFeatureDescriptorremoveBuildFeature(String featureId)Removes build feature with specified id from this settings object.voidremoveBuildParameter(String paramName)Removes existing build parameter by its name.SBuildRunnerDescriptorremoveBuildRunner(String runnerId)Removes runner descriptor with specified id.booleanremoveBuildTrigger(BuildTriggerDescriptor triggerDescriptor)Removes specified build trigger from the settingsvoidremoveCleanupPolicies()Remove all own cleanup policies for the objectvoidremoveConfigParameter(String paramName)Removes configuration parameters with specified namebooleanremoveDependency(Dependency dependOn)Remove dependency on another build configurationvoidremoveParameter(String paramName)Removes parameter.voidremoveRequirement(String parameterName)Removes first requirement with the specified property name from the configuration.voidremoveRequirement(Requirement requirement)Removes a requirement from the configuration.booleanremoveVcsRoot(SVcsRoot root)Removes existing VCS root from the build configuration.booleanreplaceInValues(String regexp, String replacement)Replaces values according to specified regexp and replacement string in all text parameters of the build configurationbooleanreplaceInValues(Pattern regexpPattern, String replacement)Replaces values according to specified pattern and replacement string in all text parameters of the build configurationbooleanreplaceVcsRoot(SVcsRoot oldVcsRoot, SVcsRoot newVcsRoot)Replaces existing VCS root entry in settings with a new one, maintaining the order of the root entriesvoidresetRunnersOrder()Resets custom runner order to default.PersistTaskschedulePersisting(String reason)Schedules background persisting of this entity settings.PersistTaskschedulePersisting(ConfigAction cause)Schedules background persisting of this project settings.PersistTaskscheduleRemove(ConfigAction cause)Schedules remove of this persistent entity.voidsendExtIdChangedEvents(ConfigAction cause, String oldExternalId, String newExternalId)This method can be used to send external id changed event.voidsetArtifactDependencies(List<SArtifactDependency> artifacts)Sets artifacts this build configuration depending on.voidsetArtifactPaths(String artifactPaths)Sets build artifact paths.voidsetBuildNumberPattern(String pattern)Sets build number pattern.voidsetCheckoutDirectory(String dir)Sets build checkout directory.booleansetCheckoutRules(VcsRoot root, CheckoutRules checkoutRules)Sets checkout rules for specified VCS root.voidsetCheckoutType(BuildTypeDescriptor.CheckoutType type)Sets preferred checkout type for the configuration sources.voidsetCleanupOption(String option, Boolean value)Sets value for a cleanup optionvoidsetDescription(String description)Sets template descriptionvoidsetEditable(boolean editable)Enables or disables editing of the template in web UI, see alsoSPersistentEntity.isReadOnly().voidsetEnabled(String parametersDescriptorId, boolean enabled)Enables or disables descriptor with specified id in build configuration settings.voidsetExternalId(String newExternalId)Changes the external id of this build template or build configuration.voidsetExternalId(ConfigAction cause, String newExternalId)Changes the external id of this build template or build configuration.voidsetExternalId(ConfigAction configAction, String newId, boolean sendEvents)Same as {BuildTypeIdentity.setExternalId(ConfigAction, String)} but provides control over events processing.voidsetName(String name)Sets name of this build type or template<T> voidsetOption(Option<T> option, T value)Set option value, clears value if it is the same as defaultbooleansetVcsRoots(Collection<SVcsRoot> vcsRoots)Sets VCS roots.booleantextValueMatches(Pattern regexpPattern)Returns true if configuration has value in text parameters which matches specified pattern.voidunregister()Removes this object from project model.booleanupdateBuildFeature(String featureId, String newType, Map<String,String> newParams)Updates build feature descriptor with specified id, changes type and parameters.booleanupdateBuildRunner(String runnerId, String newName, String newType, Map<String,String> newParams)Updates parameters in the existing build runner descriptor.booleanupdateBuildTrigger(String triggerId, String newType, Map<String,String> newParams)Updates build trigger descriptor with specified id, changes type and parameters.booleanupdateBuildTrigger(BuildTriggerDescriptor newDescriptor)Updates build trigger descriptor with id equal to newDescriptor id.-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface jetbrains.buildServer.serverSide.InheritableUserParametersHolderEx
getOwnAndParentsNonInheritedParameter, getOwnAndParentsNonInheritedParameters
-
Methods inherited from interface jetbrains.buildServer.serverSide.InternalParameters
getBooleanInternalParameter, getBooleanInternalParameterOrTrue, getInternalParameterValue
-
Methods inherited from interface jetbrains.buildServer.serverSide.SPersistentEntity
isVirtual
-
-
-
-
Constructor Detail
-
EditableTemplateCopy
public EditableTemplateCopy(@NotNull BuildTypeTemplateContext context, @NotNull ProjectEx project, @NotNull EntityId<String> entityId, @NotNull BuildTypeSettingsEx settings, @NotNull String name, @Nullable String description, boolean emptyUuid)
-
-
Method Detail
-
getProject
@NotNull public ProjectEx getProject()
Description copied from interface:BuildTypeIdentityReturns the project this build type entity belongs to.- Specified by:
getProjectin interfaceBuildTypeIdentity- Specified by:
getProjectin interfaceBuildTypeSettings- Specified by:
getProjectin interfaceBuildTypeTemplate- Specified by:
getProjectin interfaceBuildTypeTemplateEx- Returns:
- the project this build type entity belongs to.
-
getBuildSettings
@NotNull public BuildSettings getBuildSettings()
- Specified by:
getBuildSettingsin interfaceBuildTypeTemplateEx
-
getSettings
@NotNull public BuildTypeSettingsEx getSettings()
- Specified by:
getSettingsin interfaceBuildTypeIdentityEx- Specified by:
getSettingsin interfaceBuildTypeTemplateEx- Returns:
- Underlying build settings object
-
removeAllBuildRunners
public void removeAllBuildRunners()
Description copied from interface:BuildTypeSettingsRemoves all build runners from these settings- Specified by:
removeAllBuildRunnersin interfaceBuildTypeSettings
-
getRunnersOrder
@Nullable public String[] getRunnersOrder()
- Specified by:
getRunnersOrderin interfaceBuildTypeSettings- Returns:
- runner ids in their custom order (if such order is set), null otherwise
-
inline
@NotNull public BuildTypeTemplateEx inline()
Description copied from interface:BuildTypeTemplateExCreates a temporary copy of this template with all settings inherited from a project or a template inlined.- Specified by:
inlinein interfaceBuildTypeTemplateEx
-
createEditableCopy
@NotNull public BuildTypeTemplateEx createEditableCopy(boolean fillSettings)
- Specified by:
createEditableCopyin interfaceBuildTypeTemplateEx
-
getId
@NotNull public String getId()
Description copied from interface:BuildTypeTemplateReturns the internal identifier (that is used inside the database).- Specified by:
getIdin interfaceBuildTypeTemplate- Returns:
- the internal identifier.
- See Also:
BuildTypeIdentity.getExternalId()
-
getEntityId
@NotNull public EntityId<String> getEntityId()
Description copied from interface:BuildTypeIdentityExReturns the instance of the entity identifier.This instance (not a copy!) that contains immutable internal id and modifiable external id. When one has changed the external id of this build template or configuration, the external id incide this class instance will be changed too.
- Specified by:
getEntityIdin interfaceBuildTypeIdentityEx- Returns:
- the instance of the entity identifier.
-
addCleanupPolicy
public void addCleanupPolicy(@NotNull HistoryRetentionPolicy policy)Description copied from interface:CleanupSettingsInitSets cleanup policy for this build configuration- Specified by:
addCleanupPolicyin interfaceCleanupSettingsInit- Parameters:
policy- policy to set
-
getCleanupPolicies
@NotNull public Collection<HistoryRetentionPolicy> getCleanupPolicies()
- Specified by:
getCleanupPoliciesin interfaceCleanupSettings- Returns:
- combined cleanup policies, including those inherited from default or parent object
-
getOwnCleanupPolicies
@NotNull public Collection<HistoryRetentionPolicy> getOwnCleanupPolicies()
- Specified by:
getOwnCleanupPoliciesin interfaceCleanupSettings- Returns:
- cleanup policies, specific for this object only
-
getInheritedCleanupPolicies
@NotNull public Collection<HistoryRetentionPolicy> getInheritedCleanupPolicies()
- Specified by:
getInheritedCleanupPoliciesin interfaceCleanupSettings
-
getCleanupOptions
@NotNull public Map<String,Boolean> getCleanupOptions()
- Specified by:
getCleanupOptionsin interfaceCleanupSettings- Returns:
- map of all cleanup options
-
getOwnCleanupOptions
@NotNull public Map<String,Boolean> getOwnCleanupOptions()
- Specified by:
getOwnCleanupOptionsin interfaceCleanupSettings- Returns:
- map of own cleanup options only
-
findBuildRunnerByType
@Nullable public SBuildRunnerDescriptor findBuildRunnerByType(@NotNull String runnerType)
Description copied from interface:BuildTypeSettingsFinds build runner by its' type. If there is more than one build runner, returns the first one.- Specified by:
findBuildRunnerByTypein interfaceBuildTypeSettings- Parameters:
runnerType- type of the runner- Returns:
- build runner or null if runner was not found
-
getBuildParameter
public String getBuildParameter(String key)
Description copied from interface:BuildTypeSettingsReturns build parameter by parameter key- Specified by:
getBuildParameterin interfaceBuildTypeSettings- Parameters:
key- parameter key- Returns:
- build parameter by parameter key
-
getBuildParameters
@NotNull public Map<String,String> getBuildParameters()
Description copied from interface:BuildTypeSettingsReturn map of build parameters specified by user. Each build parameter has name and value. Name of each parameter starts from a prefix: env. or system. Value may by either simple string, or may contain references to other parameters in form %env.HOME% or %system.os.name% or %system.agent.name%- Specified by:
getBuildParametersin interfaceBuildTypeSettings- Returns:
- see above
-
getParameters
@NotNull public Map<String,String> getParameters()
Description copied from interface:ReadOnlyUserParametersReturns map of build and configuration parameters.- Specified by:
getParametersin interfaceInheritableUserParametersHolder- Specified by:
getParametersin interfaceReadOnlyUserParameters- Returns:
- merged map of parameters, i.e. all parameters inherited from parent holders and own parameters
-
getParameterValue
@Nullable public String getParameterValue(@NotNull String paramName)
- Specified by:
getParameterValuein interfaceReadOnlyUserParameters- Parameters:
paramName- parameter name- Returns:
- value of the parameter with given name or null if there is no such parameter
-
getRunnerTypes
@NotNull public Collection<String> getRunnerTypes()
Description copied from interface:BuildTypeSettingsReturns types of the runners attached to these settings- Specified by:
getRunnerTypesin interfaceBuildTypeSettings- Returns:
- see above
-
getCheckoutType
@NotNull public BuildTypeDescriptor.CheckoutType getCheckoutType()
Description copied from interface:BuildTypeSettingsReturns method used by agent to retrieve project sources. CheckoutType.ON_SERVER server creates patch and sends it to agent CheckoutType.ON_AGENT agent checks sources out CheckoutType.MANUAL script does it itself. This method returns actual checkout type, which may differ from the value set byBuildTypeSettings.setCheckoutType(jetbrains.buildServer.BuildTypeDescriptor.CheckoutType)- Specified by:
getCheckoutTypein interfaceBuildTypeSettings- Returns:
- method to get sources on agent.
-
getProjectId
@NotNull public String getProjectId()
Description copied from interface:BuildTypeTemplateReturns internal id of the project to which this template belongs- Specified by:
getProjectIdin interfaceBuildTypeTemplate- Returns:
- see above
-
belongsTo
public boolean belongsTo(@NotNull SProject project)Description copied from interface:BuildTypeIdentityChecks whether this build type or template belongs to the specified project or one of its subprojects, transitively.- Specified by:
belongsToin interfaceBuildTypeIdentity- Specified by:
belongsToin interfaceBuildTypeTemplate- Parameters:
project- the project to check this configuration to belongs to.- Returns:
- true if belongs.
-
isAccessibleFrom
public boolean isAccessibleFrom(@NotNull SProject project)Description copied from interface:BuildTypeTemplateReturns true if this template is accessible from specified project, i.e. it belongs to this project or to some of its parents- Specified by:
isAccessibleFromin interfaceBuildTypeTemplate- Parameters:
project- project to check- Returns:
- see above
-
getInternalId
@NotNull public String getInternalId()
Description copied from interface:BuildTypeIdentityReturns the internal identifier.- Specified by:
getInternalIdin interfaceBuildTypeIdentity- Returns:
- the internal identifier.
-
getExternalId
@NotNull public String getExternalId()
Description copied from interface:BuildTypeIdentityReturns the external identifier.- Specified by:
getExternalIdin interfaceBuildTypeIdentity- Specified by:
getExternalIdin interfaceSPersistentEntity- Returns:
- the external identifier.
-
getRunTypeRequirements
@NotNull public List<Requirement> getRunTypeRequirements()
Description copied from interface:BuildTypeSettingsReturns list of additional agent requirements imposed by configured runners.- Specified by:
getRunTypeRequirementsin interfaceBuildTypeSettings- Returns:
- see above
-
getBuildFeatureRequirements
@NotNull public List<Requirement> getBuildFeatureRequirements()
Description copied from interface:BuildTypeSettingsReturns list of additional agent requirements imposed by configured enabled build features.- Specified by:
getBuildFeatureRequirementsin interfaceBuildTypeSettings- Returns:
- see above
-
addBuildRunner
@NotNull public SBuildRunnerDescriptor addBuildRunner(@NotNull BuildRunnerDescriptor runner)
Description copied from interface:BuildTypeSettingsAdds runner descriptor. UseBuildRunnerDescriptorFactoryto create instance of runner descriptor.
Before 8.0 this method requiredSBuildRunnerDescriptoras parameter- Specified by:
addBuildRunnerin interfaceBuildTypeSettings- Parameters:
runner- descriptor- Returns:
- instance of actually added runner
-
addBuildRunner
@NotNull public SBuildRunnerDescriptor addBuildRunner(@NotNull String name, @NotNull String runnerType, @NotNull Map<String,String> parameters)
Description copied from interface:BuildTypeSettingsCreates new build runner and adds it to these settings. Runner's ID is autogenerated- Specified by:
addBuildRunnerin interfaceBuildTypeSettings- Parameters:
name- runner namerunnerType- type of the runnerparameters- runner parameters- Returns:
- newly created runner
-
addBuildRunner
@NotNull public SBuildRunnerDescriptor addBuildRunner(@NotNull String id, @NotNull String name, @NotNull String runnerType, @NotNull Map<String,String> parameters) throws DuplicateIdException, InvalidIdentifierException, ReadOnlyEntityException
Description copied from interface:BuildTypeSettingsCreates a new build runner with the specified id, name, runner type, and parameters, and adds it to the current build settings.- Specified by:
addBuildRunnerin interfaceBuildTypeSettings- Parameters:
id- the unique id of the build runner (should be unique within all runners of this configuration)name- the name of the build runnerrunnerType- the type of the build runnerparameters- the parameters for the build runner- Returns:
- the newly created build runner descriptor
- Throws:
DuplicateIdException- if the id is already in use by another build runner, runners inherited from templates are not consideredInvalidIdentifierException- if the id is invalid or emptyReadOnlyEntityException- if the settings are read-only and cannot be modified
-
removeBuildRunner
@Nullable public SBuildRunnerDescriptor removeBuildRunner(@NotNull String runnerId)
Description copied from interface:BuildTypeSettingsRemoves runner descriptor with specified id.- Specified by:
removeBuildRunnerin interfaceBuildTypeSettings- Parameters:
runnerId- descriptor id- Returns:
- removed runner descriptor
-
updateBuildRunner
public boolean updateBuildRunner(@NotNull String runnerId, @NotNull String newName, @NotNull String newType, @NotNull Map<String,String> newParams)Description copied from interface:BuildTypeSettingsUpdates parameters in the existing build runner descriptor. Does nothing if there runner with specified id was not found.- Specified by:
updateBuildRunnerin interfaceBuildTypeSettings- Parameters:
runnerId- id of runner descriptornewName- new runner namenewType- new type of the runnernewParams- new runner parameters- Returns:
- true if parameters updated and false otherwise
-
getBuildRunners
@NotNull public List<SBuildRunnerDescriptor> getBuildRunners()
Description copied from interface:BuildTypeSettingsReturns collection of build runners attached to these settings- Specified by:
getBuildRunnersin interfaceBuildTypeSettings- Returns:
- see above
-
applyRunnersOrder
public void applyRunnersOrder(@NotNull String[] ids)Description copied from interface:BuildTypeTemplateChanges order of build runners in this template and in all of the inherited build configurations. Note that after that persist operation invoked on the template will also persist inherited build configurations.- Specified by:
applyRunnersOrderin interfaceBuildTypeSettings- Specified by:
applyRunnersOrderin interfaceBuildTypeTemplate- Parameters:
ids- runner identifiers
-
resetRunnersOrder
public void resetRunnersOrder()
Description copied from interface:BuildTypeSettingsResets custom runner order to default.- Specified by:
resetRunnersOrderin interfaceBuildTypeSettings
-
findBuildRunnerById
@Nullable public SBuildRunnerDescriptor findBuildRunnerById(@NotNull String runnerId)
Description copied from interface:BuildTypeSettingsFinds build runner by its' id- Specified by:
findBuildRunnerByIdin interfaceBuildTypeSettings- Parameters:
runnerId- id of the runner- Returns:
- build runner or null if runner with such id not found
-
findRunnerParameter
@Nullable public String findRunnerParameter(@NotNull String paramName)
Description copied from interface:BuildTypeSettingsSearches runner parameter in all build runners and returns value of the first found parameter with given name.- Specified by:
findRunnerParameterin interfaceBuildTypeSettings- Parameters:
paramName- name of the parameter- Returns:
- the first found parameter value or null
-
getRunnerConditions
@NotNull public BuildStepConditions getRunnerConditions(@NotNull SBuildRunnerDescriptor descriptor)
- Specified by:
getRunnerConditionsin interfaceBuildTypeSettings- Returns:
- support for conditions for conditional build steps
-
getBuildParametersCollection
@NotNull public Collection<Parameter> getBuildParametersCollection()
Description copied from interface:BuildTypeSettingsReturns build parameters collection.- Specified by:
getBuildParametersCollectionin interfaceBuildTypeSettings- Returns:
- see above
-
addBuildParameter
public void addBuildParameter(Parameter parameter)
Description copied from interface:BuildTypeSettingsAdds build parameter to the configuration. Build parameter is a system or environment variable. Concrete parameter type is being selected by its name prefix.Constants.SYSTEM_PREFIXfor system properties andConstants.ENV_PREFIXfor environment variable.- Specified by:
addBuildParameterin interfaceBuildTypeSettings- Parameters:
parameter- specified parameter.
-
removeBuildParameter
public void removeBuildParameter(String paramName)
Description copied from interface:BuildTypeSettingsRemoves existing build parameter by its name.- Specified by:
removeBuildParameterin interfaceBuildTypeSettings- Parameters:
paramName- specified parameter name.
-
getVcsRoots
@NotNull public List<SVcsRoot> getVcsRoots()
Description copied from interface:BuildTypeSettingsReturns all roots currently attached to this configuration- Specified by:
getVcsRootsin interfaceBuildTypeSettings- Returns:
- collection of all attached vcs roots.
-
addBuildTrigger
public boolean addBuildTrigger(@NotNull BuildTriggerDescriptor triggerDescriptor)Description copied from interface:BuildTypeSettingsAdds new trigger to build configuration settings. UseBuildTriggerDescriptorFactoryto create trigger descriptor.- Specified by:
addBuildTriggerin interfaceBuildTypeSettings- Parameters:
triggerDescriptor- trigger descriptor- Returns:
- true if trigger was added, and false if trigger with such id already exists
-
addBuildTrigger
@NotNull public BuildTriggerDescriptor addBuildTrigger(@NotNull String type, @NotNull Map<String,String> params)
Description copied from interface:BuildTypeSettingsAdds new trigger of specified type and with specified parameters to build configuration settings.- Specified by:
addBuildTriggerin interfaceBuildTypeSettings- Parameters:
type- type of the triggerparams- parameters map- Returns:
- newly created trigger descriptor
-
removeBuildTrigger
public boolean removeBuildTrigger(@NotNull BuildTriggerDescriptor triggerDescriptor)Description copied from interface:BuildTypeSettingsRemoves specified build trigger from the settings- Specified by:
removeBuildTriggerin interfaceBuildTypeSettings- Parameters:
triggerDescriptor- trigger descriptor- Returns:
- true if trigger was actually removed and false otherwise
-
updateBuildTrigger
public boolean updateBuildTrigger(@NotNull String triggerId, @NotNull String newType, @NotNull Map<String,String> newParams)Description copied from interface:BuildTypeSettingsUpdates build trigger descriptor with specified id, changes type and parameters.- Specified by:
updateBuildTriggerin interfaceBuildTypeSettings- Parameters:
triggerId- id of build trigger descriptornewType- type of build trigger descriptornewParams- parameters map- Returns:
- true if parameters of build trigger descriptor were changed (descriptor with such id exists) and false otherwise
-
updateBuildTrigger
public boolean updateBuildTrigger(@NotNull BuildTriggerDescriptor newDescriptor)Description copied from interface:BuildTypeSettingsUpdates build trigger descriptor with id equal to newDescriptor id.- Specified by:
updateBuildTriggerin interfaceBuildTypeSettings- Parameters:
newDescriptor- new settings of the trigger- Returns:
- true if parameters of build trigger descriptor were changed (descriptor with such id exists) and false otherwise
-
getBuildTriggersCollection
@NotNull public Collection<BuildTriggerDescriptor> getBuildTriggersCollection()
Description copied from interface:BuildTypeSettingsReturns collection of build trigger settings- Specified by:
getBuildTriggersCollectionin interfaceBuildTypeSettings- Returns:
- see above
-
findTriggerById
@Nullable public BuildTriggerDescriptor findTriggerById(@NotNull String triggerId)
Description copied from interface:BuildTypeSettingsFinds build trigger descriptor by its' id- Specified by:
findTriggerByIdin interfaceBuildTypeSettings- Parameters:
triggerId- id of the trigger- Returns:
- build trigger descriptor or null if trigger with such id not found
-
setCheckoutType
public void setCheckoutType(BuildTypeDescriptor.CheckoutType type)
Description copied from interface:BuildTypeSettingsSets preferred checkout type for the configuration sources. Actual checkout type may differ, for example, if preferred checkout type is set to ON_AGENT, but there is vcs root which does not support on agent checkout, actual checkout type will be switched to ON_SERVER.BuildTypeDescriptor.CheckoutType.ON_SERVER- checkout sources automatically on the server and snd it to the agent.BuildTypeDescriptor.CheckoutType.ON_AGENT- checkout sources automatically on the agent.BuildTypeDescriptor.CheckoutType.MANUAL- do not check out sources automatically.- Specified by:
setCheckoutTypein interfaceBuildTypeSettings- Parameters:
type- new checkout type.
-
setCheckoutDirectory
public void setCheckoutDirectory(@Nullable String dir)Description copied from interface:BuildTypeSettingsSets build checkout directory. Set it to null to use default checkout directory.- Specified by:
setCheckoutDirectoryin interfaceBuildTypeSettings- Parameters:
dir- checkout directory
-
getCheckoutDirectory
@Nullable public String getCheckoutDirectory()
Description copied from interface:BuildTypeSettingsReturns build checkout directory - if specified explicitly using
BuildTypeSettings.setCheckoutDirectory(String). Returnsnullif default checkout directory, generated by TeamCity should be used.- Specified by:
getCheckoutDirectoryin interfaceBuildTypeSettings- Returns:
- build checkout directory.
- See Also:
BuildTypeSettings.setCheckoutDirectory(String)
-
setArtifactPaths
public void setArtifactPaths(@Nullable String artifactPaths)Description copied from interface:BuildTypeSettingsSets build artifact paths. Artifact paths are comma separated paths to build artifacts. Support ant-style wildcards and target directories like *.zip => winFiles,unix/dist.tgz => linuxFiles, where winFiles and linuxFiles are target directories. Set to null or empty string to disable artifacts processing.- Specified by:
setArtifactPathsin interfaceBuildTypeSettings- Parameters:
artifactPaths- paths to build artifacts
-
getArtifactPaths
@Nullable public String getArtifactPaths()
Description copied from interface:BuildTypeSettingsReturns build artifact paths.- Specified by:
getArtifactPathsin interfaceBuildTypeSettings- Returns:
- build artifact paths
-
getArtifactDependencies
@NotNull public List<SArtifactDependency> getArtifactDependencies()
Description copied from interface:BuildTypeSettingsReturns artifacts this build configuration depending on.- Specified by:
getArtifactDependenciesin interfaceBuildTypeSettings- Returns:
- list of artifacts this build configuration depending on
-
setArtifactDependencies
public void setArtifactDependencies(@NotNull List<SArtifactDependency> artifacts)Description copied from interface:BuildTypeSettingsSets artifacts this build configuration depending on.- Specified by:
setArtifactDependenciesin interfaceBuildTypeSettings- Parameters:
artifacts- new artifacts dependency list.
-
addArtifactDependency
public void addArtifactDependency(@NotNull SArtifactDependency dependency)Description copied from interface:BuildTypeSettingsAdds artifact dependency.- Specified by:
addArtifactDependencyin interfaceBuildTypeSettings- Parameters:
dependency- new artifact dependency
-
removeArtifactDependency
public void removeArtifactDependency(@NotNull SArtifactDependency dependency)Description copied from interface:BuildTypeSettingsRemoves artifact dependency.- Specified by:
removeArtifactDependencyin interfaceBuildTypeSettings- Parameters:
dependency- artifact dependency
-
containsVcsRoot
public boolean containsVcsRoot(long vcsRootId)
Description copied from interface:BuildTypeSettingsReturns true if VCS root with specified id is attached directly or is inherited via a template- Specified by:
containsVcsRootin interfaceBuildTypeSettings- Parameters:
vcsRootId- id of VCS root- Returns:
- see above
-
getVcsRootEntries
@NotNull public List<VcsRootEntry> getVcsRootEntries()
Description copied from interface:BuildTypeSettingsReturns all entries of vcs roots. Each entry contains reference to root and its checkout rules.- Specified by:
getVcsRootEntriesin interfaceBuildTypeSettings- Returns:
- all entries of vcs roots for this configuration
-
addVcsRoot
public boolean addVcsRoot(@NotNull SVcsRoot root) throws InvalidVcsRootScopeException, VcsRootNotFoundExceptionDescription copied from interface:BuildTypeSettingsAdds VCS root to the build configuration with default checkout rules.- Specified by:
addVcsRootin interfaceBuildTypeSettings- Parameters:
root- VCS root to add- Returns:
- true if VCS root was actually added and false otherwise (this VCS root already exists)
- Throws:
InvalidVcsRootScopeException- if VCS root scope is local and corresponds to another project (not the project - owner of this build configuration)VcsRootNotFoundException- if specified VCS root does not exist anymore
-
removeVcsRoot
public boolean removeVcsRoot(@NotNull SVcsRoot root)Description copied from interface:BuildTypeSettingsRemoves existing VCS root from the build configuration. If there were checkout rules attached to this VCS root they will be removed too.- Specified by:
removeVcsRootin interfaceBuildTypeSettings- Parameters:
root- VCS root to remove- Returns:
- true if VCS root was actually removed from the build configuration and false if build configuration did not have this vcs root attached
-
replaceVcsRoot
public boolean replaceVcsRoot(@NotNull SVcsRoot oldVcsRoot, @NotNull SVcsRoot newVcsRoot)Description copied from interface:BuildTypeTemplateExReplaces existing VCS root entry in settings with a new one, maintaining the order of the root entries- Specified by:
replaceVcsRootin interfaceBuildTypeTemplateEx- Parameters:
oldVcsRoot- VCS root to be replacednewVcsRoot- VCS root to insert instead- Returns:
- true if VCS root was actually replaced, false otherwise (the root to be replaced did not exist or the new root already existed)
-
setVcsRoots
public boolean setVcsRoots(@NotNull Collection<SVcsRoot> vcsRoots)Description copied from interface:BuildTypeTemplateExSets VCS roots. All existing VCS roots that are not present in vcsRoots are deleted, all other existing VCS roots are reordered if necessary, but retain their original checkout rules.- Specified by:
setVcsRootsin interfaceBuildTypeTemplateEx- Returns:
- true if any changes occured
-
setEditable
public void setEditable(boolean editable)
Description copied from interface:BuildTypeTemplateExEnables or disables editing of the template in web UI, see alsoSPersistentEntity.isReadOnly().SBuildType.persist()method must be called afterwards.- Specified by:
setEditablein interfaceBuildTypeTemplateEx- Parameters:
editable- true to enable editing and false to disable
-
setCheckoutRules
public boolean setCheckoutRules(@NotNull VcsRoot root, @NotNull CheckoutRules checkoutRules)Description copied from interface:BuildTypeSettingsSets checkout rules for specified VCS root. VCS root must be attached to this build configuration.- Specified by:
setCheckoutRulesin interfaceBuildTypeSettings- Parameters:
root- root to set rules forcheckoutRules- checkout rules for the VCS root- Returns:
- true if checkout rules were set for the VCS root (if VCS root is attached) and false otherwise
-
getCheckoutRules
public CheckoutRules getCheckoutRules(@NotNull VcsRoot root)
Description copied from interface:BuildTypeSettingsReturns checkout rules configured for the specified VCS root. If specified VCS root is not attached to this build configuration, then null is returned.- Specified by:
getCheckoutRulesin interfaceBuildTypeSettings- Parameters:
root- VCS root- Returns:
- checkout rules or null if specified VCS root is not attached to the build configuration
-
addConfigParameter
public void addConfigParameter(@NotNull Parameter param)Description copied from interface:BuildTypeSettingsAdds configuration parameter. There are three different types of parameters which can be added to build configuration settings:- build parameters - these are parameters passed to agent and then to a build (see
BuildTypeSettings.addBuildParameter(Parameter)), these parameters must have prefix system. or env. - runner parameters - these are parameters of a runner, they are transferred to agent and passed to corresponding build runner plugin
- configuration parameters - these parameters are not transferred to agent or build, but can be referenced in various places (including build & runner parameters and thus can effectively pass to a build)
- Specified by:
addConfigParameterin interfaceBuildTypeSettings- Parameters:
param- configuration parameter
- build parameters - these are parameters passed to agent and then to a build (see
-
removeConfigParameter
public void removeConfigParameter(@NotNull String paramName)Description copied from interface:BuildTypeSettingsRemoves configuration parameters with specified name- Specified by:
removeConfigParameterin interfaceBuildTypeSettings- Parameters:
paramName- parameter name
-
getConfigParametersCollection
@NotNull public Collection<Parameter> getConfigParametersCollection()
Description copied from interface:BuildTypeSettingsReturns collection of configuration parameters.- Specified by:
getConfigParametersCollectionin interfaceBuildTypeSettings- Returns:
- see above
-
getConfigParameters
@NotNull public Map<String,String> getConfigParameters()
Description copied from interface:BuildTypeSettingsReturns map of configuration parameters- Specified by:
getConfigParametersin interfaceBuildTypeSettings- Returns:
- see above
-
getUndefinedParameters
@NotNull public List<String> getUndefinedParameters()
Description copied from interface:BuildTypeSettingsReturns collection of parameter names (config and build params) referenced in the build configuration settings but without values provided. I.e. there is a reference to a parameter but such parameter is not defined anywhere.
Parameter value can come from different sources:- build configuration or template settings
- agents
- various extensions
- Specified by:
getUndefinedParametersin interfaceBuildTypeSettings- Returns:
- see above
-
isTemplateBased
public boolean isTemplateBased()
Description copied from interface:BuildTypeSettingsReturns true if these settings are directly based on a template. It does not take into account a default template.- Specified by:
isTemplateBasedin interfaceBuildTypeSettings- Returns:
- see above
-
getTemplate
@Deprecated @Nullable public BuildTypeTemplate getTemplate()
Deprecated.Description copied from interface:BuildTypeSettingsReturns the first template these settings are based on.- Specified by:
getTemplatein interfaceBuildTypeSettings- Returns:
- see above
-
getTemplates
@NotNull public List<? extends BuildTypeTemplate> getTemplates()
Description copied from interface:BuildTypeSettingsReturns templates these settings are based on, including the default template.- Specified by:
getTemplatesin interfaceBuildTypeSettings- Returns:
- see above
-
isTemplateAccessible
public boolean isTemplateAccessible()
Description copied from interface:BuildTypeSettingsChecks accessibility of all attached templates, excluding the default template (if present)- Specified by:
isTemplateAccessiblein interfaceBuildTypeSettings- Returns:
- true if there are such templates and all of them are accessible to currently logged in user, false otherwise
-
getTemplateIds
@NotNull public List<String> getTemplateIds()
Description copied from interface:BuildTypeSettingsReturns internal ids of the templates this settings are based on, including one of the default template- Specified by:
getTemplateIdsin interfaceBuildTypeSettings- Returns:
- see above
-
getTemplateId
@Nullable @Deprecated public String getTemplateId()
Deprecated.Description copied from interface:BuildTypeSettingsReturns internal id of the first template this setting is based on- Specified by:
getTemplateIdin interfaceBuildTypeSettings- Returns:
- see above
-
getRequirements
@NotNull public List<Requirement> getRequirements()
Description copied from interface:BuildTypeSettingsGet list of explicit requirements for build agents which can run this build configuration. Explicit requirements are specified by user in Web UI explicitly.- Specified by:
getRequirementsin interfaceBuildTypeSettings- Returns:
- see above
-
getImplicitRequirements
@NotNull public List<Requirement> getImplicitRequirements()
Description copied from interface:BuildTypeSettingsGet list of non-satisfied implicit requirements for build agents. Implicit requirements appear when some build configuration property, or run parameter contains a reference to another parameter in form %<param name>%.- Specified by:
getImplicitRequirementsin interfaceBuildTypeSettings- Returns:
- see above
-
addRequirement
public void addRequirement(@NotNull Requirement requirement)Description copied from interface:BuildTypeSettingsAdds new build requirement to the configuration. If the requirement has no id, then a copy of it with new id is generated and added to the settings.- Specified by:
addRequirementin interfaceBuildTypeSettings- Parameters:
requirement- new requirement.
-
removeRequirement
public void removeRequirement(String parameterName)
Description copied from interface:BuildTypeSettingsRemoves first requirement with the specified property name from the configuration.- Specified by:
removeRequirementin interfaceBuildTypeSettings- Parameters:
parameterName- name of the requirement parameter.
-
removeRequirement
public void removeRequirement(Requirement requirement)
Description copied from interface:BuildTypeSettingsRemoves a requirement from the configuration.- Specified by:
removeRequirementin interfaceBuildTypeSettings- Parameters:
requirement- requirement to be removed
-
getBuildNumberPattern
@NotNull public String getBuildNumberPattern()
Description copied from interface:BuildTypeSettingsReturns current build number pattern- Specified by:
getBuildNumberPatternin interfaceBuildTypeSettings- Returns:
- see above
-
setBuildNumberPattern
public void setBuildNumberPattern(@NotNull String pattern)Description copied from interface:BuildTypeSettingsSets build number pattern. %build.counter% in the pattern will be replaced with current build number value when build starts- Specified by:
setBuildNumberPatternin interfaceBuildTypeSettings- Parameters:
pattern- pattern to set
-
replaceInValues
public boolean replaceInValues(@NotNull String regexp, @NotNull String replacement) throws PatternSyntaxExceptionDescription copied from interface:BuildTypeSettingsReplaces values according to specified regexp and replacement string in all text parameters of the build configuration- Specified by:
replaceInValuesin interfaceBuildTypeSettings- Parameters:
regexp- regexpreplacement- replacement- Returns:
- true if at least one text value was affected and false otherwise
- Throws:
PatternSyntaxException- if pattern is incorrect
-
replaceInValues
public boolean replaceInValues(@NotNull Pattern regexpPattern, @NotNull String replacement)Description copied from interface:BuildTypeSettingsReplaces values according to specified pattern and replacement string in all text parameters of the build configuration- Specified by:
replaceInValuesin interfaceBuildTypeSettings- Parameters:
regexpPattern- regexp patternreplacement- replacement- Returns:
- true if at least one text value was affected and false otherwise
-
textValueMatches
public boolean textValueMatches(@NotNull Pattern regexpPattern)Description copied from interface:BuildTypeSettingsReturns true if configuration has value in text parameters which matches specified pattern. Only own parameters are checked - without inherited- Specified by:
textValueMatchesin interfaceBuildTypeSettings- Parameters:
regexpPattern- regexp pattern- Returns:
- true if such value exists and false otherwise
-
addBuildFeature
@NotNull public SBuildFeatureDescriptor addBuildFeature(@NotNull String type, @NotNull Map<String,String> params)
Description copied from interface:BuildTypeSettingsAdds build feature with specified type and parameters to this settings object.- Specified by:
addBuildFeaturein interfaceBuildTypeSettings- Parameters:
type- build feature typeparams- build feature parameters- Returns:
- build feature descriptor
-
addBuildFeature
public void addBuildFeature(@NotNull SBuildFeatureDescriptor feature)Description copied from interface:BuildTypeSettingsAdds build feature descriptor to this settings object.- Specified by:
addBuildFeaturein interfaceBuildTypeSettings- Parameters:
feature- build feature descriptor
-
getBuildFeatures
@NotNull public Collection<SBuildFeatureDescriptor> getBuildFeatures()
Description copied from interface:BuildTypeSettingsReturns build features added to this settings object.- Specified by:
getBuildFeaturesin interfaceBuildTypeSettings- Returns:
- collection of configured build features
-
getBuildFeaturesOfType
@NotNull public Collection<SBuildFeatureDescriptor> getBuildFeaturesOfType(@NotNull String type)
Description copied from interface:BuildTypeSettingsReturns all build features of specified type.- Specified by:
getBuildFeaturesOfTypein interfaceBuildTypeSettings- Returns:
- see above
-
removeBuildFeature
@Nullable public SBuildFeatureDescriptor removeBuildFeature(@NotNull String featureId)
Description copied from interface:BuildTypeSettingsRemoves build feature with specified id from this settings object.- Specified by:
removeBuildFeaturein interfaceBuildTypeSettings- Parameters:
featureId- id of the feature- Returns:
- removed build feature descriptor or null if there were no feature descriptor with such id
-
updateBuildFeature
public boolean updateBuildFeature(@NotNull String featureId, @NotNull String newType, @NotNull Map<String,String> newParams)Description copied from interface:BuildTypeSettingsUpdates build feature descriptor with specified id, changes type and parameters.- Specified by:
updateBuildFeaturein interfaceBuildTypeSettings- Parameters:
featureId- id of build feature descriptornewType- type of build feature descriptornewParams- parameters map- Returns:
- true if parameters of build feature descriptor were changed (descriptor with such id exists) and false otherwise
-
findBuildFeatureById
@Nullable public SBuildFeatureDescriptor findBuildFeatureById(@NotNull String featureId)
Description copied from interface:BuildTypeSettingsReturns build feature with specified id- Specified by:
findBuildFeatureByIdin interfaceBuildTypeSettings- Parameters:
featureId- id of the feature- Returns:
- see above
-
setEnabled
public void setEnabled(@NotNull String parametersDescriptorId, boolean enabled)Description copied from interface:BuildTypeSettingsEnables or disables descriptor with specified id in build configuration settings. This method can be used to enable or disable build runners, triggers and build features.- Specified by:
setEnabledin interfaceBuildTypeSettings- Parameters:
parametersDescriptorId- id of build runner, trigger or build featureenabled- true to enable, false to disable
-
isEnabled
public boolean isEnabled(@NotNull String parametersDescriptorId)Description copied from interface:BuildTypeSettingsReturns true if descriptor with specified id (runner, trigger or build feature) is enabled and false otherwise.- Specified by:
isEnabledin interfaceBuildTypeSettings- Parameters:
parametersDescriptorId- id of build runner, trigger or build feature
-
getTypedOption
@NotNull public <T> TypedValue<T> getTypedOption(@NotNull Option<T> option)
Description copied from interface:BuildTypeSettingsGet option extended value. See
TypedValue. When the option is not defined in this Settings TypedValue will contain null in getValue()- Specified by:
getTypedOptionin interfaceBuildTypeSettings
-
removeCleanupPolicies
public void removeCleanupPolicies()
Description copied from interface:CleanupSettingsInitRemove all own cleanup policies for the object- Specified by:
removeCleanupPoliciesin interfaceCleanupSettingsInit
-
setCleanupOption
public void setCleanupOption(@NotNull String option, @Nullable Boolean value)Description copied from interface:CleanupSettingsInitSets value for a cleanup option- Specified by:
setCleanupOptionin interfaceCleanupSettingsInit- Parameters:
option- cleanup option (seeCleanupSettingsconstants)value- value to set option to, ornullto remove the option
-
getInheritedCleanupOptions
@NotNull public Map<String,Boolean> getInheritedCleanupOptions()
- Specified by:
getInheritedCleanupOptionsin interfaceCleanupSettings
-
getDependencies
@NotNull public List<Dependency> getDependencies()
Description copied from interface:DependencySettingsGet existing dependencies, empty collection when no dependencies exist- Specified by:
getDependenciesin interfaceDependencySettings- Returns:
- see above
-
addDependency
public void addDependency(@NotNull Dependency dependOn) throws CyclicDependencyFoundExceptionDescription copied from interface:DependencySettingsAdd dependency on another build configuration- Specified by:
addDependencyin interfaceDependencySettings- Parameters:
dependOn- new dependency- Throws:
CyclicDependencyFoundException- if cycle is detected
-
removeDependency
public boolean removeDependency(@NotNull Dependency dependOn)Description copied from interface:DependencySettingsRemove dependency on another build configuration- Specified by:
removeDependencyin interfaceDependencySettings- Parameters:
dependOn- dependency to remove- Returns:
- true if dependency was actually removed
-
getParametersCollection
@NotNull public Collection<Parameter> getParametersCollection()
Description copied from interface:ReadOnlyUserParametersReturns build and configuration parameters in single collection.- Specified by:
getParametersCollectionin interfaceInheritableUserParametersHolder- Specified by:
getParametersCollectionin interfaceReadOnlyUserParameters- Returns:
- merged collection of parameters, i.e. all parameters inherited from parent holders and own parameters
-
getParameter
@Nullable public Parameter getParameter(@NotNull String paramName)
- Specified by:
getParameterin interfaceReadOnlyUserParameters
-
getOwnParametersCollection
@NotNull public Collection<Parameter> getOwnParametersCollection()
- Specified by:
getOwnParametersCollectionin interfaceInheritableUserParametersHolder- Returns:
- own parameters, without inherited. Yet they would have inherited specs or values (if any).
-
getOwnParameters
@NotNull public Map<String,String> getOwnParameters()
- Specified by:
getOwnParametersin interfaceInheritableUserParametersHolder- Returns:
- own parameters map, without inherited. Yet they would have inherited specs or values (if any).
-
setOption
public <T> void setOption(@NotNull Option<T> option, @NotNull T value)Description copied from interface:OptionSupportSet option value, clears value if it is the same as default- Specified by:
setOptionin interfaceOptionSupport- Parameters:
option- option to set value forvalue- option value
-
getOwnOptions
@NotNull public Collection<Option> getOwnOptions()
Description copied from interface:OptionSupportReturn options defined in this object, i.e. options for which some value has been set usingOptionSupport.setOption(Option, Object)method.- Specified by:
getOwnOptionsin interfaceOptionSupport- Returns:
- see above
-
getOptions
@NotNull public Collection<Option> getOptions()
- Specified by:
getOptionsin interfaceOptionSupport- Returns:
- combined set of options - own and inherited
-
getChangedOptions
@NotNull public Option[] getChangedOptions()
Description copied from interface:OptionSupportReturn options with changed values, i.e. options with non-default values- Specified by:
getChangedOptionsin interfaceOptionSupport- Returns:
- see above
-
getOption
@NotNull public <T> T getOption(@NotNull Option<T> option)Description copied from interface:OptionSupportGet option value- Specified by:
getOptionin interfaceOptionSupport- Parameters:
option- option to retrieve value for- Returns:
- value of the option. If value wasn't set, Option:getDefaultValue is returned
-
getOptionDefaultValue
@NotNull public <T> T getOptionDefaultValue(@NotNull Option<T> option)- Specified by:
getOptionDefaultValuein interfaceOptionSupport- Parameters:
option- option whose default value to return- Returns:
- default value for specified option
-
getDeclaredOption
@Nullable public <T> T getDeclaredOption(Option<T> option)
Description copied from interface:OptionSupportGet option value declared in this BuildTypeSettings
- Specified by:
getDeclaredOptionin interfaceOptionSupport- Parameters:
option- option to retrieve value for- Returns:
- value of the option. If value wasn't set, null is returned
-
getConfigId
@NotNull public String getConfigId()
Description copied from interface:SPersistentEntityReturns the entity's config identifier. Config identifier uniquely identifies the entity across different TeamCity servers and can't be modified in contrast to external identifier.- Specified by:
getConfigIdin interfaceSPersistentEntity
-
getParent
@Nullable public SPersistentEntity getParent()
Description copied from interface:SPersistentEntityThe parent entity.- Specified by:
getParentin interfaceSPersistentEntity- Returns:
- see above.
-
addParameter
public void addParameter(@NotNull Parameter param)Description copied from interface:UserParametersHolderAdds parameter.- Specified by:
addParameterin interfaceUserParametersHolder- Parameters:
param- build or config parameter, the type is determined by parameter prefix
-
removeParameter
public void removeParameter(@NotNull String paramName)Description copied from interface:UserParametersHolderRemoves parameter.- Specified by:
removeParameterin interfaceUserParametersHolder- Parameters:
paramName- build or config parameter name, the type is determined by parameter prefix
-
getLabelingType
@NotNull public VcsLabelingSettings.LabelingType getLabelingType()
- Specified by:
getLabelingTypein interfaceVcsLabelingSettings- Returns:
- Returns labeling mode
-
getLabelPattern
@NotNull public String getLabelPattern()
- Specified by:
getLabelPatternin interfaceVcsLabelingSettings- Returns:
- Returns pattern to use for labeling
-
getLabelingRoots
@NotNull public List<VcsRoot> getLabelingRoots()
Description copied from interface:VcsLabelingSettingsList of roots which should be processed by labeling process- Specified by:
getLabelingRootsin interfaceVcsLabelingSettings- Returns:
- list of up-to-date vcs roots
-
getName
@NotNull public String getName()
Description copied from interface:BuildTypeIdentityThe name of the identity.- Specified by:
getNamein interfaceBuildTypeIdentity- Specified by:
getNamein interfaceSPersistentEntity- Returns:
- see above.
- See Also:
BuildTypeIdentity.getFullName(),BuildTypeIdentity.setName(String)
-
setName
public void setName(@NotNull String name)Description copied from interface:BuildTypeIdentitySets name of this build type or template- Specified by:
setNamein interfaceBuildTypeIdentity- Parameters:
name- the new name- See Also:
BuildTypeIdentity.getName(),BuildTypeIdentity.getFullName()
-
getFullName
@NotNull public String getFullName()
Description copied from interface:BuildTypeIdentityName of the project and name of the identity.- Specified by:
getFullNamein interfaceBuildTypeIdentity- See Also:
BuildTypeIdentity.getName()
-
getDescription
public String getDescription()
- Specified by:
getDescriptionin interfaceBuildTypeTemplate- Returns:
- template description
-
setDescription
public void setDescription(@Nullable String description)Description copied from interface:BuildTypeTemplateSets template description- Specified by:
setDescriptionin interfaceBuildTypeTemplate- Parameters:
description- template description
-
setExternalId
public void setExternalId(@NotNull String newExternalId) throws InvalidIdentifierException, DuplicateExternalIdExceptionDescription copied from interface:BuildTypeIdentityChanges the external id of this build template or build configuration.This method persists the current entity, and can persist also dependent entities.
- Specified by:
setExternalIdin interfaceBuildTypeIdentity- Parameters:
newExternalId- new external identifier. Must be unique (case insensitively) in the scope of all build templates and build configurations (in other words, two projects with build configurations with same external id are not allowed).- Throws:
InvalidIdentifierException- wrong identifierDuplicateExternalIdException- a build template or a build configuration
-
dispose
public void dispose()
- Specified by:
disposein interfaceBuildTypeTemplateEx
-
unregister
public void unregister()
Description copied from interface:BuildTypeIdentityExRemoves this object from project model. No changes on disk are performed.- Specified by:
unregisterin interfaceBuildTypeIdentityEx- Specified by:
unregisterin interfaceBuildTypeTemplateEx
-
setExternalId
public void setExternalId(@NotNull ConfigAction configAction, @NotNull String newId, boolean sendEvents) throws InvalidIdentifierException, DuplicateExternalIdException, ObsoleteEntityExceptionDescription copied from interface:BuildTypeIdentityExSame as {BuildTypeIdentity.setExternalId(ConfigAction, String)} but provides control over events processing. If parameter sendEvents is false, then no events about changing of the external id will be sent. This mode can be useful if the events will be sent later, for instance, in case of bulk edit ids operation.- Specified by:
setExternalIdin interfaceBuildTypeIdentityEx- Throws:
InvalidIdentifierExceptionDuplicateExternalIdExceptionObsoleteEntityException
-
sendExtIdChangedEvents
public void sendExtIdChangedEvents(@NotNull ConfigAction cause, @NotNull String oldExternalId, @NotNull String newExternalId)Description copied from interface:BuildTypeIdentityExThis method can be used to send external id changed event.- Specified by:
sendExtIdChangedEventsin interfaceBuildTypeIdentityEx
-
getLastConfigModificationAction
@Nullable public AuditLogAction getLastConfigModificationAction()
- Specified by:
getLastConfigModificationActionin interfaceBuildTypeTemplateEx
-
getBranchSpec
@NotNull public BranchSpec getBranchSpec(@NotNull SVcsRoot root)
Description copied from interface:BuildTypeTemplateExReturns branch specification for specified parent root- Specified by:
getBranchSpecin interfaceBuildTypeTemplateEx- Parameters:
root- root of interest- Returns:
- see above
-
isBranchSpecDefined
public boolean isBranchSpecDefined(boolean processDependencies)
- Specified by:
isBranchSpecDefinedin interfaceBuildTypeTemplateEx
-
getVcsBranches
@NotNull public List<Branch> getVcsBranches(boolean includeDependenciesBranches)
Description copied from interface:BuildTypeTemplateExAll VCS branches from VCS roots attached to this template and VCS branches from dependencies (if parameter includeDependenciesBranches is true).- Specified by:
getVcsBranchesin interfaceBuildTypeTemplateEx- Parameters:
includeDependenciesBranches- whether to add branches from dependencies to the list or not- Returns:
- see above
-
moveToProject
public void moveToProject(@NotNull SProject target) throws InvalidVcsRootScopeExceptionDescription copied from interface:BuildTypeTemplateMoves this template to the specified project. Note that if there are local VCS roots attached to this template, they will be shared. If sharing is impossible due to lack of access rights, AccessDeniedException will be thrown.- Specified by:
moveToProjectin interfaceBuildTypeTemplate- Parameters:
target- target project- Throws:
InvalidVcsRootScopeException- if VCS roots used by this template will not be accessible in the target project
-
moveToProject
public void moveToProject(@NotNull ConfigAction cause, @NotNull SProject target) throws InvalidVcsRootScopeExceptionDescription copied from interface:BuildTypeTemplateMoves this template to the specified project. Note that if there are local VCS roots attached to this template, they will be shared. If sharing is impossible due to lack of access rights, AccessDeniedException will be thrown.- Specified by:
moveToProjectin interfaceBuildTypeTemplate- Parameters:
cause- config action caused the changetarget- target project- Throws:
InvalidVcsRootScopeException- if VCS roots used by this template will not be accessible in the target project
-
getVcsRootInstanceEntries
@NotNull public List<VcsRootInstanceEntry> getVcsRootInstanceEntries()
- Specified by:
getVcsRootInstanceEntriesin interfaceBuildTypeTemplateEx
-
isReadOnly
public boolean isReadOnly()
- Specified by:
isReadOnlyin interfaceBuildTypeSettings- Specified by:
isReadOnlyin interfaceSPersistentEntity- Returns:
- true if this entity settings are in read only mode
-
getReadOnlyReason
@Nullable public ReadOnlyReason getReadOnlyReason()
- Specified by:
getReadOnlyReasonin interfaceBuildTypeSettings- Specified by:
getReadOnlyReasonin interfaceSPersistentEntity- Returns:
- reason why this entity settings are in read only state or null if they are not read only
-
setExternalId
public void setExternalId(@NotNull ConfigAction cause, @NotNull String newExternalId) throws InvalidIdentifierException, DuplicateExternalIdExceptionDescription copied from interface:BuildTypeIdentityChanges the external id of this build template or build configuration.This method persists the current entity, and can persist also dependent entities.
- Specified by:
setExternalIdin interfaceBuildTypeIdentity- Parameters:
cause- configuration action caused the changenewExternalId- new external identifier. Must be unique (case insensitively) in the scope of all build templates and build configurations (in other words, two projects with build configurations with same external id are not allowed).- Throws:
InvalidIdentifierException- wrong identifierDuplicateExternalIdException- a build template or a build configuration
-
persist
public void persist() throws PersistFailedExceptionDescription copied from interface:SPersistentEntityPersists this entity instance onto disk. Should be called each time when settings are changed, otherwise the changes will be lost after the server restart.- Specified by:
persistin interfaceBuildTypeSettings- Specified by:
persistin interfaceBuildTypeTemplate- Specified by:
persistin interfaceSPersistentEntity- Throws:
PersistFailedException- if persisting failed
-
getUsages
public Collection<SBuildType> getUsages()
Description copied from interface:BuildTypeTemplateReturns collection of build configurations attached to this template. This does not include the build configurations that use this template because it is defined as default template in the respective projects- Specified by:
getUsagesin interfaceBuildTypeTemplate- Returns:
- see above.
-
getAllUsages
public Collection<SBuildType> getAllUsages()
Description copied from interface:BuildTypeTemplateSame as #getUsages() but also returns configurations that use this template as default template- Specified by:
getAllUsagesin interfaceBuildTypeTemplate- Returns:
- see above
-
getUsagesAsDefaultTemplate
public Collection<SProject> getUsagesAsDefaultTemplate()
Description copied from interface:BuildTypeTemplateReturns collection of projects where this template is used as a default template. This does not include projects that use it as a default template because it is set up as such in one of the higher level projects in their paths- Specified by:
getUsagesAsDefaultTemplatein interfaceBuildTypeTemplate- Returns:
- see above
-
getNumberOfUsages
public int getNumberOfUsages()
Description copied from interface:BuildTypeTemplateReturns total number of this template usages (without permissions filtering) in build configurations- Specified by:
getNumberOfUsagesin interfaceBuildTypeTemplate- Returns:
- see above
-
getNumberOfUsagesAsDefaultTemplate
public int getNumberOfUsagesAsDefaultTemplate()
Description copied from interface:BuildTypeTemplateReturns total number of projects (without permissions filtering) using this template as a default template- Specified by:
getNumberOfUsagesAsDefaultTemplatein interfaceBuildTypeTemplate- Returns:
- see above
-
getParentProject
@NotNull public SProject getParentProject()
Description copied from interface:BuildTypeTemplateReturns project to which this template belongs- Specified by:
getParentProjectin interfaceBuildTypeTemplate- Returns:
- see above
-
getParentProjectId
@NotNull public String getParentProjectId()
Description copied from interface:BuildTypeTemplateReturns id of the project to which this template belongs- Specified by:
getParentProjectIdin interfaceBuildTypeTemplate- Returns:
- see above
-
remove
public void remove()
Description copied from interface:SPersistentEntityRemoves this entity.This method also makes all changes (related to removing the entity) on the disk and in the database. There is no need to call the persist() after this method.
- Specified by:
removein interfaceSPersistentEntity
-
getConfigurationFile
@NotNull public File getConfigurationFile()
Description copied from interface:BuildTypeIdentityReturns the configuration file where this build type or template is persisted (or will be persisted to).- Specified by:
getConfigurationFilein interfaceBuildTypeIdentity- Specified by:
getConfigurationFilein interfaceSPersistentEntity- Returns:
- see above.
-
getCompatibilityMap
@NotNull public Map<SBuildAgent,CompatibilityResult> getCompatibilityMap()
Description copied from interface:CompatibleAgentsReturns compatibility map, key is an agent and value is compatibility result.- Specified by:
getCompatibilityMapin interfaceCompatibleAgents- Returns:
- see above
-
getCompatibleAgents
@NotNull public Collection<SBuildAgent> getCompatibleAgents()
Description copied from interface:CompatibleAgentsReturns collection of compatible agents- Specified by:
getCompatibleAgentsin interfaceCompatibleAgents- Returns:
- see above
-
getAgentCompatibility
@NotNull public CompatibilityResult getAgentCompatibility(@NotNull AgentDescription agentDescription)
Description copied from interface:CompatibleAgentsFetches compatibility information for given agent description- Specified by:
getAgentCompatibilityin interfaceCompatibleAgents- Parameters:
agentDescription- agent description- Returns:
- compatibility results.
- See Also:
CompatibilityResult
-
getChildDependencies
@NotNull public Collection<SBuildType> getChildDependencies()
Description copied from interface:DependentReturns all child dependencies collected down the chain. Note that returned dependencies are sorted by depth in the chain. Note that returned collection will contain accessible by current authority holder objects only.- Specified by:
getChildDependenciesin interfaceDependent- Returns:
- see above
-
intersectsWith
public boolean intersectsWith(@NotNull Dependent dependent)Description copied from interface:DependentReturns true if this object dependencies intersect (have same nodes) with specified object dependencies.- Specified by:
intersectsWithin interfaceDependent- Parameters:
dependent- another object- Returns:
- see above
-
getParametersProvider
@NotNull public ParametersProvider getParametersProvider()
Description copied from interface:ParametersSupportReturns parameters which can be used by value resolver. Note that some of the parameters may not have values defined because sometimes values can be calculated on the agent side only.- Specified by:
getParametersProviderin interfaceParametersSupport- Returns:
- parameters
-
getValueResolver
@NotNull public ValueResolver getValueResolver()
Description copied from interface:ParametersSupportReturns value resolver which can be used to resolve references in values- Specified by:
getValueResolverin interfaceParametersSupport- Returns:
- value resolver
-
persist
public void persist(@NotNull ConfigAction cause) throws PersistFailedExceptionDescription copied from interface:SPersistentEntityPersists this entity on disk.- Specified by:
persistin interfaceBuildTypeSettings- Specified by:
persistin interfaceSPersistentEntity- Parameters:
cause- an action which caused persisting- Throws:
PersistFailedException- if persisting failed
-
schedulePersisting
@NotNull public PersistTask schedulePersisting(@NotNull ConfigAction cause) throws PersistFailedException
Description copied from interface:SPersistentEntitySchedules background persisting of this project settings.- Specified by:
schedulePersistingin interfaceSPersistentEntity- Parameters:
cause- an action which caused persisting- Returns:
- a task which can be used to track the operation progress or wait for the operation to complete
- Throws:
PersistFailedException- if failed to schedule the operation- See Also:
SPersistentEntity.schedulePersisting(String)
-
schedulePersisting
@NotNull public PersistTask schedulePersisting(@NotNull String reason) throws PersistFailedException
Description copied from interface:SPersistentEntitySchedules background persisting of this entity settings.- Specified by:
schedulePersistingin interfaceSPersistentEntity- Parameters:
reason- provides a reason why persist operation was called- Returns:
- a task which can be used to track the operation progress or wait for the operation to complete
- Throws:
PersistFailedException- if failed to schedule the operation- See Also:
SPersistentEntity.schedulePersisting(ConfigAction)
-
scheduleRemove
@NotNull public PersistTask scheduleRemove(@NotNull ConfigAction cause) throws PersistFailedException
Description copied from interface:SPersistentEntitySchedules remove of this persistent entity. Returns task which can be used to wait for the operation to complete.- Specified by:
scheduleRemovein interfaceSPersistentEntity- Parameters:
cause- reason of the remove- Returns:
- a task which can be used to track the operation progress or wait for the operation to complete
- Throws:
PersistFailedException- if failed to schedule the operation
-
getConfigurationFile
@NotNull public File getConfigurationFile(@NotNull File projectsDir)
Description copied from interface:SPersistentEntityReturns the configuration file where this entity is persisted in custom projects directory- Specified by:
getConfigurationFilein interfaceSPersistentEntity- Parameters:
projectsDir- path to teamcity projects directory- Returns:
- see above
-
getOwnParameter
@Nullable public Parameter getOwnParameter(@NotNull String paramName)
- Specified by:
getOwnParameterin interfaceInheritableUserParametersHolder- Parameters:
paramName- parameter name- Returns:
- own parameter with given name or null if there is no such parameter
-
getOwnParametersWithoutInheritedSpec
@NotNull public Collection<Parameter> getOwnParametersWithoutInheritedSpec()
- Specified by:
getOwnParametersWithoutInheritedSpecin interfaceInheritableUserParametersHolder- Returns:
- own parameters as is, with own parameters spec.
-
getInheritedParametersCollection
@NotNull public Collection<Parameter> getInheritedParametersCollection()
- Specified by:
getInheritedParametersCollectionin interfaceInheritableUserParametersHolder- Returns:
- collection of inherited parameters.
-
getOwnNonInheritedParameter
@Nullable public Parameter getOwnNonInheritedParameter(@NotNull String paramName)
Description copied from interface:InheritableUserParametersHolderExOwn parameter without inherited parameter spec.- Specified by:
getOwnNonInheritedParameterin interfaceInheritableUserParametersHolderEx- Returns:
-
getVersion
@NotNull public PersistentEntityVersion getVersion()
Description copied from interface:SPersistentEntityReturns version of this entity which can be used to check if the entity was edited or persisted.- Specified by:
getVersionin interfaceSPersistentEntity- Returns:
- see above
-
markPersisted
public void markPersisted(long expectedEditId)
Description copied from interface:SPersistentEntityMarks entity as persisted- Specified by:
markPersistedin interfaceSPersistentEntity- Parameters:
expectedEditId- expected editId in the end of persist. The entity will be marked as unedited if expected editId is the same as actual, ie. the entity wasn't edited while persist was running
-
createConfigAction
@NotNull public ConfigAction createConfigAction(@Nullable SUser user, @NotNull String description)
Description copied from interface:SPersistentEntityCreates a config action instance associated with this entity and having the specified description. The config action object can be used inSPersistentEntity.schedulePersisting(ConfigAction)orSPersistentEntity.scheduleRemove(ConfigAction)methods to describe the performed action.- Specified by:
createConfigActionin interfaceSPersistentEntity- Parameters:
user- user who performs operation, or null if operation is performed by the systemdescription- description to set to the config action object- Returns:
- new config action
-
isDefaultBranchExcluded
public boolean isDefaultBranchExcluded()
Description copied from interface:BuildTypeTemplateExReturns true if any of VCS roots attached to configuration exclude the default branch- Specified by:
isDefaultBranchExcludedin interfaceBuildTypeTemplateEx- Returns:
- see above
-
isDeploymentBuildType
public boolean isDeploymentBuildType()
- Specified by:
isDeploymentBuildTypein interfaceBuildTypeTemplateEx- Returns:
- true if build configuration inherited from this template is doing deployment
-
isDeployment
public boolean isDeployment()
- Specified by:
isDeploymentin interfaceBuildTypeSettings- Returns:
- true if this build configuration is doing deployment
-
isCompositeBuildType
public boolean isCompositeBuildType()
- Specified by:
isCompositeBuildTypein interfaceBuildTypeSettings- Specified by:
isCompositeBuildTypein interfaceBuildTypeTemplateEx- Returns:
- true if build configuration inherited from this template is composite
-
isAgentLessBuildType
public boolean isAgentLessBuildType()
- Specified by:
isAgentLessBuildTypein interfaceBuildTypeTemplateEx
-
isEmptyUuid
public boolean isEmptyUuid()
- Specified by:
isEmptyUuidin interfaceBuildTypeTemplateEx- Returns:
- true if this template has an empty uuid in its config on disk
-
getUsagesAsEnforcedSettings
public Collection<SProject> getUsagesAsEnforcedSettings()
- Specified by:
getUsagesAsEnforcedSettingsin interfaceBuildTypeTemplateEx- Returns:
- a collection of projects that use the template to represent their enforced settings
-
getNumberOfUsagesAsEnforcedSettings
public int getNumberOfUsagesAsEnforcedSettings()
- Specified by:
getNumberOfUsagesAsEnforcedSettingsin interfaceBuildTypeTemplateEx- Returns:
- a number of projects that use the template to represent their enforced settings
-
containsOwnVcsRoot
public boolean containsOwnVcsRoot(long vcsRootId)
Description copied from interface:BuildTypeSettingsReturns true if VCS root with specified id is attached directly and is not inherited via a template- Specified by:
containsOwnVcsRootin interfaceBuildTypeSettings- Specified by:
containsOwnVcsRootin interfaceBuildTypeTemplateEx- Parameters:
vcsRootId- vcs root id- Returns:
- true if the specified VCS root is attached to the temlate directly and is not inherited
-
createDummyBuildPromotion
public BuildPromotion createDummyBuildPromotion()
- Specified by:
createDummyBuildPromotionin interfaceBuildTypeTemplateEx- Returns:
- dummy build promotion
-
compareTo
public int compareTo(@NotNull BuildTypeTemplate o)- Specified by:
compareToin interfaceComparable<BuildTypeTemplate>
-
getOptionSupport
@NotNull public ContainerWithInherited<Option<Object>,OptionValue<Object>> getOptionSupport()
- Specified by:
getOptionSupportin interfaceBuildTypeSettingsSupport
-
getBuildFeatureSupport
@NotNull public ContainerWithDisabled<String,SBuildFeatureDescriptor> getBuildFeatureSupport()
- Specified by:
getBuildFeatureSupportin interfaceBuildTypeSettingsSupport
-
getRequirementSupport
@NotNull public ContainerWithDisabled<String,Requirement> getRequirementSupport()
- Specified by:
getRequirementSupportin interfaceBuildTypeSettingsSupport
-
getBuildRunnerSupport
@NotNull public ContainerWithDisabled<String,SBuildRunnerDescriptor> getBuildRunnerSupport()
- Specified by:
getBuildRunnerSupportin interfaceBuildTypeSettingsSupport
-
getBuildTriggersSupport
@NotNull public ContainerWithDisabled<String,BuildTriggerDescriptor> getBuildTriggersSupport()
- Specified by:
getBuildTriggersSupportin interfaceBuildTypeSettingsSupport
-
getDisabledState
@NotNull public Container<String,Boolean> getDisabledState()
- Specified by:
getDisabledStatein interfaceBuildTypeSettingsSupport
-
getParametersSupport
@NotNull public ContainerWithInherited<String,Parameter> getParametersSupport()
- Specified by:
getParametersSupportin interfaceParameterSupport
-
-