ProcessStep

7 minute readReference

createProcessStep

Creates a new process step.

Arguments

Argument Name Type Description

projectName

String

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

processName

String

The name of the process. (Required)

processStepName

String

The name of the process step. (Required)

componentName

String

The name of the component, if the process is owned by a component.

actionLabelText

String

The Json derived action label text.

actualParameters

Actual parameters passed to an invoked subprocedure or process.

afterLastRetry

String

Specifies error handling for the auto retry step.

afterProcessStep

String

If specified, the process step will be placed after the named process step.

allowSkip

Boolean

When enabled, manual process step can be skipped.

alwaysRun

Boolean

True means this step will run even if preceding steps fail in a way that aborts the job.

applicationName

String

The name of the application, if the process is owned by an application.

applicationTierName

String

If references an application tier, the name of the application tier.

assignees

String array

A list of assignees who receive the notification.

beforeProcessStep

String

If specified, the process step will be placed before the named process step.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

componentRollback

Boolean

When enabled, rollback will be performed only for the components that were not deployed successfully.

credentialName

String

The name of the credential object.

dependencyJoinType

String

Join type for incoming dependencies.

description

String

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

disableFailure

Boolean

True means a manual process step cannot be failed.

emailConfigName

String

The name of email configuration.

errorHandling

String

Specifies error handling for this step.

includeCompParameterRef

Boolean

True if the actual parameters should be generated from component properties. Works for artifact components only.

instruction

String

Instruction associated with the manual process step.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

notificationEnabled

Boolean

True means this email notification is enabled, false otherwise.

notificationTemplate

String

Email notification template for process step.

processStepType

String

Defines type of the process step.

retryCount

Integer

If the retry is auto, specify the maximum number of times retry should occur.

retryInterval

Integer

If the retry is auto, specify the interval in seconds after which retry should be attempted.

retryType

String

Type of retry when process step fails. Is one of auto or manual.

rollbackSnapshot

String

Name of Snapshot to be used for rollback.

rollbackType

String

The type of the rollback.

rollbackUndeployProcess

String

Name of the undeploy process to be used during rollback.

skipRollbackIfUndeployFails

Boolean

When enabled, rollback will be performed only for the components that were successfully undeployed.

smartRollback

Boolean

Smart deploy flag to be used during rollback is triggered.

subcomponent

String

If referencing a component process, the name of the component.

subcomponentApplicationName

String

If referencing a component process, the name of the component application (if not project scoped).

subcomponentProcess

String

If referencing a component process, the name of the component process.

submicroservice

String

If referencing a microservice, the name of the microservice.

submicroserviceProcess

String

If referencing a microservice process, the name of the microservice process.

subprocedure

String

If referencing a procedure, the name of the procedure.

subproject

String

If referencing a procedure, the name of the procedure’s project.

timeLimit

String

Maximum amount of time the step can execute; abort if it exceeds this time.

timeLimitUnits

String

Units for step time limit: seconds, minutes, or hours.

useUtilityResource

Boolean

True means that step will run on utility resource instead of a tier.

utilityResourceName

String

Utility resource name.

workingDirectory

String

Working directory in which to execute the command for this step. A relative name is interpreted relative to the root directory for the job’s workspace.

workspaceName

String

The name of the workspace.

Usage

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

deleteProcessStep

Deletes an application or component process step.

Arguments

Argument Name Type Description

projectName

String

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

processName

String

The name of the process. (Required)

processStepName

String

The name of the process step. (Required)

componentName

String

The name of the component, if the process is owned by a component.

applicationName

String

The name of the application, if the process is owned by an application.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

Usage

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

getProcessStep

Retrieves an application or component process step.

Arguments

Argument Name Type Description

projectName

String

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

processName

String

The name of the process. (Required)

processStepName

String

The name of the process step. (Required)

componentName

String

The name of the component, if the process is owned by a component.

applicationEntityRevisionId

String

The revision ID of the versioned object.

applicationName

String

The name of the application, if the process is owned by an application.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

Usage

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

getProcessSteps

Retrieves all the process steps in an application or component process.

Arguments

Argument Name Type Description

projectName

String

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

processName

String

The name of the process. (Required)

componentName

String

The name of the component, if the process is owned by a component.

applicationEntityRevisionId

String

The revision ID of the versioned object.

applicationName

String

The name of the application, if the process is owned by an application.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

Usage

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

modifyProcessStep

Modifies an existing process step.

Arguments

Argument Name Type Description

projectName

String

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

processName

String

The name of the process. (Required)

processStepName

String

The name of the process step. (Required)

componentName

String

The name of the component, if the process is owned by a component.

actionLabelText

String

The Json derived action label text.

actualParameters

Actual parameters passed to an invoked subprocedure or process.

afterLastRetry

String

Specifies error handling for the auto retry step.

afterProcessStep

String

If specified, the process step will be placed after the named process step.

allowSkip

Boolean

When enabled, manual process step can be skipped.

alwaysRun

Boolean

True means this step will run even if preceding steps fail in a way that aborts the job.

applicationName

String

The name of the application, if the process is owned by an application.

applicationTierName

String

If references an application tier, the name of the application tier.

assignees

String array

A list of assignees who receive the notification.

beforeProcessStep

String

If specified, the process step will be placed before the named process step.

clearActualParameters

Boolean

If true, the step should remove all actual parameters.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

componentRollback

Boolean

When enabled, rollback will be performed only for the components that were not deployed successfully.

credentialName

String

The name of the credential object.

dependencyJoinType

String

Join type for incoming dependencies.

description

String

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

disableFailure

Boolean

True means a manual process step cannot be failed.

emailConfigName

String

The name of email configuration.

errorHandling

String

Specifies error handling for this step.

includeCompParameterRef

Boolean

True if the actual parameters should be generated from component properties. Works for artifact components only.

instruction

String

Instruction associated with the manual process step.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

newName

String

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

notificationEnabled

Boolean

True means this email notification is enabled, false otherwise.

notificationTemplate

String

Email notification template for process step.

processStepType

String

Defines type of the process step.

retryCount

Integer

If the retry is auto, specify the maximum number of times retry should occur.

retryInterval

Integer

If the retry is auto, specify the interval in seconds after which retry should be attempted.

retryType

String

Type of retry when process step fails. Is one of auto or manual.

rollbackSnapshot

String

Name of Snapshot to be used for rollback.

rollbackType

String

The type of the rollback.

rollbackUndeployProcess

String

Name of the undeploy process to be used during rollback.

skipRollbackIfUndeployFails

Boolean

When enabled, rollback will be performed only for the components that were successfully undeployed.

smartRollback

Boolean

Smart deploy flag to be used during rollback is triggered.

subcomponent

String

If referencing a component process, the name of the component.

subcomponentApplicationName

String

If referencing a component process, the name of the component application (if not project scoped).

subcomponentProcess

String

If referencing a component process, the name of the component process.

submicroservice

String

If referencing a microservice, the name of the microservice.

submicroserviceProcess

String

If referencing a microservice process, the name of the microservice process.

subprocedure

String

If referencing a procedure, the name of the procedure.

subproject

String

If referencing a procedure, the name of the procedure’s project.

timeLimit

String

Maximum amount of time the step can execute; abort if it exceeds this time.

timeLimitUnits

String

Units for step time limit: seconds, minutes, or hours.

useUtilityResource

Boolean

True means that step will run on utility resource instead of a tier.

utilityResourceName

String

Utility resource name.

workingDirectory

String

Working directory in which to execute the command for this step. A relative name is interpreted relative to the root directory for the job’s workspace.

workspaceName

String

The name of the workspace.

Usage

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