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
IntroductionACL 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 managementProcedure managementProcessProcess dependencyProcess stepProject managementProperty managementResource managementRolling deploySchedule managementServer managementSingle sign-onSnapshotsTier mapUser and group managementWait dependenciesWebhhook managementWorkflow definition managementWorkflow managementWork itemsWorkspace managementMiscellaneous management
Perl API response and element glossary
Using the Groovy API
IntroductionExamplesTroubleshooting
Groovy API reference
IntroductionaccesstokenaclaclentryactualparameteractualparametersapplicationapplicationdependencyapplicationservicemappingapplicationtierarchiveconnectorartifactartifactversioncatalogcatalogitemcatalogitemruncibuildcibuilddetailciconfigurationcieventclustercomponentcontainercredentialcredentialproviderdashboarddashboardcolumndataretentionpolicydeployerapplicationdeployerconfigurationdeployerservicedeploymenthistoryitemdevopsinsightdatasourcedirectoryprovideremailconfigemailnotifierentitychangeenvironmentenvironmentinventoryitemenvironmentmapenvironmenttemplateenvironmenttemplatetierenvironmenttemplatetiermapenvironmenttemplatetiermappingenvironmenttierenvironmentvariableenvtempltierresourcetemplmappingeventsubscriptionflowruntimeformaloutputparameterformalparametergategatewaygrouphookjobjobstepkerberoskeytablicensemicroservicemicroservicemappingnoteobjectoutputparameterpersonapersonacategorypersonapagepipelinepluginpluginconfigurationportprocedureprocedurestepprocessprocessdependencyprocessstepprojectpropertyreleasereportreportingfilterreportobjectassociationreportobjectattributereportobjecttyperepositoryreservationresourceresourcepoolresourcetemplateresourceusageretrievedartifactsrollingdeployphaserundiscoverysamlidentityprovidersamlserviceproviderschedulesearchfilterserverserversettingserversettingcategoryserviceaccountserviceserviceclustermappingservicedependencyservicemapdetailsessionsnapshotstagestatestatedefinitiontagtasktiermaptiermappingtransitiontransitiondefinitiontriggertriggererrordetailuseruseremailutilityresourcewaitdependencywebhookresultwidgetwidgetfilteroverrideworkflowworkflowdefinitionworkitemworkspacezoneArgument models

Property

35 minute readReference

createProperty

Create a property using a combination of property path and context.

When invoked in the context of a job step, COMMANDER_JOBSTEPID will be automatically set as the jobStepId argument value unless jobStepId is already specified.

Arguments

Argument NameTypeDescription

propertyName

String

Name for the property; must be unique within the property sheet. (Required)

applicationName

String

The name of the application container of the property sheet which owns the property.

applicationTierName

String

The name of the application tier container of the property sheet which owns the property.

archiveConnectorName

String

The name of the archive connector of the property sheet which owns the property.

artifactName

String

The name of the artifact container of the property sheet which owns the property.

artifactVersionName

String

The name of the artifactVersion container of the property sheet which owns the property.

catalogItemRunId

String

The primary key of the CatalogItemRun container of the property sheet which owns the property.

catalogName

String

The name of the catalog of the property sheet which owns the property.

ciBuildDetailName

String

The name of the CI build detail of the property sheet which owns the property.

clusterName

String

The name of the cluster which owns property sheet.

componentName

String

The name of the component container of the property sheet which owns the property.

configName

String

The name of the emailConfig container that owns the property.

containerName

String

Deprecated: Deprecated due to microservice model changes The name of the container that owns the property.

credentialName

String

The name of the credential container of the property sheet which owns the property.

credentialProtected

Boolean

If true, then permissions requiring modify privileges on the property sheet being manipulated will also require execute privileges on credentials attached to the property sheet owner.

dashboardName

String

The name of the dashboard of the property sheet which owns the property.

dataRetentionPolicyName

String

The name of the data retention policy of the property sheet which owns the property.

description

String

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

environmentName

String

The name of the environment container of the property sheet which owns the property.

environmentTemplateName

String

The name of the environment template container of the property sheet which owns the property.

environmentTemplateTierName

String

The name of the environment template tier container of the property sheet which owns the property.

environmentTierName

String

The name of the environment tier container of the property sheet which owns the property.

expandable

Boolean

Whether or not the property is recursively expandable.

extendedContextSearch

Boolean

For simple property names, whether or not to search objects in the hierarchy to find the desired property.

flowName

String

The name of the flow container of the property sheet which owns the property.

flowRuntimeId

String

The primary key or name of the flowRuntime container of the property sheet which owns the property.

flowRuntimeName

String

The name of the flow runtime container of the property sheet which owns the property.

flowRuntimeStateId

String

The primary key or name of the flowRuntimeState container of the property sheet which owns the property.

flowRuntimeStateName

String

The name of the flow state container of the property sheet which owns the property.

flowStateName

String

The name of the flow state container of the property sheet which owns the property.

flowTransitionName

String

The name of the flow transition container of the property sheet which owns the property.

gateType

String

The type of the gate which owns property sheet.

gatewayName

String

The name of the gateway container of the property sheet.

groupName

String

The name of the group container of the property sheet which owns the property.

jobId

String

The primary key or name of the job container of the property sheet which owns the property.

jobStepId

String

The primary key of the job-step container of the property sheet which owns the property.

microserviceName

String

The name of the microservice container of the property sheet.

notifierName

String

The name of the notifier container of the property sheet which owns the property.

objectId

String

The object id as returned by FindObjects.

path

String

Property path string.

pipelineName

String

The name of the pipeline container of the property sheet which owns the property.

pluginConfigurationName

String

The name of the plugin configuration container of the property sheet which owns the property.

pluginName

String

The name of the plugin container of the property sheet which owns the property.

procedureName

String

The name of the procedure container of the property sheet which owns the property.

processName

String

