System Documentation
System Documentation
Systems Documentation
Introduction
2
Introduction
We are
here!
3
Introduction
4
Introduction
5
Contents
• Purpose and role of systems documentation
• Types of systems documentation
• Rules for diagrams
6
Systems documentation
• Systems documentation is a way of visually
depicting the operations of a system
• A system can be depicted in several different
ways
• System documentation answers following
questions
– Who is involved?
– What activities occur?
– Where do the activities occur?
– Why do the activities occur?
7
Types of documentation
In this lecture, we will study three types of
documentation
– Process maps
– Data flow diagrams (DFDs)
– Systems flowcharts
8
Types of documentation
A process map is a simple graphical
representation of a business process, includes
– activities
– areas of business responsible for the activities
– decisions that need to be made
Types of documentation
• Data flow diagrams are graphical representations
of the data flows that occur within a system
• Three forms of DFD
– Context diagram
– Physical data flow diagram
– Logical data flow diagram
10
Types of documentation
• Systems flowcharts illustrate a system with its
– inputs
– processes
– outputs
– people involved
• Flowcharts provides more details than a
process map or data flow diagram
Process redesign and systems documentation
14
Reading Systems Documentation
15
Structured Narrative Table
Structured Narrative Table
Narrative Table
• Entities are listed in the order in which they
are involved in the process
• An entity may appear more than once
• Rows should be read in conjunction with each
other
18
Process Maps
processes
or activities
decision
Process Map
activi
process
Rules for Reading Process Maps
1. The functional areas appear down the left-
hand side of the diagram
23
Data Flow Diagram Symbols
customer data
Data Store
Data Flow
Context Diagram
• The context diagram provides a
representation of the system and the entities
that provide inputs to, or receive outputs
from, the system of interest
• It is an overview of the data flow and says
nothing about what actually happens in the
process
• Decomposing or stepwise refinement: the
process of breaking a logical diagram to a
lower level to get more details
Sample Context Diagram
System of interest
External entity
Physical Data Flow Diagram
• Physical DFD shows the people, places and
things involved in a system
• Gives answers to the question “Who is
involved?”
27
Sample Physical Data Flow Diagram
Logical Data Flow Diagram
• Logical DFDs focus on processes
• Gives answers to the question “What is
happening?”
• In physical DFDs, the labels of arrows indicate
documents or physical items
• In logical DFDs, the labels present the type of
the information being sent
• Logical DFDs have level (level 0, 1, 2,…)
29
Sample Logical Data Flow Diagram
Physical DFD vs. Logical DFD
/ Approve
31
Balancing a Data Flow Diagram
Diagrams (context, physical data flow and
logical data flow) with the same external
entities and flows to and from these external
entities are called balanced data flow
diagrams
Systems Flowcharts
A systems flowchart represents a combination
of the logical and physical data flow diagrams,
because it provides details of the processes
that are performed (logical perspective) as
well as the physical resources that are used to
perform them (physical perspective)
Common Flowchart Symbols
Stop/start Single
or external document
entity
Process Paper data
store
Decision Manual
point keying
ra quyet dinh
Disc Manual
storage process
Drawing Systems Documentation
• Key Questions to Consider: