Appendix C - A Template of User Requirements Document with ... - OGCIO

BEST PRACTICES FOR BUSINESS ANALYST

APPENDIX C A TEMPLATE OF USER REQUIREMENTS DOCUMENT WITH SAMPLE CONTENTS

[G60c]

Version: 1.0

December 2016

? The Government of the Hong Kong Special Administrative Region The contents of this document remain the property of the Office of the Government Chief Information Officer, and may not be reproduced in whole or in part without the expressed

permission of the Office of the Government Chief Information Officer.

Best Practices for Business Analyst Appendix C

Amendment History

Change Revision Number Description

Amendment History

Pages Affected

Rev.

Date

Number

Best Practices for Business Analyst Appendix C

Overview

OVERVIEW

(a) A user requirement is "what" must be delivered to provide value to business when satisfied rather than "how" to deliver. A User Requirements Document (URD) describes what the proposed IT system looks like from a business perspective. It is important as it helps gain agreement with stakeholders and provides a foundation to IT project team on what the system needs to do to satisfy the business needs and user expectations, and provide input into the next phase of the development.

(b) A URD normally consists of the following information:

i) Introduction, e.g. purpose of the URD, project background, business objectives, project scope and objectives, etc.;

ii) Identified Risks, Assumptions and Constraints; iii) Proposed System Overview, e.g. high-level system diagram or description and

system user profile; iv) Future Business Process; v) Functional Requirements define the functions or features of a system that can

be utilised by a user to fulfil business operation (i.e. what the system should do to provide business value when satisfied); vi) Non-Functional Requirements such as audit, control and security, global business rules, data requirements, usability requirements, service level targets, user volume and equipment requirements, data growth and retention requirements, etc. specify criteria of how the system can perform and maintain these functions and features (i.e. how the system should work) from a business perspective; vii) Implementation Considerations such as implementation strategy, rollout and transition approach, data conversion, training approach, etc. viii)Appendices, e.g. Future Business Process Diagrams, Data Requirements, Reference Documents, Glossary of Terms, etc.

(c) A sample template of URD with sample content is provided below. B/Ds should adopt the sample template flexibly and make changes as necessary to suit project needs.

Best Practices for Business Analyst Appendix C

Overview

(d) Notes for using the template are written in "italic" text enclosed in pointed brackets "< >", while sample contents are written in "bold italic" and can be replaced by project-specific information or removed to suit specific project needs. After all changes are made, all notes should be removed and font of all "bold italic" text should be changed to normal.

Best Practices for Business Analyst Appendix C

HINTS AND TIPS

Overview

(a) The requirements should be accurate, clear, complete, verifiable, consistent, understandable and concise.

(b) Technical solutions or elements (e.g. data architecture, application architecture, system architecture, technical infrastructure, etc.) should be avoided. Such solutions are proposed by IT staff during system design.

(c) Acceptance criteria define the boundaries for the functional requirements and they should be written in a clear and concise manner.

(d) If Agile software development method is used, only high-level requirements will be produced in the SA&D stage. Requirements should be written in layman's terms which are called "User Stories". Please refer to the "Practice Guide for Agile Software Development1" for more information about Agile.

1 "Practice Guide for Agile Software Development" can be found at .htm.

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download