The name of the process, if the container is a process or process step.

processStepName

String

The name of the process step, if the container is a process step.

projectName

String

The name of the project container of the property sheet which owns the property.

propertySheetId

String

The primary key of the property sheet which owns the property.

propertyType

String

Type of property.

releaseName

String

The name of the release container of the property sheet which owns the property.

reportName

String

The name of the report of the property sheet which owns the property.

reportObjectTypeName

String

The name of the report object type of the property sheet which owns the property.

repositoryName

String

The name of the repository container of the property sheet which owns the property.

resourceName

String

The name of the resource container of the property sheet which owns the property.

resourcePoolName

String

The name of the resource pool container of the property sheet which owns the property.

resourceTemplateName

String

The name of the resource template container of the property sheet which owns the property.

scheduleName

String

The name of the schedule container of the property sheet.

searchFilterName

String

The name of the search filter container of the property sheet.

serviceAccountName

String

Get the name of the service account container of the property sheet

serviceName

String

Deprecated: Deprecated due to microservice model changes The name of the service container of the property sheet.

snapshotName

String

The name of the snapshot container of the property sheet which owns the property.

stageName

String

The name of the stage container of the property sheet which owns the property.

stateDefinitionName

String

The name of the state definition container of the property sheet which owns the property.

stateName

String

The name of the state container of the property sheet which owns the property.

stepName

String

The name of the step container of the property sheet which owns the property.

suppressValueTracking

Boolean

If true, then change tracking will ignore changes that only affect the value of the property, and exports of past states and force imports will preserve the current value.

systemObjectName

String

The system object.

taskName

String

The name of the task which owns property sheet.

transitionDefinitionName

String

The name of the transition definition container of the property sheet which owns the property.

transitionName

String

The name of the transition container of the property sheet which owns the property.

triggerName

String

The name of the trigger which owns property sheet.

userName

String

The name of the user container of the property sheet which owns the property.

value

String

The value of the property.

widgetName

String

The name of the widget of the property sheet which owns the property.

workflowDefinitionName

String

The name of the workflow definition container of the property sheet which owns the property.

workflowName

String

The name of the workflow container of the property sheet which owns the property.

workspaceName

String

The name of the workspace container of the property sheet.

zoneName

String

The name of the zone container of the property sheet.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.createProperty(
                propertyName: 'test-propertyName'
                /* optional arguments */)

deleteProperty

Delete a property from a property sheet.

When invoked in the context of a job step, COMMANDER_JOBSTEPID will be automatically set as the jobStepId argument value unless jobStepId is already specified.

Arguments

Argument NameTypeDescription

propertyName

String

Name for the property; must be unique within the property sheet. (Required)

applicationName

String

The name of the application container of the property sheet which owns the property.

applicationTierName

String

The name of the application tier container of the property sheet which owns the property.

archiveConnectorName

String

The name of the archive connector of the property sheet which owns the property.

artifactName

String

The name of the artifact container of the property sheet which owns the property.

artifactVersionName

String

The name of the artifactVersion container of the property sheet which owns the property.

catalogItemRunId

String

The primary key of the CatalogItemRun container of the property sheet which owns the property.

catalogName

String

The name of the catalog of the property sheet which owns the property.

ciBuildDetailName

String

The name of the CI build detail of the property sheet which owns the property.

clusterName

String

The name of the cluster which owns property sheet.

componentName

String

The name of the component container of the property sheet which owns the property.

configName

String

The name of the emailConfig container that owns the property.

containerName

String

Deprecated: Deprecated due to microservice model changes The name of the container that owns the property.

credentialName

String

The name of the credential container of the property sheet which owns the property.

dashboardName

String

The name of the dashboard of the property sheet which owns the property.

dataRetentionPolicyName

String

The name of the data retention policy of the property sheet which owns the property.

environmentName

String

The name of the environment container of the property sheet which owns the property.

environmentTemplateName

String

The name of the environment template container of the property sheet which owns the property.

environmentTemplateTierName

String

The name of the environment template tier container of the property sheet which owns the property.

environmentTierName

String

The name of the environment tier container of the property sheet which owns the property.

extendedContextSearch

Boolean

For simple property names, whether or not to search objects in the hierarchy to find the desired property.

flowName

String

The name of the flow container of the property sheet which owns the property.

flowRuntimeId

String

The primary key or name of the flowRuntime container of the property sheet which owns the property.

flowRuntimeName

String

The name of the flow runtime container of the property sheet which owns the property.

flowRuntimeStateId

String

The primary key or name of the flowRuntimeState container of the property sheet which owns the property.

flowRuntimeStateName

String

The name of the flow state container of the property sheet which owns the property.

flowStateName

String

The name of the flow state container of the property sheet which owns the property.

flowTransitionName

String

The name of the flow transition container of the property sheet which owns the property.

gateType

String

The type of the gate which owns property sheet.

gatewayName

String

The name of the gateway container of the property sheet.

groupName

String

The name of the group container of the property sheet which owns the property.

jobId

String

The primary key or name of the job container of the property sheet which owns the property.

jobStepId

String

The primary key of the job-step container of the property sheet which owns the property.

microserviceName

String

The name of the microservice container of the property sheet.

notifierName

String

The name of the notifier container of the property sheet which owns the property.

objectId

String

The object id as returned by FindObjects.

path

String

Property path string.

pipelineName

String

The name of the pipeline container of the property sheet which owns the property.

pluginConfigurationName

String

The name of the plugin configuration container of the property sheet which owns the property.

pluginName

String

The name of the plugin container of the property sheet which owns the property.

procedureName

String

The name of the procedure container of the property sheet which owns the property.

processName

String

The name of the process, if the container is a process or process step.

processStepName

String

The name of the process step, if the container is a process step.

projectName

String

The name of the project container of the property sheet which owns the property.

propertySheetId

String

The primary key of the property sheet which owns the property.

releaseName

