generating use case specification a step-by-step guide for ... · generating use case specification...

Generating Use Case Specification A step-by-step guide for Training Scenario 2

Generating Use Case Specification (Scenario 2)

TABLE OF CONTENTS

Introduction ................................................................................................................................................................... 2

Creating Requirements textually using Visual Studio Online ........................................................................................ 3

Designing Visio Diagram and linking Requirements using SmartVisio4TFS ................................................................... 7

Step1: Connecting with Team Project ....................................................................................................................... 7

Step2: creating/linking Work Items with shapes and connectors ............................................................................. 7

Step3: Detecting Scenarios ...................................................................................................................................... 12

Step4: Detecting and Publishing Use Cases ............................................................................................................. 13

Step5: Detecting and publishing Test Cases ............................................................................................................ 16

Reporting using Customized EY Templates ................................................................................................................. 18

Copy right © 2015: Modern Requirements All rights reserved Page 1 of 19


INTRODUCTION

Generating Use Case Specification guide demonstrates how to create Use Case Specification document that can be generated using inteGREAT Portal, SmartVisio4TS and SmartWord4TFS. Step-by-step approach is taken to explain what to do, in order to model the Visio Diagram, identify requirements, detect scenarios Use Cases and Test Cases and finally generate that particular document. During the course of this guide we would be working on the following Visio Diagram (in Step2).

In Step 1 we start by creating our requirements (Business, Functional, Non Functional, Use Cases etc.) using Visual Studio Online.

Step2 deals with creating Linked Work Items that automatically link to selected Visio Diagram element. It also shows the process to link existing Work Items (created in Step 1) with diagram shapes/connectors.

Step3 elaborates how to detect scenarios and publish them on Team Project.

Step4 describes the process to detect and publish Use Cases.

Step5 shows how we can detect and publish Test Cases.

The last section describes how to use SmartWord4TFS to extract all the information that we created in above steps and update the Use Case Specification document that we originally created in Scenario 1.

Although the steps of this guide seem similar to that of the Scenario 1 guide however we take a different approach in this scenario as we start modeling our requirements textually in Visual Studio Online and then complete the modeling process in SmartVisio.



CREATING REQUIREMENTS TEXTUALLY USING VISUAL STUDIO ONLINE

1. Log into your Visual Studio Online account and navigate to the desired Team Project. 2. Click the Backlog link on the project’s home page.

3. Select the hierarchical view to get all types of Requirements (Business, Functional, Non-Functional, and

Use Cases) displayed.



4. Select the Business Requirement (at the top) and click the “+” sign besides it to create a child Use Case

Work Item.

5. Set the following properties of the Use Case:

• Name • Pre Condition • Post Condition



The Use Case is created as per given information.

6. Now repeat the process this time with the use case creating Functional and Non Functional Requirement

Work Items under the Use Case.



The non-hierarchical Backlog page (that shows only one type of Work Items) can be used to prioritize the requirements by moving them to the desired place using drag-and-drop. It can also be used to create new Work Items of the relevant type.

The Board page shows the states of Work Items and these states can be altered by moving respective Work Item from one state’s column to another. New columns can also be added if desired.



DESIGNING VISIO DIAGRAM AND LINKING REQUIREMENTS USING SMARTVISIO4TFS

STEP1: CONNECTING WITH TEAM PROJECT

1. Create/open the desired Visio drawing and connect to the relevant Team Project using the process described in Scenario 1 guide.

On successful connection; the Smart Panel appears at the right side of the window.

STEP2: CREATING/LINKING WORK ITEMS WITH SHAPES AND CONNECTORS

1. Click the Link to.. Tab in Smart Panel.



2. Enter relevant query info and click the Find Button.

3. Select the Use case Work Item (that we created in Visual Studio Online) and click the OK Button.



The Visio Diagram’s page is linked with our Use Case Work Item. Since we created (in Visual Studio Online) two requirements (Functional & Non Functional) as the child of our Use Case, these two also appear in SmartVisio.

4. Similarly link the shapes and connectors in the diagram with Work Items created in Visual Studio online. 5. Create new Linked Work Items (using the Links Tab in Smart Panel) in case they do not currently exist.



New Work Items can also be created using Bulk Add option.

All the Work Items linked with the shapes/connectors of the diagram are created as child of the original Use Case Work Item that we created in Visual Studio Online and linked with the Visio Diagram’s Page.



6. Click on the Show State Overlay option in the Ribbon Bar.

All the shapes and connectors (that are linked with Work Items) are shown in color. This option also tells the state of the Work Item as different colors are used to denote different states. This could help users in determining impact assessment and gap analysis.



STEP3: DETECTING SCENARIOS

1. Click Scenarios Tab in Smart Panel.

All the scenarios are automatically detected and listed. The selected scenario is highlighted with green colored path in the diagram.



STEP4: DETECTING AND PUBLISHING USE CASES

1. Click the Use Case Tab in the Smart Panel.

All the Use Cases are automatically detected and listed. The selected Use Cases is highlighted with blue colored path in the diagram.

2. Change Primary flow from the detected paths list (if desired).



3. Update the name of the paths.

4. Give a suitable title to the selected Use Case and click the small button besides the title text box.



5. Enable the Use case in description check box and then click the Publish Button.

This publishes all the information (related to the selected Use Case Path) as the description of the Use Case Work Item, linked with the drilled down page of the Visio diagram (shown in the following image).

6. Repeat the process to publish all the desired Use cases.



STEP5: DETECTING AND PUBLISHING TEST CASES

1. Click Test Cases Tab in the Smart Panel.

All the Test Cases are automatically detected and listed. The selected Test Cases are highlighted with orange colored path in the diagram.



2. Edit the name of the selected Test Case and click the Publish Button.

3. Repeat the process with all the desired Test Cases that are required to be published.

This completes the authoring part of this training. Next we would carry out the reporting part to bring out all our efforts in the shape of customized EY Templates.



REPORTING USING CUSTOMIZED EY TEMPLATES

1. Open the template used in Scenario 1.

2. Click the Refresh option in the Ribbon Bar.



The template is updated with all the information that we created/published in Visual Studio Online and SmartVisio4TFS.

This template supports bi-directional information transfer with the connected team project. Therefore if we update any information then clicking the Refresh option would update the information on Team Project as well.

This completes our step-by-step guide to create/update the Use Case Report using Scenario 2.


generating use case specification a step-by-step guide for ... · generating use case specification...

Documents