Using the Perl API
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
IntroductionExamplesTroubleshooting
IntroductionaccesstokenaclaclentryactualparameteractualparametersapplicationapplicationdependencyapplicationtierarchiveconnectorartifactartifactversioncatalogcatalogitemcatalogitemruncibuildcibuilddetailciconfigurationcieventclustercomponentcredentialcredentialproviderdashboarddashboardcolumndataretentionpolicydeployerapplicationdeployerconfigurationdeploymenthistoryitemdevopsinsightdatasourcedirectoryprovideremailconfigemailnotifierentitychangeenvironmentenvironmentinventoryitemenvironmenttemplateenvironmenttemplatetierenvironmenttemplatetiermapenvironmenttemplatetiermappingenvironmenttierenvtempltierresourcetemplmappingeventsubscriptionflowruntimeformaloutputparameterformalparametergategatewaygrouphookjobjobstepkerberoskeytablicensemicroservicemicroservicemappingnoteobjectopenidconnectconfigurationoutputparameterpersonapersonacategorypersonapagepipelinepluginplugincatalogpluginconfigurationprocedureprocedurestepprocessprocessdependencyprocessstepprojectpropertyreleasereportreportingfilterreportobjectassociationreportobjectattributereportobjecttyperepositoryreservationresourceresourcepoolresourcetemplateresourceusageretrievedartifactsrollingdeployphaserundiscoverysamlidentityprovidersamlserviceproviderschedulescmsyncsearchfilterserverserversettingserversettingcategoryserviceaccountsessionsnapshotstagestatestatedefinitiontagtasktiermaptiermappingtransitiontransitiondefinitiontriggertriggererrordetailuseruseremailutilityresourcewaitdependencywebhookresultwidgetwidgetfilteroverrideworkflowworkflowdefinitionworkitemworkspacezoneArgument models

Widget

4 minute readReference

createWidget

Create a new widget.

Arguments

Argument Name Type Description

projectName

String

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

dashboardName

String

Unique name of the dashboard within the project. (Required)

widgetName

String

The name of the dashboard widget. (Required)

actualParameters

ActualParameter array

Actual parameter values for the parameters defined on the widget’s report.

afterWidget

String

The name of the widget after which this widget should be placed.

attributeDataTypes

AttributeDataType array

Widget parameters used by UI to control data types of attributes

attributePaths

AttributePath array

Widget parameters used by UI to control paths of attributes

beforeWidget

String

The name of the widget before which this widget should be placed.

colorRanges

String

The JSON with color ranges definition for the widget.

colors

Color array

Color map used when rendering the widget. The usage of the color map depends on the widget’s visualization type.

column

String

The column in a COMMAND_CENTER dashboard that the widget belongs to. Required for a COMMAND_CENTER dashboard widget unless the widget section is 'SUMMARY' in which case it is not applicable.

description

String

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

iconUrl

String

The icon to display for the widget.

linkParameters

LinkParameter array

Widget parameters used by UI to construct the drill-down link for the widget.

linkTarget

String

Determines the page to navigate to when the user drills down through the dashboard widget.

orderIndex

Integer

Specifies the relative display order for the widget

reportName

String

Name of an existing report backing the widget

reportProjectName

String

Set if the report is in a different project than the dashboard.

section

String

The section of a COMMAND_CENTER dashboard to display the widget in. Applicable for a COMMAND_CENTER dashboard widget.

title

String

The title to display for the widget. If not set, use the report title.

visualization

String

Type of visualization data in the widget.

visualizationProperties

 
  array
#

Properties or settings used by the widget’s visualization type.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.createWidget(
                projectName: 'test-projectName',
                dashboardName: 'test-dashboardName',
                widgetName: 'test-widgetName'
                /* optional arguments */)

deleteWidget

Delete a widget.

Arguments

Argument Name Type Description

projectName

String

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

dashboardName

String

Unique name of the dashboard within the project. (Required)

widgetName

String