String

The name of the release container of the property sheet which owns the property.

reportName

String

The name of the report of the property sheet which owns the property.

reportObjectTypeName

String

The name of the report object type of the property sheet which owns the property.

repositoryName

String

The name of the repository container of the property sheet which owns the property.

resourceName

String

The name of the resource container of the property sheet which owns the property.

resourcePoolName

String

The name of the resource pool container of the property sheet which owns the property.

resourceTemplateName

String

The name of the resource template container of the property sheet which owns the property.

scheduleName

String

The name of the schedule container of the property sheet.

searchFilterName

String

The name of the search filter container of the property sheet.

serviceAccountName

String

Get the name of the service account container of the property sheet

serviceName

String

Deprecated: Deprecated due to microservice model changes The name of the service container of the property sheet.

snapshotName

String

The name of the snapshot container of the property sheet which owns the property.

stageName

String

The name of the stage container of the property sheet which owns the property.

stateDefinitionName

String

The name of the state definition container of the property sheet which owns the property.

stateName

String

The name of the state container of the property sheet which owns the property.

stepName

String

The name of the step container of the property sheet which owns the property.

systemObjectName

String

The system object.

taskName

String

The name of the task which owns property sheet.

transitionDefinitionName

String

The name of the transition definition container of the property sheet which owns the property.

transitionName

String

The name of the transition container of the property sheet which owns the property.

triggerName

String

The name of the trigger which owns property sheet.

userName

String

The name of the user container of the property sheet which owns the property.

widgetName

String

The name of the widget of the property sheet which owns the property.

workflowDefinitionName

String

The name of the workflow definition container of the property sheet which owns the property.

workflowName

String

The name of the workflow container of the property sheet which owns the property.

workspaceName

String

The name of the workspace container of the property sheet.

zoneName

String

The name of the zone container of the property sheet.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.deleteProperty(
                propertyName: 'test-propertyName'
                /* optional arguments */)

findProperties

Return properties of a particular object.

Arguments

Argument NameTypeDescription

applicationName

String

The name of the application container of the property sheet which owns the property.

applicationTierName

String

The name of the application tier container of the property sheet which owns the property.

archiveConnectorName

String

The name of the archive connector of the property sheet which owns the property.

artifactName

String

The name of the artifact container of the property sheet which owns the property.

artifactVersionName

String

The name of the artifactVersion container of the property sheet which owns the property.

catalogItemRunId

String

The primary key of the CatalogItemRun container of the property sheet which owns the property.

catalogName

String

The name of the catalog of the property sheet which owns the property.

ciBuildDetailName

String

The name of the CI build detail of the property sheet which owns the property.

clusterName

String

The name of the cluster which owns property sheet.

componentName

String

The name of the component container of the property sheet which owns the property.

configName

String

The name of the emailConfig container that owns the property.

containerName

String

Deprecated: Deprecated due to microservice model changes The name of the container that owns the property.

credentialName

String

The name of the credential container of the property sheet which owns the property.

dashboardName

String

The name of the dashboard of the property sheet which owns the property.

dataRetentionPolicyName

String

The name of the data retention policy of the property sheet which owns the property.

environmentName

String

The name of the environment container of the property sheet which owns the property.

environmentTemplateName

String

The name of the environment template container of the property sheet which owns the property.

environmentTemplateTierName

String

The name of the environment template tier container of the property sheet which owns the property.

environmentTierName

String

The name of the environment tier container of the property sheet which owns the property.

filters

Filter array

Filters

flowName

String

The name of the flow container of the property sheet which owns the property.

flowRuntimeId

String

The primary key or name of the flowRuntime container of the property sheet which owns the property.

flowRuntimeName

String

The name of the flow runtime container of the property sheet which owns the property.

flowRuntimeStateId

String

The primary key or name of the flowRuntimeState container of the property sheet which owns the property.

flowRuntimeStateName

String

The name of the flow state container of the property sheet which owns the property.

flowStateName

String

The name of the flow state container of the property sheet which owns the property.

flowTransitionName

String

The name of the flow transition container of the property sheet which owns the property.

gateType

String

The type of the gate which owns property sheet.

gatewayName

String

The name of the gateway container of the property sheet.

groupName

String

The name of the group container of the property sheet which owns the property.

jobId

String

The primary key or name of the job container of the property sheet which owns the property.

jobStepId

String

The primary key of the job-step container of the property sheet which owns the property.

maxIds

Integer

The maximum number of object ids to return.

microserviceName

String

The name of the microservice container of the property sheet.

notifierName

String

The name of the notifier container of the property sheet which owns the property.

numObjects

Integer

The number of objects to return as the first page of results.

objectId

String

The object id as returned by FindObjects.

path

String

Property path string.

pipelineName

String

The name of the pipeline container of the property sheet which owns the property.

pluginConfigurationName

String

The name of the plugin configuration container of the property sheet which owns the property.

pluginName

String

The name of the plugin container of the property sheet which owns the property.

procedureName

String

The name of the procedure container of the property sheet which owns the property.

processName

String

The name of the process, if the container is a process or process step.

processStepName

String

The name of the process step, if the container is a process step.

projectName

String

The name of the project container of the property sheet which owns the property.

propertySheetId

String

The primary key of the property sheet which owns the property.

releaseName

String

The name of the release container of the property sheet which owns the property.

reportName

String

The name of the report of the property sheet which owns the property.

reportObjectTypeName

String

The name of the report object type of the property sheet which owns the property.

repositoryName

String

The name of the repository container of the property sheet which owns the property.

resourceName

String

The name of the resource container of the property sheet which owns the property.

resourcePoolName

String

The name of the resource pool container of the property sheet which owns the property.

resourceTemplateName

String

The name of the resource template container of the property sheet which owns the property.

scheduleName

String

The name of the schedule container of the property sheet.

searchFilterName

String

The name of the search filter container of the property sheet.

