The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.
For a list of other such plugins, see the Pipeline Steps Reference page.
input: Wait for interactive inputThis step pauses Pipeline execution and allows the user to interact and control the flow of the build. Only a basic "process" or "abort" option is provided in the stage view.
You can optionally request information back, hence the name of the step. The parameter entry screen can be accessed via a link at the bottom of the build console log or via link in the sidebar for a build.
message
This parameter gives a prompt which will be shown to a human:
Ready to go?
Proceed or Abort
If you click "Proceed" the build will proceed to the next step, if you click "Abort" the build will be aborted.
Stringid (optional)
Every input step has an unique ID. It is used in the generated URL to proceed or abort.
A specific ID could be used, for example, to mechanically respond to the input from some external process/tool.
Stringok (optional)
Stringparameters (optional)
Request that the submitter specify one or more parameter values when approving. If just one parameter is listed, its value will become the value of the input step. If multiple parameters are listed, the return value will be a map keyed by the parameter names. If parameters are not requested, the step returns nothing if approved.
On the parameter entry screen you are able to enter values for parameters that are defined in this field.
agentParametername
StringdefaultValue (optional)
Stringdescription (optional)
String$class: 'AppDetectorParamaterDefinition'name
StringappName
StringdefaultValue
Stringdescription (optional)
String$class: 'ArtifactRepoParamDefinition'name
StringserverType
StringserverUrl
Define the URL of the repository instance.
Format: protocol://domain.tld:port/path
StringcredentialsId
StringignoreCertificate
When checked the HTTP connection will ignore invalid certificates while trying to connect to the repository instance. This is useful when using an internal service with self-signed certificates.
Use this feature with caution as it can introduce potential security risks.
booleanproxy
When checked it allows to define an HTTP proxy to be used for the outgoing connections.
Please note that when this option is unchecked but a global proxy is defined the connection will make use of the global proxy settings. If both the local and global proxy settings are set the local proxy settings take precedence.proxyProtocol
StringproxyHost
StringproxyPort
StringproxyCredentialsId
StringparamType
Select the type of information to display as a build parameter.
Artifact Path displays the name of deployed artifacts and makes the full path available.StringartifactName
StringrepoName
StringversionRegex
This field allows to define a Java capturing groups to extract version information from the full artifact path. In a nutshell define a regex and define a part of a string as a group by surrounding it with ( ) brackets to define a group. The first outer group found is used to extract the version information. Following is an example for a Maven artifact with the regex .+/(\d+\.\d+(\.\d+((-CANDIDATE)?-SNAPSHOT)?)?)/.+.
| Path | Version |
|---|---|
| http://localhost:8081/maven-releases/org/example/test/1.0/test-1.0.jar | 1.0 |
| http://localhost:8081/maven-releases/org/example/test/1.0.5/test-1.0.5.jar | 1.0.5 |
| http://localhost:8081/maven-releases/org/example/test/1.0.5-CANDIDATE-SNAPSHOT/test-1.0.5-CANDIDATE-SNAPSHOT.jar | 1.0.5-CANDIDATE-SNAPSHOT |
StringrepoType
StringformatType
StringdisplayStyle
StringresultsCount
StringfilterRegex
.+.
StringsortOrder
StringhideTextarea
booleandescription (optional)
String$class: 'AutoCompleteStringParameterDefinition'name
StringdisplayExpression
Display is the text the user will see when inserting tokens. Use this field to control how the text will be shown to the user
If the data provider returns a simple list of strings, each value can be referred by the variable 'value' in javascript expressions
Some examples. Let's assume the data provider resulted in the following json:
[
{"name": "Eddard Stark","id":"estark", "house":"Stark"},
{"name": "John Snow","id":"jsnow", "house":"Stark"},
{"name": "Tyrion Lannister","id":"tlannister", "house":"Lannister"},
...
]
Some valid examples:
StringvalueExpression
Value is the text the job will receive in the parameter. Use this field to control how the text will provided to the job
If the data provider returns a simple list of strings, each value can be referred by the variable 'value' in javascript expressions
Some examples. Let's assume the data provider resulted in the following json:
[
{"name": "Eddard Stark","id":"estark", "house":"Stark"},
{"name": "John Snow","id":"jsnow", "house":"Stark"},
{"name": "Tyrion Lannister","id":"tlannister", "house":"Lannister"},
...
]
Some valid examples:
StringallowUnrecognizedTokens
booleandataProvider
$class: 'GroovyDataProvider'script
Stringsandbox
booleanclasspath
path
String$class: 'InlineJsonDataProvider'autoCompleteData
[
{"name": "Eddard Stark","id":"estark", "house":"Stark"},
{"name": "John Snow","id":"jsnow", "house":"Stark"},
{"name": "Tyrion Lannister","id":"tlannister", "house":"Lannister"},
...
]
String$class: 'RemoteDataProvider'prefetch
booleanautoCompleteUrl
StringcredentialsId
String$class: 'SimpleTextProvider'autoCompleteData
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
booleanbase64FileSimple file parameter compatible with Pipeline. Transmits file contents as an environment variable in Base64 encoding, so it is best used with fairly small files. Example usage from Declarative Pipeline:
pipeline {
agent any
parameters {
base64File 'FILE'
}
stages {
stage('Example') {
steps {
sh 'echo $FILE | base64 -d > config.yaml'
}
}
}
}
name
The name of the parameter. Depending on the type of parameter, this may or may not be bound as an environment variable during the build.
If a local filename was given, an environment variable paramname_FILENAME will also be set. If the build is triggered via the CLI, the variable will not be set.
Stringdescription (optional)
StringbooleanParamname
StringdefaultValue (optional)
booleandescription (optional)
StringbuildMasterReleaseDefines a parameter where users can pick an active release from a BuildMaster application. The following environment variables will be injected into the build job:
When used within pipeline script the applicationId parameter can contain either the id or name of a BuildMaster application.
parameters {
buildMasterRelease applicationId: 'TestApplication', description: '', name: 'BuildMaster Release'
}
name
The name of the parameter.
This value is used for display purposes only - it is not exposed as an environment variable.
StringapplicationId
StringshowApplicationId
Triggering a build from an external source
As the two fields are still presented to Jenkins as a single parameter, a slightly different approach is required to to pass in both the application id and release number from other jobs or via a build api request. This is supported by separating the two values using the pipe character '|'. The applicationId is optional, can contain either an Id or applicaton name, and is only supported if this field is checked.
booleandescription (optional)
StringbuildSelectorDefines a parameter that specifies how a Copy Artifact build step should select which build to copy from. Note that this parameter type is easier to use when starting the build from a browser; to specify a value via direct HTTP POST or the CLI, valid XML must be given.
Be aware that this string value is encoded selector configuration, and not compatible with different plugin versions.
name
StringdefaultSelector
downstreamupstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggered from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downstream build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringlastWithArtifactslastCompleted$class: 'MultiJobBuildSelector'buildParameterparameterName
You can pass not only the parameter name, but also the parameter value itself. This is useful especially used with workflow-plugin.
Stringpermalinkid
String$class: 'PromotedBuildSelector'level
intlatestSavedBuildspecificbuildNumber
StringlastSuccessfulstable (optional)
booleanupstreamallowUpstreamDependencies (optional)
booleanfallbackToLastSuccessful (optional)
booleanupstreamFilterStrategy (optional)
UseGlobalSetting, UseOldest, UseNewestworkspacedescription (optional)
String$class: 'CascadeChoiceParameter'name
StringrandomName
Stringscript
$class: 'GroovyScript'Use a Groovy script to define the parameter.
The Script will be evaluated first, and if it fails (e.g. throws an exception), the Fallback Script will be used as a fallback.
This script integrates with Script Security plugin to allow regular Jenkins users to configure this parameter, while limiting what they can do for security.
If this script is used for any of the HTML choice types of an Active Choices Reactive Reference Parameter, the resulting HTML output will be sanitized to remove everything but basic formatting, like script tags, unless the script runs outside the sandbox. This mode requires approval from a Jenkins administrator to prevent cross-site scripting (HTML) and arbitrary code execution (Groovy).
script
script
Stringsandbox
booleanclasspath
path
StringfallbackScript
script
Stringsandbox
booleanclasspath
path
String$class: 'ScriptlerScript'scriptlerScriptId
Stringparameters
name
Stringvalue
StringchoiceType
StringreferencedParameters
Stringfilterable
booleanfilterLength
intdescription (optional)
StringcheckboxParametername
StringpipelineSubmitContent
Stringdescription (optional)
Stringprotocol (optional)
HTTP_HTTPS, FILE_PATHformat (optional)
YAML, JSON, Emptyuri (optional)
StringdisplayNodePath (optional)
StringvalueNodePath (optional)
StringuseInput (optional)
booleansubmitContent (optional)
String$class: 'ChoiceParameter'name
StringrandomName
Stringscript
$class: 'GroovyScript'Use a Groovy script to define the parameter.
The Script will be evaluated first, and if it fails (e.g. throws an exception), the Fallback Script will be used as a fallback.
This script integrates with Script Security plugin to allow regular Jenkins users to configure this parameter, while limiting what they can do for security.
If this script is used for any of the HTML choice types of an Active Choices Reactive Reference Parameter, the resulting HTML output will be sanitized to remove everything but basic formatting, like script tags, unless the script runs outside the sandbox. This mode requires approval from a Jenkins administrator to prevent cross-site scripting (HTML) and arbitrary code execution (Groovy).
script
script
Stringsandbox
booleanclasspath
path
StringfallbackScript
script
Stringsandbox
booleanclasspath
path
String$class: 'ScriptlerScript'scriptlerScriptId
Stringparameters
name
Stringvalue
StringchoiceType
Stringfilterable
booleanfilterLength
intdescription (optional)
Stringchoicename
Stringdescription (optional)
Stringchoices (optional)
Object$class: 'ClearCaseUcmBaselineParameterDefinition'CLEARCASE_BASELINE environment variable.
pvob
Stringcomponent
StringpromotionLevel
Stringstream
Stringrestrictions
05_impl/0_src which is in the fa4_web component of the fa4 VOB, set the value to /fa/fa4_web/05_impl/0_src.
StringviewName
CLEARCASE_BASELINE, which is replaced with the name of the ClearCase UCM baseline which is selected at build-time;JOB_NAME, which is replaced with the name of the job;USER_NAME, which is replaced with the name of the user running Hudson.CLEARCASE_VIEWNAME;CLEARCASE_VIEWPATH.StringmkviewOptionalParam
cleartool arguments when creating a view using mkview, specify them here.
-snapshot —if applicable— and -tag ${CLEARCASE_VIEWNAME} will be appended before these additional arguments.
mkview command, take a look at the ClearCase 7.0 Information Center.
StringsnapshotView
booleanuseUpdate
booleanforceRmview
booleanexcludeElementCheckedout
element * CHECKEDOUT rule from the config spec.
element * CHECKEDOUT rule is mandatory when using snapshot views.
booleanmoreRecentThan
1 year, 6 months, 1 week, 10 days
Stringuuid
Stringdescription (optional)
String$class: 'CloudSelectorParameter'description (optional)
StringcredentialsFor security reasons, the credential is NOT directly exposed, the ID of the credential is exposed.
However, the selected credential is available through variable substitution in some other parts of the configuration. The string value will be the ID of the credential. A supporting plugin can thus use the ID to retrieve the selected credential and expose it to the build in an appropriate way.name
StringdefaultValue
StringcredentialType
Stringrequired
booleandescription (optional)
String$class: 'CvsTagsParamDefinition'name
StringcvsRoot
StringpasswordRequired
booleanpassword
StringmoduleName
Stringdescription (optional)
String$class: 'DateParameterDefinition'name
StringdateFormat
StringdefaultValue
1. Java LocalDate or LocalDateTime code style
2. LocalDate String (This case should match the format of 'dateFormat')
Stringdescription (optional)
String$class: 'DeployMetaDataParameterDefinition'name
StringenvironmentKey
StringbuildVersion
StringapplicationName
Stringdescription (optional)
String$class: 'DropdownAutocompleteParameterDefinition'name
StringdisplayExpression
Value is the text the job will receive in the parameter. Use this field to control how the text will provided to the job
If the data provider returns a simple list of strings, each value can be referred by the variable 'value' in javascript expressions
Some examples. Let's assume the data provider resulted in the following json:
[
{"name": "Eddard Stark","id":"estark", "house":"Stark"},
{"name": "John Snow","id":"jsnow", "house":"Stark"},
{"name": "Tyrion Lannister","id":"tlannister", "house":"Lannister"},
...
]
Some valid examples:
StringvalueExpression
For data providers that returns JSON arrays, there are display and values. Display is the text the user will see when inserting tokens. Value is the value that will be given to the build.
This field allows you specify one the the json's field names, leave it empty to use the whole json as value or write a javascript expression using the fields between {}'s.
If the dataset returns a simple list of strings, the value of this field is ignored.
Some examples. Let's assume the dataset resulted in the following json:
[
{"name": "Eddard Stark","id":"estark", "house":"Stark"},
{"name": "John Snow","id":"jsnow", "house":"Stark"},
{"name": "Tyrion Lannister","id":"tlannister", "house":"Lannister"},
...
]
Some valid examples:
StringdefaultValue
StringdataProvider
$class: 'GroovyDataProvider'script
Stringsandbox
booleanclasspath
path
String$class: 'InlineJsonDataProvider'autoCompleteData
[
{"name": "Eddard Stark","id":"estark", "house":"Stark"},
{"name": "John Snow","id":"jsnow", "house":"Stark"},
{"name": "Tyrion Lannister","id":"tlannister", "house":"Lannister"},
...
]
String$class: 'RemoteDataProvider'prefetch
booleanautoCompleteUrl
StringcredentialsId
String$class: 'SimpleTextProvider'autoCompleteData
Stringdescription (optional)
String$class: 'DynamicReferenceParameter'name
StringrandomName
Stringscript
$class: 'GroovyScript'Use a Groovy script to define the parameter.
The Script will be evaluated first, and if it fails (e.g. throws an exception), the Fallback Script will be used as a fallback.
This script integrates with Script Security plugin to allow regular Jenkins users to configure this parameter, while limiting what they can do for security.
If this script is used for any of the HTML choice types of an Active Choices Reactive Reference Parameter, the resulting HTML output will be sanitized to remove everything but basic formatting, like script tags, unless the script runs outside the sandbox. This mode requires approval from a Jenkins administrator to prevent cross-site scripting (HTML) and arbitrary code execution (Groovy).
script
script
Stringsandbox
booleanclasspath
path
StringfallbackScript
script
Stringsandbox
booleanclasspath
path
String$class: 'ScriptlerScript'scriptlerScriptId
Stringparameters
name
Stringvalue
StringchoiceType
StringreferencedParameters
StringomitValueField
booleandescription (optional)
StringeditableChoiceDisplay choices but allows inputting any values even not in choices. Works just like suggestion.
To use in pipeline:
editableChoice(
name: 'PARAM1',
choices: ['Apple', 'Grape', 'Orange'],
// belows are optional paramters
defaultValue: 'Grape',
restrict: true,
filterConfig: filterConfig(
prefix: true,
caseInsensitive: true,
),
)
name
Stringchoices (optional)
StringchoicesWithText (optional)
choice1 choice2 choice3
StringdefaultValue (optional)
Stringdescription (optional)
StringfilterConfig (optional)
caseInsensitive (optional)
booleanprefix (optional)
Display values when their prefix matches the input. Otherwise, display values when they contains the input.
Example:
apple
orange
grape
apple
apple
grape
booleanrestrict (optional)
booleanwithDefaultValue (optional)
defaultValue
String$class: 'ExtensibleChoiceParameterDefinition'name
StringchoiceListProvider
$class: 'ArtifactoryChoiceListProvider'artifactId (optional)
Stringclassifier (optional)
StringcredentialsId (optional)
StringfilterExpression (optional)
StringgroupId (optional)
StringinverseFilter (optional)
booleanpackaging (optional)
StringrepositoryId (optional)
StringreverseOrder (optional)
booleanurl (optional)
String$class: 'FilenameChoiceListProvider'baseDirPath
StringincludePattern
StringexcludePattern
StringscanType
File, Directory, FileAndDirectoryreverseOrder
booleanemptyChoiceType
None, AtTop, AtEnd$class: 'GlobalTextareaChoiceListProvider'name
StringdefaultChoice
StringaddEditedValue
booleanwhenToAdd
Triggered, Completed, CompletedStable, CompletedUnstable$class: 'MavenCentralChoiceListProvider'artifactId (optional)
Stringclassifier (optional)
StringfilterExpression (optional)
StringgroupId (optional)
StringinverseFilter (optional)
booleanpackaging (optional)
StringrepositoryId (optional)
StringreverseOrder (optional)
boolean$class: 'MavenMetadataChoiceListProvider'artifactId (optional)
Stringclassifier (optional)
StringcredentialsId (optional)
StringfilterExpression (optional)
StringgroupId (optional)
StringinverseFilter (optional)
booleanpackaging (optional)
StringrepositoryId (optional)
StringreverseOrder (optional)
booleanurl (optional)
String$class: 'Nexus3ChoiceListProvider'artifactId (optional)
Stringclassifier (optional)
StringcredentialsId (optional)
StringfilterExpression (optional)
StringgroupId (optional)
StringinverseFilter (optional)
booleanpackaging (optional)
StringrepositoryId (optional)
StringreverseOrder (optional)
booleanurl (optional)
String$class: 'NexusChoiceListProvider'artifactId (optional)
Stringclassifier (optional)
StringcredentialsId (optional)
StringfilterExpression (optional)
StringgroupId (optional)
StringinverseFilter (optional)
booleanpackaging (optional)
StringrepositoryId (optional)
StringreverseOrder (optional)
booleanurl (optional)
String$class: 'SystemGroovyChoiceListProvider'groovyScript
script
Stringsandbox
booleanclasspath
path
StringdefaultChoice
StringusePredefinedVariables
Enable following pre-defined variables:
boolean$class: 'TextareaChoiceListProvider'choiceListText
StringdefaultChoice
StringaddEditedValue
booleanwhenToAdd
Triggered, Completed, CompletedStable, CompletedUnstableeditable
booleandescription (optional)
StringeditableType (optional)
NoFilter, Filterfilename
Stringdescription (optional)
String$class: 'FileSystemListParameterDefinition'ALL, DIRECTORY, FILE, SYMLINK. The order of the list can be reversed.
name
StringnodeName
Stringpath
StringselectedType
ALL, DIRECTORY, FILE, SYMLINK.
StringformSelectType
StringregexIncludePattern
StringregexExcludePattern
StringsortByLastModified
booleansortReverseOrder
booleandescription (optional)
String$class: 'GeneratorChoiceParameterDefinition'name
Stringchoices
Stringdescription (optional)
String$class: 'GeneratorKeyValueParameterDefinition'name
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
booleangitParameterWhen used, this parameter will present at build-time a choice to select a Git tag (or revision number) which set a parameter for parametrized build.
Be aware that git does not allow us get additional information (like author/commmit date) from a remote URL this plugin will silently clone the project when your workspace is empty. This may take a long time when we have a slow connection and/or the checkout is big.
Often the parameter defined in the "Name" field is used to specify the branch of the git checkout.
name
Stringtype
StringdefaultValue
Stringbranch
StringbranchFilter
StringtagFilter
StringsortMode
NONE, ASCENDING_SMART, DESCENDING_SMART, ASCENDING, DESCENDINGselectedValue
NONE, TOP, DEFAULTuseRepository
StringquickFilterEnabled
booleandescription (optional)
StringlistSize (optional)
String$class: 'GithubBranchParameterDefinition'name
StringgithubRepoUrl
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
boolean$class: 'GlobalVariableStringParameterDefinition'name
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
booleanimageTagname
Stringimage
Stringfilter
Stringregistry
StringcredentialId
Stringdescription (optional)
StringdefaultTag (optional)
StringtagOrder (optional)
NATURAL, REV_NATURAL, DSC_VERSION, ASC_VERSION$class: 'InheritableStringParameterDefinition'name
StringinheritanceMode
The mode that you select here will influence the final value of the parameter, when you build the child:
StringmustHaveDefaultValue
booleanmustBeAssigned
booleanwhitespaceMode
Do note that, if trimming is selected, this has an effect on both the default value used for automatically started builds, as well as user-initiated builds where the user had a chance to alter the parameter value.
StringisHidden
booleandefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
boolean$class: 'InheritableStringParameterReferenceDefinition'name
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
boolean$class: 'JFrogPipelinesParameter'name
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
boolean$class: 'JavaParameterDefinition'name
StringdefaultJDK
StringallowedJDKs
Stringdescription (optional)
String$class: 'JiraIssueParameterDefinition'name
StringjiraIssueFilter
Stringdescription (optional)
StringaltSummaryFields (optional)
Optionally, specify a comma-delimited list of fields to use instead of the issue summary as the title in the dropdown. Fields will be concatenated with spaces.
Example:
Field1,Field2String$class: 'JiraVersionParameterDefinition'name
StringjiraProjectKey
Specify the project key. A project key is the all capitals part before the issue number in Jira.
(EXAMPLE-100)
StringjiraReleasePattern
Specify a regular expression which release names have to match to be listed. Leave this blank to match all issues.
Example:
v[0-9]+([.][0-9]+)+ will match v1.0.1, v123, v12.0.1StringjiraShowReleased
StringjiraShowArchived
Stringdescription (optional)
String$class: 'LabelParameterDefinition'name
StringdefaultValue
StringallNodesMatchingLabel
booleannodeEligibility
$class: 'AllNodeEligibility'$class: 'IgnoreOfflineNodeEligibility'$class: 'IgnoreTempOfflineNodeEligibility'triggerIfResult
Stringdescription (optional)
StringlistGitBranchesWhen used, this parameter will display a field at build-time so that user is able to select a git branch or tag as a parameter for parametrized build..
Note that this plugin is specifically designed for pipeline jobs that do not configure SCM but still want to see remote repository branches or tags before build begins.
The plugin is highly motivated by Git Parameter Plugin.
But unlike Git Parameter Plugin, this plugin will not change working space at all at build-time
name
StringremoteURL
StringcredentialsId
StringdefaultValue
StringsortMode
NONE, ASCENDING_SMART, DESCENDING_SMART, ASCENDING, DESCENDINGselectedValue
NONE, TOP, DEFAULTquickFilterEnabled
booleantype
StringtagFilter
StringbranchFilter
Stringdescription (optional)
String$class: 'ListSubversionTagsParameterDefinition'Once the two fields Name and Repository URL are set, you must
SVN_TAG and Repository URL is set to https://svn.jenkins-ci.org/tags, then Subversion's Repository URL must be set to https://svn.jenkins-ci.org/tags/$SVN_TAG.
Notice that you can set the Repository URL field to a Subversion repository root rather than just pointing to a tags dir (ie, you can set it to https://svn.jenkins-ci.org rather than https://svn.jenkins-ci.org/tags). In that case, if this repository root contains the trunk, branches and tags folders, then the dropdown will allow the user to pick the trunk, or a branch, or a tag.
name
StringtagsDir
You can also specify the root of a Subversion repository: If this root contains the trunk, branches and tags folders, then the dropdown will display trunk, all the branches and all the tags. If the root does not contain these three folders, then all its subfolders are listed in the dropdown.
When you enter the URL, Jenkins automatically checks if it can connect to it. If access requires authentication, you'll be prompted for the necessary credential. If you already have a working credential but would like to change it for some other reasons, you can manage credentials and specify a different credential.
StringcredentialsId
StringtagsFilter
StringdefaultValue
StringmaxTags
StringreverseByDate
If this option is checked, the Sort Z to A one won't be taken into account.
booleanreverseByName
Notice that if Sort newest first is checked, this option won't be taken into account.
booleandescription (optional)
String$class: 'MatrixCombinationsParameterDefinition'name
StringdefaultCombinationFilter
A Groovy expression to specify which combinations are checked by default. They are also combinations which is built in a scheduled build. If not specified, the combination filter of this multi-configuration project is used. Also see help of the combination filter.
Note that you cannot enable combinations which disabled by the combination filter of the project.
StringshortcutList
$class: 'All'$class: 'CombinationFilterShortcut'name
StringcombinationFilter
String$class: 'None'$class: 'PreviousShortcut'$class: 'ResultShortcut'name
Stringexact
booleanresultsToCheck
Stringdescription (optional)
String$class: 'MavenMetadataParameterDefinition'name
StringrepoBaseUrl
StringgroupId
StringartifactId
Stringpackaging
Stringclassifier
StringversionFilter
StringsortOrder
StringdefaultValue
StringmaxVersions
StringcurrentArtifactInfoUrl
StringcurrentArtifactInfoLabel
StringcurrentArtifactInfoPattern
StringcredentialsId
Stringdescription (optional)
Stringmultiselectname
StringdecisionTree
class de.westemeyer.plugins.multiselect.MultiselectDecisionTreeformat
CSVdescription (optional)
String$class: 'NetstormTestParameterDefinition'name
Stringkeyword
Stringdescription (optional)
String$class: 'NodeParameterDefinition'name
StringdefaultSlaves
StringallowedSlaves
StringtriggerIfResult
StringnodeEligibility
$class: 'AllNodeEligibility'$class: 'IgnoreOfflineNodeEligibility'$class: 'IgnoreTempOfflineNodeEligibility'description (optional)
StringontrackChoiceParamGets a list of parameter value to choose from, using the execution of a Ontrack DSL script.
The script is expected to return a list of objects (a single object will be converted into a singleton list) and the parameter value of each item will be extracted from this object using the property defined in the Value property field.
name
Stringdsl
Stringsandbox
booleanvalueProperty
StringinjectProperties
Stringdescription (optional)
StringontrackMultiChoiceParamGets a list of parameter value to choose from, using the execution of a Ontrack DSL script.
The script is expected to return a list of objects (a single object will be converted into a singleton list) and the parameter value of each item will be extracted from this object using the property defined in the Value property field.
name
Stringdsl
Stringsandbox
booleanvalueProperty
StringinjectProperties
Stringdescription (optional)
StringontrackSingleParamGets a parameter value from the execution of a Ontrack DSL script.
The script is expected to return a single object and the value of the parameter will be extracted from this object using the property defined in the Value property field.
name
Stringdsl
Stringsandbox
booleanvalueProperty
StringinjectProperties
Stringdescription (optional)
String$class: 'PackageChoiceParameterDefinition'name
StringbaseUrl
username[:password]@ between the scheme and the hostname.
StringcredentialsId
/$username/keys/$fingerprint.
StringrequestTimeout
longserviceTimeout
longmultiselect
booleanexcludeNotInstalled
booleanexcludeModified
booleanvisibleItemCount
longquery
StringpackageIdFilter
Stringvalue
Stringdescription (optional)
String$class: 'PackageParameterDefinition'name
Stringrep
Stringpkg
Stringdescription (optional)
Stringseparatorname
StringseparatorStyle
StringsectionHeader
StringsectionHeaderStyle
Stringdescription (optional)
String$class: 'PatchParameterDefinition'description (optional)
StringpersistentBooleanname
StringdefaultValue
booleansuccessfulOnly
booleandescription (optional)
StringpersistentChoicename
Stringdescription (optional)
Stringchoices (optional)
ObjectsuccessfulOnly (optional)
boolean$class: 'PersistentPackageParameterDefinition'name
StringuseAwsKeys
If you need to access the repository outside of the repository, you will need grant access to the S3 bucket.
When accessing it from within AWS, it's probable that the server itself provides the necessary access rights.
When accessing it from outside, you need to provide a key pair. These are set up in the AWS admin console. If you don't have access, please ask operations to create a new key pair with access to the specified bucket.
booleanawsAccessKeyId
This is the AWS secret key setup in the AWS console. It will resemble the form: ‘AAAAAAAAAA2AAA2AAAAA’
If you don't have access to the AWS console, and you need an access key pair, please contact someone in operations.
StringawsSecretAccessKey
This is the AWS secret key setup in the AWS console. It will resemble the form: ‘XxXXXxx/1ZZz1zZZZ11zzZ1zz/YyYyYyyYyyyyYY’
If you don't have access to the AWS console, and you need an access key pair, please contact someone in operations.
StringbucketName
This should be set to a valid bucket name that you can access using the key value pair, or if within AWS, that the server has access to.
Ensure that the bucket specified contains the repo. It might sound obvious, but I just wanted to point that out.
StringrepoPath
This is the path to the actual repo containing the artifacts, relative to the AWS S3 bucket.
For example, given the S3 bucket ‘vhols-common-test-yumrepo’, the path to the locations-public-api repo is repos/locations-public-api
StringrepositoryType
Stringdescription (optional)
StringpersistentStringname
StringdefaultValue
StringsuccessfulOnly
booleantrim
booleandescription (optional)
StringpersistentTextname
StringdefaultValue
StringsuccessfulOnly
booleandescription (optional)
String$class: 'PersistentYumParameterDefinition'name
StringuseAwsKeys
If you need to access the repository outside of the repository, you will need grant access to the S3 bucket.
When accessing it from within AWS, it's probable that the server itself provides the necessary access rights.
When accessing it from outside, you need to provide a key pair. These are set up in the AWS admin console. If you don't have access, please ask operations to create a new key pair with access to the specified bucket.
booleanawsAccessKeyId
This is the AWS secret key setup in the AWS console. It will resemble the form: ‘AAAAAAAAAA2AAA2AAAAA’
If you don't have access to the AWS console, and you need an access key pair, please contact someone in operations.
StringawsSecretAccessKey
This is the AWS secret key setup in the AWS console. It will resemble the form: ‘XxXXXxx/1ZZz1zZZZ11zzZ1zz/YyYyYyyYyyyyYY’
If you don't have access to the AWS console, and you need an access key pair, please contact someone in operations.
StringbucketName
This should be set to a valid bucket name that you can access using the key value pair, or if within AWS, that the server has access to.
Ensure that the bucket specified contains the repo. It might sound obvious, but I just wanted to point that out.
StringrepoPath
This is the path to the actual repo containing the artifacts, relative to the AWS S3 bucket.
For example, given the S3 bucket ‘vhols-common-test-yumrepo’, the path to the locations-public-api repo is repos/locations-public-api
Stringdescription (optional)
String$class: 'PromotedBuildParameterDefinition'name
StringjobName
Stringprocess
Stringdescription (optional)
String$class: 'PromotionLevelParameter'name
StringdefaultLevel
intdescription (optional)
String$class: 'RandomStringParameterDefinition'name
StringfailedValidationMessage
Stringdescription (optional)
StringRESTListname
StringrestEndpoint
StringcredentialId
StringmimeType
APPLICATION_JSON, APPLICATION_XMLvalueExpression
Stringdescription (optional)
StringdisplayExpression (optional)
StringcacheTime (optional)
intdefaultValue (optional)
Stringfilter (optional)
StringvalueOrder (optional)
NONE, ASC, DSC$class: 'ReviewboardParameterDefinition'defaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
boolean$class: 'RunFilterParameter'name
StringdefaultFilter
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotorrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsavedorrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotorrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotorrunFilterList
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsavedorrunFilterList
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsaveddescription (optional)
Stringrunname
StringprojectName
Stringfilter
ALL, STABLE, SUCCESSFUL, COMPLETEDdescription (optional)
String$class: 'RunSelectorParameter'Defines a parameter that specifies how a Copy Artifact build step should select which build to copy from. Note that this parameter type is easier to use when starting the build from a browser; to specify a value via direct HTTP POST or the CLI, valid XML must be given.
Be aware that this string value is encoded selector configuration, and not compatible with different plugin versions.
name
StringdefaultSelector
buildNumberbuildNumber
StringfallbackentryList
runSelector
buildNumberbuildNumber
StringfallbackparameterizedparameterName
You can pass not only the parameter name, but also the parameter value itself. This is useful especially used with workflow-plugin.
Stringpermalinkid
StringstatusbuildStatus
STABLE, SUCCESSFUL, UNSTABLE, FAILED, COMPLETED, ANYtriggeringallowUpstreamDependencies (optional)
booleanupstreamFilterStrategy (optional)
UseGlobalSetting, UseOldest, UseNewestrunFilter
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotorrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsavedorrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotorrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotorrunFilterList
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsavedorrunFilterList
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
StringnotrunFilter
andrunFilterList
anddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsaveddisplayNamerunDisplayName
String$class: 'DownstreamRunFilter'upstreamProjectName
Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.
Downstream builds are found using fingerprints of files. That is, a build that is triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.
Note: "Downsteram build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).
StringupstreamBuildNumber
Stringnotorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedorparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
Stringsavedparameterizedparameter
PARAM, specify ${PARAM} here.
StringparametersparamsToMatch
Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.
StringsavedparameterizedparameterName
You can pass not only the parameter name, but also the parameter value itself. This is useful especially used with workflow-plugin.
Stringpermalinkid
StringstatusbuildStatus
STABLE, SUCCESSFUL, UNSTABLE, FAILED, COMPLETED, ANYtriggeringallowUpstreamDependencies (optional)
booleanupstreamFilterStrategy (optional)
UseGlobalSetting, UseOldest, UseNewestdescription (optional)
String$class: 'SauceParameterDefinition'description (optional)
String$class: 'ScriptSelectionTaskDefinition'name
Stringpath
StringarrayCheckBox
name
StringvariableName
Stringcheck
booleantype
Stringparent
StringtestDelimSymbol
StringnodeDelimSymbol
StringcountDelimiterSymbol
intdelimiter
StringdefaultValue
Stringdescription (optional)
StringsnParamcredentialsForPublishedApp
StringinstanceForPublishedAppUrl
StringcredentialsForInstalledApp
StringinstanceForInstalledAppUrl
StringsysId
application scope is not specified. The system id of the application for which to apply the changes. You can locate this value in the Sys ID field in the Custom Application [sys_app] table.
StringappScope
application system ID is not specified. The scope name of the application for which to apply the changes, such as x_aah_custom_app. You can locate this value in the scope field in the Custom Application [sys_app] table.
StringpublishedAppVersion
StringrollbackAppVersion
StringbatchRollbackId
StringprogressCheckInterval
intdescription (optional)
String$class: 'SpringBootLibrariesListParameterDefinition'springBootVersion
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
boolean$class: 'StashBranchParameterDefinition'name
Stringrepository
StringdefaultValue
Stringdescription (optional)
StringbranchNameRegex (optional)
StringtagNameRegex (optional)
StringstashedFileFile parameter compatible with Pipeline but using the stash system, better suited to large files. The file will be saved to a stash named like the parameter containing one entry, also named like the parameter. Example usage from Declarative Pipeline:
pipeline {
agent any
parameters {
stashedFile 'assets.zip'
}
stages {
stage('Example') {
steps {
unstash 'assets.zip'
sh 'unzip assets.zip'
}
}
}
}
name
The name of the parameter. Depending on the type of parameter, this may or may not be bound as an environment variable during the build.
If a local filename was given, an environment variable paramname_FILENAME will also be set. If the build is triggered via the CLI, the variable will not be set.
Stringdescription (optional)
Stringstringname
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
boolean$class: 'TestExecuter'name
StringpropertiesFilePath
StringenableField
text
StringgroupBy
text
StringfieldSeparator
text
StringshowFields
text
StringmultiplicityField
text
Stringdescription (optional)
Stringtextname
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
booleanuploadPgyerTimeoutParametername
StringdefaultValue (optional)
Stringdescription (optional)
Stringtrim (optional)
boolean$class: 'ToolVersionParameterDefinition'toolName
Stringdescription (optional)
StringuploadPgyerUploadParametername
StringdefaultValue (optional)
booleandescription (optional)
String$class: 'VBoxParameterDefinition'name
StringnodeDelimiter
Stringdescription (optional)
Stringemailname
StringdefaultValue
Stringdomain
StringexternalEmail
booleandescription (optional)
StringvalidatingStringname
These parameters are exposed to build as environment variables.
StringdefaultValue
Stringregex
Standard Java regular expression that will be used to validate the entered string parameter value.
StringfailedValidationMessage
This message is displayed to the user if they enter a value that does not match the configured regular expression.
Stringdescription (optional)
StringvalidatingYamlParametername
StringdefaultValue
StringfailedValidationMessage
This message is displayed to the user if they enter a value that is not a syntactical correct YAML
Stringdescription (optional)
String$class: 'VersionParameterDefinition'name
StringgroupId
StringartifactId
Stringdescription (optional)
StringincludeReleases (optional)
booleanincludeSnapshots (optional)
booleanlimit (optional)
StringoldestFirst (optional)
booleanrepositoryId (optional)
StringuseLatest (optional)
booleanuseRelease (optional)
boolean$class: 'WHideParameterDefinition'name
StringdefaultValue
Stringdescription (optional)
String$class: 'WReadonlyStringParameterDefinition'name
StringdefaultValue
Stringdescription (optional)
String$class: 'WReadonlyTextParameterDefinition'name
StringdefaultValue
Stringdescription (optional)
StringextendedChoicename
Stringtype
Country City
United States San Francisco
United States Chicago
Mexico Mexico City
Mexico Cancun
This would result in a first drop down with the options "Select a country...", "United States", and "Mexico" (the initial selection is "Select a country...", which serves as a label for the drop down). After the user selects a country, a "City" drop down would appear. If United States was chosen first, then San Francisco and Chicago would be options, but if Mexico was selected then instead Mexico City and Cancun would be options. Stringvalue
StringprojectName
StringpropertyFile
prop1=a,b,c,d,eThe properties file can be placed anywhere on the file-system that Jenkins can access.
prop2=${prop1},f,g,h
StringgroovyScript
StringgroovyScriptFile
Stringbindings
StringgroovyClasspath
StringpropertyKey
prop1=a,b,c,d,eThen you could specify the property as either prop1 or prop2.
prop2=1,2,3,4
StringdefaultValue
StringdefaultPropertyFile
StringdefaultGroovyScript
StringdefaultGroovyScriptFile
StringdefaultBindings
StringdefaultGroovyClasspath
StringdefaultPropertyKey
StringdescriptionPropertyValue
StringdescriptionPropertyFile
StringdescriptionGroovyScript
StringdescriptionGroovyScriptFile
StringdescriptionBindings
StringdescriptionGroovyClasspath
StringdescriptionPropertyKey
StringjavascriptFile
Stringjavascript
StringsaveJSONParameterToFile
booleanquoteValue
booleanvisibleItemCount
intmultiSelectDelimiter
Inserts this value between selections when the parameter is a multi-select.
The default when empty is ','
Stringdescription (optional)
String$class: 'com.michelin.cio.hudson.plugins.passwordparam.PasswordParameterDefinition'name
Stringdescription (optional)
String$class: 'com.moded.extendedchoiceparameter.ExtendedChoiceParameterDefinition'name
Stringtype
Country City
United States San Francisco
United States Chicago
Mexico Mexico City
Mexico Cancun
This would result in a first drop down with the options "Select a country...", "United States", and "Mexico" (the initial selection is "Select a country...", which serves as a label for the drop down). After the user selects a country, a "City" drop down would appear. If United States was chosen first, then San Francisco and Chicago would be options, but if Mexico was selected then instead Mexico City and Cancun would be options. Stringvalue
StringpropertyFile
prop1=a,b,c,d,eThe properties file can be placed anywhere on the file-system that Jenkins can access.
prop2=${prop1},f,g,h
StringpropertyKey
prop1=a,b,c,d,eThen you could specify the property as either prop1 or prop2.
prop2=1,2,3,4
StringdefaultValue
StringdefaultPropertyFile
StringdefaultPropertyKey
StringquoteValue
booleanvisibleItemCount
intmultiSelectDelimiter
Inserts this value between selections when the parameter is a multi-select.
The default when empty is ','
StringbindFieldName
StringsvnPath
booleansvnUrl
StringsvnUserName
StringsvnPassword
StringprojectName
StringroleBasedFilter
booleandescription (optional)
Stringpasswordname
StringdefaultValueAsSecret
class hudson.util.Secretdescription (optional)
Stringsubmitter (optional)
StringsubmitterParameter (optional)
parameters value.
StringPlease submit your feedback about this page through this quick form.
Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?
See existing feedback here.