-Sưu liệu là một phần của hệ thống phần mềm- Có hai lớp sưu liệu kết hợp với hệ thống máy tính + Lớp sưu liệu người dùng mô tả làm thế nào để sử dụng hệ thống + Sưu liệu hệ thống được mô
Trang 1Ths Nguyễn Khắc Quốc Email:quoctv10@gmail.com
BÀI GIẢNG MÔN
CÔNG NGHỆ PHẦN MỀM
Chương 7
SƯU LIỆU
Trang 2-Sưu liệu là một phần của hệ thống phần mềm
- Có hai lớp sưu liệu kết hợp với hệ thống máy tính
+ Lớp sưu liệu người dùng mô tả làm thế nào
để sử dụng hệ thống
+ Sưu liệu hệ thống được mô tả thiết kế và thực hiện hệ thống
7.1 Tổng quan
Trang 37.2 Sưu liệu người dùng
- Là sưu liệu mô tả chức năng của hệ thống
- Không tham chiếu đến chức năng được thực hiện như thế nào
- Sưu liệu người dùng nên được cấu trúc sao cho không nhất thiết phải đọc hết tất cả sưu liệu trước khi bắt đầu dùng hệ thống
Trang 4Có 5 loại sưu liệu cho người dùng:
- Mô tả chức năng, giải thích hệ thống có thể làm gì
- Sưu liệu cài đặt, giải thích làm thế nào để có thể cài đặt được hệ thống, chi tiết từng cấu hình phần cứng
cụ thể
- Giới thiệu, giải thích thuật ngữ, cách bắt đầu hệ thống
- Tham chiếu, mô tả chi tiết tất cả tiện ích của hệ thống
- Hướng dẫn người quản trị hệ thống, những trường phát sinh, backup hệ thống
7.2 Sưu liệu người dùng (tt)
Trang 57.2.1 Mô tả chức năng
-Phác thảo yêu cầu của hệ thống
-Phác thảo mục đích của người thiết kế hệ thống
-Mô tả hệ thống có thể làm được gì, không làm được gì -Giới thiệu ví dụ minh họa nhỏ bất kỳ chỗ nào có thể -Vẽ sơ đồ là tốt nhất
Trang 67.2.2 Bảng giới thiệu
-Cung cấp cái nhìn tổng quát hệ thống
-Trình bày giới thiệu thông tin đối với hệ thống
-Mô tả làm thế nào bắt đầu hệ thống, làm thế nào thực hiện sử dụng những tiện ích chung của hệ thống
-Chỉ cho người dùng tránh những rắc rối khi họ làm sai
Trang 77.2.2 Bảng tham khảo
-Là sưu liệu được định nghĩa cho cách sử dụng hệ thống
-Bảng tham khảo nên hoàn chỉnh
-Phần tham khảo hệ thống nên mô tả:
+ Những báo cáo lỗi phát sinh của hệ thống + Những tình huống lỗi phát sinh
+ Hướng người dùng đến những mô tả tiện ích
đã gây ra lỗi
Trang 87.2.4 Sưu liệu cài đặt
-Nên cung cấp đầy đủ chi tiết làm thế nào để cài đặt được hệ thống trong môi trường cụ thể
-Gồm các mô tả:
+Cấu hình tối thiểu để chạy hệ thống
+Tập tin cố định phải được thiết lập
+Làm thế nào để bắt đầu hệ thống
Trang 97.2.4 Sưu liệu cài đặt (tt)
-Hướng dẫn cho quản trị hệ thống
+ Mô tả những thông điệp phát sinh ở màn hình
hệ thống, làm thế nào để ứng phó với những thông điệp này
+ Giải thích những nhiệm vụ của người theo dõi duy trì phần cứng đó
+ Danh sách các tham khảo nhanh sẵn có của tiện ích hệ thống và làm thế nào để sử dụng chúng
+ Hệ thống online – Help
Trang 107.3 Sưu liệu hệ thống
- Chứa tất cả những sưu liệu mô tả quá trình thực hiện của hệ thống từ sưu liệu đặc tả đến bản kế hoạch test cuối cùng
+ Tài liệu mô tả thiết kế + Sưu liệu mô tả thực hiện + Sưu liệu mô tả kiểm thử
- Cần thiết để hiểu và bảo trì hệ thống
Trang 117.3 Sưu liệu hệ thống (tt)
Những thành phần của sưu liệu hệ thống:
-Định nghĩa và đặc tả yêu cầu và kết hợp
-Trình bày đặc tả tất cả hệ thống làm thế nào những yêu cầu được phân rã thành những nhóm các chương trình tương tác với nhau
-Một kế hoạch kiểm thử chi tiết làm thế nào đẻ mỗi đơn
vị của chương trình được kiểm thử
-Kế hoạch kiểm thử được chấp nhận, vạch ra sự nối kết những người dùng hệ thống
Trang 127.4 Chất lượng của sưu liệu
-Quan trọng như chất lượng chương trình
-Tạo những sưu liệu tốt không đơn giản, tiến trình cũng khó như tạo một chương trình tốt
-Cần lập một chuẩn cho sưu liệu và yêu cầu tất cả các sưu liệu phải tuân thủ theo định dạng đó
-Những tiêu chuẩn của sưu liệu:
+ Mô tả định dạng trước cho tất cả các tài liệu
+ Đánh số trang và cách thức ghi chú trang
+ Phương thức tham khảo tài liệu khác
+ Số đề mục và đề mục con
Trang 137.4 Chất lượng của sưu liệu (tt)
-Phong cách viết là yếu tố nền tảng ảnh hưởng đến chất lượng sưu liệu
-Một số cách viết nên tránh:
+ Câu quá dài + Mô tả quá phức tạp + Lặp lại
+ Thông tin tham chiếu toàn là số + Không có những chi tiết gợi nhớ cho người đọc
Trang 147.5 Bảo trì sưu liệu
-Hệ thống thay đổi thì sưu liệu cũng được cập nhật theo
-Tất cả những sưu liệu kết hợp nên được cập nhật khi một thay đổi bởi chương trình
-Hỗ trợ bảo trì sưu liệu với công cụ phần mềm
-Ghi nhận mối liên hệ sưu liệu
-Nhắc người phát triển khi thay đổi một sưu liệu có tác động đến sưu liệu khác
-Ghi nhận những thay đổi trong sưu liệu
Trang 157.6 Các mẫu sưu liệu cho qui trình làm PM
-Xác định yêu cầu (SRS) Software Requirements Speccifications – Chuẩn IEE 830-1984
+ Giới thiệu
Mục đích Phạm vi Định nghĩa Tài liệu tham khảo
Mô tả cấu trúc tài liệu
Trang 167.6 Các mẫu sưu liệu cho qui trình làm PM (tt)
+ Mô tả chung:
Tổng quan về sản phẩm Chức năng sản phẩm Đối tượng người dùng Ràng buộc tổng thể Giả thiết về sự lệ thuộc
+ Yêu cầu chi tiết:
Yêu cầu chức năng 1
Giới thiệu
Dữ liệu vào
Xử lý Kết quả Yêu cầu chức năng 2
……
Yêu cầu chức năng n
Trang 177.6 Các mẫu sưu liệu cho qui trình làm PM (tt)
+ Thiết kế:
Thiết kế cơ sở dữ liệu Thiết kế ràng buộc
Sưu liệu kiến trúc phần mềm Thiết kế thành phần