serviceAccountName

String

Get the name of the service account container of the property sheet

serviceName

String

Deprecated: Deprecated due to microservice model changes The name of the service container of the property sheet.

snapshotName

String

The name of the snapshot container of the property sheet which owns the property.

sorts

Sort array

Sort specifications.

stageName

String

The name of the stage container of the property sheet which owns the property.

stateDefinitionName

String

The name of the state definition container of the property sheet which owns the property.

stateName

String

The name of the state container of the property sheet which owns the property.

stepName

String

The name of the step container of the property sheet which owns the property.

systemObjectName

String

The system object.

taskName

String

The name of the task which owns property sheet.

transitionDefinitionName

String

The name of the transition definition container of the property sheet which owns the property.

transitionName

String

The name of the transition container of the property sheet which owns the property.

triggerName

String

The name of the trigger which owns property sheet.

userName

String

The name of the user container of the property sheet which owns the property.

widgetName

String

The name of the widget of the property sheet which owns the property.

workflowDefinitionName

String

The name of the workflow definition container of the property sheet which owns the property.

workflowName

String

The name of the workflow container of the property sheet which owns the property.

workspaceName

String

The name of the workspace container of the property sheet.

zoneName

String

The name of the zone container of the property sheet.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.findProperties(
                /* optional arguments */)

getProperties

Return all properties associated with an object, along with the property sheet identifier of the object’s property sheet.

When invoked in the context of a job step, COMMANDER_JOBSTEPID will be automatically set as the jobStepId argument value unless jobStepId is already specified.

Arguments

Argument NameTypeDescription

applicationName

String

The name of the application container of the property sheet which owns the property.

applicationTierName

String

The name of the application tier container of the property sheet which owns the property.

archiveConnectorName

String

The name of the archive connector of the property sheet which owns the property.

artifactName

String

The name of the artifact container of the property sheet which owns the property.

artifactVersionName

String

The name of the artifactVersion container of the property sheet which owns the property.

catalogItemRunId

String

The primary key of the CatalogItemRun container of the property sheet which owns the property.

catalogName

String

The name of the catalog of the property sheet which owns the property.

ciBuildDetailName

String

The name of the CI build detail of the property sheet which owns the property.

clusterName

String

The name of the cluster which owns property sheet.

componentName

String

The name of the component container of the property sheet which owns the property.

configName

String

The name of the emailConfig container that owns the property.

containerName

String

Deprecated: Deprecated due to microservice model changes The name of the container that owns the property.

credentialName

String

The name of the credential container of the property sheet which owns the property.

dashboardName

String

The name of the dashboard of the property sheet which owns the property.

dataRetentionPolicyName

String

The name of the data retention policy of the property sheet which owns the property.

environmentName

String

The name of the environment container of the property sheet which owns the property.

environmentTemplateName

String

The name of the environment template container of the property sheet which owns the property.

environmentTemplateTierName

String

The name of the environment template tier container of the property sheet which owns the property.

environmentTierName

String

The name of the environment tier container of the property sheet which owns the property.

expand

Boolean

If true, property values are expanded.

flowName

String

The name of the flow container of the property sheet which owns the property.

flowRuntimeId

String

The primary key or name of the flowRuntime container of the property sheet which owns the property.

flowRuntimeName

String

The name of the flow runtime container of the property sheet which owns the property.

flowRuntimeStateId

String

The primary key or name of the flowRuntimeState container of the property sheet which owns the property.

flowRuntimeStateName

String

The name of the flow state container of the property sheet which owns the property.

flowStateName

String

The name of the flow state container of the property sheet which owns the property.

flowTransitionName

String

The name of the flow transition container of the property sheet which owns the property.

gateType

String

The type of the gate which owns property sheet.

gatewayName

String

The name of the gateway container of the property sheet.

groupName

String

The name of the group container of the property sheet which owns the property.

jobId

String

The primary key or name of the job container of the property sheet which owns the property.

jobStepId

String

The primary key of the job-step container of the property sheet which owns the property.

microserviceName

String

The name of the microservice container of the property sheet.

notifierName

String

The name of the notifier container of the property sheet which owns the property.

objectId

String

The object id as returned by FindObjects.

path

String

Property path string.

pipelineName

String

The name of the pipeline container of the property sheet which owns the property.

pluginConfigurationName

String

The name of the plugin configuration container of the property sheet which owns the property.

pluginName

String

The name of the plugin container of the property sheet which owns the property.

procedureName

String

The name of the procedure container of the property sheet which owns the property.

processName

String

The name of the process, if the container is a process or process step.

processStepName

String

The name of the process step, if the container is a process step.

projectName

String

The name of the project container of the property sheet which owns the property.

propertyName

String

The name of a nested property sheet

propertySheetId

String

The primary key of the property sheet which owns the property.

recurse

Boolean

True means nested property sheets are included.

releaseName

String

The name of the release container of the property sheet which owns the property.

reportName

String

The name of the report of the property sheet which owns the property.

reportObjectTypeName

String

The name of the report object type of the property sheet which owns the property.

repositoryName

String

The name of the repository container of the property sheet which owns the property.

resourceName

String

The name of the resource container of the property sheet which owns the property.

resourcePoolName

String

The name of the resource pool container of the property sheet which owns the property.

resourceTemplateName

String

The name of the resource template container of the property sheet which owns the property.

scheduleName

String

The name of the schedule container of the property sheet.

searchFilterName

String

The name of the search filter container of the property sheet.

serviceAccountName

String

Get the name of the service account container of the property sheet

serviceName

String

Deprecated: Deprecated due to microservice model changes The name of the service container of the property sheet.

snapshotName

String

The name of the snapshot container of the property sheet which owns the property.

stageName

String

The name of the stage container of the property sheet which owns the property.

stateDefinitionName

String

The name of the state definition container of the property sheet which owns the property.

stateName

String

