Release Tracking with Filters

A version the built-in Release Tracking board with additional filters.

Features are plotted into every iteration where that feature has a scheduled story. Iterations across projects are assumed to be the same if they share the same start and end date as the current projet's iterations. Iteration name is explicitly NOT used to work around a query that sometimes causes a timeout with certain data.

Test Plan

List of Features

• PASS - Shows all features in current project
• PASS - Show all features in all projects
• PASS - Milestone filter shows all features in current project
• PASS - Milestone filter shows all features in all projects
• PASS - Ancestor filters shows all features in current project
• PASS - Ancestor filters shows all features in any project
• PASS - Saved views
• PASS - Only plot features with stories
• PASS - Features plotted in all projects that have stories for that feature
• PASS - Story count correct for project
• PASS - Story count is top-level stories
• PASS - accepted count correct for project
• PASS - story list correct for project
• PASS - Story list is top-level stories
• PASS - story dependencies correct for project
• PASS - feature dependencies correct for project
• PASS - List of stories specific to feature
• PASS - List of stories specific to iteration
• PASS - Iterations shown are specific to current project (by name and date)
• PASS - Iterations from current project merged with matching name+dates of other projects
• PASS - Non-timeboxed page shows date range
• Release filtered page
  • PASS - Showns only Features assigned to Release
• Milestone filtered page
  • PASS -Shows only Features directly assigned to selected Milestone (not indirect due to story assigned to milestone)
• Iteration filtered page
  • PASS - Shows only features with stories in selected iteration
  • PASS - Shows "Unscheduled"

Board of features

Development Notes

First Load

If you've just downloaded this from github and you want to do development, you're going to need to have these installed:

• node.js
• grunt-cli
• grunt-init

Since you're getting this from github, we assume you have the command line version of git also installed. If not, go get git.

If you have those three installed, just type this in the root directory here to get set up to develop:

npm install

Structure

• src/javascript: All the JS files saved here will be compiled into the target html file
• src/style: All of the stylesheets saved here will be compiled into the target html file
• test/fast: Fast jasmine tests go here. There should also be a helper file that is loaded first for creating mocks and doing other shortcuts (fastHelper.js) Tests should be in a file named -spec.js
• test/slow: Slow jasmine tests go here. There should also be a helper file that is loaded first for creating mocks and doing other shortcuts (slowHelper.js) Tests should be in a file named -spec.js
• templates: This is where templates that are used to create the production and debug html files live. The advantage of using these templates is that you can configure the behavior of the html around the JS.
• config.json: This file contains the configuration settings necessary to create the debug and production html files. Server is only used for debug, name, className and sdk are used for both.
• package.json: This file lists the dependencies for grunt
• auth.json: This file should NOT be checked in. Create this to run the slow test specs. It should look like: { "username":"you@company.com", "password":"secret" }

Usage of the grunt file

####Tasks

grunt debug

Use grunt debug to create the debug html file. You only need to run this when you have added new files to the src directories.

grunt build

Use grunt build to create the production html file. We still have to copy the html file to a panel to test.

grunt test-fast

Use grunt test-fast to run the Jasmine tests in the fast directory. Typically, the tests in the fast directory are more pure unit tests and do not need to connect to Rally.

grunt test-slow

Use grunt test-slow to run the Jasmine tests in the slow directory. Typically, the tests in the slow directory are more like integration tests in that they require connecting to Rally and interacting with data.

grunt deploy

Use grunt deploy to build the deploy file and then install it into a new page/app in Rally. It will create the page on the Home tab and then add a custom html app to the page. The page will be named using the "name" key in the config.json file (with an asterisk prepended).

You can use the makeauth task to create this file OR construct it by hand. Caution: the makeauth task will delete this file.

The auth.json file must contain the following keys: { "username": "fred@fred.com", "password": "fredfredfred", "server": "https://us1.rallydev.com" }

(Use your username and password, of course.) NOTE: not sure why yet, but this task does not work against the demo environments. Also, .gitignore is configured so that this file does not get committed. Do not commit this file with a password in it!

When the first install is complete, the script will add the ObjectIDs of the page and panel to the auth.json file, so that it looks like this:

{ "username": "fred@fred.com", "password": "fredfredfred", "server": "https://us1.rallydev.com", "pageOid": "5233218186", "panelOid": 5233218188 }

On subsequent installs, the script will write to this same page/app. Remove the pageOid and panelOid lines to install in a new place. CAUTION: Currently, error checking is not enabled, so it will fail silently.

grunt watch

Run this to watch files (js and css). When a file is saved, the task will automatically build, run fast tests, and deploy as shown in the deploy section above.

grunt makeauth

This task will create an auth.json file in the proper format for you. Be careful this will delete any existing auth.json file. See grunt deploy to see the contents and use of this file.

grunt --help

Get a full listing of available targets.