Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

Re 2

Download as pdf or txt
Download as pdf or txt
You are on page 1of 220

BCS

Requirements
Engineering
BCS Certificate in
Requirements Engineering
RE-2 v7.6
Contents
How to use this workbook ........................................................................3
Introduction ..............................................................................................5
Module 1 – Requirements Engineering in Context ............................... 12
Module 2 – Requirements Stakeholders and Elicitation ....................... 42
Module 3 – Organising and Analysing Requirements .......................... 88
Module 4 – Use of Models in Requirements Engineering .................. 126
Module 5 – Requirements Documentation ......................................... 165
Module 6 – Requirements Validation and Management .................... 189
Examination Hints and Tips ................................................................ 206
Answers to Post Tests ........................................................................ 213

2
How to use this workbook
Activity
Alongside this icon you will find details of the group/
individual activity or a point for everyone to discuss.

Definition
Where a word with a very specific definition (or one that
could be described as jargon) is introduced this will
highlight that a definition is provided.

Exam tips
This icon indicates an examinable technique or will highlight
information that you may find useful in the exam.

Expansion materials
This manual contains examinable materials. The QA++
symbol contains further information. Skip over these during
class. They are not needed for the examination.

Glossary
Definition of a term.

Helpful hint
This icon guides you to tips or hints that will help you avoid
the standard pitfalls that await the unwary practitioner or to
show you how you might increase your effectiveness or
efficiency in practising what you have learnt.

3
Important idea or concept
Generally this icon is used to draw your attention to ideas
that you need to understand by this point in the course. Let
your trainer know if you do not understand or see the
relevance of this idea or concept.

Key point
This icon is used to indicate something that practitioners in
this field should know. It is likely to be one of the major
things to remember from the course, so check you do
understand these key points.

Reference material
When we have only touched briefly on a topic this icon
highlights where to look for additional information on the
subject. It may also be used to draw your attention to
International or National Standards or Web addresses that
have interesting collections of information.

Reinforcement
From time to time, there will be places within the course
where it is useful for you to reinforce your understanding.
This might be in the form of a question to ponder or a short
end-of-module test.

Useful tool
This icon indicates a technique that will help you put what
you have learnt into action.

Warning
This icon is used to point out important information that may
affect you and your use of the product or service in
question.

4
Introduction
Welcome to QA’s Requirements Engineering course. During the next
few days, you will learn the skills, techniques and knowledge
required to attempt the BCS examination in this subject. Full details
of the syllabus are at:

http://certifications.bcs.org/upload/pdf/ba-re-syllabus.pdf

Course Administration
Before we begin the course, your instructor needs to take you
through a number of administrative points as shown below.

5
BCS Course Objectives
Holders of the BCS Certificate in Requirements Engineering should
be able to:

• Explain the importance of linking requirements to the Business


Case
• Describe the roles and responsibilities of key stakeholders in the
requirements engineering process
• Explain the use of a range of requirements elicitation techniques
and the relevance of the techniques to business situations
• Analyse, prioritise and organise elicited requirements
• Document requirements
• Identify problems with requirements and explain how
requirements documentation may be improved
• Create a model of the features required from a system
• Interpret a model of the data requirements for an information
system
• Describe the principles of Requirements Management and
explain the importance of managing requirements
• Describe the use of tools to support Requirements Engineering
• Explain the process and stakeholders involved in Requirements
Validation

6
BCS Requirements Engineering Exam

•1-1.5 pages •Course manual •No writing


•Includes some •Notes •No highlighting
requirements •Exercises •No applying or
•Solutions moving sticky
tabs
15 minutes’
Case study Open book
reading time

•50 marks •Read these first •All delegates


available •Answers must produce
•A minute per specific to the photo ID before
mark case study the exam (BCS’
•50% to pass •Be concise rules)
60 minutes’ 4 or 5
Photo ID
writing time questions

7
BCS Business Analysis Diploma

Knowledge-based Practitioner
Core
Specialism Specialism

Business Analysis Commercial Modelling Business


Practice Awareness Processes

Requirements Foundation Systems Modelling


Engineering Certificate in IS Techniques
Project Management

Foundation Systems
Certificate in Development
Business Analysis Essentials

Foundation Benefits Management


Certificate in and Business
Business Change Acceptance

Both of the above 1 of the above and 1 of the above


plus

8
BCS Oral Examination

An Oral
Examination is • Can be booked once all required written
required to exams have been passed
complete the
Solution • Must be taken within 12 months of the
Development or written notification of passing the final
Business Analysis exam
Diploma

• Questions range over the latest BCS


2 BCS syllabus for the relevant oral exam
• Each Oral has its own syllabus, and so
Examiners, 50 may cover topics additional to those
minute interview covered in the written examination
modules taken **

Review BCS • Review the 'Candidate Guidelines'


'Candidate available from the BCS covering the Oral
Guidelines' Examinations

• Attendance at a Preparation Workshop


Oral Preparation covering all the relevant syllabus topics
Workshops from an 'oral examination' perspective is
recommended, but not mandatory

** see the candidate guidelines and syllabus on the BCS website

9
Recommended Reading References
Title: Business Analysis (3rd Edition)

Author: Debra Paul, Donald Yeates and James Cadle

Publisher: BCS

Publication Date: 2014

ISBN: 9781780172774

URL: http://shop.bcs.org

Title: Mastering the Requirements Process

Author: Suzanne Robertson and James Robertson

Publisher: Addison Wesley

Publication Date: 1999

ISBN: 978-0201360462

Title: Writing Effective Use Cases

Author: Alistair Cockburn

Publisher: Addison-Wesley

Publication Date: October 2000

ISBN: 0201702258

10
Title: User Stories Applied: For Agile Software Development

Author: Mike Cohn

Publisher: Addison Wesley

Publication Date: March 2004

ISBN: 9780321205681

Title: Requirements Engineering: Processes and Techniques

Author: Gerald Kotonya and Ian Sommerville

Publisher: John Wiley & Sons

Publication Date: April 1998

ISBN: 0471972088

Also see the RE syllabus for further and recommended reading.

11
Module 1: Requirements Engineering in Context

Module 1 – Requirements
Engineering in Context
Topics
In this section of the course, we will cover:

• A rationale for Requirements Engineering


• Problems with Requirements
• Requirements and the Business Case/ToR/PID
• Importance of Requirements planning and estimating
• A framework for Requirements Engineering

12
Module 1: Requirements Engineering in Context

What do you think?


How would you define ‘Requirement’?

13
Module 1: Requirements Engineering in Context

What is a Requirement?
Note that the following definitions cover both the user and the
developer viewpoint.

IEEE (Standard Glossary, 610.12-1990)


“A condition or capability:

• Needed by a user to solve a problem or achieve an objective that


must be met by a system or system component to satisfy a
contract, standard, specification or other formally imposed
document
• A documented representation of a condition or capability”

BCS ‘Business Analysis’ Glossary definition


“A feature that the business users needs the new system (business
or IT) to provide”

Sommerville and Sawyer


“… a specification of what should be implemented. Descriptions of
how the system should behave, or of a system property or attribute.
May be a constraint on the development process”.

Ian Sommerville and Pete Sawyer, Requirements Engineering: A


Good Practice Guide (Wiley 1997)

14
Module 1: Requirements Engineering in Context

Requirements and Business as Usual (BaU)

The Business Change is intended to be supported by the IT system


or solution created by the project.

In this course we will focus on the IT requirements that make up the


IT system, which support the business, people, and processes in
Business as Usual (BaU).

The diagram above shows that the requirements are central to


successfully moving the business from an as-is state to the future
state, or to-be.

Requirements are not related solely to a project, they reflect the


overall needs of the business and must be implemented, via the IT
solution, in a way that supports the business and addresses the
issues they were experiencing.

The change (the resolution of whatever issue is being addressed)


itself is facilitated by the project, which temporarily takes it away from

15
Module 1: Requirements Engineering in Context

business as usual for the duration of the project, however long this
may be.

As the project progresses, the business is still moving towards its


business objectives and strategic goals, which could change and
impact project scope and budget. It is important therefore to ensure
that these business objectives are kept in sight, reviewed and that
the requirements are clearly linked to them.

Not every set of requirements is relevant to an IT system or new


software requirements.

Remember too that there can be multiple change projects arising


from the need to resolve a business issue and therefore many links
back to business objectives.

16
Module 1: Requirements Engineering in Context

Origin of Requirements
Businesses are constantly changing and are faced with new threats
and new problems, demand from the customers and fresh
opportunities.

Requirements come from a need to address an issue within the


current business environment.

They can come from pretty much anywhere but typically arise due to:

• Business Changes
o Operational changes
o Business process changes
• Strategic Changes
o These are covered in the Business Analysis Practice course
• New business, products, business rules or regulations
• Opportunities for improvement, enhancements etc.

Requirements will support the business needs and are fundamental


to successful change.

17
Module 1: Requirements Engineering in Context

What do you think?


What problems have you encountered with requirements?

18
Module 1: Requirements Engineering in Context

Common problems in Requirements


Engineering
Requirements are notoriously difficult to write well.

Requirements specifications range from a scrawl on the back of an


envelope to multiple volumes, and all points in between. Rarely does
a team or organisation express the opinion that their method of
producing them, or that the contents when produced, are ideal.

The customer, users and developers all think they know which
functionality is to be included, but their understandings are all
somewhat different, resulting in expectations that are unlikely to be
met.

Some common problems are:

• Problem not well defined


• Users unsure what is needed
• Ambiguous expressions
• Contradiction between requirements
• Conflict between requirements
• Overlapping and duplicate requirements
• Unrealistic requirements
• Not testable
• Solutionising
• Missing requirements
• Not linked to the business objective

19
Module 1: Requirements Engineering in Context

Origin of Errors
% Origin of conceptual errors found at acceptance testing – James
Martin

60
50
40
30
20
10
0
Analysis Design Build Misc.

Poor Requirements are Expensive


Requirements definition is the key activity of analysis and most
people are aware of the importance of getting them right. Yet we still
have the situation where almost 60% of the faults found in user
acceptance testing are caused by errors occurring during analysis
and specifically during requirements capture.

The data in the graph above was first correlated in the 1980s and
has remained true to this day. It indicates failures in:

• Capturing the correct requirements


• Analysing, correlating, negotiating the requirements
• Validating the requirements in formal reviews

20
Module 1: Requirements Engineering in Context

It also indicates failures in the management of requirements


including base-lining, change control, identification, tracking etc.

In other words, the graph indicates poor Requirements Engineering.

Correction Cost
If most errors are errors in the requirements engineering process, it
follows that, if we could find those errors during analysis, we could
correct them at a relatively low cost.

Conversely, if the requirements errors are allowed to propagate


through design and build and into operation they will become
exponentially more costly to fix.

Relative cost of correcting errors – Barry Boehm

10

0
Analysis Design Build Operation

Deploy all of the tools, communications skills, analysis skills,


inspection skills and iterative activities needed to get the
requirements ‘right’ and to find any errors early.

21
Module 1: Requirements Engineering in Context

That is, introduce a defined Requirements Engineering process.

Although the majority of errors are introduced at the analysis stage,


the BCS book specifies that 12% of project time is allocated to
requirements analysis, and often delivered systems do not properly
match business objectives as a result.

22
Module 1: Requirements Engineering in Context

Planning and Estimating


Requirements engineering, just like any other project activity, needs
careful planning…

Why?

Requirements can:

• Form the basis of project estimates


• Clarify scope
• Reveal more about the problem, the people, the processes, the
business rules
• Rationalise at a task level why the problem needs addressing
• Take time to uncover

A balance must be struck between investing enough time in


requirements engineering, but guarding against the dreaded
‘paralysis by analysis’

Project Managers and Sponsors will require an estimate of the


number of days’ effort and elapsed time so that the project can be
costed and scheduled.

• Requirements are often seen as being ‘just’ a project deliverable;


a set of guidelines that drive a solution
• We have already seen what can happen if the analysis stage is
not properly considered in the graphs earlier in this section
• To enable this to be done properly the right amount of time is
needed to plan and execute the requirements

Project constraints, such as time, budget, resource availability and


time are likely to be considered as criteria for shaping the project and
often separately from the business objectives that frame the solution.

Ultimately though, realising the business benefits and fulfilling the


business objectives is the lasting impression that the project makes,
long after the project has been closed down.

23
Module 1: Requirements Engineering in Context

Sometimes, in the rush to scope the project, delivery of the solution


is mistakenly seen as the end goal, when in fact implementing a
solution to solve a business problem is the end goal, and the users
are the ones left picking up the pieces of a failed project.

Planning and estimating are therefore key activities that help identify
the tasks that will be required to ensure that the resulting solution,
delivered by the project, is fit for purpose.

Use Case Function Points, a recycling of the well-known ‘Function


Point Analysis’, technique can give guidance to the estimating
activity:

http://www.softwaremetrics.com/Articles/using.htm

24
Module 1: Requirements Engineering in Context

The importance of planning

• Many different stakeholders may be involved in a Business


situation, in the development of a suitable supporting system,
and they may have subtly (or not so subtly) different ideas of
what is required
• Often it is unclear what is actually needed – even the problem
owner may be unsure
• Users can find it hard to articulate what is wrong with their
business area and will often describe the symptoms of the
problem in relation to how they ‘see’ the solution
o In most cases the restricted view that stakeholders have of the
problem limits their understanding of the relative complexity
required to make it work better

It is the Business Analyst’s job to help the stakeholders to


communicate and clarify their understanding of the
requirements as efficiently as possible. The Business Analyst
needs time to do this properly.

25
Module 1: Requirements Engineering in Context

A further rationale for Requirements


Engineering
Requirements Engineering is focused on defining the characteristics
of the product(s) that will solve the business problems and therefore
facilitate the needs of the business towards making money.

Without adequate requirements:


• We may end up with the wrong solution
• It might be difficult to evaluate and rationalise alternative
solutions
• We may find it difficult to interpret or understand the solution in
the future
• It might be difficult to change the solution in the future

Whatever solution we advise the business to adopt, and however big


or small, we should keep in sight how that change will be measured
and tracked through the project or programme.

We can also plan for how we measure the transition, through


implementation, into Business as Usual (BaU).

26
Module 1: Requirements Engineering in Context

Solutions are not Requirements


Solutions define how the requirements will be met, and requirements
should be solution agnostic.

There may be many solutions available for a given requirement:

• We can’t choose or configure a solution to a problem unless we


understand the requirements (and the business objectives that
drive the business need)
• A complete set of requirements should narrow down the list of
suitable solutions, which can be further refined by using the
business objectives to prioritise

Solutions can constrain the requirement and limit the possibilities for
how it could be met. For example, if we need to be able to tell the
time, we want to keep our options open for how the requirement is
met, and therefore the solutions could include:

• A wrist watch
• Checking a mobile phone
• A clock
• Asking an intelligent personal assistant (such as Apple’s ‘Siri’)
• Understanding the position of the sun

We wouldn’t build a house before we have considered the plans,


materials, the number of rooms, the potential market for purchase,
the budget etc.

27
Module 1: Requirements Engineering in Context

Characteristics of ‘good’ Requirements


• They address a well-defined problem
• They specify features that stakeholders need
• Where possible, requirements expressions are SMART:
o Specific: specific features are defined without ambiguity and
without solution-orientated language
o Measurable: we will be able to measure their delivery in the
solution
o Achievable: can be realised in the solution within time, cost,
risk constraints
o Realistic: technically feasible or Relevant (relevant to the
problem)
o Time-bound: we know when they will be delivered or Testable
(each requirement is testable and we know how to test it)
• A compromise has been reached over any conflicts between
requirements
• Requirements are atomic and self-contained
• Requirements have been assessed and linked to business
objectives (and the Business as Usual)

28
Module 1: Requirements Engineering in Context

Good Requirements Checklist


There are multiple ways to write requirements. This course doesn’t
go into the detail of constructing the requirements. However, it is
possible to apply some good practice to your requirements.

To be considered “good”, a requirement should be:

Cohesive – it must address only one thing.

Complete – all the information about it should be in that one place


and nothing should be missing.

Consistent – it should not contradict other requirements or


documentation.

Atomic – it must not contain more than one requirement, indicated


by the use of words such as “and” or “or”.

Traceable – we should be able to trace this back to the documented


needs of the stakeholders and forwards to the solution.

Current – it must be up-to-date.

Feasible – it must be possible to implement the requirement, given


the project constraints and business objectives.

Unambiguous – this is perhaps the hardest of all. Most


requirements are written in idiomatic English and misinterpretations
are highly possible, especially when the implementation is out-
sourced.

Verifiable – through inspection, demonstration, test or analysis, it


must be able to be shown that the requirement has been
implemented.

29
Module 1: Requirements Engineering in Context

Business inputs to requirements

Every change project needs a starting point and the above


documents are key to ensuring that the project clearly expresses the
business need, has a defined scope and forms a basis for
communication.

30
Module 1: Requirements Engineering in Context

The Business Case Business


BCS “Business Analysis” Glossary Definition Case
A business case is a document that describes the
findings from a business analysis study and presents a
recommended course of action for senior management to consider.
The business case justifies investment in the new/amended
products, including any IT products.

The business case:

• Justifies investment in the product or in the project


• Provides options for resolving issues and measures of success

The business case brings together components that describe:

• The problem description


• The high level requirements
• The outline solution and deployment
• Costs, benefits, impacts and risks

It is important to keep focused on the business case during


Requirements Engineering:

