Rally

4 minute readExtensibilityDeveloper productivity

The EC-Rally plugin enables you to create, read, update, delete and query Rally objects. This plugin also links to a new report that contains information from the Rally server about what was linked, updated, or created.

The plugin interact with Rally API using PERL and JSON to perform the following tasks:

  • Create configuration to hold connection information.

  • Query for objects information.

  • Create, read, delete, and update objects.

More information can be found at Rally Software website. Check out the Rally API at Documentation.

Plugin Version 1.1.3.2020102201 Revised on January 9, 2019

Integrated version

This plugin was developed and tested against version Rally Community Edition - Build 2012.03.24-3

Plugin procedures

For all parameter descriptions below, required parameters are shown in bold italics.

Plugin configuration

Plugin configurations are sets of parameters that apply across some or all of the plugin’s procedures. They are intended to reduce repetition of common values, create predefined sets of parameters for end users, and to securely store credentials where needed. Each configuration is given a unique name that is entered in designated parameters on procedures that use them.

Navigate to Administration Plugins, find EC-Rally, and select Configure.

ParameterDescription

Configuration Name

Provide a unique name for the configuration, keeping in mind that you may need to create additional configurations over time. (Required)

Description

Provide a simple description for this configuration.

Rally Url

Provide the host name or IP address of the Rally server. (Required)

Configuration Credential Parameters

Rally account username/password or API key name/API key. This credential must have enough privileges to perform API functions.

Debug Level

Level for output: 0=errors only, 1=normal headers and responses, 2+=debugging information included. (Required)

API version

API version to use. (Required)

CreateObject

This procedure allows you to create a new Object on Rally server.

ParameterDescription

Configuration

The name of the configuration which holds all the connection information for Rally. This must reference a valid existing configuration. (Required)

Object Type

Provide the object type to perform the create operation. (Required)

JSON

Provide the JSON structure of the object to create. (Required)

ReadObject

This procedure allows you to read an Object on Rally server, and return the json.

ParameterDescription

Configuration

The name of the configuration which holds all the connection information for Rally. This must reference a valid existing configuration. (Required)

Object Type

Provide the object type to perform the read operation. (Required)

Use FormattedID?:

If selected, specify the FormattedID in the next field, if not selected, use ObjectID.

ID

Provide the ID of the object (e.g. DE1057 or 205918369687). (Required)

UpdateObject

This procedure allows you to update an existing Object on Rally server.

ParameterDescription

Configuration

The name of the configuration which holds all the connection information for Rally. This must reference a valid existing configuration. (Required)

Object Type

Provide the object type to perform the update operation. (Required)

Use FormattedID?:

If selected, specify the FormattedID in the next field, if not selected, use ObjectID.

ID

Provide the ID of the object (e.g. DE1057 or 205918369687). (Required)

JSON

Provide the JSON structure with the attributes of the object to update. (Required)

DeleteObject

This procedure allows you to delete an existing Object on Rally server.

ParameterDescription

Configuration

The name of the configuration which holds all the connection information for Rally. This must reference a valid existing configuration. (Required)

Object Type

Provide the object type to perform the delete operation. (Required)

Use FormattedID?:

If selected, specify the FormattedID in the next field, if not selected, use ObjectID.

ID

Provide the ID of the object (e.g. DE1057 or 205918369687). (Required)

QueryObject

This procedure allows you to Query for objects on Rally server.

ParameterDescription

Configuration

The name of the configuration which holds all the connection information for Rally. This must reference a valid existing configuration. (Required)

Fetch Full Object?

Fecth the complete json structure of the object.

Object Type

Provide the object type to query the create operation. (Required)

Order by

Provide the Attribute to order the results. (e.g. Priority desc,Severity)

Page Size

Page size for results. Must be greater than 0 and not more than 100, default is 20.

Query

A query string (e.g. Name contains "foo") and (TargetBuild = "12345", (Description contains "baz"))

Start Index

Start index (1-based) for queries. The default is 1.

Workspace URL:

If not present, then the query will run in the user’s default workspace. If present, this should be the REST URL of the workspace the user wants to search in. (e.g. https://community.rallydev.com/slm/webservice/1.31/workspace/2077)

Project URL:

If not set, or specified as "null" then the "parent project" in the given workspace is used. If set, this should be the REST URI of the project. You may omit the "Workspace URL" parameter because the workspace will be inherited from the project. (e.g. https://community.rallydev.com/slm/webservice/1.31/project/2078)

Project Scope Up:

In addition to the specified project, include projects above the specified one. (Default is true)

Project Scope Down:

In addition to the specified project, include child projects below the current one. (Default is true)

Examples and use cases

Create a task

Create a new CreateObject procedure, fill in the requested parameters with real values from your Rally server:

CreateObject job:

CreateObject output:

Update a defect

Create a new UpdateObject procedure, fill in the requested parameters with real values from your Rally server:

UpdateObject output:

Query for open defects

Create a new QueryObject procedure, fill in the requested parameters with real values from your Rally server:

QueryObject job:

Release notes

EC-Rally 1.1.3

  • The documentation has been migrated to the main documentation site.

EC-Rally 1.1.2

  • The plugin icon has been updated.

EC-Rally 1.1.1

  • Fixed issue with configurations being cached for IE.

  • Support API keys authorization.

EC-Rally 1.1.0

  • Enable support for Rally API V2.0 (JSON)

  • Remove need for shared directory with agent (agent/lib) directory

  • Minimum Commander Server version is now 4.2

EC-Rally 1.0.2

  • Added utf-8 support.

EC-Rally 1.0.1

  • Procedure name(s) were changed in the step picker section

EC-Rally 1.0.0

  • Configuration Management.

  • Procedures: CreateObject, ReadObject, UpdateObject, DeleteObject and QueryObject.

  • Implemented XML parameter panel

  • Created help page.

  • Added procedures to StepPicker.