Forums for the Business Analyst

 
  Modern Analyst Forums  Business and Sy...  Requirements  How would you write this requirement?
Previous Previous
 
Next Disabled
New Post 10/24/2018 11:28 AM
User is offline prasad
3 posts
No Ranking


How would you write this requirement? 
Modified By Chris Adams  on 10/24/2018 1:51:04 PM)

I am not sure how to write below requirements related to complex screen. So many details given below I want to include in requirements and I am confused whether we need to write each and every detail in requirement. However, before going through the requirements mentioned below, please check the screen for which requirements need to be written: https://ibb.co/dYTZOA

1.            When this screen loads, all the cities and towns,under the recording jurisdictioncorresponding to “Town Level” link, should get displayed in alphabetical order under the heading “Recording Jurisdiction”.

2.            Each recording jurisdiction should have corresponding research link icon placed beside phone number under “Taxes” content type, if at least one website with the content type as “Taxes” is associated with the recording jurisdiction.

3.            Each recording jurisdiction should have corresponding research link icon placed beside phone number under “Assessment” content type,if at least one website with the content type as “Assessment” is associated with the recording jurisdiction.

4.            Click on research link icon should open a window named “Primary sites- Taxes & Assessment” as a pop-up.

 

5.            When the user clicks on the phone icon, a separate window should be displayed to enable the user to report BAD phone numbers.

6.            On top right corner of this screen, two links should be displayed :

7.            New Search – When this link is clicked, user should getredirected to “Online Research” screen.

 

b.            Site Suggestion- Click on this link should open “Site Suggestion” window as a pop-up.

 

 

 

 
New Post 10/24/2018 1:13 PM
User is offline Chris Adams
310 posts
5th Level Poster






Re: How would you write this requirement? 

Hi Prasad,

You are mixing things here beyond simple requirements.  First, understand that requirements are not just textual statements. They can be models that communicate the user need as well.  Ultimately your requirements should explain WHAT the application is intended to do, not so much HOW it should do it.  So, WHAT are the goals of the user, which leads to WHAT the application should accomplish to deliver value to the user.

You wrote: When the user clicks on the phone icon, a separate window should be displayed to enable the user to report BAD phone numbers.

The requirement is: The user shall be able to report bad phone numbers.  

HOW the screen is designed or structured to achieve this (phone icons, pop-ups, etc) is a design decision that should be decoupled from your requirement. The HOW usually occurs after the requirements are documented (and is determined by a UX designer, though BA can do this role if they are skilled or if it is required because the team is small). 

Documenting the information or data inputs required to meet the user goal is part of the requirements, but I would capture the detailed data requirements separately and only reference data at an aggregate level.  

For instance, you mentioned a search feature. I'm not sure I understand what you are trying to search but I'll invent a requirement here for you as an example.

Requirement: The system shall provide search capability which receives Customer Address data as input and returns Jurisdiction as output.

You can then define WHAT "Customer Address" data is separately (Name, Address Line One, Address Line Two, State, Country, Zip Code). You can also define the rules of the search by creating test cases which validate that your requirement is correctly implemented. 

Test Cases for Search:

1) IF any of the following are missing: State, Country, Zip Code, THEN the system shall create an error notification which reads "The following data is missing..."

2) IF two jurisdictions are available THEN ...

Hopefully you get the idea.

In all of these cases, I haven't referenced anything about how the screen will look or where the data will be presented. That's UI/UX design.  These feature may occur on 1 screen or multiple screens. Inputs could be input into text fields or selected from dropdowns, etc..

So remember, keep the requirements decoupled and separate. They describe WHAT goal or value the system provides to the user.


Chris Adams
Core Member – ModernAnalyst.com
LinkedIn Profile
 
Previous Previous
 
Next Disabled
  Modern Analyst Forums  Business and Sy...  Requirements  How would you write this requirement?

Community Blog - Latest Posts

Ekaterina Barabash
Ekaterina Barabash
I address my thoughts to those who are in IT management for whom the terms such as quality of project implementation development and profitability indicators of the company are important.  And it is also addressed to business analysts whose daily routine is the process of communication with Customer. A little about myself first. The last 8...
0 Responses
Dan Tasker
Dan Tasker
I have long been a believer in the saying “Context is everything.” As a business analyst dealing with business users, understanding the context of the topic of discussion is essential. In thinking about what constitutes quality requirements it occurred to me that there are a number of additional contexts that play a role. Examples inclu...
0 Responses
Alexey Kiselev
Alexey Kiselev
We are writing User Stories to fix the scope and describe - what our application should do when implemented.User Stories are great, because the are: Short, Defining Roles, A great connection of the requirement itself and a business need. User Story declared as a high level definition of the requirement, but it could be used to s...
0 Responses




Latest Articles

Demystifying Strategic Thinking in Business Analysis
Nov 12, 2018
1 Comments
One of my former business analysts on the team asked me this question recently; ‘I am really over being a BA. How do I move into strategy?&rsquo...
Featured Digital Library Resources 
Copyright 2006-2018 by Modern Analyst Media LLC