• As stakeholders emerge
• As requirements change
• As the product evolves
• As the business continually changes
• As costs, benefits and risk become clearer

The Business Case is often created as a standalone product of a


feasibility study, commissioned to investigate area/s of the business
that need attention.

It is usually the starting point of a project, once the preferred option


has been selected.

31
Module 1: Requirements Engineering in Context

Terms of Reference (ToR)


Terms
Terms
One of the ways that the components of a Terms of
project, and time, can be identified and of
of
Reference
documented is through a Terms of Reference
or ToR.

The ToR provides a structured way of defining the key components


of a project. It (or an equivalent) should be considered an essential
part of the project planning activities. It can be produced at many
levels, for example by each key resource group involved in the
project, i.e. one for Business Analysis activities, one for Testing, one
for User Experience etc.

It will typically provide, before a project gets underway, the following


information, often documented using the framework, BOSCARD:

• Background – what is happening in / to the business


• Objectives – what the project is aiming to achieve
• Scope – what is included and what is excluded
• Constraints – limits on time, budget, etc.
• Authority – the ultimate arbiter of any conflicts
• Resources – the people and equipment available to the project
• Deliverables – what we will measure to see if the objectives
have been met

There is also a briefer version in use – OSCAR.

Terms of Reference are necessary for a pre-project stage, such


as feasibility studies, to:

• Focus on understanding the scope of the problem, confirming the


project boundaries, deliverables and high level requirements
• Deriving the business case that will provide detail for investment
decisions
• Communicate what we will do

The ToR can also serve as a starting point for negotiation of what is
achievable within the usual project constraints of time, cost and
resources and may sometimes contain the estimates from the

32
Module 1: Requirements Engineering in Context

planning stage. It usually feeds into the documentation for the


Project, such as the Project Initiation Document, or PID.

Definition of a Project
Now we have the ToR and an understanding of what’s involved the
project can be further formalised.

‘A project is a discrete piece of work with an agreed start and end


date.

It consists of a set of co-ordinated and controlled activities


undertaken to deliver a product conforming to specific requirements
within the constraints of time, cost and resources.

Projects exist to deliver products that the business can use to deliver
benefits.’

• A project is required once we have agreed ‘what to do’.


• Software development is usually part of wider business changes
that are include in the project’s remit too.

33
Module 1: Requirements Engineering in Context

Project Initiation Document Project


(PID) Initiation
Document
The Project Initiation Document is a project
management product that forms the contract
between the business and the project team.

• It defines the “What, Why, Where, Who, How and When” of the
project and provides a basis for the management of a project and
for measuring success

The PID includes:

• The ‘project proposal’ is formalised as a Project Brief or Project


Charter and consolidates the initial review, consolidated from the
ToR into the Project Definition
• It provides links back to the Business Case
• Estimates, communication plans and resource requirements,
success criteria (linked to the Business Objectives) are also
included

The Project Brief as defined in PRINCE 2 ™ is a ‘full and firm


foundation for the initiation of the project’.

34
Module 1: Requirements Engineering in Context

Requirements Engineering Framework


The following diagram shows the components of the BCS
Requirements Engineering Framework – we shall examine each of
these during this course.

The BCS Requirements Engineering Syllabus is structured around


this five-part framework, which is typically applied to a project
initiated by an approved business case.

Although some high level ‘feasibility’ work across all five areas may
have been conducted prior to the project start, as part of a wider set
of change initiatives.

Requirements Elicitation: suggestions covering the drawing out of


requirements from the relevant stakeholders.

Requirements Analysis: suggestions covering a collection of


activities needed to shape the requirements into a suitable form such
that they are clear and understandable.

Requirements Validation: description and execution of the process


by which the business, and in particular the Sponsor, signs off on the

35
Module 1: Requirements Engineering in Context

set of requirements as being an accurate statement of what is


needed.

Requirements Documentation: recommendations and means of


documenting requirements.

Requirements Management: suggestions covering the need for


change management, version and configuration control.

36
Module 1: Requirements Engineering in Context

Case Study – Goatilicious


Read the Case Study Scenario (in your exercise workbook).

We will use the Case Study as the basis for future exercises.

Having read the case study, do you have any questions?

37
Module 1: Requirements Engineering in Context

Summary
The key points of this module are as follows:

# Subject Prepared?

1 A requirement is something a business user 


needs the (IT) system to provide.
2 A requirement should not specify how the
requirement is to be implemented.
3 Requirements are the basis for acceptance
testing and need to be written in a way that
makes this easy to do.
4 Requirements arise because of changes in the
business from internal and external sources.

5 Requirements are difficult to capture and


document well.
6 The majority of conceptual errors occur during
the analysis phase of a project. The later they
are discovered, the more expensive they are to
correct.
7 Projects exist to deliver products that the
business will use to deliver benefit.
New/amended IT products are often part of the
project’s focus.
8 A business case defines the recommendations
of a business analysis study, and justifies
investment in the products.

9 Terms of Reference for pre-project work, might


be based on the acronym BOSCARD or the
shorter OSCAR.
10 A Project Initiation Document formally
launches a project and forms the contract
between the business and the project team.

38
Module 1: Requirements Engineering in Context

Post Test
To reinforce the materials we have just covered, try out the following
questions in your own time. You’ll find the answers are on page 213.

1. Name three classes of change which give rise to the need


for new requirements.
2. List three problems often faced by requirements engineers
when trying to write requirements.
3. What percentage of errors (approximately) occur in the
analysis phase of a project?
4. State the definition of a “project”.
5. What is a business case?
6. What is a Project Initiation Document?
7. Name the words behind the acronym BOSCARD.

39
Module 1: Requirements Engineering in Context

Further Reading
1. Wiegers, Karl E. (2003). Software Requirements, Second
Edition. Microsoft Press. ISBN 0-7356-1879-8.
2. Young, Ralph R. (2001). Effective Requirements Practices.
Addison-Wesley. ISBN 978-0201709124.

40
Module 1: Requirements Engineering in Context

End of Module Notes

41
Module 2: Requirements Stakeholders and Elicitation

Module 2 – Requirements
Stakeholders and Elicitation
Topics
In this section of the course, we will cover:

• Stakeholders involved in RE
• Elicitation problems and knowledge types
• Requirements list
• Elicitation techniques
• Understanding the applicability of techniques

42
Module 2: Requirements Stakeholders and Elicitation

Stakeholders involved in RE
What is a Stakeholder?
A stakeholder is anyone affected by or interested in the business
situation/area being investigated. They may be internal to the
organisation or external, such as a supplier.

Who are the stakeholders?


There are many potential stakeholders in the RE process.
The BCS syllabus mentions the following:

43
Module 2: Requirements Stakeholders and Elicitation

Project Sponsor
The sponsor is the ‘owner’ of the new
system.

• As such, the sponsor has the


responsibility for ensuring that the
system meets its goals and realises its
benefits
• This implies that the sponsor has sign-off powers and has the
final decision on all project matters
• Additionally, the sponsor is accountable for the project terms of
reference, initiates project reviews, resolves project issues and
acts as Champion for the new system

As far as the Requirements Engineering Process is concerned, the


sponsor must ensure that the requirements capture the functionality
and constraints of the new system such that it satisfies the business
goals and yields the business benefits.

System End-Users and Managers


System end-users and managers represent the views of those who
will use the system on a day-to-day basis.
• They must make sure that functionality and usability
requirements are properly specified and therefore have a large
say in the requirements
• They must be happy that the requirements are ‘workable’ and
complete

Subject Matter Expert (SME)


The subject matter expert is the ‘super user’ who provides the
specialist knowledge of the business area to be improved.

• They may be an internal or external resource, and may well have


‘consultancy’ type experience

44
Module 2: Requirements Stakeholders and Elicitation

• The expert provides information and ideas on business issues


and possibilities and works with the analysts to ensure that the
knowledge and ideas are represented in the requirements

Project Manager
The Project Manager, unsurprisingly, plans
and controls the project, ensuring it keeps to
time and cost constraints.

• Additionally, the project manager must


ensure that the Requirements Engineering
Process is being properly followed
• He/she may be called upon to resolve conflicts between
stakeholders over the requirements

Business Analysts
The analysts are, in fact, the Requirements Engineers.

• Analysts elicit, document, analyse, validate and often manage


the requirements
• In some cases the analysts will write the User Acceptance Tests
and run them with the users to ensure the requirements have
been met
• Analysts often produce supporting models, such as business
process models, etc.

Developers
The developers are responsible for creating the new IT system to
meet the requirements.

• The developers’ main concern is that the requirements can be


built and tested
• Sloppy requirements will mean that the developers must
constantly refer back to the analysts or simply ‘make it up’

45
Module 2: Requirements Stakeholders and Elicitation

Customers
Customers are affected by the interfaces to
the system (inputs, outputs).

• Projects must comply with legal


requirements concerning customers
• Often there is the need to communicate
with them to inform them of changes
• Analysts may need to consult with them to discover preferences

Regulators
Many industries have statutory regulatory bodies (e.g. financial,
utilities, telecoms).

• Regulatory constraints give rise to requirements on projects


• Changes to the law can also give rise to requirements

Suppliers
Suppliers may be affected by changes to interfaces.

• They will need time to change their systems if affected


• Our degree of influence over the supplier will partly depend on
the relative sizes of the businesses

Others
There is of course plenty of scope for other stakeholders that are
relevant to your own organisation or project requirements. Examples
of other stakeholders could include:

• The government
• The general public (not necessarily your customers, perhaps
those whom you ask an opinion of via surveys)
• Prospects/Hand-raisers (groups of potential customers)
• Previous Customers
• Testers and other project team members

46
Module 2: Requirements Stakeholders and Elicitation

What do you think?


• What sort of problems do Stakeholders have in stating
requirements?

• What sort of problems does the Analyst have in eliciting


requirements?

Stakeholders

Analyst

47
Module 2: Requirements Stakeholders and Elicitation

Stakeholder problems
Stakeholders are subject to a number of problems, they:
• Might not know what they really want
• Find it hard to articulate what they want
• Make unrealistic demands through not understanding cost
implications
• Express their requirements from their own viewpoints and the
requirements may conflict
• Are subject to, and may be swayed by, politics
• They change their minds!

Analyst problems
Analysts may not have much experience in the domain in question
and:

• Find it difficult to identify all of the stakeholders


• Must find a way to express requirements in terms that ALL
stakeholders and actors can understand and agree
• Must resolve requirements conflicts and uncover commonalities
• Must cope with a changing businesses environment which might
affect the priority of, or need for, requirements

Preparation
To elicit requirements, we must first understand:

• The business objectives


• The problem area and problem to be solved
• The business processes in scope
• The systems supporting the processes
• The operational constraints and business rules
• The stakeholders and their attitudes

We must also foster a sympathetic attitude to the needs of the


stakeholders, the fact that this could be a big change for them: it
could impact on how they work, the processes they are using now,

48
Module 2: Requirements Stakeholders and Elicitation

the way the work and the teams are structured and also the
technology they have. They could be fearful of that change. So we
must be prepared to take the time to find out their real needs.

Stakeholder viewpoints
Requirements are not normally elicited from a single stakeholder.

• Different stakeholders will have their own viewpoints on a


requirement, the solution and the issues that are being
experienced. All may be valuable
• The problem with single-viewpoint requirements can be that
other stakeholders might not agree with it, resulting in unused
functionality
• On the other hand, multiple viewpoints help us prioritise
requirements and understand the important issues that our
stakeholders face day to day

As an example, consider a business goal which is to ‘Improve the


Customer Experience’:

• What problems does the customer currently perceive to be


spoiling their experience with us?
o The quote system is too slow and prone to errors
• What will improve the customer experience?
o An improved response time for requests for quotes
o The elimination of errors and lost quotes
o Instant response to queries about requested quotes
• How can we achieve these improvements?
o By integrating IT to improve logging of the quotes
o By changing the structure of the quote team
o By placing an audit trail on each quote so we can track them
o By introducing a ‘workflow’ approach to the quote status

The requirements that will support the business objective should flow
from these.

49
Module 2: Requirements Stakeholders and Elicitation

Tie in the Business Objectives


Despite all our efforts the stakeholders will still bombard us with their
wants and needs, and in some cases this can be overwhelming.

Using the business objectives as assessment criteria helps us to


rationalise the requirements more effectively, and can be used to
justify why the requirements have been prioritised in a certain way.

Even better still is using the business objectives as a way to inform


the stakeholders as early as possible and manage their expectations
for what the business is aiming to achieve. Over time this will
become a clearer message and will be part of the project
infrastructure:

To summarise:

• Stakeholders won’t automatically know what the business


objectives are, and their focus will be on resolving problems they
perceive are present, in a way that allows them to articulate their
concerns (which could be ‘I want the system to do what Google
does’)
• We can use the business objectives as the driver for
requirements elicitation and the rationale for validation
• All requirements must contribute to the business objectives in
some way so that we can ensure the solution moves the
business towards their objectives and strategic direction
• If they do not, they are superfluous and could consume valuable
resources with zero return

50
Module 2: Requirements Stakeholders and Elicitation

Knowledge Types
Unconscious Competence
"Reports that say that something hasn't happened are always
interesting to me, because as we know, there are known knowns;
there are things we know we know. We also know there are known
unknowns; that is to say we know there are some things we do not
know. But there are also unknown unknowns – the ones we don't
know we don't know.”
Donald Rumsfeld
Very often our users do not tell us everything and this is not because
they want to keep information from us (most of the time!) but
because it does not occur to them to tell us.

We encounter plenty of people who are good at their jobs and who
perform many of their tasks without thinking too much about what
they are doing and the way in which they are doing it. As a result, our
understanding of the situation may be flawed.

51
Module 2: Requirements Stakeholders and Elicitation

Knowing that this is a problem allows us to take action.

The four stages of competence (on the previous page), or four


stages of learning helps us understand how we learn a new skill or
competence:

• Stage 1: Unconscious incompetence, an individual has no


awareness of the need to know a skill and has no awareness of
the deficit
• Stage 2: Conscious incompetence, the individual still has no
knowledge of the skill but they now have knowledge of what they
don’t know: they are aware of the deficit
• Stage 3: Conscious competence, the individual understands or
knows something but they need to concentrate on its application
• Stage 4: Unconscious competence, the skill has become
second nature and the individual no longer has to consciously
think about the application in order to perform it

Tacit Knowledge
Unconscious competence refers to unknown knowns; those areas of
knowledge that we have forgotten we know, do automatically, take
for granted, have a skill in or simply can’t explain.

We refer to the pieces of knowledge that fall under unconscious


competence as ‘tacit knowledge’.

Tacit Knowledge is ‘those aspects of business work that a user is


unable, or omits, to articulate or explain. This may be due to a failure
to recognise that the information is required or to the assumption that
the information is already known to the analyst.’

The opposite of tacit knowledge is explicit knowledge – areas of


knowledge that can be accessed by anyone, can be fully explained
and can be documented.

Explicit Knowledge is ‘the knowledge of procedures and data that


is foremost in the business users’ minds, and which they can easily
articulate.’

BCS FCBC Glossary of Terms, 2014

52
Module 2: Requirements Stakeholders and Elicitation

Tacit knowledge takes many forms, consider the following:

• Skills
o Trying to explain every single step towards achieving a goal is
very difficult. Imagine having to explain in detail how to start a
new word document, apply formatting and add a table of
contents
• Taken for granted information
o This category relates to the sort of information that users may
not feel is worth mentioning and the analyst doesn’t question
further. It could be around the specific use of terminology for
instance, which the business user knows has different
meanings across the business and assumes you know that
too
• Front story / back story
o This occurs when the user paints a more positive picture of
their workplace or situation than is actually the case. Whether
this is deliberate or not depends on the user. Sometimes it’s
about ‘protecting’ the team from criticism where the analyst is
perceived to be representing management or head office, for
example

Much of this is important for us to be aware of if we are going to


design a solution that will enable the business to achieve its
objectives.

53
Module 2: Requirements Stakeholders and Elicitation

Tacit vs. Explicit


The analyst can experience problems trying to elicit tacit knowledge:

• Need to adopt particular techniques


• Once elicited, ensure it is documented

Types of tacit and explicit knowledge at an individual and corporate


level are shown in the table below:

Tacit Explicit

Individual Skills, values, taken-for- Tasks, job descriptions,


granted, intuitiveness targets, volumes and
frequencies

Corporate Norms, back story, Procedures, style


culture, communities of guides, processes,
practice, organisation knowledge-sharing
history repositories, manuals,
company reports

Business users will be able to pass on to us their explicit knowledge;


it is more difficult for them to articulate the tacit knowledge. Much of
this tacit knowledge is important for us to be aware of if we are going
to design a solution that will enable the business to achieve its
objectives. Once elicited and documented it becomes explicit
knowledge and we can make use of it.

54
Module 2: Requirements Stakeholders and Elicitation

Tacit to Explicit Knowledge: AERO


Once elicited and documented, the tacit knowledge becomes explicit
knowledge we can understand and use.

As you can see from the diagram, there are four basic ways to make
tacit information explicit.

These can be summarised through the acronym AERO, and are:

• Apprentice: shadowing; protocol analysis


• Enact: prototyping; scenario role-play
• Recount: story-telling; scenarios
• Observe: observation (formal, informal)

55
Module 2: Requirements Stakeholders and Elicitation

Documenting your findings


Once we begin the process of eliciting our requirements from our
stakeholders we need to start documenting them.

A standard approach is to begin with a simple, informal requirements