The name of the state container of the property sheet which owns the property.

stepName

String

The name of the step container of the property sheet which owns the property.

systemObjectName

String

The system object.

taskName

String

The name of the task which owns property sheet.

transitionDefinitionName

String

The name of the transition definition container of the property sheet which owns the property.

transitionName

String

The name of the transition container of the property sheet which owns the property.

triggerName

String

The name of the trigger which owns property sheet.

userName

String

The name of the user container of the property sheet which owns the property.

widgetName

String

The name of the widget of the property sheet which owns the property.

workflowDefinitionName

String

The name of the workflow definition container of the property sheet which owns the property.

workflowName

String

The name of the workflow container of the property sheet which owns the property.

workspaceName

String

The name of the workspace container of the property sheet.

zoneName

String

The name of the zone container of the property sheet.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.getProperties(
                /* optional arguments */)

getProperty

Get value of the specified property.

When invoked in the context of a job step, COMMANDER_JOBSTEPID will be automatically set as the jobStepId argument value unless jobStepId is already specified.

Arguments

Argument NameTypeDescription

propertyName

String

Name for the property; must be unique within the property sheet. (Required)

applicationName

String

The name of the application container of the property sheet which owns the property.

applicationTierName

String

The name of the application tier container of the property sheet which owns the property.

archiveConnectorName

String

The name of the archive connector of the property sheet which owns the property.

artifactName

String

The name of the artifact container of the property sheet which owns the property.

artifactVersionName

String

The name of the artifactVersion container of the property sheet which owns the property.

catalogItemRunId

String

The primary key of the CatalogItemRun container of the property sheet which owns the property.

catalogName

String

The name of the catalog of the property sheet which owns the property.

ciBuildDetailName

String

The name of the CI build detail of the property sheet which owns the property.

clusterName

String

The name of the cluster which owns property sheet.

componentName

String

The name of the component container of the property sheet which owns the property.

configName

String

The name of the emailConfig container that owns the property.

containerName

String

Deprecated: Deprecated due to microservice model changes The name of the container that owns the property.

credentialName

String

The name of the credential container of the property sheet which owns the property.

dashboardName

String

The name of the dashboard of the property sheet which owns the property.

dataRetentionPolicyName

String

The name of the data retention policy of the property sheet which owns the property.

environmentName

String

The name of the environment container of the property sheet which owns the property.

environmentTemplateName

String

The name of the environment template container of the property sheet which owns the property.

environmentTemplateTierName

String

The name of the environment template tier container of the property sheet which owns the property.

environmentTierName

String

The name of the environment tier container of the property sheet which owns the property.

expand

Boolean

If true, property values are expanded.

extendedContextSearch

Boolean

For simple property names, whether or not to search objects in the hierarchy to find the desired property.

flowName

String

The name of the flow container of the property sheet which owns the property.

flowRuntimeId

String

The primary key or name of the flowRuntime container of the property sheet which owns the property.

flowRuntimeName

String

The name of the flow runtime container of the property sheet which owns the property.

flowRuntimeStateId

String

The primary key or name of the flowRuntimeState container of the property sheet which owns the property.

flowRuntimeStateName

String

The name of the flow state container of the property sheet which owns the property.

flowStateName

String

The name of the flow state container of the property sheet which owns the property.

flowTransitionName

String

The name of the flow transition container of the property sheet which owns the property.

gateType

String

The type of the gate which owns property sheet.

gatewayName

String

The name of the gateway container of the property sheet.

groupName

String

The name of the group container of the property sheet which owns the property.

jobId

String

The primary key or name of the job container of the property sheet which owns the property.

jobStepId

String

The primary key of the job-step container of the property sheet which owns the property.

microserviceName

String

The name of the microservice container of the property sheet.

notifierName

String

The name of the notifier container of the property sheet which owns the property.

objectId

String

The object id as returned by FindObjects.

path

String

Property path string.

pipelineName

String

The name of the pipeline container of the property sheet which owns the property.

pluginConfigurationName

String

The name of the plugin configuration container of the property sheet which owns the property.

pluginName

String

The name of the plugin container of the property sheet which owns the property.

procedureName

String

The name of the procedure container of the property sheet which owns the property.

processName

String

The name of the process, if the container is a process or process step.

processStepName

String

The name of the process step, if the container is a process step.

projectName

String

The name of the project container of the property sheet which owns the property.

propertySheetId

String

The primary key of the property sheet which owns the property.

releaseName

String

The name of the release container of the property sheet which owns the property.

reportName

String

The name of the report of the property sheet which owns the property.

reportObjectTypeName

String

The name of the report object type of the property sheet which owns the property.

repositoryName

String

The name of the repository container of the property sheet which owns the property.

resourceName

String

The name of the resource container of the property sheet which owns the property.

resourcePoolName

String

The name of the resource pool container of the property sheet which owns the property.

resourceTemplateName

String

The name of the resource template container of the property sheet which owns the property.

scheduleName

String

The name of the schedule container of the property sheet.

searchFilterName

String

The name of the search filter container of the property sheet.

serviceAccountName

String

Get the name of the service account container of the property sheet

serviceName

String

Deprecated: Deprecated due to microservice model changes The name of the service container of the property sheet.

snapshotName

String

The name of the snapshot container of the property sheet which owns the property.

stageName

String

The name of the stage container of the property sheet which owns the property.

stateDefinitionName

String

The name of the state definition container of the property sheet which owns the property.

stateName

String

The name of the state container of the property sheet which owns the property.

stepName

String

The name of the step container of the property sheet which owns the property.

systemObjectName

String

The system object.

taskName

String

The name of the task which owns property sheet.

transitionDefinitionName

String

The name of the transition definition container of the property sheet which owns the property.

transitionName

String

The name of the transition container of the property sheet which owns the property.

triggerName

String

The name of the trigger which owns property sheet.

userName

String

The name of the user container of the property sheet which owns the property.

widgetName

String

The name of the widget of the property sheet which owns the property.

workflowDefinitionName

String

The name of the workflow definition container of the property sheet which owns the property.

workflowName

String

The name of the workflow container of the property sheet which owns the property.

workspaceName

String

The name of the workspace container of the property sheet.

zoneName

String

The name of the zone container of the property sheet.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.getProperty(
                propertyName: 'test-propertyName'
                /* optional arguments */)

incrementProperty

Atomically increments an integer property by the specified amount and returns the new value.

When invoked in the context of a job step, COMMANDER_JOBSTEPID will be automatically set as the jobStepId argument value unless jobStepId is already specified.

Arguments

Argument NameTypeDescription

propertyName

String

Name for the property; must be unique within the property sheet. (Required)

applicationName

String

The name of the application container of the property sheet which owns the property.

applicationTierName

String

The name of the application tier container of the property sheet which owns the property.

archiveConnectorName

String

The name of the archive connector of the property sheet which owns the property.

artifactName

String

The name of the artifact container of the property sheet which owns the property.

artifactVersionName

String

The name of the artifactVersion container of the property sheet which owns the property.

catalogItemRunId

String

The primary key of the CatalogItemRun container of the property sheet which owns the property.

catalogName

String

The name of the catalog of the property sheet which owns the property.

ciBuildDetailName

String

The name of the CI build detail of the property sheet which owns the property.

clusterName

String

The name of the cluster which owns property sheet.

componentName

String

The name of the component container of the property sheet which owns the property.

configName

String

The name of the emailConfig container that owns the property.

containerName

String

Deprecated: Deprecated due to microservice model changes The name of the container that owns the property.

credentialName

String

The name of the credential container of the property sheet which owns the property.

dashboardName

String

The name of the dashboard of the property sheet which owns the property.

dataRetentionPolicyName

String

The name of the data retention policy of the property sheet which owns the property.

environmentName

String

The name of the environment container of the property sheet which owns the property.

environmentTemplateName

String

The name of the environment template container of the property sheet which owns the property.

environmentTemplateTierName

String

The name of the environment template tier container of the property sheet which owns the property.

environmentTierName

String

The name of the environment tier container of the property sheet which owns the property.

extendedContextSearch

Boolean

For simple property names, whether or not to search objects in the hierarchy to find the desired property.

flowName

String

The name of the flow container of the property sheet which owns the property.

flowRuntimeId

String

The primary key or name of the flowRuntime container of the property sheet which owns the property.

flowRuntimeName

String

The name of the flow runtime container of the property sheet which owns the property.

flowRuntimeStateId

String

The primary key or name of the flowRuntimeState container of the property sheet which owns the property.

flowRuntimeStateName

String

The name of the flow state container of the property sheet which owns the property.

flowStateName

String

The name of the flow state container of the property sheet which owns the property.

flowTransitionName

String

The name of the flow transition container of the property sheet which owns the property.

gateType

String

The type of the gate which owns property sheet.

gatewayName

String

The name of the gateway container of the property sheet.

groupName

String

The name of the group container of the property sheet which owns the property.

incrementBy

Integer

The amount by which to increment the property.

jobId

String

The primary key or name of the job container of the property sheet which owns the property.

jobStepId

String

The primary key of the job-step container of the property sheet which owns the property.

microserviceName

String

The name of the microservice container of the property sheet.

notifierName

String

The name of the notifier container of the property sheet which owns the property.

objectId

String

The object id as returned by FindObjects.

path

String

Property path string.

pipelineName

String

The name of the pipeline container of the property sheet which owns the property.

pluginConfigurationName

String

The name of the plugin configuration container of the property sheet which owns the property.

pluginName

String

The name of the plugin container of the property sheet which owns the property.

procedureName

String

The name of the procedure container of the property sheet which owns the property.

processName

String

The name of the process, if the container is a process or process step.

processStepName

String

The name of the process step, if the container is a process step.

projectName

String

The name of the project container of the property sheet which owns the property.

propertySheetId

String

The primary key of the property sheet which owns the property.

releaseName

String

The name of the release container of the property sheet which owns the property.

reportName

String

The name of the report of the property sheet which owns the property.

reportObjectTypeName

String

The name of the report object type of the property sheet which owns the property.

repositoryName

String

The name of the repository container of the property sheet which owns the property.

resourceName

String

The name of the resource container of the property sheet which owns the property.

resourcePoolName

String

The name of the resource pool container of the property sheet which owns the property.

resourceTemplateName

String

The name of the resource template container of the property sheet which owns the property.

scheduleName

String

The name of the schedule container of the property sheet.

searchFilterName

String

The name of the search filter container of the property sheet.

serviceAccountName

String

Get the name of the service account container of the property sheet

serviceName

String

Deprecated: Deprecated due to microservice model changes The name of the service container of the property sheet.

snapshotName

String

The name of the snapshot container of the property sheet which owns the property.

stageName

String

The name of the stage container of the property sheet which owns the property.

stateDefinitionName

String

The name of the state definition container of the property sheet which owns the property.

stateName

String

The name of the state container of the property sheet which owns the property.

stepName

String

The name of the step container of the property sheet which owns the property.

systemObjectName

String

The system object.

taskName

String

The name of the task which owns property sheet.

transitionDefinitionName

String

The name of the transition definition container of the property sheet which owns the property.

transitionName

String

The name of the transition container of the property sheet which owns the property.

triggerName

String

The name of the trigger which owns property sheet.

userName

String

The name of the user container of the property sheet which owns the property.

widgetName

String

The name of the widget of the property sheet which owns the property.

workflowDefinitionName

String

The name of the workflow definition container of the property sheet which owns the property.

workflowName

String

The name of the workflow container of the property sheet which owns the property.

workspaceName

String

The name of the workspace container of the property sheet.

zoneName

String