The name of the dashboard widget. (Required)

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.deleteWidget(
                projectName: 'test-projectName',
                dashboardName: 'test-dashboardName',
                widgetName: 'test-widgetName')

getWidget

Retrieve a dashboard widget by name.

Arguments

Argument Name Type Description

projectName

String

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

dashboardName

String

Unique name of the dashboard within the project. (Required)

widgetName

String

The name of the dashboard widget. (Required)

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.getWidget(
                projectName: 'test-projectName',
                dashboardName: 'test-dashboardName',
                widgetName: 'test-widgetName')

getWidgets

Retrieve all dashboard widgets for dashboard.

Arguments

Argument Name Type Description

projectName

String

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

dashboardName

String

Unique name of the dashboard within the project. (Required)

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.getWidgets(
                projectName: 'test-projectName',
                dashboardName: 'test-dashboardName')

modifyWidget

Modify a widget.

Arguments

Argument Name Type Description

projectName

String

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

dashboardName

String

Unique name of the dashboard within the project. (Required)

widgetName

String

The name of the dashboard widget. (Required)

actualParameters

ActualParameter array

Actual parameter values for the parameters defined on the widget’s report.

afterWidget

String

The name of the widget after which this widget should be placed.

attributeDataTypes

AttributeDataType array

Widget parameters used by UI to control data types of attributes

attributePaths

AttributePath array

Widget parameters used by UI to control paths of attributes

beforeWidget

String

The name of the widget before which this widget should be placed.

clearAttributeDataTypes

Boolean

Whether or not to clear attribute data types for the widget.

clearAttributePaths

Boolean

Whether or not to clear attribute paths for the widget.

clearColors

Boolean

Whether or not to clear color for the widget.

clearLinkParameters

Boolean

Whether or not to clear link parameters for the widget.

clearVisualizationProperties

Boolean

Whether or not to clear visualization properties for the widget.

colorRanges

String

The JSON with color ranges definition for the widget.

colors

Color array

Color map used when rendering the widget. The usage of the color map depends on the widget’s visualization type.

column

String

The column in a COMMAND_CENTER dashboard that the widget belongs to. Required for a COMMAND_CENTER dashboard widget unless the widget section is 'SUMMARY' in which case it is not applicable.

description

String

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

iconUrl

String

The icon to display for the widget.

linkParameters

LinkParameter array

Widget parameters used by UI to construct the drill-down link for the widget.

linkTarget

String

Determines the page to navigate to when the user drills down through the dashboard widget.

newName

String

New name for an existing object that is being renamed.

orderIndex

Integer

Specifies the relative display order for the widget

reportName

String

Name of an existing report backing the widget

reportProjectName

String

Set if the report is in a different project than the dashboard.

section

String

The section of a COMMAND_CENTER dashboard to display the widget in. Applicable for a COMMAND_CENTER dashboard widget.

title

String

The title to display for the widget. If not set, use the report title.

visualization

String

Type of visualization data in the widget.

visualizationProperties

 
  array
#

Properties or settings used by the widget’s visualization type.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.modifyWidget(
                projectName: 'test-projectName',
                dashboardName: 'test-dashboardName',
                widgetName: 'test-widgetName'
                /* optional arguments */)

moveWidget

Move a widget within a dashboard.

Arguments

Argument Name Type Description

projectName

String

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

dashboardName

String

Unique name of the dashboard within the project. (Required)

widgetName

String

The name of the dashboard widget. (Required)

beforeWidget

String

The name of the widget before which the widget should be placed. Blank to move the widget to the last position in the specified section or phase.

column

String

The column in a COMMAND_CENTER dashboard to display the widget in. Applicable only for COMMAND_CENTER type of dashboard.

section

String

The section of a dashboard to display the widget in. Applicable only for COMMAND_CENTER type of dashboard. Required if column is not set.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.moveWidget(
                projectName: 'test-projectName',
                dashboardName: 'test-dashboardName',
                widgetName: 'test-widgetName'
                /* optional arguments */)
webhookresult
widgetfilteroverride