list (as shown below) which is later analysed and developed into an
organised requirements catalogue (see Requirements
Documentation).

Requirement Source Comment

1. All transactions must be K Harrison What kind of


secure security?
2. A report of all A King What’s in the
transactions in the last report? File format?
seven days needs to be Feed?
produced at 0900 each Fields?
Monday morning

3. Customers need the K Harrison Where? When?


option of English or Welsh
4. The system is to capture R King Ambiguous – what
customer details details are to be
captured?

A crucial consideration as you begin the process of documentation


is to think about how you might need to use the information at a later
stage.

For example, if you omit the source and date of capture now will this
prove problematic when you need to go back and understand the
context that initial requirement was captured within?

This traceability will be useful later on!

56
Module 2: Requirements Stakeholders and Elicitation

Activity – Elicitation Techniques


Your Instructor will now give you syndicate time to prepare
presentations on Elicitation Techniques.

Use the information on the following pages for some guidance, but
also include:

• Your own experience


• What has worked well for you (and what hasn’t)
• Situations in which you have used the technique
• The kind of information you have been looking for
• When you have faced tacit knowledge and what techniques
helped to make this explicit
• The kind of stakeholders you have involved

Each syndicate group will be assigned an Elicitation Technique or


Techniques by the instructor.

Your presentation should last no more than ten minutes.

57
Module 2: Requirements Stakeholders and Elicitation

Elicitation Techniques
Elicitation techniques include:

• Interviews
• Workshops
• Observation:
o Formal/informal
o Shadowing
• Focus Groups
• Prototyping
• Scenarios
• Document Analysis
• Special Purpose Records
• Questionnaires

Over the following pages, we will look at each of these techniques in


turn.

58
Module 2: Requirements Stakeholders and Elicitation

Interviews
An interview is a structured discussion
between the analyst and a stakeholder to elicit
facts and information about the business
situation and the stakeholder’s role in it.
Interviewing is an excellent elicitation
technique and a key analysis skill.

The analyst uses the interview as a technique for gaining


understanding of the business area under investigation and the
problems being experienced therein, eliciting and understanding the
requirements.

Among the advantages of using interviews is that they enable us to


quickly build up rapport with key stakeholders and build a working
relationship with them as we are in a confidential, one-on-one setting
with them.

However, if we were to rely exclusively on interviews it would be very


time consuming, and each interview only gives us one stakeholder’s
point of view.

Interview Lifecycle
Interviews should never be attempted without proper planning and
structure, as shown on the following pages.

Plan

It will probably not be possible to interview all of our stakeholders


due to time and geographical constraints. In order to make best use
of this technique we should consider using it with senior
stakeholders. Consider meeting the sponsor, department heads,
directors etc. We should set clear objectives for each interview that
we are going to conduct. This will help us as we prepare and conduct
the interviews.

59
Module 2: Requirements Stakeholders and Elicitation

Prepare

Having ensured that we have management clearance to carry out


the interview and that we know the stakeholder’s availability, we
schedule the interview. It is important that we inform the stakeholder
of our objectives for the interview and any preparation they need to
make before we meet. Agree with them when the interview is to take
place, where it will happen and how long it will last. Consider where
the interviewee might feel relaxed, how you can reduce the risk of
interruptions, whether back-up material must be available and
whether the physical environment will be suitable.

We also need to ensure that we are fully prepared – what we need to


cover in the introduction, what type of questions we are going to ask
and in what order, etc. The type of questions we ask will obviously
depend on the purpose of the interview. We are trying to understand
the current business processes and systems so that we can uncover
the problems and create the requirements for the new system.

A good ‘Questioning Strategy’ will serve as a framework (or


checklist) for structuring our questions during the interview. We may
include questions on the processes, problems associated with the
processes, what the key business data entities are for each process,
what business rules constrain the process, which stakeholders are
involved, what are their attitudes, how often the process runs, and of
course what are this stakeholder’s requirements for change.

It is vital to go into an interview with a clear set of prioritised and


sequenced topics that you want to cover. Maintain a logical
sequence of topics and cover the most important topics first in case
you run out of time. You might like to introduce sensitive topics later
in the interview once rapport is established.

It is also important to follow a time plan and to not exceed the time
allocated for each topic. To this end, prepare the key questions in
advance for each topic and ensure the questions are ‘open’. Open
questions encourage the interviewee to feel relaxed and ‘open up’.
Examples are:

60
Module 2: Requirements Stakeholders and Elicitation

• “I understand that you are the best person to talk to about


ordering. Could you tell me how you organise the process?”
• “What are the benefits of monthly stock checks over more
frequent ones?”
• “I’m very interested in the way you control your bookings. Could
you walk me through your experiences in that area?”
• “That’s really interesting. Why do you do it that way?”

In contrast, closed questions invite closed answers and can induce


defensiveness:

• “You are in charge of ordering, aren’t you?”


• “Do you do a stock check every week?”
• “Did you make last quarter’s target?”

Closed questions may, however, be useful when starting the


interview to get the interviewee comfortable.

61
Module 2: Requirements Stakeholders and Elicitation

Conduct

Initial impressions are vital in building up rapport and putting the


interviewee at ease. Make sure you:

• Introduce yourself
• Smile and make eye contact
• Shake hands, where appropriate
• Thank the interviewee for seeing you
• Restate purpose, timing and needs
• Explain why the information is necessary
• Explain the need for note-taking
• Explain what feedback will be given
• Explain the structure
• While you are doing this, attempt to assess attitude of
interviewee

During the body of interview, use the interview structure that you
prepared, moving from topic to topic and introducing each topic with
an open question. Use the prepared follow-up questions BUT listen
to the answers you are getting and adjust your questioning
accordingly. A successful interviewer will build up rapport quickly,
listen actively and think quickly. You will need to show that you’re
listening by using appropriate body language and sending out small
verbal messages.

Show that you understand what is being said by demonstrating


empathy, paraphrasing important points and summarising at the end
of each topic.

Throughout the interview, try to read the reactions of the interviewee.


Is he or she disassociating, frowning, nodding at inappropriate times,
looking at their watch, fidgeting, showing signs of distress. Be
prepared to exit gracefully if necessary.

At the end of the interview, review the interview notes and confirm
the main points with the interviewee. Tell the interviewee what will
happen next and check on future availability for further interviews if
necessary. Thank the interviewee for their time and contribution.

62
Module 2: Requirements Stakeholders and Elicitation

Always try to conclude the interview by the agreed time.

Follow-Up

Write up notes as soon as possible while the memory is fresh, and


then send a copy to interviewee for comment. Amend the notes as
necessary and then publish them. Carry out an analysis of the
information gathered in order to extract and organise the facts so
that you can create the requirements.

Summary

Advantages Disadvantages

Build rapport building and one to Time consuming


one engagement
Only provide one viewpoint
Allow discussion of confidential
Can be difficult to manage (and
information
can go off track easily)
Useful for senior stakeholders

Workshops
A facilitated workshop is a team-based
information gathering and decision-making
technique designed to accelerate business
planning and development. It is an interactive
communication technique involving experienced
and empowered personnel working in one or more
sessions run by an independent facilitator. A workshop is a process
to be implemented when there is a requirement to make decisions,
explore ideas and exchange knowledge to solve a business problem.

The strength of the facilitated workshop technique is that it enables


the exchange of information between key individuals and enables
them to reach decisions that are mutually acceptable. A workshop
provides a forum for exchanging views and achieving consensus

63
Module 2: Requirements Stakeholders and Elicitation

decisions in a structured framework across and within areas of the


business. Clear deliverables are produced during the workshops
enabling all attendees to review decisions taken by the group.

Advantages

Workshops offer the following benefits:


• Speed – by gathering all the relevant stakeholders in a
workshop, it is possible to achieve an agreed set of user
requirements, for example, in a day or two as opposed to weeks
or months using traditional methods
• Ownership – stakeholders who are part of the group decision-
making process are more likely to be committed to its decisions
and to feel a greater sense of ownership for subsequent
development work
• Productivity – the workshop often benefits from the participants
building on each other’s ideas and gaining a better
understanding of each other’s viewpoint. Often
misunderstandings in the business areas can be swiftly clarified
during workshops
• Consensus – the workshop provides an opportunity for the
participants to discuss relevant subject matters, including the
major issues and problems, with a view to reaching a consensus
on all the important decisions
• Quality of decision-making – because stakeholders are active
players in the decision-making process, the levels of confidence
and understanding of the workshop output are likely to be high
• Overall perspective – workshop participants can appreciate the
importance of business areas contained within the project but in
which they are not directly involved

The simple principle is that several brains pulling together can


(usually) produce better solutions than one brain working in isolation.
However, badly planned and conducted workshops can be a
complete waste of everyone’s time. The symptoms of a bad
workshop include:

• A vague, ambiguous statement of the objectives

64
Module 2: Requirements Stakeholders and Elicitation

• A lack of clear focus and direction


• A lack of consensus and commitment to the solutions
• Time-wasting, side discussions, arguments etc.

Facilitated workshops are an excellent forum for requirements


analysis and negotiation.

Workshop Roles
Sponsor

The sponsor ultimately ‘owns’ the workshop and its objectives and is
the ultimate decision-maker. The sponsor (or delegated person)
works with the facilitator to create the terms of reference for the
workshop. They will agree the rules for the workshop and the
sponsor empowers the facilitator to enforce them. The sponsor also
empowers the participants of the workshop to make the necessary
decisions.
Facilitator

The facilitator is the key player in the workshop. He or she ensures


the group meets the agreed objectives in the agreed timeframe. It is
important that the facilitator manages the workshop process
and NOT the content of workshop.

The facilitator maintains the focus of the workshop, manages the


group dynamics and encourages individual contributions. Naturally,
the facilitator also upholds the workshop rules.

The facilitator needs a range of attributes, including:

• Detachment, neutrality and objectivity


• Professionalism and integrity
• Positive, patient, cheerful, organised demeanour
• Active listening ability
• Ability to question and to give feedback
• Ability to maintain group participation and consensus
• Ability to handle group dynamics and conflict

65
Module 2: Requirements Stakeholders and Elicitation

Participants

The participants are required to contribute fully and positively to the


workshop by providing the ideas and expertise. They must work
towards group success and stay within the workshop rules. It is vital
that the participants are empowered to speak and make decisions on
behalf of their areas.

The Scribe

The scribe works closely (and often interchangeably) with the


facilitator. He or she is responsible for ensuring workshop output is
captured accurately and published as formal documentation. The
scribe takes no other part in the process.

The Workshop Lifecycle


Planning and Preparation

When (as facilitator) you plan and prepare for the workshop, you will
need to understand and document the terms of reference, including:

• The context of the workshop


• The objectives of the workshop
• When it will be held
• Where will it be held
• Who will be invited
• How long will it run for
• What the rules will be
• What the time plan will be
• What form the output is to take

The analyst will then need to agree the plan with the sponsor and
send invitations to participants along with the rules, the terms of
reference and any other documentation they require. The analyst will
also need to brief the scribe before the workshop and personally
check the venue for layout, lighting, ventilation and equipment such
as stationery, flip charts, white boards, sticky notes, projectors etc.

66
Module 2: Requirements Stakeholders and Elicitation

Introduction

Before the workshop starts, review and agree the terms of reference
with the participants as some may not have had the opportunity to
read it themselves. Cover at least: BOSCARD, structure and time-
plan.

Then review and agree the workshop rules with the participants.
Some example rules are:

• All are equal


• All are to contribute
• All are to be treated with respect and consideration
• Facilitator is the sole arbiter of process decisions
• Side-discussions are to be conducted outside the workshop

Brainstorming

Many workshops start with some sort of brainstorming session that


generates ideas for the objective. For instance, we might hold a risk
workshop for a set of requirements and this might start with a
brainstorm to throw up candidate risks.
When brainstorming we are looking for the quantity of contributions
not the quality, so the facilitator accepts all ideas without discussion
and ensures that all contributions are visible (typically with sticky
notes). It is a good idea to capture the contributor’s name for the
later discussion.

Nominal Group Technique (NGT)


NGT is a form of brainstorming/brainwriting.

NGT aims to help groups of suitably skilled and motivated


participants to deliver high-quality products in a short timebox.

Using sticky notes, ideas are generated without talking. Quality, and
not quantity, is expected. The facilitator should arrange the post-its

67
Module 2: Requirements Stakeholders and Elicitation

on a flipchart into groups and give a representative name to each.


Care should be taken if is impossible to name a group.

It probably means that you do not have a homogenous group. If


groups have to be prioritised, the team should be asked to write
down a number between 1 and 5 on a group-by-group basis (again,
without conversation).

By averaging the results for each group, the order of preference is


clear. NGT can be used to arrive at a candidate list of requirements
and prioritise them very quickly and without protracted
discussion/argument.

Selection / Validation

Once the brainstorming is complete, the facilitator invites discussion


on each contribution in turn, asking the contributor to speak first. The
facilitator should try to elicit a short description of the contribution in
order to allow the group to agree on the validity of it. In any case, the
group will determine whether the contribution is valid (and where
appropriate, its relative merit) and will reject invalid contributions.

Often the contributions can be categorised, grouped, ordered or in


other ways classified. For instance, agreed risks could be placed into
categories and assigned a risk factor.

Review

Once the contributions have been agreed and any classification


achieved, the result is reviewed using a formal walkthrough of the
workshop findings. It might be appropriate to run the walkthrough as
a benefits/concerns session. The group is looking to check for
completeness, ambiguities, duplication etc. and to check descriptions
are adequate. If the review fails, the group must decide if more
brainstorming, selection or validation is required.

68
Module 2: Requirements Stakeholders and Elicitation

Follow Up

The scribe formally documents the output of the workshop,


distributes the documentation to the sponsor, participants and other
stakeholders and requests comments within a short time-frame.

Summary

Advantages Disadvantages

Can help get buy-in Can be expensive


Achieves consensus Can be difficult to manage and
document
Speeds things up
No consensus achieved
Gives an overall perspective to all
participants Can go off track

69
Module 2: Requirements Stakeholders and Elicitation

Observation
Watching people actually carrying out the
tasks rather than just asking about them is a
very useful way of getting information about
the work practices and environment. This
can be done in a number of ways. If you are
going to carry out observation it is important
to get the agreement of those being
observed to avoid possible industrial
relations problems.

Advantages

• We can get a good understanding of the processes, problems,


politics etc.
• Helps devise workable, acceptable solutions

Disadvantages

• Can feel like ‘Big Brother’ – unsettles the observed


• Your presence may impact the process

Types of Observation
Formal

This involves watching staff carrying out specific tasks. It is important


for the staff to be prepared for your observation, and to emphasise
that you are watching to gain an understanding of the tasks and not
assess performance. There is a danger that staff may perform the
tasks “by the book” rather than how they would normally if they think
you have been sent by management.

Informal

Really just wandering about to see what goes on. The dangers here
are that staff may be unnerved by your presence as they have not
been prepared and that you will not see the full range of tasks that
you need to see. If the workers are used to your presence, however,
this can be a good way of seeing what really goes on.

70
Module 2: Requirements Stakeholders and Elicitation

Shadowing

This means following a worker for a period of time, and can be


usefully done before some of the more structured requirements
elicitation in interviews or workshops. It may include Protocol
Analysis in which the worker performs a task and describes each
step as they perform it. This gives excellent opportunities for asking
“why?” type questions.

Advantages

• Enables an understanding of the ‘real world’, i.e. what the


behind the scenes looks like
• Gives access to the users in their usual environment
• Can facilitate discussion and exploration of tacit knowledge

Disadvantages

• Can intimidate users


• May not provide insight into typical day to day activities (e.g.
busy periods, fluctuations on workload, seasonal variations)

71
Module 2: Requirements Stakeholders and Elicitation

Focus Groups
Focus groups are useful for business
and market research. They consist of a
group of people with a common
interest.

Groups like this help to identify and


understand:

• Attitudes
• Concerns
• Beliefs
• Opinions

There is no need for consensus or ownership but remember that


findings need to be analysed.

Advantages

• Facilitates a broad view of opinions and concerns


• Can be used to achieve market research activities that help
understand how the customers feel about a particular solution or
option before investment takes place
• No consensus is required

Disadvantages

• Results have to be analysed carefully and may uncover further


investigation
• The objectives need to be understood fully
• The results may not yield the expected results

72
Module 2: Requirements Stakeholders and Elicitation

Prototyping
A common complaint from analysts is
that users are much better at telling
you what they do and don’t like or
want when something is presented to
them than they are at telling you what
they want off the top of their heads.

By creating a ‘demonstration system’, prototyping shows the users


how a system might work which can help clarify their thinking and
firm up requirements before we are too far down the development
path.

The ‘system’ can be anything from sticky notes or a set of screen


mock-ups to a fully-fledged application.

Prototyping is an integral part of iterative / incremental systems


development, and has a strong link with scenarios.

A fuller treatment of prototyping can be found in the module on


Requirements Validation.

Advantages

• Helps the user to really determine the requirements, especially


user interface, performance, navigation paths
• Validates requirements
• Reduces risk of “getting it wrong”

Disadvantages

• Can run out of control


• Can raise unrealistic expectations
• Can lead user to overestimate progress

73
Module 2: Requirements Stakeholders and Elicitation

Scenarios
Scenarios tell the story of the task, including:

• All steps from business trigger to


outcome
• Pre-conditions
o Must be true for the scenario to begin
• Post-conditions
o Must be true following conclusion
• Alternative paths
• Exception situations

