Bài 60 — Cheat Sheet — Quick Reference Card

Mở đầu — vì sao bài này quan trọng

Sau 59 bài học, bạn đã đi qua gần như toàn bộ hệ sinh thái JIRA và Confluence dành cho công việc của một Business Analyst: từ Issue Types, Workflows, Custom Fields, JQL cơ bản và nâng cao, Boards, Dashboards, cho đến BRD trên Confluence, Automation Rules, REST API và hàng loạt best practices. Đó là một lượng kiến thức rất lớn. Vấn đề thực tế là: khi bạn đang ngồi giữa một buổi sprint planning, một stakeholder hỏi "issue này đang stuck ở đâu?", hoặc PM yêu cầu "lọc cho anh tất cả story chưa estimate trong sprint này trong 30 giây", bạn không có thời gian để mở lại 59 bài học và đọc từng cái.

Bài 60 này chính là tấm thẻ tham chiếu nhanh (cheat sheet) — thứ bạn in ra dán cạnh màn hình, hoặc lưu thành một trang Confluence ghim trên đầu space của team. Nó không dạy kiến thức mới mà cô đọng những thứ bạn dùng nhiều nhất thành dạng tra cứu tức thì. Một BA giỏi không phải người nhớ thuộc lòng mọi toán tử JQL, mà là người biết chính xác cần tra cái gì ở đâu và áp dụng đúng trong vài giây. Hãy xem đây là "vũ khí mang theo người" — gọn, nhanh, và luôn đúng lúc bạn cần nhất.

Khái niệm cốt lõi

Một cheat sheet tốt cho BA cần gói gọn bốn nhóm: cú pháp JQL, các phím tắt thao tác nhanh, cú pháp markup Confluence, và quy trình ra quyết định lặp đi lặp lại. Dưới đây là phần ruột mà bạn sẽ tra cứu hàng ngày.

JQL Quick Reference — Toán tử

Toán tử (operator) là xương sống của mọi câu JQL. Nhớ đúng nhóm này là bạn viết được 80% truy vấn thực tế:

• = và != — bằng / khác. Ví dụ: status = "In Progress", assignee != currentUser()
• >, <, >=, <= — lớn hơn / nhỏ hơn, dùng cho ngày và số. Ví dụ: created >= "2026-01-01", priority >= High
• IN và NOT IN — thuộc / không thuộc một tập giá trị. Ví dụ: status IN ("To Do", "In Progress"), project NOT IN (ARCHIVE, OLD)
• ~ (contains) và !~ (not contains) — chứa / không chứa văn bản, chỉ dùng cho trường text. Ví dụ: summary ~ "login", description !~ "deprecated"
• IS EMPTY và IS NOT EMPTY — trống / không trống. Ví dụ: fixVersion IS EMPTY, assignee IS NOT EMPTY
• WAS, WAS IN, WAS NOT, CHANGED — toán tử lịch sử, truy vấn theo trạng thái quá khứ. Ví dụ: status WAS "Blocked", status CHANGED AFTER -7d

JQL Quick Reference — Từ khóa logic và sắp xếp

• AND, OR, NOT — kết hợp điều kiện. Luôn dùng dấu ngoặc đơn để nhóm rõ ràng: (status = Done OR status = Closed) AND assignee = currentUser()
• ORDER BY ... ASC/DESC — sắp xếp kết quả. Ví dụ: ORDER BY priority DESC, created ASC
• EMPTY và null — đại diện cho giá trị rỗng trong mệnh đề

JQL Quick Reference — Hàm hay dùng nhất

• currentUser() — người đang đăng nhập. Trụ cột cho filter cá nhân: assignee = currentUser()
• now() — thời điểm hiện tại: duedate < now() AND status != Done (tìm issue quá hạn)
• startOfWeek(), endOfWeek(), startOfMonth(), endOfDay() — mốc thời gian tương đối: created >= startOfWeek()
• openSprints(), closedSprints(), futureSprints() — theo trạng thái sprint: sprint IN openSprints()
• membersOf("group-name") — thành viên của một group: assignee IN membersOf("ba-team")
• linkedIssues("KEY-123") — các issue liên kết với một issue cụ thể

Cú pháp ngày tháng (Date math)

JIRA hiểu cả ngày tuyệt đối lẫn tương đối. Ngày tương đối cực kỳ tiện cho filter động: w (tuần), d (ngày), h (giờ), m (phút). Ví dụ created >= -1w nghĩa là tạo trong 7 ngày qua, duedate <= 3d nghĩa là đến hạn trong 3 ngày tới.