The name of the zone container of the property sheet.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.incrementProperty(
                propertyName: 'test-propertyName'
                /* optional arguments */)

modifyProperty

Modify an existing property in a property sheet.

When invoked in the context of a job step, COMMANDER_JOBSTEPID will be automatically set as the jobStepId argument value unless jobStepId is already specified.

Arguments

Argument NameTypeDescription

propertyName

String

Name for the property; must be unique within the property sheet. (Required)

applicationName

String

The name of the application container of the property sheet which owns the property.

applicationTierName

String

The name of the application tier container of the property sheet which owns the property.

archiveConnectorName

String

The name of the archive connector of the property sheet which owns the property.

artifactName

String

The name of the artifact container of the property sheet which owns the property.

artifactVersionName

String

The name of the artifactVersion container of the property sheet which owns the property.

catalogItemRunId

String

The primary key of the CatalogItemRun container of the property sheet which owns the property.

catalogName

String

The name of the catalog of the property sheet which owns the property.

ciBuildDetailName

String

The name of the CI build detail of the property sheet which owns the property.

clusterName

String

The name of the cluster which owns property sheet.

componentName

String

The name of the component container of the property sheet which owns the property.

configName

String

The name of the emailConfig container that owns the property.

containerName

String

Deprecated: Deprecated due to microservice model changes The name of the container that owns the property.

credentialName

String

The name of the credential container of the property sheet which owns the property.

credentialProtected

Boolean

If true, then permissions requiring modify privileges on the property sheet being manipulated will also require execute privileges on credentials attached to the property sheet owner.

dashboardName

String

The name of the dashboard of the property sheet which owns the property.

dataRetentionPolicyName

String

The name of the data retention policy of the property sheet which owns the property.

description

String

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

environmentName

String

The name of the environment container of the property sheet which owns the property.

environmentTemplateName

String

The name of the environment template container of the property sheet which owns the property.

environmentTemplateTierName

String

The name of the environment template tier container of the property sheet which owns the property.

environmentTierName

String

The name of the environment tier container of the property sheet which owns the property.

expandable

Boolean

Whether or not the property is recursively expandable.

extendedContextSearch

Boolean

For simple property names, whether or not to search objects in the hierarchy to find the desired property.

flowName

String

The name of the flow container of the property sheet which owns the property.

flowRuntimeId

String

The primary key or name of the flowRuntime container of the property sheet which owns the property.

flowRuntimeName

String

The name of the flow runtime container of the property sheet which owns the property.

flowRuntimeStateId

String

The primary key or name of the flowRuntimeState container of the property sheet which owns the property.

flowRuntimeStateName

String

The name of the flow state container of the property sheet which owns the property.

flowStateName

String

The name of the flow state container of the property sheet which owns the property.

flowTransitionName

String

The name of the flow transition container of the property sheet which owns the property.

gateType

String

The type of the gate which owns property sheet.

gatewayName

String

The name of the gateway container of the property sheet.

groupName

String

The name of the group container of the property sheet which owns the property.

jobId

String

The primary key or name of the job container of the property sheet which owns the property.

jobStepId

String

The primary key of the job-step container of the property sheet which owns the property.

microserviceName

String

The name of the microservice container of the property sheet.

newName

String

New name for an existing object that is being renamed.

notifierName

String

The name of the notifier container of the property sheet which owns the property.

objectId

String

The object id as returned by FindObjects.

path

String

Property path string.

pipelineName

String

The name of the pipeline container of the property sheet which owns the property.

pluginConfigurationName

String

The name of the plugin configuration container of the property sheet which owns the property.

pluginName

String

The name of the plugin container of the property sheet which owns the property.

procedureName

String

The name of the procedure container of the property sheet which owns the property.

processName

String

The name of the process, if the container is a process or process step.

processStepName

String

The name of the process step, if the container is a process step.

projectName

String

The name of the project container of the property sheet which owns the property.

propertySheetId

String

The primary key of the property sheet which owns the property.

propertyType

String

Type of property.

releaseName

String

The name of the release container of the property sheet which owns the property.

reportName

String

The name of the report of the property sheet which owns the property.

reportObjectTypeName

String

The name of the report object type of the property sheet which owns the property.

repositoryName

String

The name of the repository container of the property sheet which owns the property.

resourceName

String

The name of the resource container of the property sheet which owns the property.

resourcePoolName

String

The name of the resource pool container of the property sheet which owns the property.

resourceTemplateName

String

The name of the resource template container of the property sheet which owns the property.

scheduleName

String

The name of the schedule container of the property sheet.

searchFilterName

String

The name of the search filter container of the property sheet.

serviceAccountName

String

Get the name of the service account container of the property sheet

serviceName

String

Deprecated: Deprecated due to microservice model changes The name of the service container of the property sheet.

snapshotName

String

The name of the snapshot container of the property sheet which owns the property.

stageName

String

The name of the stage container of the property sheet which owns the property.

stateDefinitionName

String

The name of the state definition container of the property sheet which owns the property.

stateName

String

The name of the state container of the property sheet which owns the property.

stepName

String

The name of the step container of the property sheet which owns the property.

suppressValueTracking

Boolean

If true, then change tracking will ignore changes that only affect the value of the property, and exports of past states and force imports will preserve the current value.

systemObjectName

String

The system object.

taskName

String

The name of the task which owns property sheet.

transitionDefinitionName

String

The name of the transition definition container of the property sheet which owns the property.

transitionName

String

The name of the transition container of the property sheet which owns the property.

triggerName

String

The name of the trigger which owns property sheet.

userName

String

The name of the user container of the property sheet which owns the property.

value

String

The value of the property.

widgetName

String

The name of the widget of the property sheet which owns the property.

workflowDefinitionName

String

The name of the workflow definition container of the property sheet which owns the property.

workflowName

String

The name of the workflow container of the property sheet which owns the property.

workspaceName

String