Advantages

• Aids visualisation and discussion of real life situations


• Can be used to build test scenarios

Disadvantages

• Can become complex, especially where there are many


alternative paths

74
Module 2: Requirements Stakeholders and Elicitation

Document Analysis
This involves the reading and analysis of
source documentation such as forms,
screen layouts and reports. For each
document analysed, we need to find out:

• How is the document completed


• Who uses it
• When is it used / produced
• How many are used / produced
• How is the document retained
• Details of the information shown on the document (source, rules,
etc.)

It is often easier to determine this if we are able to use completed


forms or real printouts rather than just layouts.

Advantages

• Can yield good information on:


o Organisation
o Process
o System
• Can be useful to go back to the source of information, particularly
where it is written, such as in:
o Order forms
o Questionnaires
o Requests for information

Disadvantages

• Doesn’t get differing viewpoints


• Dry and tedious

75
Module 2: Requirements Stakeholders and Elicitation

Special Purpose Records


Here, stakeholders are asked to keep a record of
what they do when engaged in a task or process.
This can range from a simple diary to filling in
specially prepared questionnaires at intervals during
the day. For this to succeed we need the workers to
buy in to the process; if they don’t see the need we
are more likely to experience the problems shown below. We need to
be realistic about what we can reasonably expect people to record
while carrying out their normal work.

Advantages

• Good for capturing metrics, problems, time and motion etc.


• Avoids ‘big brother’ aspect of observation

Disadvantages

• People dislike the extra work


• Must be done real time or accuracy will suffer
• People might ‘bend’ the records to put themselves in a better
light

76
Module 2: Requirements Stakeholders and Elicitation

Questionnaires
Questionnaires are a very useful way of eliciting
limited amounts of information from a large group of
people, especially if they are geographically spread.
The skill comes in formulating the questions so that
you are able to get the needed information in a way
that is easy to analyse and turn into requirements.

Advantages

• Can reach a large audience, even if geographically separated


• Can uncover common problems
• Can determine attitudes

Disadvantages

• People don’t like surveys


• The survey must be kept small and focused
• It takes skill to formulate a survey

77
Module 2: Requirements Stakeholders and Elicitation

Understanding the Applicability of


Techniques
The table below shows how far application of the techniques can be
useful in uncovering different types of knowledge.

After Maiden & Rugg (1996)

78
Module 2: Requirements Stakeholders and Elicitation

In Summary

Technique Who? Information Why?

Project Sponsor May need confidentiality


Clarify terms of reference
SMEs Specific detail
Interviews Understand objectives Gain
Senior May need to build
explicit knowledge
management rapport/engage with their teams

Exploring ideas
Peer groups/teams Engage with users
Decisions
Workshops Users Gain consensus
Knowledge exchange (can
Decision-makers Engagement at group/team level
gain tacit knowledge)

Tacit knowledge
Sense of reality
Formal The users Processes and what 'actually
To get to grips with any
Observation themselves happens' (if the users are
workarounds and problems
comfortable!)

Why something is being Sense of reality


The users
Shadowing done as well as how it is To get to grips with any
themselves
done workarounds and problems

79
Module 2: Requirements Stakeholders and Elicitation

Technique Who? Information Why?


Groups of people
Opinions and concerns To gain a rich understanding of
Focus Group with a common
(market research) attitudes, opinions and concerns
interest
The users Often to validate requirements
Understanding of user needs
Prototyping themselves (and by showing users something
Clarify requirements
their managers) visual
Step by step detail of what To identify the success criteria
The users should happen within a To identify exceptions and
Scenarios
themselves process, group of tasks or a alternate process requirements
task itself To identify business rules

Not targeted Processes


May need to understand more
towards a user Systems and their users
Document than the users reveal
specifically but will Background and history
Analysis May need to see how a process
likely be user Data capture requirements
was intended to be completed
documentation and usage

Special To gain 'real' analysis that the


The users Metrics, frequencies,
Purpose users have participated in
themselves volumes etc.
Records (which may help their buy in)

80
Module 2: Requirements Stakeholders and Elicitation

Technique Who? Information Why?


Usually large
groups of people Factual information Can reach a large audience who
Questionnaires
who we may not Opinions and thoughts we may not have access to
have access to

81
Module 2: Requirements Stakeholders and Elicitation

What do you think?


Which elicitation techniques are the most useful for you? When do
you use them?

82
Module 2: Requirements Stakeholders and Elicitation

Dos and Don’ts of Requirements Gathering


Do talk with a vertical span of business people, including executives,
directors / managers and analysts.
Don't rely on a single user to represent the business, even if it's less
intimidating and easier to schedule.
Do allow plenty of time to coordinate calendars for scheduling,
especially with travelling business management.
Don't get angry if someone has to reschedule at the last second.
Do get help from skilled assistants to manage scheduling.
Don't offload interview coordination to someone unfamiliar with the
project or organisation.
Do arrive for the interview on time.
Do be professional and respect the other person’s time. Leave your
mobile switched off and out of sight so that you don’t cause any
distractions.
Don’t use a laptop to capture notes as this creates a barrier between
you and the interviewee.
Do plan on using a two-person requirements team in each interview,
if possible – one to interview, one to scribe.
Don't overwhelm a lone interviewee with six people sitting across
from him/her, Inquisition-style.
Do designate one person as the lead interviewer with primary
responsibility for steering the session.
Don't turn the interview into a free-for-all, bouncing randomly from
one interviewer to the next.
Do flesh out your scribbled interview notes immediately, or you'll lose
much of the interesting detail by the next day.
Don't schedule multiple interviews per day.
Do document what you learned during the requirements gathering
and feedback results to close the loop with participants.
Don't lose sight of the scope of your requirements process.

83
Module 2: Requirements Stakeholders and Elicitation

Exercise 1
Open your exercise workbook and complete Exercise 1 on the case
study:

‘Stakeholders and Elicitation Techniques’.

84
Module 2: Requirements Stakeholders and Elicitation

Summary

# Subject Prepared?

1 There are many stakeholders in RE, including: 


• Business
• Project
• External

2 Stakeholders have problems in expressing


their requirements realistically, completely and
unambiguously.

3 Business Analysts face the challenge of


understanding the system, the stakeholders
and the requirements.

4 Requirements are not normally elicited from a


single stakeholder.

5 Knowledge falls into two main categories –


Individual and Corporate – and within those
into Tacit and Explicit.

6 Tacit Information is that which is understood


but not explicitly documented, nor can be
easily articulated

7 There are many requirements elicitation


techniques, such as interviewing, prototyping
and workshops.

85
Module 2: Requirements Stakeholders and Elicitation

Post Test
To reinforce the materials we have just covered, try out the following
questions in your own time. You’ll find the answers on page 213.
1. List the major types of Requirements Stakeholders.
2. What is another name for the Domain Expert?
3. List three problems faced by Stakeholders when they are
assisting the Analyst to create the business requirements.
4. List three problems faced by Analysts when crafting
requirements.
5. List the strategies aimed at changing tacit knowledge to
explicit.
6. List three benefits of workshops as an elicitation technique.

Further Reading
1. Maiden, N.A.M. & Rugg, G. (1996) ACRE: a framework for
acquisition of requirements. Software Engineering Journal,
11(3) pp. 183-192

86
Module 2: Requirements Stakeholders and Elicitation

End of Module Notes

87
Module 3: Organising and Analysing Requirements

Module 3 – Organising and


Analysing Requirements

Topics:
In this section of the course, we will cover:

• Prioritising and packaging requirements for delivery


• Organising requirements
• Ensuring well-formed requirements: the filters
• Prototyping requirements
• Verifying requirements

88
Module 3: Organising and Analysing Requirements

Analysis in Context

Once we have elicited and documented the requirements, we need


to organise them (see Hierarchy and Documentation below),
consider the releases in which they will be included and analyse
them to ensure they are complete, consistent and unambiguous, and
then negotiate with the stakeholders to seek agreement and resolve
conflicts.
Analysis often raises additional questions and we may need to revisit
the elicitation stage.

We can see from the Requirements Engineering Process that


Elicitation and Analysis make up an iterative cycle.

89
Module 3: Organising and Analysing Requirements

Poorly Expressed Requirements


Requirements are often couched in ambiguous, “woolly” terms.

For example:

“I want a user friendly system”

• Define a way of measuring user friendliness, perhaps based on


speed to learn or popularity

“The system must never fail”

• Not testable – and probably not realistic

“Response time must be 2 seconds”

• Give a range, 50% of transactions within 2 secs; 30% within 4


secs...

“Do what we currently do but faster”

• Don’t just re-implement current system

“Input will be with a mouse”

• Don’t give solutions

It’s the analyst’s job to help the business express their requirements
accurately.

90
Module 3: Organising and Analysing Requirements

Business Objectives to Solution Delivery


Business objectives drive the need for change and give rise to new
business requirements.

91
Module 3: Organising and Analysing Requirements

Defining the Requirements


As discussed previously the business objectives can help us to
prioritise our business needs, and therefore our requirements.

• By understanding the business objectives we can also make sure


that implementation activities and integration into Business as
Usual is managed to the benefit of the business.
• And map to the people, processes, technology and
organisational changes that will be implemented as part of the
change
• Longer-term business focused requirements may influence the
requirements for IT solutions, requirements which will be
expressed in functional and non-functional categories
• Solution requirements may be subject to frequent change

92
Module 3: Organising and Analysing Requirements

The Hierarchy of Requirements


Business Requirements, which we can further categorise as
general and technical requirements, tend to be those that are defined
at an Enterprise, Organisation or Departmental level. They are
usually requirements that, irrespective of the solution, are governed
by over-arching needs of the organisation.

Business objectives are intrinsic to understanding business


requirements which in turn are key to understanding and uncovering
solution requirements

Solution requirements tend to be defined at a product level, which


means that whilst each product we create is different they are all
compatible within the overall requirements of the business. Solution
requirements are typically categorised as Functional and Non-
Functional (NFR).

Requirements start to evolve very early in a project, or even at a pre-


project stage:

93
Module 3: Organising and Analysing Requirements

• These address goals and objectives set by the business, or


specific problems that need to be resolved
• The level of detail and scope increases as the requirements are
investigated, defined and transformed throughout the project
lifecycle, thus creating a hierarchy of increasing detail
• It is important to note that the level of detail and format of
requirements in one project will not necessarily be the same as in
another
• The scope, level of detail and format of requirements should be
based upon the characteristics of the product to be produced
• Deciding how much detail and formal documentation is required
at any given point is a matter for Business Analysts and
developers to judge, based on the individual project’s
characteristics

The next section explores General, Technical. Functional and Non-


Functional Requirement categories.

Other Categories
It’s important to acknowledge here that there are numerous ways of
categorising requirements.
Along with defining business and solution requirements, there may
also be a need to categorise by, for example:
• Department
• Stakeholder grouping
• Technology
• Legal
• Language

94
Module 3: Organising and Analysing Requirements

Business: General Requirements


The General group of Business requirements includes:

Business Business Legal


constraints policies • Legislative and
• Budget, timescale, • Standards, regulatory
resources etc. business rules constraints

Branding Cultural Language


• Image, style guide • Vision, approach, • If operating across
management style international
etc. boundaries

Business
continuity
• Coping with
disaster

95
Module 3: Organising and Analysing Requirements

Business: Technical Requirements


These are examples of the Technical group of Business
Requirements:

Hardware Software
• IT and other hardware • Operating systems,
package applications,
networking,
communications etc.

Interoperability Internet
• Standards for • Policies on Internet
communicating use and web services
between systems and
devices

These requirements may well derive from policies set by, for
example, the Enterprise Architecture group, aimed at aligning
Business and IT Strategies.

96
Module 3: Organising and Analysing Requirements

Solution Requirements
• Requirements are expressed as statements of what the ‘system’
must do in order to meet its business goals (Functional
Requirements) and statements about the way the functionality
should be delivered in order for it to be a successful product
(Non-Functional Requirements or NFR)
• There is a relationship between the two types of requirements in
that non-functional requirements are intended to act as
constraints within which functional requirements must operate
• All requirements must be implementable and testable, although
some operational NFRs are difficult to test before implementation
and should be the subject of appropriate Service Level
Agreements (SLAs)
• Solution requirements inform us as to what the system needs to
do (the functionality)

97
Module 3: Organising and Analysing Requirements

Solution: Functional Requirements


Example categories of Functional Requirements:

Data entry Data maintenance


• Gathering and • Changes to data,
recording data including data deletion

Procedural Retrieval
• Implementation of requirements
business rules • Reporting, responding
to enquiries

Since we are talking about software products, the description of


functionality relates to things like data capture, manipulation or
reporting, all of which must be provided by the IT system.
• Functional requirements are expressions of stakeholder needs of
a system to achieve their particular goals
• They are what the system must do, functionality it must offer

This functionality is often summarised as CRUD:


• Create – data or records added to the system
• Read – data or records available to be viewed or retrieved such
as from a search or for a report
• Update – data or records that need to be edited. Note they
usually also need to be viewed (i.e. read) first
• Delete – data or records that are removed from the system

• Functional requirements also reflect procedural needs as well

98
Module 3: Organising and Analysing Requirements

Solution: Functional Requirement Examples


The system shall:
• Hold details of all customers, including name, address, credit
limit, date of first order (Create)
• Allow changes to be made to customer details (Update)
• Report on all orders placed in the last week (Read)
• Orders can be cancelled (Delete)
• An insurance policy can have a maximum of 3 policy holders
(Procedural, business rule)

It is considered good practice to express Functional Requirements


using a verb-noun phrase.

Note: in many organisations the exact information that would make


up a customer record is covered in the general requirements. It could
though, be specific to the product being defined and so may also fit
within the functional requirements.

Often these sorts of decisions are dependent on the organisational


policies and impact to other systems. If the product being built needs
to add a new field to the customer data then this may impact all of
the systems that use customer details. This is why it is important to
properly analyse your requirements!

99
Module 3: Organising and Analysing Requirements

Solution: Non-Functional Requirements


(NFR)
Non-Functional Requirements (NFRs) are all to do with how well the
functional requirements will be provided.
They must be implementable and testable, or subject to a Service
Level Agreement (SLA).
Non-Functional Requirements are often applicable to major costs,
time and risk parameters within a project.
Requirements of this nature include:

Performance Security Access


• Speed of processing • Security levels for • Permissions, who
transactions protection of data has access to which
functionality and how

Backup & Archiving & Robustness


recovery retention • Reliability, data
• Protection against • Duration, methods, integrity, user error
loss of data eventual deletion

Availability Usability Capacity


• Timeframe for • Ease of learning, • Data volumes,
availability of ease of use transaction volumes,
functionality user volumes

Debra Paul, in the BCS book, describes non-functional requirements


as being ‘concerned with how well the solution will operate, and
answer questions such as “How quickly will it respond?” and “How
easy will it be to use?”’.

100
Module 3: Organising and Analysing Requirements

Solution: Non-Functional Requirements


Examples
Examples of NFRs, include:
Only the Accounts Supervisor may change a customer’s credit
limit.

• This is a security or access constraint

Reprint the report on demand.

• This is an availability constraint

Respond to an enquiry on available customer credit within 5


seconds.

• This is a performance constraint

You can test for a Non-Functional Requirement by asking “Is this


requirement about the way the product must be, or does it describe
an attribute that the product must have?”

Usually Non-Functional Requirements will be constraints that limit


the way the functionality will be used, such as who has access to the
functionality or data, how quickly the system will respond, availability
of data and functionality and how easy the system should be to use
(the latter being relative to the system complexity).

101
Module 3: Organising and Analysing Requirements

Uncovering Non-Functional Requirements


The important thing is to get the stakeholders involved.

Use both a ‘top-down’ and a ‘bottom-up’ approach:

Top-down
• Look at each standard NFR category and ask:
o “What constraints apply to this area?”
• Most development organisations develop their own list of NFRs
to check against

Bottom-up
• Look at each functional requirement and process activity and
ask:
o “Is this subject to any specific constraints?”
• Ensure that the functional requirement is cross referenced to any
non-functional requirement(s) by which it is constrained

What do you think?


Which are more important – functional requirements or non-
functional requirements?

102
Module 3: Organising and Analysing Requirements

Exercise 2 – Ticket Sales System


Open the exercise workbook and do Exercise 2 – Ticket Sales.

103
Module 3: Organising and Analysing Requirements

FURPS+
This is a model for categorising software quality attributes. It was
developed by Hewlett-Packard and first publicly described by Grady
and Caswell. The acronym stands for:

• Functionality – Feature set, Capabilities, Generality, Security


• Usability – Human Factors, Aesthetics, Consistency,
Documentation
• Reliability – Frequency/Severity of Failure, Recoverability,
Predictability, Accuracy, Mean Time To Failure (MTF)
• Performance – Speed, Efficiency, Resource consumption,
Throughput, Response time
• Supportability – Testability, Extensibility, Adaptability,
Maintainability, Compatibility, Configurability, Serviceability,
Installability, Localisability, Portability

FURPS+ is now widely used in the software industry.

SWEBOK
This stands for the Software Engineering Book Of Knowledge and
the document, created by the IEEE, includes major chapters on:

• Software Engineering Requirements


• Software Engineering Design
• Software Quality
• Related Disciplines of Software Engineering

Chapter 2 of the Book, which can be found


at http://www.computer.org/portal/web/swebok/html/contentsch2#ch2
has a great deal of knowledge appropriate and useful to the business
analyst.

