Rally Task Tracking

With its strategic acquisition of Rally, CA Technologies provides proven way to help customers adopt agile, while maintaining visibility into agile teams’ business deliverables and resources. DATASTAR provides an integrated solution so that version control commits can be associated with tasks and user stories. Once this association has been created it can be used to create deployments centered around your user stories.

Create Repository

The CA Agile Central data model has a SCMRepository object. Every changeset object created in CA Agile Central is associated to one of these SCM Repository objects. Therefor you must create one of these to represent your GIT repository (note this is not an actual GIT repository, it's just an internal object that represents the external GIT repository that you are using).

There is not a place in the CA Agile Central GUI to view a list of your SCM Repositories. To do so, go here and select the Query button. At the time of writing the SCM Repository can only be created using the Web service interface, however this is a one time setup step and can be created following the steps below:

1. Get Security Token

Submit a GET request to URL: https://rally1.rallydev.com/slm/webservice/v2.0/security/authorize

Note: you will need to authenticate using your Rally username and password or API Key.

The response will include the token that will be used in the next step:

{"OperationResult": {"rallyAPIMajor": "2", "rallyAPIMinor": "0", "Errors": [], "Warnings": [], "SecurityToken": "73bd3465-...."}}

2. Create SCM Repository

Submit a POST request to URL: https://rally1.rallydev.com/slm/webservice/v2.0/scmrepository/create

Note: you will need to append the session key from the first step to the URL, for example:

https://rally1.rallydev.com/slm/webservice/v2.0/scmrepository/create?key=73bd3465-....

The body of the POST request must contain a valid JSON string with the details of the repository:

{"SCMRepository":{
    "Name":"DataStar",
    "Description":"DataStar Git Repository",
    "SCMType":"Git",
    "Uri":"https://gitlab.com/absolute.technology/datastar",
    "Projects":{"Project":"/project/12527515559"}}
}

The attributes above are shown for example, you will need to set these to values that make sense for your environment. Notice that SCM Repository object has attribute Projects which is a collection of projects, hence this syntax: "Projects":{"Project":"/project/12527515559"}}

You can obtain your project id's using the following query:

https://rally1.rallydev.com/slm/webservice/v2.0/project?query=(Name="Sample Project")&fetch=ObjectID

Connect to Rally

If you have specified a GIT repository as your Version Control System, the Project Tracking option will be enabled in the Version Control menu ribbon group:

1563737940945

Clicking on this button will bring up the Task Tracking Connection dialog where you can select "RALLY" from the drop down, this will being up the dialog:

1563738157749

The RALLY connection supports the following authentication mechanisms:

  • API Key
  • Single Signon - Rally's current SSO implementation is based on the SAML specification which requires a user to interact with a browser to complete authentication.
  • Username / Password

Once connected the Rally icon will be displayed in the status bar on the bottom right of the main window.