Professional Documents
Culture Documents
User Guide
Document Release Date: May 2011 Software Release Date: May 2011
HP Confidential
Legal Notices
Authorized Use Use is governed by the TEMPLATE SOLUTION END USER LICENSE AGREEMENT included with this package. Confidential Information The contents herein are proprietary to HP and contain HP Confidential Information. The contents may not be disclosed in whole or in part without the express written authorization of HP. Copyright Notices Copyright 2011 Hewlett-Packard Development Company, L.P.
HP Confidential
Documentation Updates
The title page of this document contains the following identifying information: Software Version number, which indicates the software version. Document Release Date, which changes each time the document is updated. Software Release Date, which indicates the release date of this version of the software.
To check for recent updates or to verify that you are using the most recent edition of a document, go to: http://h20230.www2.hp.com/selfsolve/manuals This site requires that you register for an HP Passport and sign-in. To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html Or click the New users - please register link on the HP Passport login page. You will also receive updated or new editions if you subscribe to the appropriate product support service. Contact your HP sales representative for details.
HP Confidential
Support
Visit the HP Software Support web site at: www.hp.com/go/hpsoftwaresupport This Web site provides contact information and details about the products, services, and support that HP Software offers. HP Software online support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by using the support web site to: Search for knowledge documents of interest Submit and track support cases and enhancement requests Download software patches Manage support contracts Look up HP support contacts Review information about available services Enter into discussions with other software customers Research and register for software training
Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html To find more information about access levels, go to: http://h20230.www2.hp.com/new_access_levels.jsp
HP Confidential
Contents
1 Prerequisites......................................................................................7 2 Introduction........................................................................................8 3 Theme: Folder Structure.....................................................................9 4 Theme: User Story Prioritization and Navigation - Not Available in Basic Version and in ALM................................................................11 5 Theme: Create Tasks, User Defined Fields.......................................12 6 Theme: Effort Calculation & Story Points..........................................13 7 Theme: Risk Based Story and Task Management Not Available in Basic Version...................................................................................14 8 Theme: Automatic Testing Time from Functional Complexity Not Available in Basic Version................................................................15 9 Theme: Sprint Team Capacity Not Available in Basic Version...........16 10 Theme: Unit Testing ......................................................................17 11 Integration with JUnit......................................................................20 12 Integration with FitNesse Not Available in Basic Version...............22 13 Continuous Integration with Cruise Control.net Not Available in Basic Version...................................................................................23 14 Integration with Hudson Not Available in Basic Version.................25 15 Theme: Epic Not Available in Basic Version....................................26 16 Theme- Reporting Excel Charts ...................................................27
HP Confidential 5
Sprint Burn down Chart By Effort..............................................................................................27 Sprint Burn down Chart By Story Points Not Available in Basic Version....................................28 Velocity by # of Story Points Not Available in Basic Version.......................................................29 Velocity by # of User Stories Not Available in Basic Version.......................................................30 Team Based Burndown Chart Not Available in Basic Version......................................................30
17 Theme: Converting Defects to Tasks Not Available in Basic Version ........................................................................................................32 18 Theme: Pre-built Views Not Available in Basic Version...................33 19 Theme Security and Agile User Groups Not Available in Basic Version............................................................................................34 20 Theme - Taskboard....................................................................35
HP Confidential
1 Prerequisites
You will need a QC 10.0 instance. Do not delete the existing releases, cycles and requirements in the project as the sample reports are based on this data. If you delete this data you will not be able to see the sample reports. Add these two parameters to Site Config of your QC instance: DISABLE_COMMAND_INTERFACE (set it to N) DISABLE_EXTENDED_STORAGE (set it to N)
HP Confidential
2 Introduction
The QC Agile Accelerator helps Dev and QA teams to implement Agile processes and entities within an organization using HP Quality Center. The main features of the Accelerator are: 1 2 3 4 5 6 7 8 Set up of Agile entities Product, Release, Sprint, User Stories and Tasks. Special user-defined fields for each of the entities. Product Backlog re-prioritization and navigation Effort Calculation & Story Points Super Stories Agile Reports Pre-built Views Teams and Team members Security and Authorization
HP Confidential
Note: Every sprint will have a default user story created called <sprint name>_Tasks_FromDefectsModule. This is the user story that will contain all tasks that are generated from the Defects module. 6 Now we need to create User Stories. User Stories can be created by uploading using Excel add-in or can be created manually. For purposes of demo, we are going to do it manually. Select the Release Backlog Folder requirement created above and click the New Requirement icon. Create at least 3 User story requirements. There is a certain amount of built in fault tolerance in the workflow. Selecting the backlog folder, create one more new requirement and this time choose a Requirement other than User Story requirement in the New requirement dropdown. The workflow auto corrects to create a User Story requirement. This feature guides the user to create the right folder structure. Fill in details about the user story. It will be noticed that the User Story is automatically populated with the following values: Release to which the user story belongs to Highlight the point that the Sprint to which the user story belongs to is Blank since it is now in the Backlog Folder Team that is going to implement the User Story
HP Confidential 9
7 8
Story Points -> This is the weightage for the User Story. Select any value from 1 through 8.
HP Confidential
10
4 Theme: User Story Prioritization and Navigation - Not Available in Basic Version and in ALM
1 We have created 4 User Stories in the above step. Look at the Requirements grid and you will notice that the Position column is automatically filled in with the position of the User Story. The position determines the priority of the User Story. Lower the number higher the priority. In order to move around the User Stories you have 2 options: a b Use the Up and Down Arrows (icons) to move the User Stories within the sprint Use the Order Backlog icon. Click on the icon and enter the position where you want to move the User Story to.
2 3
(IMPORTANT: After navigation the page may not refresh automatically this is a probable issue that is being looked into. To fix this for now, just click on the "Refresh" button manually on the QC screen or just log off and log back in to the project and it will be fine. )
HP Confidential
11
HP Confidential
12
5 6 7
HP Confidential
13
7 Theme: Risk Based Story and Task Management Not Available in Basic Version
User Stories can also be prioritized using Business risk. This helps in working on the high risk tasks first so defects can be uncovered faster by testing them first. 1 2 3 4 5 6 7 Open development Tasks, click on the Risk button on the left panel. Fill out both Risk Assessment (Business Criticality and Failure probability) and Functional Complexity. Once this has been done for all development tasks underneath the User Story, Open the User Story click on Risk button on the left panel. Click on Perform Risk Analysis. Fill out the Total Allocated Testing time based on the number displayed. You can now see how the tasks have been categorized across Business risk. Do not close this window yet.
HP Confidential
14
8 Theme: Automatic Testing Time from Functional Complexity Not Available in Basic Version
1 In the same window above, click on Save and Apply to Children. The testing time generated from the functionally complexity has now been assigned to the dev tasks. Close this window, select a dev task by highlighting it. Now click on the Copy dev task to test task button on the toolbar. A new testing task is created and also notice the estimated effort field is automatically filled from the functional complexity of the development task.
2 3 4
HP Confidential
15
HP Confidential
16
b c
Unit Test case will be generated under the Unit folder of corresponding Sprint in the test plan module. Create Nunit VAPI Script.(In Test Plan Module)
HP Confidential 17
Select the Unit Test case and click on the Nunit VAPI script Creation button.
Provide the Application folder information where the Nunit Test file or Application exe resides.
Provide .nunit or .exe file with extension. VAPI Test Script will be generated and uploaded in the repository. Execute the Nunit VAPI Script. After selecting the Test case, open Test Script Tab in the test plan. Newly generated script will be downloaded to the test script window. Execute the script by clicking on the Execute Script button.
HP Confidential
18
Nunit Tool will execute and the result will appear in the Output window.
HP Confidential
19
Application Name with package name. Input should be like org.junit.samples.SimpleTest. Unit Test case will be generated under the Unit folder of corresponding Sprint in the test plan module. Create JUnit VAPI Script. (In Test Plan Module).
Select the Unit Test case and click on the JUnit VAPI script Creation Button.
HP Confidential
20
Provide the Application folder information where the Junit Test files or where the Application resides. JUnit VAPI Test Script will be generated and uploaded to the QC repository. Execute the JUnit VAPI Script. After selecting the Test case, open Test Script Tab in the test plan. Newly generated Script will be downloaded to the test script window. Execute the script by clicking on Execute Script button.
JUnit Tool will execute and the result will appear in the Output window.
Results: Test result is stored in temporary folder, for example, D:\Documents and Settings\user.r\Local Settings\Temp\UnitTest_junitTest28_11134_325\junitTestresult.
HP Confidential
21
Wiki pages to be tested should be ready. These wikipages are located in FitNesseRoot. Input Parameters: You will now be prompted for: Location of the fitnesse.jar file. Input should be given like D:\Fitnesse. Application Name to be tested like MyTestPage. Results Test result is stored in temporary folder, for example, D:\Documents and Settings\user.r\Local Settings\Temp\UnitTest_FitnesseTest1_11137_333\FitnesseTestresult.
HP Confidential
22
Message box will be displayed to check whether you need to edit configuration file.
If Yes is selected, Configuration file will be displayed and you can make changes on it and the Integration tool will be activated. If No is selected, Cruise Control.net will be invoked. After triggering the Force Build, information will be stored in the Folder configured in CCNet.Config Xml file.
HP Confidential 23
HP Confidential
24
System should be ready with all the prerequisites (like Java, Ant, SVC, etc.) necessary for using Hudson. Install the latest version of Hudson.war file. You can download this file as a zip file from the Internet. Rename it with the command prompt as Hudson.war. Install Hudson.war as windows service on server. Install Hudson-cli on client machine. Set environment variable HUDSON_HOME with
http://
[servername]:portnumber/
Select a Sprint Folder and click on the Continuous Integration with Hudson button, you will be prompted for: a b Location of Hudson-cli in your system. Give the full path with extension .jar like d:\ _hudson-cli.jar. Application Name. Give the Hudson project name. It is located on server in .hudson\jobs.
HP Confidential
25
15 Theme: Epic
1 2
Sometimes user stories need be broken down to smaller stories. A user story that contains smaller user stories is called an Epic. To create an Epic, select Y in the Epic drop-down in a User Story (let us call this user story A). Now new user stories can be created beneath this parent user story. (By default, only tasks can be created beneath user stories.) The Story Points of an Epic is the sum of the story points of its child user stories.
HP Confidential
26
The charts X axis is Date starting from the first day of the sprint till the last day of the sprint. The charts Y axis is # of hours. The chart has 3 lines: a b c Ideal Scenario Effort burn down in the ideal scenario if no change occurs to estimated effort throughout the sprint Actual Effort Actual effort burn down during the sprint Additional Effort added This line reflects any changes to the estimated effort after the start of the sprint
HP Confidential
27
Not Available in
The Sprint Burn down Chart By Story Points has 3 input parameters: a b c Release Name Sprint Name Sprint ID (This is one of the user-defined fields when you open a sprint requirement details dialog)
2 3
The charts X axis is Date starting from the first day of the sprint till the last day of the sprint. The charts Y axis is # of Story Points. The chart has 3 lines: a b c Ideal Scenario Effort burn down in the ideal scenario if no change occurs to estimated effort throughout the sprint Actual Effort Actual story point burn down during the sprint Additional Effort added This line reflects any changes to the estimated # of story points after the start of the sprint
HP Confidential
28
The Velocity Chart by # of Story Points has 1 input parameter: Release ID (This is one of the user-defined fields when you open a Release Folder requirement details dialog)
The chart is bar graph. X axis is Sprint name and the Y axis is # of Story Points accepted or completed per sprint. The Velocity chart by # of Story Points gives an indication of the # of Story Points that the project team can accomplish per sprint and thus helps in future sprint planning.
HP Confidential
29
The Velocity Chart by # of User Stories has 1 input parameter: Release ID (This is one of the user-defined fields when you open a Release Folder requirement details dialog)
The chart is bar graph. X axis is Sprint name and the Y axis is # of User Stories accepted or completed in that sprint. The Velocity chart by # of User Stories gives an indication of the # of User Stories that the project team can accomplish on an average per sprint and thus helps in future sprint planning.
Team based Burndown allows to create burn down charts for the different teams in Agile project thus allowing for a comparative view of the progress across teams. Select the Sprint<#>_Team_Capacity_For _Sprint folder and click on the Sprint Burndown by Effort button.
HP Confidential
30
HP Confidential
31
Not
Defects require time to be fixed. So fixing a defect can be a task that will need its effort estimations to be performed and calculated. Navigate to the Defect module. Create and submit a defect. Selecting the defect in the Grid, click on the Create Tasks from Defects toolbar button. This automatically creates a defect and adds it under the User Story <Sprint name>_Tasks_From_DefectsModule under the corresponding Sprint in the Requirements module. A confirmation message box for the task creation is displayed. Now change the title or the description in the Defect. Click the Create Tasks from Defects toolbar button again. You get a confirmation message that the changed has been synched to the Requirement. A QC link is also created between the defect and the Requirement.
4 5 6 7
HP Confidential
32
HP Confidential
33
19 Theme Security and Agile User Groups Not Available in Basic Version
1 Three special Agile groups are available: a b c 2 3 4 Product Owner (productowner1/<no password>) Scrum Master (scrummaster1/<no password>) Team member (developer1/<no password> or tester1/<no password>)
Users with Admin or Product Owner permissions can create or delete Product, Releases. Users with Admin or Product Owner or Scrum master permissions can create Sprints and User Stories (Scrum masters cannot delete Sprints or User Stories). User with Team member permissions can create Tasks.
HP Confidential
34
20
Theme - Taskboard
1 Taskboard view is a new feature in AA v5.0. Select a Sprint to be open in the Taskboard Interface.
Drag and drop the Task for changing the Task Status. Not Available in Basic Version User can change the Task status by move the task card from one state to Another. We have 4 states for Tasks. Draft, Defined, In Progress and Completed.
Modify User Story and Tasks. Not Available in Basic Version User can modify the user story or task by clicking on the Edit icon on the User Story Task card.
HP Confidential
35
By clicking on the Add User Story button user can create a new User story. Name field is mandatory for the User Story. 5 Add New Task. Not Available in Basic Version
HP Confidential
36
By selecting the Add Task link in the User Story card, New Task can be create under it. 6 Sprint Navigation User can navigate to different Sprint using the Sprint navigation link. After selecting the Sprint navigation link, list of all the Sprints under different releases will be displayed on a panel. User can select required Sprint from this panel list.
Story Summary This link will provide a summary view of all the User stories under selected Sprint.
Show Owner Summary Show Owner summary will give the owner wise Remaining effort, Task status and Progress, etc.
HP Confidential
37
HP Confidential
38