Stage

4 minute readReference

createStage

Creates a new stage in a pipeline for a project.

Arguments

Argument Name Type Description

projectName

String

The name for the project that must be unique among all projects. (Required)

stageName

String

The name of the stage. (Required)

afterStage

String

If specified, the stage will be placed after the named stage.

beforeStage

String

If specified, the stage will be placed before the named stage.

colorCode

String

The hexadecimal value of the color to be used with an entity.

completed

Boolean

Set true to complete and false to incomplete a stage with manual completion type. A stage with auto completion type ignores this argument.

completionType

String

The stage completion type: auto (be default) or manual.

condition

String

A fixed text or text embedding property references that is evaluated into a logical TRUE or FALSE. An empty string, a 0 or false is interpreted as FALSE. Any other result string is interpreted as TRUE.

description

String

Comment text describing this object that is not interpreted at all by CloudBees CD/RO.

duration

String

Duration in minutes for which the stage or task should relative to plannedStartDate.

incompletePostStages

Boolean

If True then in case off specified stage inclompletion all post stages are incompleted too.

parallelToPrevious

Boolean

If TRUE, the flow state will be run in parallel to the previous flow state.

pipelineName

String

The name of the pipeline.

plannedEndDate

String

The date when this stage or task is expected to end.

plannedStartDate

String

The date when this stage or task is expected to start.

precondition

String

A fixed text or text embedding property references that is evaluated into a logical TRUE or FALSE. An empty string, a 0 or false is interpreted as FALSE. Any other result string is interpreted as TRUE.

releaseName

String

The name of the release.

resourceName

String

The name of the default resource for this stage.

timeZone

String

The time zone to use when interpreting times.

waitForPlannedStartDate

Boolean

True to enable waiting for planned start date.

Usage

import com.electriccloud.client.groovy.ElectricFlow import com.electriccloud.client.groovy.models.* ElectricFlow ef = new ElectricFlow() def result = ef.createStage( projectName: 'test-projectName', stageName: 'test-stageName' /* optional arguments */)

deleteStage

Deletes a stage in a project.

Arguments

Argument Name Type Description

projectName

String

The name for the project that must be unique among all projects. (Required)

stageName

String

The name of the stage. (Required)

pipelineName

String

The name of the pipeline.

releaseName

String

The name of the release.

Usage

import com.electriccloud.client.groovy.ElectricFlow import com.electriccloud.client.groovy.models.* ElectricFlow ef = new ElectricFlow() def result = ef.deleteStage( projectName: 'test-projectName', stageName: 'test-stageName' /* optional arguments */)

getStage

Retrieves a stage by its name.

Arguments

Argument Name Type Description

stageName

String

The name of the stage. (Required)

projectName

String

The name for the project that must be unique among all projects. (Required)

pipelineName

String

The name of the pipeline.

releaseName

String

The name of the release.

timeZone

String

The time zone to use when interpreting times.

Usage

import com.electriccloud.client.groovy.ElectricFlow import com.electriccloud.client.groovy.models.* ElectricFlow ef = new ElectricFlow() def result = ef.getStage( stageName: 'test-stageName', projectName: 'test-projectName' /* optional arguments */)

getStages

Retrieves all the stages for a pipeline.

Arguments

Argument Name Type Description

projectName

String

The name for the project that must be unique among all projects. (Required)

pipelineName

String

The name of the pipeline.

releaseName

String

The name of the release.

Usage

import com.electriccloud.client.groovy.ElectricFlow import com.electriccloud.client.groovy.models.* ElectricFlow ef = new ElectricFlow() def result = ef.getStages( projectName: 'test-projectName' /* optional arguments */)

getWaitDependencies

Retrieves all wait dependencies for projectName.

Arguments

Argument Name Type Description

projectName

String

The name for the project that must be unique among all projects. (Required)

pipelineName

String

The name of the pipeline.

stageName

String

The name of the stage.

gateType

String

The type of gate.

releaseName

String

The name of the release.

taskName

String

The name of the task.

Usage

import com.electriccloud.client.groovy.ElectricFlow import com.electriccloud.client.groovy.models.* ElectricFlow ef = new ElectricFlow() def result = ef.getWaitDependencies( projectName: 'test-projectName', /* optional arguments */)

modifyStage

Modifies an existing stage.

Arguments

Argument Name Type Description

projectName

String

The name for the project that must be unique among all projects. (Required)

stageName

String

The name of the stage. (Required)

afterStage

String

If specified, the stage will be placed after the named stage.

beforeStage

String

If specified, the stage will be placed before the named stage.

colorCode

String

The hexadecimal value of the color to be used with an entity.

completed

Boolean

Set true to complete and false to incomplete a stage with manual completion type. A stage with auto completion type ignores this argument.

completionType

String

The stage completion type: auto (be default) or manual.

condition

String

A fixed text or text embedding property references that is evaluated into a logical TRUE or FALSE. An empty string, a 0 or false is interpreted as FALSE. Any other result string is interpreted as TRUE.

description

String

Comment text describing this object that is not interpreted at all by CloudBees CD/RO.

duration

String

Duration in minutes for which the stage or task should relative to plannedStartDate.

incompletePostStages

Boolean

If True then in case off specified stage inclompletion all post stages are incompleted too.

newName

String

The new name for an existing object that is being renamed.

parallelToPrevious

Boolean

If TRUE, the flow state will be run in parallel to the previous flow state.

pipelineName

String

The name of the pipeline.

plannedEndDate

String

The date when this stage or task is expected to end.

plannedStartDate

String

The date when this stage or task is expected to start.

precondition

String

A fixed text or text embedding property references that is evaluated into a logical TRUE or FALSE. An empty string, a 0 or false is interpreted as FALSE. Any other result string is interpreted as TRUE.

releaseName

String

The name of the release.

resourceName

String

The name of the default resource for this stage.

timeZone

String

The time zone to use when interpreting times.

waitForPlannedStartDate

Boolean

True to enable waiting for planned start date.

Usage

import com.electriccloud.client.groovy.ElectricFlow import com.electriccloud.client.groovy.models.* ElectricFlow ef = new ElectricFlow() def result = ef.modifyStage( projectName: 'test-projectName', stageName: 'test-stageName' /* optional arguments */)

removeTaskGroup

Removes a task group, but does not delete the tasks. The location of the ungrouped tasks is the same as the location of the group task.

Arguments

Argument Name Type Description

projectName

String

The name for the project that must be unique among all projects. (Required)

pipelineName

String

The name of the pipeline.

stageName

String

Name of the stage to which this task belongs to.

gateType

String

The type of the gate.

groupName

String

The name of the group task.

releaseName

String

The name of the release.

Usage

import com.electriccloud.client.groovy.ElectricFlow import com.electriccloud.client.groovy.models.* ElectricFlow ef = new ElectricFlow() def result = ef.removeTaskGroup( projectName: 'test-projectName', /* optional arguments */)