Chia sẻ về cách mô tả lỗi phần mềm một cách hiệu quả

1. MÔ TẢ LỖI HIỆU QUẢ
HOÀNG HIỀN
hthien@software.misa.com.vn

2. Nội dung
1. Tại sao phải mô tả lỗi tốt
2. Thế nào là một bản mô tả lỗi tốt
3. Làm thế nào để mô tả lỗi tốt

3. Tại sao phải Mô tả lỗi cho tốt
◉ Các bản ghi lỗi là một trong những sản phẩm quan trọng nhất
của testing
◉ Bản mô tả lỗi tốt sẽ giúp:
• Dev không cần mất nhiều thời gian để hiểu đúng lỗi  Tăng quỹ thời
gian và tốc độ fix lỗi
• Giúp các quản lí nhanh chóng xác định được tình trạng chất lượng của sp
• Giảm số lỗi bị developer trả lại, tăng uy tín của phía test
• Thắt chặt tình đồng đội giữa nhóm test với nhóm phát triển

4. Thế nào là một bản Mô tả lỗi tốt
Chữ và Nghĩa
Tái sinh được Chính xác Tổng quát hóa
Có tiêu đề
tốt
Vừa đủDễ hiểu
Khuyến
khích fix

5. Bản mô tả lỗi tốt - Nghĩa
Chính xác
Đây thực sự là một lỗi của phần mềm, không phải
là lỗi của người sử dụng hay vấn đề Set up hay…
Tái sinh được
Những điều kiện và các bước cần thiết để tái lặp lỗi
là gì?
Tổng quát hoát
Lỗi xảy ra theo quy luạt như thế nào

6. Lưu ý: Một số lỗi dễ tái lặp, một số không
Tái lặp được
• Mô tả tất cả các bước theo
đúng thứ tự
• Mô tả dữ liệu cụ thể
• Mô tả 1 cách rõ ràng và vừa
đủ
Không tái lặp được
• Cần ghi chú là lỗi Khó tái lặp
• Đưa ra tất cả thông tin có khả
năng có ích cho người
nhận/sửa lỗi

7. Bản mô tả lỗi tốt – Chữ
Tiêu đề tốt
Một tiêu đề cô đọng, giàu thông tin
Vừa đủ
Không thừa, không thiếu thông tin
Dễ hiểu
Đơn giản, dễ hiểu, ngôn từ trong sáng, logic rõ
ràng, không viết tắt bừa bãi
Trung hòa
Chỉ nêu sự thật, không đùa cợt, không mỉa mai,
chê bai

8. Làm thế nào để Mô tả lỗi cho tốt
◉ Mô tả lỗi
• Tiêu đề: trả lời được câu hỏi "Ở chức năng nào, có lỗi gì trong
trường hợp nào?“
• Diễn giải: trả lời được các câu hỏi:
 Các bước tái lặp lỗi
 Kết quả đang sai như thế nào?
 Kết quả đúng phải như thế nào?

9. Làm thế nào để Mô tả lỗi cho tốt
◉ Để đảm bảo mô tả lỗi Chính xác, hãy xem xét:
• Liệu có điều gì trong setup gây ra lỗi này? VD đã cài đúng version cần test
và có đúng, đủ các thành phần, cấu hình liên quan chưa? Liệu có phải đây
là vấn đề liên quan đến network hay các điều kiện về môi trường sử dụng?
• Đã sử dụng đúng account, role? Account đã được phân quyền thích hợp,
đã thực hiện thao tác đúng trình tự?
• Có thể do máy test không “sạch”, hãy một lỗi từng xảy ra gây nên lỗi này?
• Bạn đã thực sự hiểu chức năng này được thiết kế để hoạt động ntn? Hay
dữ liệu bạn dùng để test có gì đặc biệt?

10. Làm thế nào để Mô tả lỗi cho tốt
◉ Để Tái lặp được lỗi, hãy lặp lại các bước dẫn đến lỗi đồng thời:
• Để ý tìm ra bộ các bước cần thiết nhất để sinh lại lỗi.
• Nếu test của bạn có nhiều giá trị đầu vào, hãy thay đổi các giá trị đó đến
khi bạn thực sự hiểu những giá trị nào sẽ dẫn đến lỗi.
• Hãy xem xét các options, configurations, setting mà có thể là một phần
của các điều kiện dẫn đến lỗi.

11. Làm thế nào để Mô tả lỗi cho tốt
◉ Để Tổng quát hóa lỗi, hãy:
• Suy luận và thử làm những bước nào đó để tìm ra quy luật tổng quát hay các
cách khác để dẫn đến lỗi.

12. Làm thế nào để Mô tả lỗi cho tốt
◉ Mô tả Tiêu đề tốt:
• Nêu vắn tắt xem vấn đề là gì (chứ không phải chỉ là Có vấn đề).
• Sử dụng những từ giàu ý nghĩa
• Chỉ ra môi trường, hoàn cảnh và cả hậu quả
• Theo hướng trả lời vắn tắt cho who, what, when, where, why, and how
• Có thể sử dụng từ viết tắt
• Ngữ pháp chỉ là vấn đề thứ yếu, sau vấn đề nội dung thông điệp truyển
đi

13. VD#2 về TIÊU ĐỀ TỐT
Đừng
• Không đăng nhập được vào
CUKCUK mobile
Hãy
• Không đăng nhập được và
CUKCUK mobile trường hợp sử
dụng gói license Starter
• Khách hàng sử dụng gói license
Starter không đăng nhập được
vào CUKCUK Mobile