The name of the workspace container of the property sheet.

zoneName

String

The name of the zone container of the property sheet.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.modifyProperty(
                propertyName: 'test-propertyName'
                /* optional arguments */)

setProperty

Set a property in a property sheet.

When invoked in the context of a job step, COMMANDER_JOBSTEPID will be automatically set as the jobStepId argument value unless jobStepId is already specified.

Arguments

Argument NameTypeDescription

propertyName

String

Name for the property; must be unique within the property sheet. (Required)

applicationName

String

The name of the application container of the property sheet which owns the property.

applicationTierName

String

The name of the application tier container of the property sheet which owns the property.

archiveConnectorName

String

The name of the archive connector of the property sheet which owns the property.

artifactName

String

The name of the artifact container of the property sheet which owns the property.

artifactVersionName

String

The name of the artifactVersion container of the property sheet which owns the property.

catalogItemRunId

String

The primary key of the CatalogItemRun container of the property sheet which owns the property.

catalogName

String

The name of the catalog of the property sheet which owns the property.

ciBuildDetailName

String

The name of the CI build detail of the property sheet which owns the property.

clusterName

String

The name of the cluster which owns property sheet.

componentName

String

The name of the component container of the property sheet which owns the property.

configName

String

The name of the emailConfig container that owns the property.

containerName

String

Deprecated: Deprecated due to microservice model changes The name of the container that owns the property.

credentialName

String

The name of the credential container of the property sheet which owns the property.

dashboardName

String

The name of the dashboard of the property sheet which owns the property.

dataRetentionPolicyName

String

The name of the data retention policy of the property sheet which owns the property.

description

String

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

environmentName

String

The name of the environment container of the property sheet which owns the property.

environmentTemplateName

String

The name of the environment template container of the property sheet which owns the property.

environmentTemplateTierName

String

The name of the environment template tier container of the property sheet which owns the property.

environmentTierName

String

The name of the environment tier container of the property sheet which owns the property.

expandable

Boolean

Whether or not the property is recursively expandable.

extendedContextSearch

Boolean

For simple property names, whether or not to search objects in the hierarchy to find the desired property.

flowName

String

The name of the flow container of the property sheet which owns the property.

flowRuntimeId

String

The primary key or name of the flowRuntime container of the property sheet which owns the property.

flowRuntimeName

String

The name of the flow runtime container of the property sheet which owns the property.

flowRuntimeStateId

String

The primary key or name of the flowRuntimeState container of the property sheet which owns the property.

flowRuntimeStateName

String

The name of the flow state container of the property sheet which owns the property.

flowStateName

String

The name of the flow state container of the property sheet which owns the property.

flowTransitionName

String

The name of the flow transition container of the property sheet which owns the property.

gateType

String

The type of the gate which owns property sheet.

gatewayName

String

The name of the gateway container of the property sheet.

groupName

String

The name of the group container of the property sheet which owns the property.

jobId

String

The primary key or name of the job container of the property sheet which owns the property.

jobStepId

String

The primary key of the job-step container of the property sheet which owns the property.

microserviceName

String

The name of the microservice container of the property sheet.

notifierName

String

The name of the notifier container of the property sheet which owns the property.

objectId

String

The object id as returned by FindObjects.

path

String

Property path string.

pipelineName

String

The name of the pipeline container of the property sheet which owns the property.

pluginConfigurationName

String

The name of the plugin configuration container of the property sheet which owns the property.

pluginName

String

The name of the plugin container of the property sheet which owns the property.

procedureName

String

The name of the procedure container of the property sheet which owns the property.

processName

String

The name of the process, if the container is a process or process step.

processStepName

String

The name of the process step, if the container is a process step.

projectName

String

The name of the project container of the property sheet which owns the property.

propertySheetId

String

The primary key of the property sheet which owns the property.

releaseName

String

The name of the release container of the property sheet which owns the property.

reportName

String

The name of the report of the property sheet which owns the property.

reportObjectTypeName

String

The name of the report object type of the property sheet which owns the property.

repositoryName

String

The name of the repository container of the property sheet which owns the property.

resourceName

String

The name of the resource container of the property sheet which owns the property.

resourcePoolName

String

The name of the resource pool container of the property sheet which owns the property.

resourceTemplateName

String

The name of the resource template container of the property sheet which owns the property.

scheduleName

String

The name of the schedule container of the property sheet.

searchFilterName

String

The name of the search filter container of the property sheet.

serviceAccountName

String

Get the name of the service account container of the property sheet

serviceName

String

Deprecated: Deprecated due to microservice model changes The name of the service container of the property sheet.

snapshotName

String

The name of the snapshot container of the property sheet which owns the property.

stageName

String

The name of the stage container of the property sheet which owns the property.

stateDefinitionName

String

The name of the state definition container of the property sheet which owns the property.

stateName

String

The name of the state container of the property sheet which owns the property.

stepName

String

The name of the step container of the property sheet which owns the property.

suppressValueTracking

Boolean

If true, then change tracking will ignore changes that only affect the value of the property, and exports of past states and force imports will preserve the current value.

systemObjectName

String

The system object.

taskName

String

The name of the task which owns property sheet.

transitionDefinitionName

String

The name of the transition definition container of the property sheet which owns the property.

transitionName

String

The name of the transition container of the property sheet which owns the property.

triggerName

String

The name of the trigger which owns property sheet.

userName

String

The name of the user container of the property sheet which owns the property.

value

String

The value of the property.

widgetName

String

The name of the widget of the property sheet which owns the property.

workflowDefinitionName

String

The name of the workflow definition container of the property sheet which owns the property.

workflowName

String

The name of the workflow container of the property sheet which owns the property.

workspaceName

String

The name of the workspace container of the property sheet.

zoneName

String

The name of the zone container of the property sheet.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.setProperty(
                propertyName: 'test-propertyName'
                /* optional arguments */)
project
release