104
Module 3: Organising and Analysing Requirements

Requirements Analysis
Requirements analysis is carried out against a checklist of analysis
areas. It is like passing the requirements through a set of filters, each
one catching specific types of problem. The syllabus suggests the
areas listed in the diagram below.

Priority,
Realism &
Overlaps Feasibility
&
Conflicts

Ambiguity
&
Testability

Filters

105
Module 3: Organising and Analysing Requirements

Priority (MoSCoW)
The first stage of requirements prioritisation is to identify the
business objectives and then keep these to hand. Any rationalisation
should map back the need against the priority.

It is important to assign priorities to requirements to allow the


business and IT to phase implementation of the change and to
manage the expectations of all stakeholders.

• Mandatory in the first increment;


M – must have cannot meet business and project
objectives without it

• Mandatory but may wait until


S – should have second increment; the system will
have short-term value without it

• Beneficial if time or funds allow, but


C – could have not central to project objectives

W – want to have • Will not be met in this delivery; may


(won’t have this be included in a future delivery
time)

The priority is not generally assigned when the requirement is first


captured (although you may find you have a good idea of how the
priorities may pan out), but later on during review and negotiation.

MoSCoW is widely used as a framework for prioritisation as it allows


the requirements to be clearly linked to the business objectives.

All requirements should be prioritised and the priorities should be


used to focus the analysis, negotiation, implementation and test. It is
pointless expending energy and resources on a requirement that is
merely cosmetic as opposed to one having massive business
impact.

106
Module 3: Organising and Analysing Requirements

Note that the priority of requirements may change over time as


conflicts are resolved and the descriptions are clarified.

MoSCoW Questions
We should examine each requirement to ensure it has been correctly
prioritised:

• Does this requirement help to achieve a business goal or goals


• How high is its business impact (MoSCoW)?
• How much risk does it carry?
• How difficult is it to implement? Will this affect its priority?
• What ‘iteration’ should it be implemented in?

107
Module 3: Organising and Analysing Requirements

Kano Analysis
Noriaki Kano developed his model in the late 1980s to help analysts
separate the real stakeholder requirements from the purely
incremental. The technique allows analysts to prioritise requirements
as a function of customer satisfaction.

There are four categories of requirement:

• Surprise and Delight – these are capabilities which differentiate


the product from the competition, e.g. the iPod nav-wheel
• More is better – improvements along a clear continuum of
increasing utility – e.g. better battery life in an MP3 player
• Must be – without these capabilities, customers will not buy/use
the product
• Better not be – these represent the aspects which would prevent
customers from buying / using the product

The first development phase of the solution should primarily include


the “Must be” requirements. The “More is better” set are prioritised
on ROI. Finally the “Surprise and delight” are examined, not because
they are whimsical, but because they are valuable differentiators
from the competition. Marketing strategies play a strong part in this
activity.

108
Module 3: Organising and Analysing Requirements

Realism and Feasibility


Requirements Engineering should not be conducted in a vacuum. It
is important to keep realism and feasibility in mind during the process
(and the business objectives can help to achieve this).

There are three aspects to feasibility:


• Technical: is there technology available to implement the
requirement? It is important to discuss technology with our
technicians early in the process
• Business: assessment of acceptability by the business. By
engaging with the business stakeholders, we can ensure that the
proposals are realistic in their view
• Financial: is the expenditure to implement the requirement
justified? In the end the product’s Sponsor must make this
judgement

109
Module 3: Organising and Analysing Requirements

Overlaps and Duplication


• Where requirements overlap, they must be separated
o Overlapping requirements may mean they are not atomic
o Separate out the individual, atomic requirements and delete
any duplication
• Where requirements duplicate each other, either delete one of
them or merge them where each has useful information

It is good practice to cross-reference requirements when deleting or


merging. Some Requirements Engineers create a new requirement
that incorporates the merged requirements and archive the
requirements that are merged (so as to never re-use requirement IDs
and thus allow the requirements to be fully traceable).

110
Module 3: Organising and Analysing Requirements

Conflicts
Sometimes requirements will conflict with one another, sometimes a
requirement may contradict another. In either case the analyst must
work to resolve the issue.

• Conflict can exist for many reasons, and is completely normal,


e.g. security of the systems vs usability of the solution
• The differing views (perspectives) of the stakeholders in conflict
needs to be properly understood
o Identify the areas of agreement / disagreement and facilitate
discussion to find a compromise position that still meets the
main objectives or allows the stakeholders to sell the new
position to colleagues
• Be prepared to escalate but understand the consequences.
• Also be aware of conflicting data requirements, e.g. data
manipulated does not match the data captured

111
Module 3: Organising and Analysing Requirements

Ambiguity
Ambiguity is inherent in requirements definition as requirements are
typically expressed using text.

Business Analysts can also add ambiguity through documenting


requirements using language they themselves understand. This is no
guarantee that another reader will interpret them in the same way.

Business Analysts can also try to add some variety into their
requirements through use of language – we have to maintain and
use simple, standard terminology, despite it being boring to write!

Stakeholders may express their requirements in a way that makes


perfect sense to them, but may mean other things to other people.
This is particularly true of non-functional requirements.

For example, if the stakeholder says that they want the system to be
easy to use we need to define what they mean in measurable terms.

‘Easy to use’ may be measured by means of a test or a survey with


acceptable results defined in advance, e.g. ‘Easy to learn’ means
that a novice can pass a competence test with score of at least 70%
after 1 hour of training.

Dealing with ambiguity


There are some simple steps we can take to ensure we are not
introducing or retaining ambiguity in our requirements:

• Use clear, simple, standard language expressions, see below


• NFRs need to be defined in measurable terms – use standards
• Models often support driving out ambiguity
o In this course we look at the effect of using the requirements
to interpret a data model
• Consider the testing – if you can’t test it, it might be ambiguous
• Use standard requirements templates
• Use standard definitions
o E.g. define what a functional, non-functional, technical
requirement means in your team

112
Module 3: Organising and Analysing Requirements

• Use a glossary and distribute it to all stakeholders


• Use prototypes to help clarify understanding

Structuring your requirements


There are many ways to write requirements. Good practice is to use
the following notation:
1. User (or user role)
2. Verb phrase
3. Object or Noun phrase
For example:
• The Help Desk Supervisor shall be able to view all outstanding
tickets by date

Note: using ‘shall’ also helps avoid any implicit prioritisation that
Must, Should, Could or Would may bring.

113
Module 3: Organising and Analysing Requirements

Exercise 3
Analysing Requirements
Open the exercise workbook and with reference to the Goatilicious
Case Study scenario do Exercise 3.

114
Module 3: Organising and Analysing Requirements

Testability
• Testers should be invited to reviews of requirements
specifications and this should start early on so that the
requirements can be properly formed
• Only a few testers, preferably the more experienced or senior
ones, need be involved

Requirements Acceptance Criteria Acceptance


Analysis Testing

Requirements
Test
Specification Specification

This approach helps to limit those nasty surprises that tend to appear
towards the end of the project. In turn, this should improve overall
productivity.
Note that if testers have been involved in the initial reviews of
requirements, they should also be involved in reviews of changes to
requirements.
Testing should be built in to the project from the outset.
What the Testers look for
Primarily, Testers are thinking “Can we test this requirement?”
• Do we understand the requirement as written?
o Is it too vague or ambiguous to test?
• Can we create a test script directly from the description?
o Do we understand the data sufficiently to write the test?
o Do we understand the constraining business rules?
o Do we know the pre-conditions for the tests?
o Do we know the post-conditions for the tests?
o Do we know the required response to exceptions?

115
Module 3: Organising and Analysing Requirements

The test scripts written at this stage are high-level detail, e.g. of user
interfaces, will follow. A requirement that cannot be tested is no use
to anybody. However, operational requirements may be covered by
SLAs.

The test plans written at an early stage may be high level but at least
some assurance of testability has been obtained.

116
Module 3: Organising and Analysing Requirements

Prototyping Requirements
What is Prototyping?
• Prototyping is a technique that enables the development of a set
of screens for one or more requirements
• The screens might be true GUI screens or simply mock-ups and
system functionality might be actual or simulated

Prototyping is a good method to refine requirements by avoiding the


“blank page” syndrome. It is especially suitable in ‘greenfield’
scenarios, or where major changes carry high risk. Once the broad
requirements are known, an initial screen set (and perhaps
functionality) is built which can be tested for usability and fitness for
purpose.

Why do it?
The users need to be involved so they can confirm acceptability,
understanding or specify further changes (i.e. requirements).

• It is considerably easier to validate requirements against even


simple prototypes
• It helps the reviewers visualise the requirement and spot errors
and inconsistencies
• Evaluates the initial look and feel
• Promotes shared responsibility for the requirement
• Results in early error identification and resolution

The dangers with prototypes include scope creep, and slipping into
design mode, before we have clarified the requirements.

Whether full application code and data are used is a decision that
needs to be made before prototyping starts, as this can cause issues
where users see further advancement than is actually the case.

117
Module 3: Organising and Analysing Requirements

Types of Prototype
Paper
• Screen mock ups are created on paper or sticky notes and used
to walk through requirements scenarios
• This method can be surprisingly effective and it also avoids the
issues with ‘designing’ the solution

User Interface
• An IT user interface prototype is created but the functionality is
lacking or partly simulated

Full Prototype
• Both functionality and interface are created using the technology
that will be used

Note: for requirements purposes, it is better if the prototype is not too


realistic. We want to try to avoid a design or solution focus as users
may lose the purpose of the prototype (and start critiquing the design
or solution!).

See the QA++ on Wireframes further on if you’re interested in


creating solution or design agnostic prototypes.

118
Module 3: Organising and Analysing Requirements

Verification
Verification is the process of ensuring that the requirements are
ready to be validated. We verify that we have captured the
requirements correctly and they are complete before we gain
agreement.

A final check once all filters


have been applied and
prototyping completed:

Is each
requirement well-
written, clear and
SMART?

Are the requirements ready for validation?

119
Module 3: Organising and Analysing Requirements

Wireframes
Wireframing is a tool used in Information Architecture (designing
screens and deciding how to organise them). It is commonly
associated with website design.

Whilst it is not a skill that a Business Analyst is expected to master,


using wireframes can help to avoid some of the pitfalls of
prototyping.

A wireframe is similar to an Architect’s schematic: whilst the


customer can easily see where the doors and windows are, the size
of the rooms and the overall layout, they do not at this stage get
distracted by what the wooden floor will look like in the hallway.

The idea of wireframing is that the skeleton of a screen can be


shown with all of the components which can sometimes be helpful in
allowing stakeholders to visualise what they will need, and therefore
draw out the requirements. Traditionally, wireframes are created
using paper templates but more and more there are software tools
which do the same job.

We use modelling in a similar way, as you will see later on.

Some common tools for wireframing, aside from pen and paper, can
be found at the following:

http://balsamiq.com/

http://www.axure.com/

Illustrator, Omnigraffle and Visio all have templates that can be


downloaded to use for wireframing.

120
Module 3: Organising and Analysing Requirements

Exercise 4
Prioritising Requirements
Open the exercise workbook and with reference to the Goatilicious
scenario do Exercise 4.

121
Module 3: Organising and Analysing Requirements

Summary

# Subject Prepared?

1 Requirements are often couched in ambiguous 


terms.
2 Requirements are hierarchical in nature.

3 Business requirements are divided into General


and Technical.
4 Solution requirements are divided into functional
and non-functional.
5 NFRs constrain how functional requirements
deliver their benefit.
6 NFRs are uncovered using a combination of top-
down and bottom-up analysis.

7 It is important to prioritise requirements to allow


phased implementation (most important first) and
to manage the stakeholders’ expectations.
8 A common approach to prioritising requirements
is MoSCoW.

9 Requirements should be filtered for:

• Priority, Realism and Feasibility


• Overlaps and Duplication
• Conflicts
• Ambiguity
• Testability

10 Prototyping allows the analyst to help the


stakeholders firm up their requirements,
particularly in graphical areas.
11 Verification is the process of ensuring that the
requirements are ready to be validated.

122
Module 3: Organising and Analysing Requirements

Post Test
To reinforce the materials we have just covered, try out the following
questions in your own time. You’ll find the answers are on page 214.

1. The Requirements Engineering Process is built of four steps,


run iteratively. Three of these are Elicitation, Documenting
and Negotiation. What’s the fourth?
2. Two major groupings of requirements fall out of the Business
Objectives. What are they?
3. General and Technical Requirements make up which major
group of requirements?
4. To which group of requirements does “Interoperability”
belong?
5. What is a Non-Functional Requirement?
6. What is the acronym commonly used when prioritising
requirements?
7. What are the three main levels of prototyping?

123
Module 3: Organising and Analysing Requirements

Further Reading
1. SWEBOK Manual Chapter 2
IEEE: http://www.computer.org/portal/web/swebok/html/conte
ntsch2#ch2

124
Module 3: Organising and Analysing Requirements

End of Module Notes

125
Module 4: Use of Models in Requirements Engineering

Module 4 – Use of Models in


Requirements Engineering
Topics
In this section of the course, we will cover:
• The purpose of modelling requirements
• Modelling the business context for the system
• Developing a model to represent the system processing
requirements
• Interpreting a data model

126
Module 4: Use of Models in Requirements Engineering

What do you think?


Why do we model requirements?

127
Module 4: Use of Models in Requirements Engineering

The Purpose of Modelling Requirements


Requirements are modelled in order to check understanding,
completeness and to provide a vehicle for clear communication
between all parties in a project.

Generating
questions
Cross-
checking for
Unambiguous
consistency
communication
and
completeness

Clarifying Defining
understanding Models business rules

128
Module 4: Use of Models in Requirements Engineering

Modelling the Business Context for IT


systems

The process model above is often used to confirm requirements.


Only some of the interactions shown will need to be supported
through IT functionality.

• The Business Analyst will usually model this using some form of
process model, typically a flow chart with swimlanes, as shown
above
• Business Analysts also make use of techniques such as
Scenario building that we have mentioned earlier, and perhaps
even create personas (fictitious users)
o Personas help us to understand how the system will be used
by different types of users; encompassing their capabilities,
expectations and needs
• Each Task in the process model is examined to determine what
IT support could be deployed. Conversely, if we are given an IT
requirement we need to know what Task within what Process it
supports

129
Module 4: Use of Models in Requirements Engineering

Modelling Functionality and Data


• We need models to communicate and describe the functionality
and data requirements for our system
• These models help us to ensure we have a complete view of
where users need interaction with IT to complete their goals and
what data will support that process from start to end

For example, for the process ’Rent Vehicle’:

• For the Record Rental activity, a sales person needs


functionality to allow them to capture customer details such as
name, address, contact details and billing information which
would result in data groups detailing Customer, Vehicle, Rental
details and Address
• For the Take Payment activity, a sales person needs
functionality to advise on the Billing details (who to take
payment from), Address and Payment details (how much and
method of payment)
• For Record Return, the sales person needs functionality to find
the vehicle and record the inspection details against as well as
log that vehicle back in so other customers can rent it

Each function also uses data that is then passed between each role.

130
Module 4: Use of Models in Requirements Engineering

Use Cases
The use case diagram is used as a summary of the required
functional requirements for the IT system.

Use cases:

• Encapsulate business functionality in a highly graphical way, and


represent the user’s perspective and needs
• Use cases can be identified by:
 Examining process models
 Reviewing documentation, procedures
 Interview, workshops etc.

Each use case is supported by descriptions showing the “happy day”


path and the exceptions / alternates which can arise

• Use cases can also be supported by prototypes and other forms


of documentation and diagrams
• Optionally, they may be further supported by activity diagrams

Once we have an idea of the functionality our users will require, we


can begin to document this using a Use Case Diagram.

What is a Use Case?


A use case is a ‘structured requirement’ that describes a piece of
system functionality. It describes the ‘what’ not the ‘how’ (that comes
later!).

• The use case is expected to deliver a result of value to an actor,


allowing them to achieve a goal they have of the IT system; a
‘case of use’, hence ‘use case’
• A use case is a description of the external sequence of events
between an actor and the system needed to meet the actor’s
goals
• All use cases are, by definition, within the scope of the system.
The sum of the use cases is “The System”
• The naming of use cases is important:

131
Module 4: Use of Models in Requirements Engineering

o Use cases should be named using a verb-noun phrase such


as ‘Create Purchase Order’, ‘Accept Delivery’ etc.

132
Module 4: Use of Models in Requirements Engineering

Use Cases: levels of detail


There are a number of different levels of detail that we can use to
describe our functionality within the use case notation.

Context Diagram

The first is a Context Diagram. This describes the actors of the


system and the system boundary itself, but treats the system as a
‘black box’. We do not need to go into the detail of these here

Use Case Diagram

133
Module 4: Use of Models in Requirements Engineering

The next level is the Use Case Diagram itself. The context diagram
is expanded and we now show what happens within the system
boundary using Use Cases to represent the goals of the users. This
step is useful in analysis because it helps the Analyst uncover what
functionality the user needs from the system

Use Case Description

The next level is the Use Case Description. This expands on a


single Use Case and describes the pre-conditions, inputs, outputs,
post-conditions, actors, business rules etc. that govern the use case

Contained within is also the Use Case Description Flow; the main
dialogue that needs to occur between the users and the system, and
the alternative paths. This is sometimes represented as an activity
diagram

134
Module 4: Use of Models in Requirements Engineering