14. Mô tả đảm bảo Dễ hiểu, Vừa đủ
◉ Mô tả rõ ràng mà ngắn gọn. Loại bỏ các thông tin, tữ ngữ thừa.
◉ Theo một cách đơn giản, minh bạch.
• Bạn đang không viết văn biết báo, nên hãy sử dụng ngôn ngữ thông
dụng, logic dễ hiểu.
• Không dùng nhiều từ tiếng Việt không dấu, không dùng các từ ngữ khó
hiểu hoặc dễ gây nhầm lẫn
◉ Luôn nhớ ai sẽ là người đọc lỗi này.
• Có thể là developers, testers khác, managers, hay cả khách hàng. Đảm
bảo ai cũng có thể hiểu được.

15. VD#1 về DỄ HIỂU
◉Cách nào dễ hiểu nhất?
• “Mai kém Linh 4 tuổi, Lan hơn Mai 3 tuổi Lan kém Linh một tuổi.”
• “Mai kém Linh 4 tuổi, Lan hơn Mai 3 tuổi, tức là Mai kém Lan 3 tuổi
Lan kém Linh một tuổi.”
• “Mai kém Linh 4 tuổi, Mai kém Lan 3 tuổi Linh hơn Lan 01 tuổi.”

16. VD#1 về VỪA ĐỦ
ĐỪNG HÃY
Yêu cầu : Thêm loại chứng từ phiếu chi nào thì sau khi cất
phải cất đúng loại phiếu chi đó
Lỗi gì? Khi nào?:
Chi tiền_ Thêm mới PC khác từ PC trả tiền NCC (TM hoặc TG)
thì phiếu chi khác bị hiểu là loại phiếu chi trả tiền NCC nhưng
tab chứng từ bị trống
Các bước tái lặp:
Thêm mới phiếu chi trả tiền NCC bằng TM -> Cất -> Tại form
chi tiết của chứng từ phiếu chi thêm mới phiếu chi mới là phiếu
chi khác -> Cất thành công
Xem trên danh sách -> Chứng từ phiếu chi khác sau khi cất
hiển thị loại chứng từ là Phiếu chi trả tiền NCC.
Mở lên xem chi tiết thì hiển thị loại phiếu chi trả tiền NCC
nhưng Tab chứng từ trống thông tin.
Nếu trên form chọn đối tượng ko phải là NCC thì lúc này mã
đối tượng bị trống, chỉ hiển thị được tên đối tượng
Thông tin khác : Bị cả trên chi tiền bằng TG (ủy nhiệm chi)
Yêu cầu : Thêm loại chứng từ phiếu chi nào thì sau
khi cất phải cất đúng loại phiếu chi đó
Lỗi gì? Khi nào?:
Sai loại chứng từ khi thêm mới PC khác từ PC trả
tiền NCC
Các bước tái lặp:
1. Thêm mới phiếu chi PC01 trả tiền NCC bằng TM
2. Trên Form chi tiết PC01, thêm phiếu chi PC02,
chọn Loại phiếu chi = Khác
Lỗi: Loại chứng từ của PC02 trên danh sách hiển thị
là Phiếu chi trả tiền NCC (đúng là Phiếu chi khác)
3. Mở form chi tiết PC02
Lỗi: Tab chứng từ trống thông tin
Thông tin khác: Lỗi tương tự đối với phiếu chi tiền
gửi

17. Mô tả đảm bảo Trung hòa
◉Hãy đưa tin xấu một cách nhẹ nhàng! Luôn nhớ phải tôn trọng
công sức của developer
◉Tránh:
• Mỉa mai, phê phán
• Thể hiện sự bực tức, chán nản
• Đùa cợt, trêu cười
◉Hãy làm bản mô tả lỗi chỉ là một tập các trạng thái/kết quả về sự
kiện thực tế

18. VD#1 về TRUNG HÒA
Đừng
• Type ẩu quá. Lầu sau cẩn thận
hơn. Xem hình minh họa.
Hãy
• Lỗi nhỏ xíu! Dấu chấm hỏi (?)
sai vị trí

19. VD#1 về TRUNG HÒA
Đừng
• Chỉ test thử một chút cũng
thấy ngay là chức năng ABC bị
lỗi nếu nhập bất kỳ giá trị âm
nào.
Hãy
• Chức năng ABC bị lỗi với các
giá trị âm.
• Một số giá trị đã test: -1, -36, -
32767.

20. Mô tả đảm bảo Khuyến khích fix
◉Chỉ ra hậu quả tiềm tàng của lỗi, đảm bảo lỗi này sẽ nhận được sự chú ý
cần thiết.
◉Xác định đúng mức độ Nghiêm trọng (Severity) và mức độ Ưu tiên
(Priority) của lỗi level
• Severity: mức độ ảnh hưởng hay hậu quả của lỗi đối với NSD, tổ chức, bên thứ
ba hay một dịch vụ, v.v.
• Frequency: khả năng (tần suất) một lỗi xảy ra hay lộ ra trước NSD, tổ chức, bên
thứ ba hay một dịch vụ, v.v.
• Priority: mức độ quan trọng tương đối trong việc sửa chữa, xử lý lỗi
• Priority nên là kết quả tổ hợp của cả Severity and Frequency.

21. VD#1 về KHUYẾN KHÍCH FIX
◉Với một lỗi chính tả:
• “Đây là lỗi rất nhỏ nhưng hễ NSD dùng phần mềm này thì lại nhìn
thấy nó đầu tiên, dễ sinh phản cảm”.
◉Về một lỗi liên quan đến khả năng phục hồi hệ thống sau sự
cố:
• “Khả năng NSD phải dùng đến tính năng này rất thấp, nhưng một khi
phải dùng thì sẽ vô cùng nguy hại cho họ nếu lỗi này không được
fix”.

22. THANKS!
Any questions?
You can find me at
@hthien/hthien@software.misa.com.vn