CA Agile Central's Eclipse Plugin Installation & User Guide
For developers and testers using the Eclipse framework for application development, the CA Agile Central connector for Eclipse provides access to CA Agile Central artifacts from within the Eclipse interface.
The artifacts (CA Agile Central stories, tasks, and defects) can be viewed or updated, along with viewing and sharing the context of those artifacts through the Mylyn framework, providing a one-stop access to information in CA Agile Central without having to leave the Eclipse IDE.
Mylyn (http://www.eclipse.org/mylyn ) is the task-focused UI for Eclipse that reduces information overload and makes multi-tasking easy. It does this by making tasks a first-class part of Eclipse.
Once your tasks are integrated, Mylyn monitors your work activity to identify information relevant to the task-at-hand, and uses this task context to focus the Eclipse UI on the interesting information, hide the uninteresting, and automatically find what is related.
This install guide includes:
- Software requirements
- Create a CA Agile Central task repository
- Create a query
- View the CA Agile Central dashboard
The following are the software requirements to use the CA Agile Central connector for Eclipse:
Known Limitations: IDP-initiated SSO isn't supported in Eclipse
- Launch Eclipse.
- Be sure Mylyn (3.12 or higher) is installed within Eclipse.
- Inside Eclipse, click the menu option Help → Install New Software...
- Enter the following URL into the Work with: field, and click Add... to create a new task repository:
Create a CA Agile Central task repository
- Launch Eclipse.
- Inside Eclipse, click the menu option Windows → Show View → Other.
- Inside the Mylyn folder, select both Task Repositories and Task List, then click OK to show these views.
- From the Task Repositories window, right-click on Tasks (under Local ) and select Add Task Repository....
- Select CA Agile Central, then click Next .
- Setup password recovery at this point if so desired.
- In the Add Task Repository... window, enter information into the corresponding fields:
- Login Method:,
- User ID: (your full CA Agile Central Username even if using CA Agile Central Single Sign-On),
- Password: (if Login Method is not CA Agile Central Single Sign-On).
- If CA Agile Central Single Sign-On was selected above for the Login Method:, then an SSO login window will appear. Enter your SSO credentials.
Create a query
- On the Task Repositories tab, right-click on the CA Agile Central repository you created and select New Query.
- Select Tasks & Stories, or Defects.
- Select the owner to filter.
- Select the workspace, project, iteration, and owner to display after the query is run.
- Click Finish to create the Query.
View the CA Agile Central Dashboard
- On the Eclipse toolbar, click Open CA Agile Central Dashboard.
- On the CA Agile Central Dashboard tab, select the task repository you would like to query.
- On the CA Agile Central Dashboard tab, select the query you would like to run.
Results will display on the CA Agile Central dashboard.
To create an Open CA Agile Central Dashboard button on the Eclipse toolbar:
- To add a command icon for the plugin, choose Window → Customize Perspective.
- From the Command Groups Availability tab, select the CA Agile Central checkbox.
The icon displays at the top of your environment in the toolbar.
- Error displayed after entering the url in the "work with" line: Unable to read repository at https://help.rallydev.com/integrations/eclipse/update/latest/content.xml.
- Solution: The following link has helped users with this issue in the past: http://www.ibm.com/support/knowledgecenter/SSUS84_22.214.171.124/com.ibm.ram.installguide.doc/topics/t_install_eclipse_https.html
- Currently there is a limitation that the task list can't be sorted by rank, but this problem will resolve once users upgrade to Mylyn 3.19
- When working with Support, you may need to provide a log file for the Eclipse plugin in order to help isolate the root cause. The log files are located in Tasktop application folder.
- If you are using Eclipse, this is in <path to workspace>\.metadata\.log
- Windows Vista and above:
- Windows XP:
- C:\Documents and Settings\\Application Data\Tasktop\workspace\.metadata\.log
- Now built on the Java Toolkit for CA Agile Central and uses WSAPI v2.0 instead of WSAPI 1.16