This course covers Use Case Diagrams and Use Case Descriptions
(primarily the main flow with a summary of the alternative and
exception paths).

In the exam you may be asked to draw a Use Case Diagram to


represent a set of requirements or you could be asked to describe a
Use Case Description Flow.

135
Module 4: Use of Models in Requirements Engineering

Actors and the System Boundary


An actor is an external entity (i.e. external to the system) performing
a named role with respect to the system:

• The role requires participation in one or more system use cases


• An actor is often a role played by a human but it can be any
mechanism interacting with the system including other computer
systems or devices
• Time can also be represented as an actor and often the time we
need is shown. This could be a specific time such as 9am or a
frequency, such as weekly, monthly or every three months
• In some notations you may see an actor illustrated as a
rectangular box
• If a system is being represented in our use case then we can
show this actor as well, using ‘<<’ and ‘>>’ to show we’re
stereotyping the actor notation

A use case can also show different types of actors:


• A primary actor triggers the use case…
• Whereas secondary actors provide input to the system and/or
receive output from it

136
Module 4: Use of Models in Requirements Engineering

Key points about Use Cases


• Use cases are always described from the actor’s point of view
• Use cases yield a result of value to that actor in the context of
their work, and achieves a goal of the user
• Use cases support activities in business processes and therefore
describe only interactions with the system and not events
outside
• They should not be confused with business processes:
o The use case is a piece of IT functionality
o A business process is an end-to-end set of business
activities, some of which may be supported by use cases

Use Case Notation


Use case diagrams are very simple to understand.

We can clearly and unambiguously define the scope of the project,


the users and their roles. If we are building or updating multiple
systems, then each system can be documented separately, allowing
us to ‘see’ the requirements of each system and therefore each
actor’s needs separately.

If no association exists between an actor and a use case then, when


the system is built, it should NOT be possible for a person logged on
in the role of that actor to gain access to that use case.

The main symbols are Actor, Use Case and User Association:

In the diagram above, the actor ‘Sales Team’ is involved with the use
case ‘Record Rental’.

137
Module 4: Use of Models in Requirements Engineering

In UML 2 the association should only have an arrow on it when an


actor is the recipient of output but hasn't been involved directly with
the use case.

Use Case Diagram


The use case diagram encapsulates the system boundary, actors
and functionality in an easy-to-understand deliverable.

From our process model we can see that there are requirements for
the following:

• The Sales Team shall record Vehicle rental details in the Vehicle
Rental system
• The Sales Team shall record Vehicle return details in the Vehicle
Rental system
• The Sales Team shall be able to search for Vehicles in the
Vehicle Rental system
• The Workshop Supervisor shall record the results of an
inspection in the Vehicle Rental system
• The Workshop Supervisor shall be able to search for Vehicles in
the Vehicle Rental System

138
Module 4: Use of Models in Requirements Engineering

What do you think?


The use case also covers one category of Non-Functional
Requirement… what is it?

139
Module 4: Use of Models in Requirements Engineering

Exercise 5(i)
Document Management System
In the exercise workbook you will find exercise 5 ‘Document
Management System’.

Complete Part (i) of this exercise.

140
Module 4: Use of Models in Requirements Engineering

The «include» Relationship


There are pieces of functionality within a system that are common
and used multiple times.

The example below shows a member of the Sales Team renting out
a vehicle. When (s)he initiates this use case, it (in turn) triggers the
functionality to take the payment for the hire. Take Payment is a
common piece of functionality.

The «include» relationship indicates that this action is always done.

Using relationships like this permits a degree of re-usability of


subordinate use cases like “Take Payment”.

141
Module 4: Use of Models in Requirements Engineering

Use Case Diagram with <<include>>


The diagram below shows the previous diagram, this time using
«include».

In this example (although not shown in the process model) a


payment must be taken when the rental is recorded and when it is
returned. Both use cases require access to the same functionality, so
we have a common use case, ‘Take Payment’.

The «extend» Relationship


The extend relationship shows pieces of major functionality that only
occur under certain conditions:

• If this functionality is very different and has some complexity it


may be better to model it as a separate use case to avoid over
complicating the main functionality
• In the process model we have a condition whereby if the fuel
tank isn’t full when the customer returns the vehicle we need to
take a payment. If the customer has returned the vehicle with a

142
Module 4: Use of Models in Requirements Engineering

full tank the vehicle passes the inspection and nothing happens
except to record the return
• The diagram below shows that “Record Return” may be
extended by the functionality of “Take Payment” if the customer
returns the vehicle without filling up the petrol tank

143
Module 4: Use of Models in Requirements Engineering

Use Case Diagram Complete


Here we can see the complete use case diagram, using normal
associations and those with «include» and «extend».

Note that we have taken out the ‘Search Vehicle’ use case for
simplicity. Use case diagrams by their nature can get quite
complicated!

144
Module 4: Use of Models in Requirements Engineering

Exercise 5 (ii)
Document Management System
In the exercise workbook you will find exercise 5 ‘Document
Management System’.

Complete part (ii) of the exercise.

145
Module 4: Use of Models in Requirements Engineering

Exercise 6
Use Case Diagram
In the exercise workbook, with reference to the Goatilicious case
study scenario complete Exercise 6.

146
Module 4: Use of Models in Requirements Engineering

Modelling Data
So far we’ve looked at the functionality needed to satisfy and confirm
the requirements. But what about the data?

The Use Case ‘Record Rental’ will allow the sales person to meet
their goal to log the rental on the system and will also capture
information that will identify the Customer (including we would
assume such information as driving licence details), the Vehicle and
the Rental period, enable Billing and update the customer account (if
necessary).

Why model data?


A clear understanding of the meaning and structure of the required
data is at the heart of effective requirements analysis and systems
design. This is true of projects both large and small and in all
technical environments.

Data analysis is the technique of examining the data requirements of


a part (or all) of the business to produce a model of that data that will
support the process requirements. The scope of investigation can
vary from a relatively small application system to the organisation as
a whole.

There are two common standards in use for modelling data: the
Entity Relationship Diagram from Structured Systems Analysis and
the Class Diagram from the Unified Modelling Language.

In this syllabus we look at the Class diagram from the increasingly


popular UML notation.

147
Module 4: Use of Models in Requirements Engineering

A thorough data model is necessary for the following reasons:

• To determine the data requirements of the system


o What data does the system need to store?
o Omitting required data from the requirements can have very
serious consequences, nearly always more serious than
omitting required processing
• It provides a common understanding of the data
o This is vital if different applications, or different components of
an application system, are to share data
• It is the basis of the technical implementation
o The data model is the start point, no matter what the eventual
technical implementations are to be
• It defines integrity rules about the data
o In a particular business, data is not haphazard; it has a
structure or rules that reflect rules about the business

The Class Diagram


The data model defines what data is required, how it is structured,
what it means and the integrity rules about that data. The data model
consists of full descriptions of each:

• Class – a type of thing of interest to the business, the groupings


of data
• Attribute – lowest level data item, a property of a class, the
individual pieces of information we need about the data grouping
• Association – a link between classes, the business connections

The data model is a conceptual model of the business data.

That is, it models the data requirements independent of:

• The technology that will be used to store the data


• The way in which individual processes require to view the data
• Any performance constraints

148
Module 4: Use of Models in Requirements Engineering

A Class is...
... any thing about which data information is to be recorded.

In a garage some classes would be:

• People and Organisations like:


Supplier, Customer, and Employee
• Things like: Vehicle Model, Vehicle,
and Part
• Events like: Sale, Service
• Places like: Garage (assuming they
have several)

149
Module 4: Use of Models in Requirements Engineering

Components of a Class

* You do not need to understand or use Operations for the RE exam,


although you may need to be aware of their relevance in classes for
the Oral Exam.

Class
A class is shown as a simple, rectangular
container with its name (a singular noun) in
the uppermost of its two compartments. If the
name has more than one word, the first letter
of each should be capitalised and spaces
should be omitted. Example names are:
• Customer
• QuoteType
• CourseBooking
• BankAccount

Think of a class as a template for the group of data you wish to know
about.

Every Customer you have on the system will be shaped in the same
way, as will every Quote Type and every Bank Account.

150
Module 4: Use of Models in Requirements Engineering

Attributes are...
... the things, pieces of data, we need to know about the class.
Note that each attribute can hold only
one value at any one time.

Attributes are shown in the lower


compartment of the class, as you can
see here.

Attribute names are normally shown


with a lower case first letter and all subsequent words in the name
having uppercase first letters (‘camel case’).

We do not always show the attributes in the class model –


sometimes at the early stages of the analysis we are simply trying to
understand the data groupings and the business connections
between them.

Again, think of the template – each Customer you have on the


system will have a Customer Number, a Name and an Address.

Operations are…
• The procedures you can perform using
the attributes in the class
• They are invoked by messages sent
from other classes
• The attributes within a class are only
accessible by the operations of that
class (known as encapsulation)
• If we wanted to update a credit limit:
o A message would be sent to the
Account class with the Account
Number and the Name and the
amount the Credit Limit needs to be
adjusted to

151
Module 4: Use of Models in Requirements Engineering

An Association is...
... a logical, meaningful business connection
linking two classes.

• Delegate ATTENDS course


• Customer MAKES booking
• Passenger TRAVELS ON train
• Employee SELLS vehicle

For the last example, we have one possible


association between the Employee and the Vehicle classes.

It will support the requirement to know, for a given Salesperson,


which Vehicles they sold; and for a given Vehicle, which Salesperson
sold it.

Associations need to be named precisely to reflect the business


rules they are supporting. We only include those which are direct and
of interest to the business.

Association
In UML an association is shown as a simple line between the two
classes.

To enhance meaning, it is often also labelled and given an arrow to


help understand the directionality of the description.

Note that the label and the arrow are not always present.

152
Module 4: Use of Models in Requirements Engineering

Multiplicity of the Association


Numbers, at each end of an association, indicate the range of
numbers of instances of the class allowed in the relationship: the
multiplicity.

Note that the asterisk means an unspecified “many” in UML.

Possible values for these multiplicities include:

• 0..1
• 0..10
• 0..* (or just *)
• 1..*
• 1..1 (or just 1)
• 3..12

Note that the separator in these ranges is a double dot, not a triple
dot, which means an ellipsis in English.

• A ‘1’ on its own means 1..1, i.e. 1 and only 1.


• A ‘*’ on its own means 0..* i.e. zero to many

Here is an example of the use of multiplicities:

A Customer owns zero or more Vehicles.

A Vehicle is owned by zero or one Customer.

153
Module 4: Use of Models in Requirements Engineering

Reading the Class Model


The direction of the relationship (if present) helps decide the
requirement, starting from the Customer end.

Start with the class pointing away from the relationship, in this
example that’s Customer.

Customer (class) Owns (relationship) zero or many (multiplicity:


0..*) Vehicle(s) (class).

And reading back the other way:

Vehicle (class) is owned by (relationship) zero or one


(multiplicity: 0..1) Customer (class).

You may ask how a vehicle can be “owned” by zero customers but
consider those vehicles which have not yet been purchased – the
model must hold ‘true’ at all moments in time.

The fact that a Customer can own zero vehicle, allows the customer
to be present on the system before they own anything and therefore
allows for records to be kept that log enquiries and information sent.
Perhaps while the customer is in the pre-purchase phase.

154
Module 4: Use of Models in Requirements Engineering

Generalisation Association
A generalisation association is not between classes but is a form of
documenting a single class:

• The Base Class holds all the common attributes


• The Sub-classes inherit these but have their own attributes too
• In this example, Current Account and Savings Account are both
types of Account

This strategy will make it easy to add new types of account later, if
needed, without changing the existing definitions.

155
Module 4: Use of Models in Requirements Engineering

Modelling Requirements
The question, now, is: “How do we take our requirements and
construct a data model which supports them?” Consider the following
requirements:

• The system is to record for a given Employee, which Vehicles


they sold as new
• The system is to record details of all Services performed on each
Vehicle
• The system is to record which Vehicles are currently owned by
which Customers

You can see that there are four key “things” here:

• Customer
• Vehicle
• Service
• Employee

This will give us four classes. You must consider which of these
relate to which others and how many of each there might be at each
end of the association.

See the suggested solution below:

156
Module 4: Use of Models in Requirements Engineering

The CRUD Matrix – Cross Checking


Recall that use cases are built from functional requirements. Do all
the use cases actually do something? Is all the data used? Does the
system process data items that are never created? Can data be
deleted?

As with the identification of functional requirements we can use


CRUD.

In this case we can use a CRUD Matrix to ensure that we know which
use cases create, read, update and/or delete each entity.

Class
Customer Vehicle Employee Service Account

Take R U
Payment
Record R U R
Rental
Use Case

Record R RU U R
Sale
Manage CRUD
Customer
Add C
Vehicle
Record R U U C R
Service

157
Module 4: Use of Models in Requirements Engineering

Housekeeping Use Cases


Often we may find that we are missing a use case whose job is, for
example, to delete obsolete service records (in our garage scenario).
This might simply be because it never came up during interviews and
the analyst didn’t think of it at the time. It may be that a completely
different system is responsible for this but at least we will have
checked. The CRUD Matrix helps us do this.

Use Cases like this are often called “housekeeping” use cases and
often do not appear in the project until some form of verification is
performed.

158
Module 4: Use of Models in Requirements Engineering

Exercise 7 – At the Vet


In the exercise workbook you will find Exercise 7 ‘At the Vet’.

159
Module 4: Use of Models in Requirements Engineering

Exercise 8
Class Diagram
In the exercise workbook with reference to the Goatilicious scenario
complete Exercise 8.

160
Module 4: Use of Models in Requirements Engineering

Summary

# Subject Prepared?

1 Requirements are modelled in order to check 


understanding/completeness and to provide a
vehicle for clear communication between all
parties in a project.

2 A Process Model shows the context for the IT


System.

3 A use case is a ‘structured requirement’ that


describes a piece of system functionality.

4 An actor is an external entity performing a


named role with respect to the system.

5 Use cases are always described from the


actor’s point of view and yield a result of value
to that actor.

6 Use Cases should not be confused with


processes.

7 The «include» relationship indicates that when


the primary use case is triggered, the
subordinate one is always subsequently
triggered, too.

8 The «extend» relationship means that when


the primary use case is triggered, the
subordinate one will also be triggered if the
specified condition is met.

9 The domain class diagram is a model of the


business domain’s data which defines the
entities, their attributes and the associations
between them.

161
Module 4: Use of Models in Requirements Engineering

10 A class is shown as a simple, rectangular


container with its name, a singular noun, in the
uppermost of its two compartments.

11 Attributes are the things we need to know


about the class.

12 An association is a meaningful relationship


between classes. It has a name and direction
to enhance meaning.

13 Multiplicities are the number of possible


instances at each end of a relationship.

14 The CRUD Matrix affords the analyst a useful


way to check that the functionality of the use
case diagram is complete.

Post Test
To reinforce the materials we have just covered, try out the following
questions in your own time. You’ll find the answers are on page 215.

1. What is an Actor?
2. What is a use case?
3. From which perspective are use cases described?
4. What is the only occasion in which you would expect a
normal use case association to have an arrow?
5. What are the conventions to be applied to class names?
6. How many values can a class attribute normally hold?
7. What do we call the numbers at each end of an association
between two classes?

162
Module 4: Use of Models in Requirements Engineering

Further Reading
8. “Writing Effective Use Cases”, Alistair Cockburn. ISBN-13:
978-0201702255.
9. “Data Modeling Made Simple”. Steve Hoberman. ISBN-13:
978-0977140060

163
Module 4: Use of Models in Requirements Engineering

End of Module Notes

164
Module 5: Requirements Documentation

Module 5 – Requirements
Documentation
Topics
In this section of the course, we will cover:

• Documentation styles
• User stories
• Use cases
• Requirements catalogue

165
Module 5: Requirements Documentation

What do you think?


How do you usually document requirements?

166
Module 5: Requirements Documentation

Documentation Styles
There are many styles of documentation to choose from:

• Catalogue
• Business Requirements Document (BRD) or Business
Requirements Specification (BRS)
• Prioritised Requirements List (PRL)
• Functional Specification
• Software Requirements Specification (SRS)
• User Story
• Use Case
• IEEE 830, IEEE 1233, and so on

Often the decision about which documentation to use will depend on


existing standards within your organisation.

It may also be governed by the nature of the deliverables you need,


the project methodology and even the experience of the resources
working on the project.

Many Different
styles and
levels
variations

Dependent on
company
conventions
Iterative and type of
application

167
Module 5: Requirements Documentation

Agile Approach
Agile is an incremental, iterative development methodology that is
promoted through self-organising teams and cross functional working
practices.

Agile Manifesto
“We are uncovering better ways of developing software by doing it and
helping others do it. Through this work we have come to value:
Individuals and interactions over processes and tools
Working software over comprehensive
documentation
Customer collaboration over contract negotiation
Responding to change over following a plan
That is, while there is value in the items on the right, we value the
items on the left more”

In Agile, documentation is kept to a minimum due to the evolutionary


nature of development, but contrary to popular belief this doesn’t
mean that documentation doesn’t exist at all.

The artefact nearest to a ‘requirements’ document is the User Story


and the Business Analyst typically manages the Product Backlog, as
well as liaising with Product Owners and the project team to ensure
that the ‘requirements’ meet the criteria of the business objectives.

There are many different variations of agile, including DSDM, Scrum


and XP.

168
Module 5: Requirements Documentation

User Story (Agile)


