Class InaccessibleTemplate
- java.lang.Object
-
- jetbrains.buildServer.serverSide.impl.InaccessibleTemplate
-
- All Implemented Interfaces:
Comparable<BuildTypeTemplate>,BuildTypeIdentity,BuildTypeIdentityEx,BuildTypeOptions,BuildTypeOwnSettings,BuildTypeSettings,BuildTypeSettingsEx,BuildTypeTemplate,BuildTypeTemplateEx,CleanupSettings,CleanupSettingsInit,CompatibleAgents,DependencySettings,Dependent,BuildTypeSettingsSupport,ParameterSupport,InheritableUserParametersHolder,InheritableUserParametersHolderEx,InternalParameters,ParametersSupport,ReadOnlyUserParameters,SPersistentEntity,UserParametersHolder,VcsLabelingSettings,OptionSupport
public class InaccessibleTemplate extends Object implements BuildTypeTemplateEx, BuildTypeSettingsEx
Wrapper object used in the case when template became inaccessible to current user (either template was deleted or template is from the project to which user does not have permissions)
-
-
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 Modifier and Type Field Description static InaccessibleTemplateINSTANCE-
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
-
-
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 configurationvoidaddListener(BuildTypeSettingsListener listener)voidaddListener(BuildTypeSettingsListener listener, boolean delayPropagation)Adds listener to the build type settings and all settings of the attached templatesvoidaddParameter(Parameter param)Adds parameter.voidaddRequirement(Requirement requirement)Adds new build requirement to the configuration.voidaddRunParameter(SBuildRunnerDescriptor runner, Parameter parameter)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.voidapplyRunnersOrder(String[] ids, boolean alwaysSetCustom)Apply custom order of build stepsvoidattachedToModel(ProjectDataModel model)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 templatevoidcopyAllSettings(BuildTypeSettingsEx source)Copies all settings, the behaviour is the same as copySettings with empty copyOptions, i.e.voidcopyOverridableSettings(BuildTypeSettingsEx settingsSource)voidcopyOwnSettings(BuildTypeSettingsEx settings)voidcopySettings(BuildTypeSettingsEx source, BuildTypeCopySettings copyOptions)Copies settings, parameters, options etc.ConfigActioncreateConfigAction(SUser user, String description)Creates a config action instance associated with this entity and having the specified description.BuildTypeSettingsExcreateCopy()BuildPromotioncreateDummyBuildPromotion()BuildTypeTemplateExcreateEditableCopy(boolean fillSettings)ParametersProvidercreateParametersProvider(SBuild build)ReadOnlyBuildTypeSettingscreateReadOnlySettings()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.List<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()BranchFiltergetBuildTypeBranchFilter(ValueResolver valueResolver)BranchFiltergetBuildTypeBranchFilterUnsafe(ValueResolver valueResolver)Same asBuildTypeSettingsEx.getBuildTypeBranchFilter(ValueResolver)but throws an exception if the filter is incorrectOption[]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 directoryList<Dependency>getDependencies()Get existing dependencies, empty collection when no dependencies existDependencyOptionsgetDependencyOptions(SBuildType buildType)StringgetDescription()Collection<String>getDisabledParameterDescriptorIds()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()List<SArtifactDependency>getOwnArtifactDependencies()List<SBuildFeatureDescriptor>getOwnBuildFeatures()List<SBuildRunnerDescriptor>getOwnBuildRunners()List<BuildTriggerDescriptor>getOwnBuildTriggers()Map<String,Boolean>getOwnCleanupOptions()Collection<HistoryRetentionPolicy>getOwnCleanupPolicies()CleanupSettingsSupportgetOwnCleanupSupport()List<Dependency>getOwnDependencies()Collection<String>getOwnDisabledParameterDescriptorIds()ParametergetOwnNonInheritedParameter(String paramName)Own parameter without inherited parameter spec.Collection<Option>getOwnOptions()Return options defined in this object, i.e.OptionSupportExgetOwnOptionSupport()ParametergetOwnParameter(String paramName)Map<String,String>getOwnParameters()Collection<Parameter>getOwnParametersCollection()Collection<Parameter>getOwnParametersWithoutInheritedSpec()List<Requirement>getOwnRequirements()Collection<String>getOwnRunnerTypes()SerializableParametersCollectiongetOwnSerializableParameters()List<String>getOwnTemplateExternalIds()List<String>getOwnTemplateIds()List<BuildTypeTemplateEx>getOwnTemplates()List<VcsRootEntry>getOwnVcsRootEntries()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.ProjectExgetParentProject()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.SecureDataStoragegetSecureDataStorage()BuildTypeSettingsExgetSettings()BuildTypeTemplateExgetTemplate()Returns the first template these settings are based on.StringgetTemplateExternalId()Deprecated.StringgetTemplateId()Returns internal id of the first template this setting is based onList<String>getTemplateIds()Returns internal ids of the templates this settings are based on, including one of the default templateList<BuildTypeTemplateEx>getTemplates()Returns templates these settings are based on, including the default template.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 id)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 configurationvoidremoveListener(BuildTypeSettingsListener listener)voidremoveParameter(String paramName)Removes parameter.voidremoveRequirement(String propertyName)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.voidreplaceDependency(SArtifactDependency origDep, SArtifactDependency newDep)Replaces original dependency object with another onevoidreplaceDependency(Dependency origDep, Dependency newDep)Replaces original dependency object with another onebooleanreplaceInValues(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 id, boolean enabled)Enables or disables descriptor with specified id in build configuration settings.voidsetExternalId(String externalId)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 defaultvoidsetParametersSupport(ParametersSupport paramsSupport)voidsetProject(ProjectEx project)Sets new project to settings objectvoidsetSecureDataStorage(SecureDataStorage secureDataStorage)Sets secure data storage to be used by these settings when they are persisted on disk.voidsetTemplateIds(List<String> templateIds)Change which templates these settings are attached to.voidsetTemplatesOrder(List<String> templateIds)Imposes new order on the associated templates.booleansetVcsRoots(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 name, String type, Map<String,String> params)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.booleanvcsRootsAccessibleInProject(SProject project)-
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.BuildTypeSettingsEx
getDeclaredOption, getParameterDescriptorState, getTypedOption
-
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
-
-
-
-
Field Detail
-
INSTANCE
public static final InaccessibleTemplate INSTANCE
-
-
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 interfaceBuildTypeSettingsEx- Specified by:
getProjectin interfaceBuildTypeTemplate- Specified by:
getProjectin interfaceBuildTypeTemplateEx- Returns:
- the project this build type entity belongs to.
-
setProject
public void setProject(@NotNull ProjectEx project)Description copied from interface:BuildTypeSettingsExSets new project to settings object- Specified by:
setProjectin interfaceBuildTypeSettingsEx
-
getParent
@Nullable public SPersistentEntity getParent()
Description copied from interface:SPersistentEntityThe parent entity.- Specified by:
getParentin interfaceSPersistentEntity- Returns:
- see above.
-
getSettings
@NotNull public BuildTypeSettingsEx getSettings()
- Specified by:
getSettingsin interfaceBuildTypeIdentityEx- Specified by:
getSettingsin interfaceBuildTypeTemplateEx- Returns:
- Underlying build settings object
-
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.
-
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()
-
getDescription
@NotNull public String getDescription()
- Specified by:
getDescriptionin interfaceBuildTypeTemplate- Returns:
- template description
-
setDescription
public void setDescription(@NotNull String description)Description copied from interface:BuildTypeTemplateSets template description- Specified by:
setDescriptionin interfaceBuildTypeTemplate- Parameters:
description- template description
-
getInternalId
@NotNull public String getInternalId()
Description copied from interface:BuildTypeIdentityReturns the internal identifier.- Specified by:
getInternalIdin interfaceBuildTypeIdentity- Returns:
- the internal identifier.
-
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
-
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.
-
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)
-
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()
-
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()
-
persist
public void persist()
Description 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
-
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
-
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
-
getUsagesAsEnforcedSettings
public Collection<SProject> getUsagesAsEnforcedSettings()
- Specified by:
getUsagesAsEnforcedSettingsin interfaceBuildTypeTemplateEx- Returns:
- a collection of projects that use the template to represent their enforced settings
-
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
-
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
-
createEditableCopy
public BuildTypeTemplateEx createEditableCopy(boolean fillSettings)
- Specified by:
createEditableCopyin interfaceBuildTypeTemplateEx
-
moveToProject
public void moveToProject(@NotNull SProject target)Description 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
-
moveToProject
public void moveToProject(@NotNull ConfigAction cause, @NotNull SProject target) throws InvalidVcsRootScopeException, TemplateBecomesInaccessibleExceptionDescription 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 projectTemplateBecomesInaccessibleException- if template is used by configurations and won't be available for them if it is moved to target project
-
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
-
getOwnRunnerTypes
@NotNull public Collection<String> getOwnRunnerTypes()
- Specified by:
getOwnRunnerTypesin interfaceBuildTypeOwnSettings
-
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
-
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.
-
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
-
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
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.
-
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.
-
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
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
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
-
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 interfaceBuildTypeSettingsEx- 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 interfaceBuildTypeSettingsEx- Specified by:
setVcsRootsin interfaceBuildTypeTemplateEx- Returns:
- true if any changes occured
-
setSecureDataStorage
public void setSecureDataStorage(@NotNull SecureDataStorage secureDataStorage)Description copied from interface:BuildTypeSettingsExSets secure data storage to be used by these settings when they are persisted on disk.- Specified by:
setSecureDataStoragein interfaceBuildTypeSettingsEx- Parameters:
secureDataStorage- secure data storage
-
getSecureDataStorage
@NotNull public SecureDataStorage getSecureDataStorage()
- Specified by:
getSecureDataStoragein interfaceBuildTypeSettingsEx- Returns:
- secure data storage used by these settings
-
getDependencyOptions
@Nullable public DependencyOptions getDependencyOptions(@NotNull SBuildType buildType)
- Specified by:
getDependencyOptionsin interfaceBuildTypeSettingsEx- Parameters:
buildType- build type- Returns:
- dependency options instance if current settings instance has snapshot dependency on specified build type or null
-
getBuildTypeBranchFilter
@NotNull public BranchFilter getBuildTypeBranchFilter(@NotNull ValueResolver valueResolver)
- Specified by:
getBuildTypeBranchFilterin interfaceBuildTypeSettingsEx- Parameters:
valueResolver- value resolver- Returns:
- branch filter which is used to filter branches available in this build type
-
getBuildTypeBranchFilterUnsafe
public BranchFilter getBuildTypeBranchFilterUnsafe(@NotNull ValueResolver valueResolver) throws InvalidBranchSpecException
Description copied from interface:BuildTypeSettingsExSame asBuildTypeSettingsEx.getBuildTypeBranchFilter(ValueResolver)but throws an exception if the filter is incorrect- Specified by:
getBuildTypeBranchFilterUnsafein interfaceBuildTypeSettingsEx- Throws:
InvalidBranchSpecException
-
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
-
vcsRootsAccessibleInProject
public boolean vcsRootsAccessibleInProject(@NotNull SProject project)- Specified by:
vcsRootsAccessibleInProjectin interfaceBuildTypeSettingsEx
-
createReadOnlySettings
@NotNull public ReadOnlyBuildTypeSettings createReadOnlySettings()
- Specified by:
createReadOnlySettingsin interfaceBuildTypeSettingsEx
-
createCopy
@NotNull public BuildTypeSettingsEx createCopy()
- Specified by:
createCopyin interfaceBuildTypeSettingsEx
-
replaceDependency
public void replaceDependency(@NotNull Dependency origDep, @NotNull Dependency newDep)Description copied from interface:BuildTypeSettingsExReplaces original dependency object with another one- Specified by:
replaceDependencyin interfaceBuildTypeSettingsEx
-
replaceDependency
public void replaceDependency(@NotNull SArtifactDependency origDep, @NotNull SArtifactDependency newDep)Description copied from interface:BuildTypeSettingsExReplaces original dependency object with another one- Specified by:
replaceDependencyin interfaceBuildTypeSettingsEx
-
getOptions
@NotNull public Collection<Option> getOptions()
- Specified by:
getOptionsin interfaceOptionSupport- Returns:
- combined set of options - own and inherited
-
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
-
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
-
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
-
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
-
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
-
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
-
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
-
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
-
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).
-
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 interfaceBuildTypeOwnSettings- Specified by:
isTemplateBasedin interfaceBuildTypeSettings- Returns:
- see above
-
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
public String getTemplateId()
Description copied from interface:BuildTypeSettingsReturns internal id of the first template this setting is based on- Specified by:
getTemplateIdin interfaceBuildTypeSettings- Returns:
- see above
-
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
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 name, @NotNull String type, @NotNull Map<String,String> params)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 descriptorname- new runner nametype- new type of the runnerparams- 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
-
removeAllBuildRunners
public void removeAllBuildRunners()
Description copied from interface:BuildTypeSettingsRemoves all build runners from these settings- Specified by:
removeAllBuildRunnersin interfaceBuildTypeSettings
-
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
-
findBuildRunnerByType
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
-
findBuildRunnerById
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
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
-
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 propertyName)
Description copied from interface:BuildTypeSettingsRemoves first requirement with the specified property name from the configuration.- Specified by:
removeRequirementin interfaceBuildTypeSettings- Parameters:
propertyName- 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
-
setParametersSupport
public void setParametersSupport(@NotNull ParametersSupport paramsSupport)- Specified by:
setParametersSupportin interfaceBuildTypeSettingsEx
-
copySettings
public void copySettings(@NotNull BuildTypeSettingsEx source, @NotNull BuildTypeCopySettings copyOptions)Description copied from interface:BuildTypeSettingsExCopies settings, parameters, options etc. from another instance of build type settings.- Specified by:
copySettingsin interfaceBuildTypeSettingsEx- Parameters:
source- source settingscopyOptions- copy options; if empty, the method regenerates setting ids for the settings that clash by ids with the inherited ones in the destination, and copies disabled and inherited settings from the source- See Also:
BuildTypeSettingsCopyOptions
-
copyAllSettings
public void copyAllSettings(@NotNull BuildTypeSettingsEx source)Description copied from interface:BuildTypeSettingsExCopies all settings, the behaviour is the same as copySettings with empty copyOptions, i.e. it regenerates setting ids for the settings that clash by ids with the inherited ones in the destination, and copies disabled and inherited settings from the source.- Specified by:
copyAllSettingsin interfaceBuildTypeSettingsEx
-
copyOwnSettings
public void copyOwnSettings(@NotNull BuildTypeSettingsEx settings)- Specified by:
copyOwnSettingsin interfaceBuildTypeSettingsEx
-
copyOverridableSettings
public void copyOverridableSettings(@NotNull BuildTypeSettingsEx settingsSource)- Specified by:
copyOverridableSettingsin interfaceBuildTypeSettingsEx
-
addListener
public void addListener(@NotNull BuildTypeSettingsListener listener)- Specified by:
addListenerin interfaceBuildTypeSettingsEx
-
addListener
public void addListener(@NotNull BuildTypeSettingsListener listener, boolean delayPropagation)Description copied from interface:BuildTypeSettingsExAdds listener to the build type settings and all settings of the attached templates- Specified by:
addListenerin interfaceBuildTypeSettingsEx- Parameters:
listener- ListenerdelayPropagation- If true, attaching of the listener to a template is delayed until attachedToModel is called
-
removeListener
public void removeListener(@NotNull BuildTypeSettingsListener listener)- Specified by:
removeListenerin interfaceBuildTypeSettingsEx
-
getTemplate
public BuildTypeTemplateEx getTemplate()
Description copied from interface:BuildTypeSettingsReturns the first template these settings are based on.- Specified by:
getTemplatein interfaceBuildTypeSettings- Specified by:
getTemplatein interfaceBuildTypeSettingsEx- Returns:
- see above
-
getTemplates
@NotNull public List<BuildTypeTemplateEx> getTemplates()
Description copied from interface:BuildTypeSettingsReturns templates these settings are based on, including the default template.- Specified by:
getTemplatesin interfaceBuildTypeSettings- Specified by:
getTemplatesin interfaceBuildTypeSettingsEx- Returns:
- see above
-
getOwnTemplates
@NotNull public List<BuildTypeTemplateEx> getOwnTemplates()
- Specified by:
getOwnTemplatesin interfaceBuildTypeOwnSettings
-
createParametersProvider
public ParametersProvider createParametersProvider(@NotNull SBuild build)
- Specified by:
createParametersProviderin interfaceBuildTypeSettingsEx
-
applyRunnersOrder
public void applyRunnersOrder(@NotNull String[] ids, boolean alwaysSetCustom)Description copied from interface:BuildTypeSettingsExApply custom order of build steps- Specified by:
applyRunnersOrderin interfaceBuildTypeSettingsEx- Parameters:
ids- the order defined by build step idsalwaysSetCustom- if true, the build configuration stores the new order as a custom order even if there are no templates attached
-
attachedToModel
public void attachedToModel(@NotNull ProjectDataModel model)- Specified by:
attachedToModelin interfaceBuildTypeSettingsEx
-
dispose
public void dispose()
- Specified by:
disposein interfaceBuildTypeSettingsEx- Specified by:
disposein interfaceBuildTypeTemplateEx
-
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.
-
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
-
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
-
getOwnDependencies
@NotNull public List<Dependency> getOwnDependencies()
- Specified by:
getOwnDependenciesin interfaceBuildTypeOwnSettings
-
getOwnVcsRootEntries
@NotNull public List<VcsRootEntry> getOwnVcsRootEntries()
- Specified by:
getOwnVcsRootEntriesin interfaceBuildTypeOwnSettings
-
addRunParameter
public void addRunParameter(@NotNull SBuildRunnerDescriptor runner, @NotNull Parameter parameter)- Specified by:
addRunParameterin interfaceBuildTypeSettingsEx
-
getOwnDisabledParameterDescriptorIds
@NotNull public Collection<String> getOwnDisabledParameterDescriptorIds()
- Specified by:
getOwnDisabledParameterDescriptorIdsin interfaceBuildTypeOwnSettings
-
getDisabledParameterDescriptorIds
@NotNull public Collection<String> getDisabledParameterDescriptorIds()
- Specified by:
getDisabledParameterDescriptorIdsin interfaceBuildTypeSettingsEx
-
getBuildSettings
@NotNull public BuildSettings getBuildSettings()
- Specified by:
getBuildSettingsin interfaceBuildTypeSettingsEx- Specified by:
getBuildSettingsin interfaceBuildTypeTemplateEx
-
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
-
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
-
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 List<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
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 id, 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:
id- id of build runner, trigger or build featureenabled- true to enable, false to disable
-
isEnabled
public boolean isEnabled(@NotNull String id)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:
id- id of build runner, trigger or build feature
-
isDeployment
public boolean isDeployment()
- Specified by:
isDeploymentin interfaceBuildTypeSettings- Returns:
- true if this build configuration is doing deployment
-
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
-
setExternalId
public void setExternalId(@NotNull String externalId) 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:
externalId- 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
-
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
-
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
-
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
-
getParentProject
@NotNull public ProjectEx 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
-
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
-
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
-
getLastConfigModificationAction
public AuditLogAction getLastConfigModificationAction()
- Specified by:
getLastConfigModificationActionin interfaceBuildTypeTemplateEx
-
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
-
getVcsRootInstanceEntries
@NotNull public List<VcsRootInstanceEntry> getVcsRootInstanceEntries()
- Specified by:
getVcsRootInstanceEntriesin interfaceBuildTypeTemplateEx
-
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
-
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
-
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
-
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
-
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
-
getInheritedCleanupOptions
@NotNull public Map<String,Boolean> getInheritedCleanupOptions()
- Specified by:
getInheritedCleanupOptionsin 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
-
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
-
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
-
compareTo
public int compareTo(BuildTypeTemplate o)
- Specified by:
compareToin interfaceComparable<BuildTypeTemplate>
-
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
-
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
-
getTemplateExternalId
@Nullable @Deprecated public String getTemplateExternalId()
Deprecated.- Specified by:
getTemplateExternalIdin interfaceBuildTypeSettingsEx
-
setTemplatesOrder
public void setTemplatesOrder(@NotNull List<String> templateIds)Description copied from interface:BuildTypeSettingsExImposes new order on the associated templates. Unlike#setTemplatIdsthis method cannot add or remove templates.- Specified by:
setTemplatesOrderin interfaceBuildTypeSettingsEx- Parameters:
templateIds- the existing template ids in the new order
-
setTemplateIds
public void setTemplateIds(@NotNull List<String> templateIds)Description copied from interface:BuildTypeSettingsExChange which templates these settings are attached to. No copying of settings or cleaning of duplicates occurs in process- Specified by:
setTemplateIdsin interfaceBuildTypeSettingsEx
-
getOwnTemplateExternalIds
@NotNull public List<String> getOwnTemplateExternalIds()
- Specified by:
getOwnTemplateExternalIdsin interfaceBuildTypeOwnSettings
-
getOwnTemplateIds
@NotNull public List<String> getOwnTemplateIds()
- Specified by:
getOwnTemplateIdsin interfaceBuildTypeOwnSettings
-
getOwnOptionSupport
@NotNull public OptionSupportEx getOwnOptionSupport()
- Specified by:
getOwnOptionSupportin interfaceBuildTypeOwnSettings
-
getOwnSerializableParameters
@NotNull public SerializableParametersCollection getOwnSerializableParameters()
- Specified by:
getOwnSerializableParametersin interfaceBuildTypeOwnSettings
-
getOwnBuildRunners
@NotNull public List<SBuildRunnerDescriptor> getOwnBuildRunners()
- Specified by:
getOwnBuildRunnersin interfaceBuildTypeOwnSettings
-
getRunnersOrder
@Nullable public String[] getRunnersOrder()
- Specified by:
getRunnersOrderin interfaceBuildTypeSettings- Returns:
- runner ids in their custom order (if such order is set), null otherwise
-
getOwnBuildFeatures
@NotNull public List<SBuildFeatureDescriptor> getOwnBuildFeatures()
- Specified by:
getOwnBuildFeaturesin interfaceBuildTypeOwnSettings
-
getOwnRequirements
@NotNull public List<Requirement> getOwnRequirements()
- Specified by:
getOwnRequirementsin interfaceBuildTypeOwnSettings
-
getOwnBuildTriggers
@NotNull public List<BuildTriggerDescriptor> getOwnBuildTriggers()
- Specified by:
getOwnBuildTriggersin interfaceBuildTypeOwnSettings
-
getOwnArtifactDependencies
@NotNull public List<SArtifactDependency> getOwnArtifactDependencies()
- Specified by:
getOwnArtifactDependenciesin interfaceBuildTypeOwnSettings
-
getOwnCleanupSupport
@NotNull public CleanupSettingsSupport getOwnCleanupSupport()
- Specified by:
getOwnCleanupSupportin interfaceBuildTypeOwnSettings
-
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
-
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
-
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
-
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 interfaceBuildTypeSettingsEx- 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
-
getParametersSupport
@NotNull public ContainerWithInherited<String,Parameter> getParametersSupport()
- Specified by:
getParametersSupportin interfaceParameterSupport
-
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
-
getRunnerConditions
@NotNull public BuildStepConditions getRunnerConditions(@NotNull SBuildRunnerDescriptor descriptor)
- Specified by:
getRunnerConditionsin interfaceBuildTypeSettings- Returns:
- support for conditions for conditional build steps
-
-