Introduction
Using JRuby
API error messages
API command line access
Using DSL
IntroductionGetting started with DSLGenerating DSL scriptsDSL automation as codeDSL editorsTroubleshooting and FAQs
DSL method reference
Using the RESTful API
Using the Perl API
Perl API reference
IntroductionAccess tokensACL managementApplication dependencyApplicationsApplication tier Artifact managementCatalogsChange historyCI build detailCI configurationCI jobsComponentsCredential managementCustom filtersDatabase configurationData retentionCloudBees AnalyticsDirectory provider managementDynamic environmentsEmail configuration managementEmail notifier managementEnvironmentEnvironment tierGateway and zone managementInstalling or upgrading remote agentsJob managementMicroservicesObject tagsParameter managementPersonasPipelines and releasesPlugin managementPlugin configuration managementProcedure managementProcessProcess dependencyProcess stepProject managementProperty managementResource managementRolling deploySchedule managementService accounts for webhooksServer managementSingle sign on for SAMLSnapshotsTier mapTrigger managementUser and group managementUser profile email managementWait dependenciesWorkflow definition managementWorkflow managementWork itemsWorkspace managementMiscellaneous management
Perl API response and element glossary
Using the Groovy API
IntroductionExamplesTroubleshooting
Groovy API reference
IntroductionaccesstokenaclaclentryactualparameteractualparametersapplicationapplicationdependencyapplicationtierarchiveconnectorartifactartifactversioncatalogcatalogitemcatalogitemruncibuildcibuilddetailciconfigurationcieventclustercomponentcredentialcredentialproviderdashboarddashboardcolumndataretentionpolicydeployerapplicationdeployerconfigurationdeploymenthistoryitemdevopsinsightdatasourcedirectoryprovideremailconfigemailnotifierentitychangeenvironmentenvironmentinventoryitemenvironmenttemplateenvironmenttemplatetierenvironmenttemplatetiermapenvironmenttemplatetiermappingenvironmenttierenvtempltierresourcetemplmappingeventsubscriptionflowruntimeformaloutputparameterformalparametergategatewaygrouphookjobjobstepkerberoskeytablicensemicroservicemicroservicemappingnoteobjectopenidconnectconfigurationoutputparameterpersonapersonacategorypersonapagepipelinepluginplugincatalogpluginconfigurationprocedureprocedurestepprocessprocessdependencyprocessstepprojectpropertyreleasereportreportingfilterreportobjectassociationreportobjectattributereportobjecttyperepositoryreservationresourceresourcepoolresourcetemplateresourceusageretrievedartifactsrollingdeployphaserundiscoverysamlidentityprovidersamlserviceproviderschedulescmsyncsearchfilterserverserversettingserversettingcategoryserviceaccountsessionsnapshotstagestatestatedefinitiontagtasktiermaptiermappingtransitiontransitiondefinitiontriggertriggererrordetailuseruseremailutilityresourcewaitdependencywebhookresultwidgetwidgetfilteroverrideworkflowworkflowdefinitionworkitemworkspacezoneArgument models

TransitionDefinition

3 minute readReference

createTransitionDefinition

Creates a new transition definition for a workflow definition.

Arguments

Argument Name Type Description

projectName

String

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

workflowDefinitionName

String

The name of the workflow definition. (Required)

stateDefinitionName

String

The name used for the state definition (Required)

transitionDefinitionName

String

The name used for the transition (Required)

actualParameters

ActualParameter array

The actual parameters to the transition’s target state.

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.

targetState

String

Target state for the transition definition.

trigger

String

Specifies the type of trigger for this transaction.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.createTransitionDefinition(
                projectName: 'test-projectName',
                workflowDefinitionName: 'test-workflowDefinitionName',
                stateDefinitionName: 'test-stateDefinitionName',
                transitionDefinitionName: 'test-transitionDefinitionName'
                /* optional arguments */)

deleteTransitionDefinition

Deletes a transition definition.

Arguments

Argument Name Type Description

projectName

String

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

workflowDefinitionName

String

The name of the workflow definition. (Required)

transitionDefinitionName

String

The name used for the transition (Required)

stateDefinitionName

String

The name used for the state definition (Required)

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.deleteTransitionDefinition(
                projectName: 'test-projectName',
                workflowDefinitionName: 'test-workflowDefinitionName',
                transitionDefinitionName: 'test-transitionDefinitionName',
                stateDefinitionName: 'test-stateDefinitionName')

getTransitionDefinition

Find a transition definition by name.

Arguments

Argument Name Type Description

projectName

String

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

workflowDefinitionName

String

The name of the workflow definition. (Required)

transitionDefinitionName

String

The name used for the transition (Required)

stateDefinitionName

String

The name used for the state definition (Required)

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getTransitionDefinition(
                projectName: 'test-projectName',
                workflowDefinitionName: 'test-workflowDefinitionName',
                transitionDefinitionName: 'test-transitionDefinitionName',
                stateDefinitionName: 'test-stateDefinitionName')

getTransitionDefinitions

Retrieve all transition definitions in a workflow definition.

Arguments

Argument Name Type Description

projectName

String

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

workflowDefinitionName

String

The name of the workflow definition. (Required)

stateDefinitionName

String

The name used for the state definition (Required)

targetState

String

Limits results to transition definitions that have the specified state definition as a target.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getTransitionDefinitions(
                projectName: 'test-projectName',
                workflowDefinitionName: 'test-workflowDefinitionName',
                stateDefinitionName: 'test-stateDefinitionName'
                /* optional arguments */)

modifyTransitionDefinition

Modifies an existing transition definition.

Arguments

Argument Name Type Description

projectName

String

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

workflowDefinitionName

String

The name of the workflow definition. (Required)

stateDefinitionName

String

The name used for the state definition (Required)

transitionDefinitionName

String

The name used for the transition (Required)

actualParameters

ActualParameter array

The actual parameters to the transition’s target state.

clearActualParameters

Boolean

True if the transition should remove all actual parameters to the target state.

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.

newName

String

New name for an existing object that is being renamed.

targetState

String

Target state for the transition definition.

trigger

String

Specifies the type of trigger for this transaction.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.modifyTransitionDefinition(
                projectName: 'test-projectName',
                workflowDefinitionName: 'test-workflowDefinitionName',
                stateDefinitionName: 'test-stateDefinitionName',
                transitionDefinitionName: 'test-transitionDefinitionName'
                /* optional arguments */)

moveTransitionDefinition

Move a transition definition within a workflow definition.

Arguments

Argument Name Type Description

projectName

String

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

workflowDefinitionName

String

The name of the workflow definition. (Required)

stateDefinitionName

String

The name used for the state definition (Required)

transitionDefinitionName

String

The name used for the transition (Required)

beforeTransitionDefinition

String

The name of the transition before which 'transitionDefinitionName' should appear. Blank to move the transition to the last position.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.moveTransitionDefinition(
                projectName: 'test-projectName',
                workflowDefinitionName: 'test-workflowDefinitionName',
                stateDefinitionName: 'test-stateDefinitionName',
                transitionDefinitionName: 'test-transitionDefinitionName'
                /* optional arguments */)
transition
trigger