• User stories are often brief, informal expressions of a
requirement, written by the stakeholder and representing some
feature to be developed
• User stories are used heavily in XP and other agile
methodologies where there is close contact between the
customer and the developer
• Very little documentation is produced (or even expected).

169
Module 5: Requirements Documentation

Often the User Stories are written in the format:

As a [role], I want to [use a feature] so that I can [achieve


a goal/rationale]

For example: “As a customer I want to register my details on the site


so that I can book a hotel room quickly whenever I need to”.

User Story Characteristics

170
Module 5: Requirements Documentation

Reminder: Use Case Diagram


Use cases are the goals that the user requires of functionality from
the system. They are linked to the actors through the associations in
the Use Case Diagram.

Record Rental, Record Return are the goals of the actor ‘Sales
Team’ in the above example.

171
Module 5: Requirements Documentation

Individual Use Case Documentation


Use Cases are documented as dialogues:
• Detailed description of the interaction between the user and
system
• Primary scenario (‘happy/sunny path’) documented first
• Alternates and exceptions documented separately
• Pre-conditions and post-conditions
• May be supported by activity diagrams, or shown in a tabular
format

You’ll sometimes need to


use a table to describe the
interactions.

172
Module 5: Requirements Documentation

Use Case Description: elements

The use case description is made up of elements that summarise the


main requirements of the functionality needed to achieve the users
goals, such as:

• What needs to be in place prior to the use case starting


o The pre-conditions
• What needs to be there once completed
o The post conditions
• The use case narrative, structured as a dialogue between the
Actor (the User) and the IT system
o The dialogue should refrain from using any language that
suggests a solution

Although the Use Case Diagram is a part of the UML and, therefore,
subject to its strictures, the Use Case Description has no template
prescribed by OMG (Object Management Group).

173
Module 5: Requirements Documentation

Use Case Description Template


The following headings are commonly used:

• Name (verb-noun
phrase)
• Identifier (unique
identifier for this use
case)
• Description (a few
sentences describing
the basic intent of the
use case)
• Primary Actor
(who/what initiates
the use case)
• Secondary Actors
(any other actors that
may be involved)
• Preconditions (things
the system can
ensure will be true
before the use case starts)
• Primary Scenario/Main Flow (describe the “normal” processing
path as a dialogue between Actor and System)
• Alternate Flows (describe any variations on the main flow)
• Post conditions (the state of the system on completion of the use
case)

174
Module 5: Requirements Documentation

Use Case Description Example


A simple example for our Vehicle Rental system:

Heading Description

Name Record Rental

Identifier UC01

Description Sales Person selects the vehicle, rental period,


and records the rental, as well as taking
payment

Primary Actor Sales Person

Pre-conditions • Sales Person logged in, Rental screen


displayed
• Customer selected
• Vehicle and Vehicle status on system
• Hire Rates on system

Main Flow See below

Alternative Flows See below

Post-conditions Rental recorded, vehicle status updated,


payment taken

If a question asks you to document the interaction between users of


a system you will be producing a Use Case Description – Main flow.
It is unlikely you will be asked to document, in detail, the alternative
flows but you may be asked to identify a specified number of them.

175
Module 5: Requirements Documentation

Use Case Description – Main and Alternate


Flows
It is common practice to document the ‘main flow’ of the Use Case,
the narrative, and then specify a number of alternative flows, to cover
other possible ways things might go, and to specify exception
handling. ‘Normal Path’, ‘Happy Day’, ‘Sunny Day’ are all names
commonly used as labels for the main flow.

It is simply, what the use case should achieve to satisfy the users
goals.

Main Flow
1. Sales Person selects ‘New Rental’
2. Vehicle Rental System displays Vehicle selection list
3. Sales Person selects vehicle
4. Vehicle Rental System displays available dates
5. Sales Person selects start date required (A1)
6. Sales Person selects end date required (A2)
7. Vehicle Rental System confirms selections
8. Sales Person confirms rental period (A3)
9. Vehicle Rental System calculates and displays price
10. Sales Person selects payment method
11. Vehicle Rental System records payment and updates vehicle
status

Alternate Flows

• A1. Vehicle not available for selected start date


• A2. Vehicle not available for selected end date
• A3. Sales Person wishes to change rental period

Note how the flow is specified as a dialogue between the Actor and
the IT System.

Note also that there is no solution language used here – the Use
Case describes the requirements, as seen from a user’s perspective.

176
Module 5: Requirements Documentation

Column/Table Use Case Format


A columnar / table format for specifying this dialogue is also used,
where the Actor / System dialogue structure may be clearer.

177
Module 5: Requirements Documentation

Requirements Document
A typical Requirements Document is likely to contain at least the
following sections:

• Introduction and Background


o Describes the scope of the project and its objectives
• Business Process Models
o Shows the “to-be” model as swimlane diagrams
• Function Models
o Context diagrams and Use Case diagrams
• Data Models
o A clear picture of the data requirements of the project in entity-
relationship diagrams and/or class diagrams
• Requirements Catalogue
o A detailed description of each requirement – we’ll be looking at
this in more detail shortly
• Glossary
o A clear definition of the terms used – it might be for this project
only or organisation-wide

178
Module 5: Requirements Documentation

Business Dialects
Particularly in large, geographically-dispersed organisations, the
tendency for regional business dialects to grow needs to be carefully
considered. This is also true of organisations, which might be based
in a single region but have a number of independent product lines or
“silos”.

For example, one business line in the company might refer to a


customer as an “Opportunity”, while another uses the more
traditional name for the entity (in this example the more traditional
name would be ‘Customer’).

“Customer” and “Opportunity” are referred to as synonyms. We are


able to tell that they refer to the same entity because they will be
used in the same way and will have an identical set of attributes.

A slightly more difficult situation to detect is that of homonyms.


Here, we refer to two different entities, using the same name. The
classic example in IT of an homonym is the “mouse”. Clearly, it is a
pointing device but it is also the word for a furry rodent. The set of
attributes will be very different and also the way in which the entity is
used.

The purpose of a glossary is not only to define terms unambiguously


but also to resolve issues like these.

179
Module 5: Requirements Documentation

Sample Requirement Catalogue Entry

What do you think?


Do you use all of these fields?

Do you think they are all needed?

180
Module 5: Requirements Documentation

Requirement Catalogue Components


ID and Version
• It is vital to give each requirement a unique ID and a version
number
• The ID can be used to hold the classification such as General,
Technical, FR or NFR
o Many organisations would hold this as a separate ‘type’ field,
leaving the ID to be neutral and if documented using a
spreadsheet can be easily filtered and sorted
• This section allows the management of requirements and
enables traceability between requirements and to other
documents

Author
The Requirements Engineer who is writing the requirement on behalf
of the business.

Date Captured
The date on which the requirement is captured.

Name
A short, readily understood description.

Description
This is a clear definition of the requirement. One could use the
following structure (for a functional requirement):
• Actor
• Verb phrase
• Object (noun or noun phrase)

The amount of detail captured tends to vary over time:


• Initially, only the intent of the requirement might be captured
• More detail will be added after further elicitation and analysis

181
Module 5: Requirements Documentation

Status
This is the current status of the requirement in terms of whether it
has been validated, signed-off, baselined and so on.

Acceptance Criteria
Acceptance criteria may be considered as:

• The criteria that will demonstrate to the business that the


requirement has been met
• The basis for acceptance of the system by the client

For example:

• A customer order that would take the customer over their credit
limit will be rejected and the customer advised that they may not
place further orders until payments have been cleared

Source
Stakeholders are the usual source of requirements. Other sources
include documentation, standards, problem reports, other
requirements etc.

Note the source(s) and their role on every requirement since it helps
you to:

• Improve traceability
• Return to the source in case of change

Owner
The business ‘owns’ all requirements. Usually businesses appoint
individuals to own the requirements in their area. The owner has the
responsibility for approving the definition of the requirement.
Priority (MoSCoW)
It is important to be able to refer to the priority.

182
Module 5: Requirements Documentation

The BCS preference is MoSCoW. (See module 3 for more


information on MoSCoW.)

• Mandatory in the first increment;


M – must have cannot meet business and project
objectives without it

• Mandatory but may wait until


S – should have second increment; the system will
have short-term value without it

• Beneficial if time or funds allow, but


C – could have not central to project objectives

W – want to have • Will not be met in this delivery; may


(won’t have this be included in a future delivery
time)

Rationale
The rationale explains why the requirement is
needed and what benefits will accrue.
It is the link between the problem and the
requirement.
Just thinking about the rationale helps to ensure
that the requirement is justified.
The rationale also helps to determine the priority of the requirement
and may be cross-referenced to benefits detailed in the business
case.

183
Module 5: Requirements Documentation

Links to other Requirements/Documents


• The ‘Associated Non-Functional Requirements’ section can be
used to:
o Link the requirement to any non-functional requirements that
constrain it
o Describe any non-functional requirements that pertain only to
this particular requirement
• Related Documents
o Relates this requirement to any other documentation, from this
project or elsewhere, which is relevant.
o This may include the ToR or PID for this project, company
strategy documentation, etc.

• The ‘Related Requirements’ section links the requirement to


other requirements that are related in some way, such as:
o Higher level requirements, i.e. those on which this requirement
is based
o Requirements which conflict with this requirement
o Requirements which have superseded this requirement
o Requirements which have been superseded by this
requirement

184
Module 5: Requirements Documentation

Exercise 9
Use Case Description
In the exercise workbook with reference to the Goatilicious scenario
complete Exercise 9.

185
Module 5: Requirements Documentation

Summary

# Subject Prepared?

1 There are many styles of documentation to 


choose from, including Catalogue, BRD, PRL,
Functional Specification, SRS, User Story, Use
Case, IEEE 830 and IEEE 1233.

2 User stories are brief, informal expressions of


a requirement, written by the stakeholder and
representing some feature to be developed.

3 Use cases encapsulate business functionality


in a highly graphical way supported by textual
descriptions.

4 A typical requirements document contains


several sections, including Business Process
Models, Function Models, Data Models,
Requirements Catalogue and Glossary.

5 A typical requirement is described using a


number of fields, some of which may be
regarded as optional in some circumstances.

Post Test
To reinforce the materials we have just covered, try out the following
questions in your own time. You’ll find the answers are on page 215.

1. What factors determine the style to be adopted when


creating a business requirements document?
2. Name a methodology which makes significant use of user
stories.
3. What is the purpose of a Glossary in a requirements
document?
4. Why do we specify a rationale for a requirement?

186
Module 5: Requirements Documentation

Further Reading
1. How to Create Business
Requirements: http://www.ehow.com/how_2067174_create-
business-requirements.html

187
Module 5: Requirements Documentation

End of Module Notes

188
Module 6: Requirements Validation and Management

Module 6 – Requirements
Validation and Management
Topics
In this section of the course, we will cover:

• Validating requirements
• Dealing with change
• Traceability
• Requirements Engineering support tools

189
Module 6: Requirements Validation and Management

Requirements Validation
The majority of errors are made in the Analysis stage of the project
and particular care has to be taken to ensure that the requirements
are properly formulated.

After the Requirements Catalogue has been analysed and


negotiated, it MUST be validated and signed-off by the senior
stakeholders.

• Validation is concerned with proving that the ‘final’ draft is as free


from defects as possible, complies with standards and the
product to be built seems to be fit for purpose

190
Module 6: Requirements Validation and Management

Types of Review
• The appropriate degree of formality of a review will depend on
the characteristics of the product, e.g.:
o Major safety issues
o Major compliance/legal issues
o Strategic importance
o Scope, Budget, Risk etc.

• Reviews range from quick informal reviews with the sponsor to


formally documented structured reviews with all the main
stakeholders present
• A forum for the validation of requirements is a formal review – a
peer group or stakeholder group review for the purposes of
finding deficiencies in the requirements

A Review is Not...
• An appraisal of the Requirements
Engineer
• A requirements elicitation or
analysis meeting
• A management review
• A think tank

When conducted properly, the review


has proved to be the most effective
method for finding defects in requirements.

The review can often help to resolve misunderstandings and


misinterpretations between the various Stakeholders involved in the
requirements.

The objective of a review is to increase the overall "quality" of the


requirements that are being developed and also to increase user
confidence in the development effort.

Thus, the idea is:

191
Module 6: Requirements Validation and Management

• To catch errors as soon as possible


• To establish user buy-in
• To check adherence to standards

Formal Review – Roles


Project Sponsor

Checking for alignment to business


goals

Business Owners

Checking that their requirements have


been dealt with satisfactorily

Domain Experts

Checking that the business ‘rules’ and practices have been


respected

Developers

Assessing technical feasibility

Testers

Affirm the testability of the product

PMO

Checking the implementation project proposal against


Project/Programme standards

Requirements Engineer (e.g. Business Analyst)

Explanations and clarifications

Moderator / Chair and Scribe

Management of the review

192
Module 6: Requirements Validation and Management

At the Review
The Moderator:

• Calls the meeting to order


• Reminds the group of the nature and the
purpose of the walkthrough

The Requirements Engineer walks


methodically through the requirements.

The Reviewers:

• Criticise, comment, discuss with the Author


• Present their comments about the product without
reference to the Author – "egoless" concept

Remember that the purpose of the walkthrough is defect detection