Confluence Markup nhanh

Khi gõ trên trang Confluence, các ký tự "kích hoạt" giúp bạn không phải rời tay khỏi bàn phím:

• / — mở menu chèn (insert) mọi loại macro, panel, table
• [ — chèn link nội bộ hoặc smart link tới JIRA issue
• @ — mention người, ngày, hoặc page
• { — gợi ý macro nhanh (gõ {status ra macro Status)
• // — chèn ngày hiện tại
• Markdown inline: đậm, nghiêng, ` code , # Heading 1, - cho bullet, [] cho checkbox

• Gõ phím c — tạo issue mới (create) từ bất kỳ đâu
• / — nhảy vào ô search nhanh
• i — gán issue cho mình (assign to me)
• a — assign cho người khác
• m — comment nhanh
• . — mở bảng lệnh (command palette) làm gần như mọi thao tác bằng bàn phím
• g rồi g — mở menu "go to"

Cụ thể, câu assignee = currentUser() AND sprint IN openSprints() AND status != Done ORDER BY priority DESC được lưu thành filter "Việc của tôi trong sprint". Vì dùng currentUser(), cùng một filter chạy đúng cho cả 8 người mà không cần sửa. Kết quả: thời gian một BA mất để "biết hôm nay mình cần làm gì" giảm từ khoảng 5 phút mò mẫm xuống còn 1 cú click. Bài học rút ra: cheat sheet phát huy giá trị gấp nhiều lần khi bạn biến nó từ tài liệu tĩnh thành filter và template dùng chung — kiến thức cá nhân trở thành tài sản của cả team.

Ví dụ 2 — VNG: cứu một buổi review với date math

Trong một buổi review của một studio game tại VNG, Product Owner đột ngột hỏi: "Tuần vừa rồi có bao nhiêu bug được mở mà chưa ai đụng tới?". Bình thường BA sẽ lúng túng vì không nhớ cú pháp lịch sử. Nhưng nhờ có cheat sheet dán cạnh màn hình, bạn ấy gõ ngay: issuetype = Bug AND created >= -1w AND status = "To Do" AND assignee IS EMPTY ORDER BY created DESC.

Trong 15 giây, màn hình hiện ra 12 bug chưa được phân công. Nhờ cột created sắp giảm dần, mọi người thấy ngay cái cũ nhất đã nằm đó 6 ngày. PO lập tức ra quyết định phân công ngay tại chỗ. Điều "cứu" buổi review chính là việc nhớ được sự kết hợp created >= -1w (date math) với IS EMPTY (toán tử trống). Bài học: ba mảnh ghép nhỏ — một hàm thời gian, một toán tử trống, một mệnh đề sort — gộp lại tạo ra câu trả lời tức thì mà nếu không có cheat sheet bạn sẽ phải thử sai vài lần.

Ví dụ 3 — Một ngân hàng số ở Đông Nam Á: chuẩn hóa markup Confluence

Đội BA của một ngân hàng số (digital bank) viết rất nhiều BRD và biên bản họp trên Confluence. Trước đây mỗi người định dạng một kiểu: người dùng emoji trạng thái, người gõ tay "DONE" màu xanh, dẫn đến tài liệu không nhất quán và khó scan. Họ áp dụng phần "Confluence Markup nhanh" của cheat sheet làm chuẩn chung: mọi trạng thái dùng macro Status qua {status, mọi tham chiếu issue dùng [ để tạo smart link tự cập nhật, mọi quyết định họp đánh dấu bằng [] checkbox và @ mention người chịu trách nhiệm kèm // ngày deadline.

Sau một tháng, biên bản họp trở nên đồng nhất đến mức stakeholder chỉ cần liếc qua là biết task nào còn treo, ai chịu trách nhiệm, hạn khi nào. Bài học: cheat sheet không chỉ giúp cá nhân nhanh hơn, mà khi cả đội dùng cùng một bộ ký tự kích hoạt, chất lượng tài liệu được nâng lên đồng đều — đây chính là điều phân biệt một team BA chuyên nghiệp.

Hướng dẫn từng bước

Để biến bài này thành công cụ thực sự dùng được, làm theo các bước sau:

• Tạo trang cheat sheet trên Confluence. Vào space của team BA, tạo page mới tên "JIRA & Confluence Cheat Sheet". Dùng macro Table of Contents (/toc) để điều hướng nhanh giữa các mục JQL, phím tắt, markup.

• Sao chép bốn nhóm bảng vào trang. Dán toàn bộ phần JQL operators, hàm, date math và markup vào trang. Với mỗi câu JQL mẫu, bọc trong macro Code (/code) để giữ định dạng và dễ copy.

• Biến câu JQL hay dùng thành saved filter. Mỗi BA mở phần Filters của JIRA, dán câu mẫu, kiểm tra kết quả, rồi Save với tên dễ hiểu. Ưu tiên dùng currentUser() và openSprints() để filter chạy được cho mọi người.

Lỗi 1 — Nhầm = với ~ cho trường text. Rất nhiều người gõ summary = "login" và thắc mắc sao không ra kết quả. Trường text dài cần dùng ~ (contains): summary ~ "login". Toán tử = chỉ khớp chính xác toàn bộ, phù hợp cho trường select hoặc status.

Lỗi 2 — Quên dấu ngoặc khi trộn AND với OR. Câu status = Done OR status = Closed AND assignee = currentUser() không chạy như bạn nghĩ vì AND được ưu tiên trước OR. Luôn nhóm rõ: (status = Done OR status = Closed) AND assignee = currentUser().

Lỗi 3 — Dùng tên hiển thị thay vì giá trị thật. Một số custom field có tên hiển thị khác với tên kỹ thuật. Khi câu JQL báo lỗi không nhận field, hãy dùng tính năng gợi ý autocomplete của JIRA thay vì gõ tay theo trí nhớ.

Lỗi 4 — Hard-code ngày tháng thay vì date math. Filter "bug tuần này" mà gõ ngày cụ thể created >= "2026-06-01" sẽ chết sau một tuần. Dùng created >= -1w hoặc startOfWeek() để filter tự cập nhật mãi mãi.

Mẹo vàng: Phím . (dấu chấm) mở command palette là phím tắt quyền lực nhất trong JIRA hiện đại — gần như mọi thao tác (đổi status, gán người, thêm label) đều làm được bằng bàn phím qua đó. Học một phím này tiết kiệm hơn cả chục thao tác chuột.

Mẹo phân biệt nhanh: IS EMPTY dùng cho việc "có giá trị hay không" (assignee, fixVersion); còn ~ dùng cho "nội dung text chứa gì". Đừng dùng = "" — JQL không hiểu cú pháp đó.

Bài tập thực hành

• Viết lại không nhìn cheat sheet: Tìm tất cả issue được giao cho bạn, thuộc sprint đang mở, chưa Done, sắp xếp theo độ ưu tiên giảm dần. (Gợi ý: 4 mệnh đề + 1 ORDER BY.)

• Date math: Viết câu JQL tìm mọi Story tạo trong 14 ngày qua mà chưa có estimate (story point trống). Dùng đúng -2w và IS EMPTY.

• Toán tử lịch sử: Viết câu tìm những issue từng ở trạng thái "Blocked" tại bất kỳ thời điểm nào, dùng WAS.

• Confluence: Tạo một trang Confluence và chỉ dùng ký tự kích hoạt (/, [, @, {, //) để chèn: một bảng, một smart link tới issue, một mention, một macro Status, và ngày hôm nay. Không dùng chuột vào menu.

Cheat sheet không phải để bạn học thêm điều gì mới, mà để biến toàn bộ 59 bài đã học thành phản xạ tra cứu trong vài giây. Hãy nhớ bốn trụ cột: nhóm toán tử JQL (=, !=, IN, ~, IS EMPTY, WAS), nhóm hàm động (currentUser(), openSprints(), now(), các mốc thời gian), date math để filter không bao giờ lỗi thời, và ký tự kích hoạt Confluence (/, [, @, {, //) để soạn tài liệu không rời bàn phím. Phím . mở command palette là người bạn quyền lực nhất.

Giá trị thật sự xuất hiện khi bạn chuyển cheat sheet từ tài liệu cá nhân thành tài sản chung của team: saved filter dùng currentUser()`, trang Confluence được ghim, chuẩn markup thống nhất. Đó là lúc kiến thức của bạn nhân lên cho cả đội. Hãy in nó ra, dán cạnh màn hình, và để mỗi lần stakeholder hỏi một câu hóc búa, bạn trả lời được trong 15 giây — đó là dấu hiệu của một BA thành thạo JIRA và Confluence thực thụ. Chúc bạn áp dụng thật hiệu quả những gì đã học qua suốt khóa.