and not defect correction (that is the Author's job).

The Scribe:

• Notes and clarifies action points.

193
Module 6: Requirements Validation and Management

After the review


There are three possible outcomes from a review:

• Accept the catalogue in its present form


• Accept the catalogue with the suggested revisions (provisional
sign-off), trusting that they will be made
• Plan another review after the defects are fixed

The Moderator:

• Produces a management summary of the


meeting and a set of detailed comments made
by the participants
• Sends copies of the above to all
participants

Note that the summary does not state how many errors were found,
only what was reviewed, when the meeting took place, who was in
attendance and what the outcome was.

194
Module 6: Requirements Validation and Management

Components of Requirements Management

The tight control of requirements is absolutely necessary in all


projects but particularly so in software intensive projects which are
often large, long term and subject to extensive change Requirements
may exist, quite legitimately, in various versions and releases and for
various target projects.

Each version of each requirement is supported by a raft of


documentation including specifications, system designs, code
designs and test data and results.

These products are heavily interrelated, such that a change to one


may impact on hundreds of others.

Unless these products and relationships are tightly controlled, the


project will quickly and inevitably become chaotic.

Requirements Management is a subset of Configuration


Management which controls all project deliverables.

• In its wider context, Requirements Management encompasses


the activities involved in gathering, recording, analysing,

195
Module 6: Requirements Validation and Management

validating, verifying, managing changes to and tracking


requirements throughout the project lifecycle

Requirements Management is concerned with the following activities:

• Requirements identification
o Each requirement is uniquely identified
o A reference to it corresponds to only one requirement
• Requirements cross-referencing
o Allows the analyst to identify requirements related to the one
that is to be changed
o The basis for impact analysis
• Requirements origin and ownership
o The source will provide information on the impact of change
o The owner has ultimate authority
• Software support
o Documentation
o Secure storage and access
o Linkage
o Version numbering
• Change control
o Documenting a proposed change
o Consulting stakeholders
o Making a decision
• Configuration management
o Controls the change process

196
Module 6: Requirements Validation and Management

 Configuration items are identified, validated, baselined and


subjected to version control as they are checked out and
back in

Fundamentals for Management


• Uniquely identify each requirement
• Establish a change control authority
• Create a change process
 Document it
 Apply it consistently
• Establish system of baselines and versions
• Maintain history of changes
• Track status of each and every requirement

197
Module 6: Requirements Validation and Management

Baselined Requirement
The concept of the Baseline is fundamental to
Requirements Management.

A Baseline is a product that has been formally


reviewed and agreed upon, it is a frozen version of a
requirement.

Thereafter it serves as the basis for further


development and can only be changed through formal Change
Control Procedures.

It should be noted that the same rigorous review procedures are


used to examine changed requirements as were used to examine
the requirements on first development.

The baseline concept provides many benefits for requirements


management:

• Definitive versions of all items are available at all times and


changes are performed against a known baseline: the baselined
version is never overwritten
• It has been approved by management and associated with a
version number
• Once baselined, any change requires approval
• All changes can be tracked and it is therefore possible to ‘fall
back’ to a previous, working version if the new version is proved
faulty

198
Module 6: Requirements Validation and Management

Stable and Volatile Requirements


We have already discussed that requirements engineering is an
iterative process.

Part of the reason for this is that, in business, the only constant is
change.

Some environments are more volatile than others by their nature.

• Requirements tend to be quite volatile initially, but as we gain


agreement during analysis and negotiation they should become
more stable
• All changes are now governed through a change control process

After validation, requirements should be “baselined”.

Sources of Change
• Change of key stakeholder(s)
• Change in project scope
• Changed or new legislation
• Altered business priorities
• Competitor action
• Compatibility with new technology
• Users change their minds
• Users develop better understanding of
need

199
Module 6: Requirements Validation and Management

Management of changes to Requirements


The change control process must support:

• Change proposal
o Detail about the change and how the change will be managed
• Impact analysis
o Cost; risk; scope; benefits; quality; time
o Consider link to project objectives
• Resolution
o Approval or rejection

All changes must be managed through the process.

Uncontrolled changes can lead to problems managing the budget,


resources, testing and priorities.

Change Control approvals


Some organisations have formal Change Control Boards or Change
Control Authorities – a group that meets to review and decide on
whether changes will be approved or rejected.

• It is important to recognise though that not all Change Requests


are the same and may be different in scale, impact and
complexity
• It is good practice to have different levels of change authorities
for different types of change
• The change process is built into the Project or Programme
methodology (which may be company-wide or specific to the
project needs)
• Some changes are reviewed at a project or requirements level by
the Business Analyst or Project Manager, whilst others may have
to go to the Change Board
• Each change is reviewed against cost, urgency, risk and impact
• The sponsor may be called upon to make the final decision

200
Module 6: Requirements Validation and Management

Traceability
If we manage our requirements properly we can also ensure full
traceability forward from the requirements through to the
implemented product and backwards from the implemented product
to the requirements.

In Requirements Management, there are typically two types of


traceability:

Vertical Traceability: backwards to the business


objectives

Horizontal Traceability: from origin to delivery

The need for ownership as a mechanism for traceability is also


emphasised

201
Module 6: Requirements Validation and Management

Software Support
There are many
commercial CASE
(Computer Aided
Software Engineering)
and CARE (Computer
Aided Requirements
Engineering) tools
available.

Before rushing out to


purchase one or more
of these we must
ensure that we have
established an effective
requirements management process first. We also need to be aware
of the fact that such tools can be expensive and that installation is a
project in its own right, possibly needing consultancy support. The
use of a tool will also require administration and training.

A CASE/CARE tool can provide:

• Documentation creation and storage


• Secure storage and access
• Documentation linkage
• Version control
• Modelling
• Even code generation!

202
Module 6: Requirements Validation and Management

Summary

# Subject Prepared?

1 The majority of errors are committed at the 


analysis phase and great care has to be taken
to ensure that the requirements are valid.

2 The purpose of a formal review is to catch


errors as soon as possible, establish user buy-
in and check adherence to standards.

3 Formal reviews take place with the author,


moderator and peer reviewers.

4 Requirements Management ensures the tight


control of requirements.

5 Requirements are baselined after validation.

6 The Change Control Board is the final arbiter


to changes to baselines.

7 CARE and CASE tools can be used to help the


engineer manage the complexities of
requirements in large projects.

203
Module 6: Requirements Validation and Management

Post Test
To reinforce the materials we have just covered, try out the following
questions in your own time. You’ll find the answers on page 215.

1. What is the proper forum to validate requirements?


2. Formal reviews are often mis-used. Give two ways in which
this happens?
3. Name one purpose of a formal review.
4. List the roles involved in a formal review.
5. List two activities of Requirements Management.
6. What is a baseline?
7. Who is the final arbiter of change to requirements?
8. What does the acronym CARE stand for?
9. Name three benefits of using a CASE/CARE tool.

204
Module 6: Requirements Validation and Management

Further Reading
1. Requisite Pro from IBM – a tool for requirements
management: http://www-
01.ibm.com/software/awdtools/reqpro/
2. List of CARE tools with
descriptions: http://easyweb.easynet.co.uk/~iany/other/vendo
rs.htm

End of Module Notes

205
Examination Hints and Tips

Examination Hints and Tips


Note that these notes are for guidance in
approaching the written exam only.

• The exam is about applying requirements


engineering techniques to a business scenario
• The exam lasts for 75 minutes in total: 15
minutes reading time to look at the scenario,
questions and reference materials; 60 minutes
to answer the questions
• The key to answering the questions is to
apply the techniques and come up with specific
answers based on the scenario
• No credit is earned for generic answers
and answers copied from the course notes
• The paper is worth 50 marks and the pass mark is 25 (50%)

Reading Period (15 mins)


• Valid reading materials include the examination paper scenario and
questions, and your course notes (including any notes you make during
the course). Use this time wisely to understand the questions and the
scenario
• Read the questions first and understand what you are being asked. Be
aware of the number of marks available for each question
• Read the scenario to pick up ideas for answers on your first pass
through
• Make use of your reference materials but note that no writing,
marking, highlighting or annotating is allowed during this reading
period

206
Examination Hints and Tips

Writing Period (60 Mins)


• Manage your time effectively. Try to earn a “mark a minute”, i.e. spend
10 minutes answering a 10 mark question; this will allow 10 minutes at
the end to check your answers
• Answer only what you have been asked for, nothing more. If you are
asked for a specific number of examples, give that number (no more). If
you are asked to explain your answer, give explanations; otherwise
don’t waste time giving something that is not required
• Do not rewrite the question!
• For each of the techniques, look at the number of marks at stake and
how many components requested to give you an idea of how much
time to spend coming up with the answer
• Play the percentages – the pass mark is 50%. 100% correct answers
for each question are almost impossible
• Write as neatly as you can – it makes marking easier, and the marker
cannot give you marks if your answer is illegible
• It is “Open Book” – open your books and look at the examples, but
don’t copy them

Case Study
The Case Study Scenario will be between one and one-and-a-half pages
long and will include a general description of an organisation, its
operations, a business need and an outline project to meet that need, as
well as some requirements for change. These requirements, for an IT
application, may be presented as several paragraphs of prose or as
numbered lists.

When you refer to a requirement in your answers it may be enough to give


the requirement’s number (if it has one).

However, if the requirement needs to be broken down, you will need to


indicate which part of the requirement you are referring to; the best way of
doing this is by quoting the relevant part of the requirement verbatim.

207
Examination Hints and Tips

Important Note
Our markers regularly see papers in which candidates have lost marks
(sometimes many marks, sometimes making the difference between pass
and fail) through either failing to read the questions or failing to follow the
instructions. READ THE QUESTIONS CAREFULLY AND DO WHAT THEY
ASK OF YOU.

Examinable Topics
The exam is about the practical application of the techniques you have
studied. Some topics in the syllabus don’t have techniques associated with
them; they will eventually become relevant though if you go forward for the
oral examination.

Below is a list of the examinable topics followed by details on how to


approach a question on that technique.

• Requirements Stakeholders
o Project Stakeholders
o Business Stakeholders
o External Stakeholders
• Knowledge Types
o Tacit/Explicit (non-tacit)
o Individual/Corporate
• Elicitation Techniques
o Interviews
o Workshops
o Observation
o Focus Groups
o Prototyping
o Scenarios
o Document Analysis
o Special Purpose Records
o Questionnaires
• Hierarchy of Requirements
o General Requirements (e.g. legal and business policy)
o Functional Requirements
o Non-Functional Requirements

208
Examination Hints and Tips

• Requirements Analysis Filters


o Priority
o Feasibility
o Overlaps & Duplication
o Conflicts
o Ambiguity
o Testability
• Models
o Use Case Diagram
o Interpreting a Class Diagram
• Use Case
o Use Case Description Main Flow
• Requirements Catalogue
o Sample Template
• Prioritising Requirements
o MoSCoW
• Requirements Validation
o Prototyping

Other topic areas will not be included in the written exam, but must be
revised in preparation for the (closed book) diploma oral exam.

Here are exam hints on some of these topics.

Elicitation Techniques
• This always comes up
• You may be matching stakeholders to techniques or techniques to
stakeholders
• The question is often lengthy – read it carefully
• You may be asked about a specific stakeholder
• Unless instructed otherwise, consider only stakeholders mentioned in
the case study
• Avoid generic answers – look for specifics in the case study to justify
your matching of stakeholder to elicitation technique
o Justification is vital here
• You may be asked about the kind of information you hope to elicit –
consider tacit/explicit knowledge and look for clues in the case study

209
Examination Hints and Tips

• If you are asked to justify the use of the technique then be clear why
this technique is useful for this stakeholder
• Look out for questions asking for different techniques or different
stakeholders

FR/NFR/Solution/General
• There is always a question asking you to identify functional and non-
functional requirements
• Sometimes you’ll be asked to spot solutions too
• You will often need to break the requirements down (quote when you
need to)
• You’ll be asked to state the category of NFRs and you may be asked to
explain what makes your FRs functional, in terms of CRUD
• This question may also ask you to apply some of the filters (see below)
• You could be requested to identify general requirements as well

Requirements Filters
• You may be asked to apply filters to the requirements, identifying a
given number of ambiguities, solutions, etc.
• Justification is usually required
• You may be asked about involving stakeholders to resolve the issues –
look for specific information from the case study
• Conflicting requirements may contradict one another, compromise one
another or may be to do with data mismatch. You will be looking for a
single conflict between two requirements

Use Case Diagram


• You may be asked to draw a Use Case Diagram to represent the
functions demanded by the requirements or a subset thereof
• Make sure you name the use cases appropriately (verb-noun phrase)
• Use <<include>> only if functions are to be re-used
• Remember to draw the system boundary and name the system

210
Examination Hints and Tips

Class Diagram
• You may be asked for a given number of errors or inconsistencies in
the diagram or to check it against each requirement in turn
• You’re looking for where the class diagram fails to support the
requirements, not the other way round
• Your answer should be in the form of text – you do not need to re-draw
the diagram (in fact, a re-drawn diagram will not be marked)
• Remember that you are being asked to check whether the class
diagram supports the requirements so be clear in your answer and
don’t sit on the fence!
• If the class diagram contains no attributes then stating an attribute is
missing, is not a valid answer!

Use Case Description Main Flow


• You may be asked to document the primary scenario (happy path) of a
Use Case
• Show the interaction between user and system as a numbered list
• Remember that this is the primary flow and assumes a successful
outcome
• The question may then ask you for a given number of alternates. You
need only outline these – do not detail them as you did the primary flow
• Think about what might happen or how the user may wish to deviate
from the happy path

Requirements Catalogue
• You might be asked to review a catalogue entry or to create an entry
using specified fields
• For reviewing an entry, your justification is vital
• Make sure you consider how the fields relate to one another
• A rationale may look fine but check that it matches the description, i.e.
that it is the rationale for this requirement!

211
Examination Hints and Tips

MoSCoW
• You cannot prioritise requirements until you understand the objective
they are intended to meet. Sometimes the objective will be stated
explicitly, sometimes you will have to deduce it from the information
given. Once you have identified the objective, write it down for yourself
so you don’t have to look for it again, even if the question doesn’t ask
for this
• You’ll probably be asked for justification here and this is where the
marks are
• Make sure your justification matches your level of priority

Prototyping
• As well as perhaps using prototyping for elicitation you may be asked
about prototyping for validation of a particular requirement
• Draw on specifics from the case study when explaining why prototyping
is appropriate

212
Answers to Post Tests

Answers to Post Tests

Answers to Module 1
1. Business, Operational and Software.
2. Any three of:

• Scope is implicit
• Too little definition / too much definition
• Ambiguity
• Contradiction
• Written from differing ‘viewpoints’
• Lack of traceability to business rules, processes and data

3. 50-60%.
4. A project is a discrete piece of work with an agreed start and end
date. It consists of a set of co-ordinated and controlled activities
undertaken to deliver a product conforming to specific requirements
within the constraints of time, cost and resources. Projects exist to
deliver benefits to the business.
5. A business case is a document that describes the findings from a
business analysis study and presents a recommended course of
action for senior management to consider.
6. The Project Initiation Document is a project management product
that forms the contract between the business and the project team.
7. Background, Objectives, Scope, Constraints, Authority, Resources,
Deliverables.

Answers to Module 2
1. Business, Project and External.
2. Subject Matter Expert or SME.
3. Any three of:

• Might not know what they really want


• Find it hard to articulate what they want
• Make unrealistic demands

213
Answers to Post Tests

• Viewpoints
• Subject to politics

4. Any three of:

• May find it difficult to identify all of the stakeholders


• Must find a way to express requirements in terms that ALL stakeholders
and actors can understand and agree
• Must resolve requirements conflicts and uncover commonalities
• Must cope with a changing businesses environment which might affect
the priority of, or need for, requirements

5. Apprentice, Observe, Recount, Enact.


6. Any three of:

• Speed
• Ownership
• Productivity
• Consensus
• Quality of decision-making
• Overall perspective

Answers to Module 3
1. Analysis.
2. Business and Solution.
3. Business Requirements.
4. Business: Technical.
5. A requirement which constrains the way in which a functional
requirement operates.
6. MoSCoW.
7. Paper, User Interface, Full.

214
Answers to Post Tests

Answers to Module 4
1. A named role in relation to the business in scope.
2. A use case is a ‘structured requirement’ that describes a piece of
system functionality.
3. From the point of view of the actor.
4. When the actor is the recipient of the output of a use case but is
otherwise uninvolved.
5. The name should start with a capital letter. Names consisting of
multiple words should not be separated and they, too, must have
initial capitals.
6. One.
7. Multiplicities.

Answers to Module 5
1. Company conventions and type of application.
2. XP or Agile.
3. To provide a clear definition of the terms used in the project – it
might be for this project only or organisation-wide.
4. The rationale explains why the requirement is needed and what
benefits will accrue.

Answers to Module 6
1. Formal Review.
2. Any two of:

• An appraisal of the Requirements Engineer


• A requirements elicitation or analysis meeting
• A management review
• A think tank

3. Any one of:

• To catch errors as soon as possible


• To establish user buy-in
• To check adherence to standards

215
Answers to Post Tests

4. Requirements Engineer (the Author), Moderator, Reviewer.


5. Any two of:

• Requirements identification
• Requirements cross-referencing
• Requirements origin and ownership
• Software support
• Change control
• Configuration management

6. A Baseline is a product that has been formally reviewed and agreed


upon. Thereafter it serves as the basis for further development and
can only be changed through formal Change Control Procedures.
7. The Change Control Board (CCB).
8. Computer Assisted Requirements Engineering.
9. Any three of:

• Documentation creation and storage


• Secure storage and access
• Documentation linkage
• Version control
• Modelling
• Code generation

216
Index

Index
Agile, 169 Eva, Malcolm, 100
Ambiguity, 112 Feasibility, 109
Analyst Problems, 48 Focus Groups, 72
BCS RE Syllabus, 5 Formal Review, 191
Business Case Hierarchy of Requirements, 93
Definition of, 31 Interview Lifecycle, 59
Business Objectives, 91 Interviews, 59
Business Requirements MoSCoW, 106
General, 95 NFR, 100
Technical, 96 NGT, 67
CARE, 202 Nominal Group Technique, 67
CASE, 202 Observation, 70
Case Study Exercises Types of, 70
Ex-1, 84 Overlaps, 110
Ex-2, 114 PID, 34
Ex-3, 121 Priority, 106, 107
Ex-4, 146 Project Initiation Document
Ex-5, 160 Definition of, 34
Ex-6, 185 Prototyping, 73, 117
Class Diagrams, 147 Questionnaires, 77
Associations, 152 Realism, 109
Attributes, 151 Requirements
Class, 149 Ambiguous, 90
CRUD, 157 Baselined, 199
Multiplicity, 153 Change Control, 196, 216
Classroom Exercises Change, Sources of, 199
At the Vet, 159 Configuration Management,
Document Management 196, 216
System, 140, 145 Correction Cost, 21
Ticket Sales System, 103 Definition of, 14
Conflicts, 111 Document, 178
Document Analysis, 75 Documentation styles, 167
Documentation Styles, 167 Good, 29
Documenting Findings, 56 Hierarchy, 93
Duplication, 110 Management of Change to,
Elicitation Techniques, 58 200

217
Index

Origin, 196, 216 Objectives of, 191


Origin of Errors, 20 RM, 195
Ownership, 196, 216 Sample Requirement, 180
Prioritising, 106 Scenarios, 74
Problems, 19 SME, 44
Purpose of Modelling, 128 Software Support, 202
Software Support, 196, 216 Solution Requirements
Solutions, 27 Non-functional, 100
Specifications, 19 Special Purpose Records, 76
Stable, 199 Stakeholder
Traceability, 201 Problems, 48
Validation, 190 Viewpoints, 49
Volatile, 199 Subject Matter Expert, 44
Requirements Engineering Terms of Reference
Activities, 35 Definition of, 32
Stakeholders, 43 ToR, 32
Business Analysts, 45 Traceability, 201
Customers, 46 Unconscious Competence, 51
Developers, 45 Use Cases, 131
Project Manager, 45 Description, 173
Project Sponsor, 44 Diagram, 138
Regulators, 46 Diagrams, 131
Subject Matter Expert, 44 Extend association, 142
Suppliers, 46 Focus of, 137
System End-User, 44 Include association, 141
Requirements Identification, 196, Naming conventions, 132
216 User Stories, 169
Requirements Management Validation, 190
Components of, 195 Verification, 119
Reviews Workshops, 63
After, 194 Lifecycle, 66
During, 193 XP, 169

218
Contact us:
0845 757 3888
info@qa.com
www.qa.com

Must take two core courses Must take one Must take one
knowledge-based course Practitioner course

BCS Certificate in Business BCS Certificate in Commer- BCS Certificate in Modelling


Analysis Practice cial Awareness Business Processes

3 days 3 days 3 days


Exam:1 hour 15 mins Exam:1 hour Exam:1 hour 15 mins
BCS Certificate in Require- BCS Foundation Certificate BCS Certificate in Systems
ments Engineering in Business Analysis Modelling Techniques
(Structured)
3 days 3 days 4 days
Exam:1 hour 15 mins Exam:1 hour Exam:1 hour 15 mins

BCS Foundation Certificate BCS Certificate in Systems


in Business Change Modelling Techniques
(UML)
3 days 4 days
Exam:1 hour Exam:1 hour 15 mins

BCS Foundation Certificate BCS Certificate in Systems


in Project Management Development Essentials

3 days 3 days
Exam:1 hour 15 mins Exam:1 hour 15 mins

Four courses and exams in total

Exam preparation workshop (recommended)

Diploma oral exam

You might also like