Mở đầu — vì sao bài này quan trọng
Hãy tưởng tượng bạn là một BA trong dự án ngân hàng số. Cách đây sáu tháng, bạn viết một tài liệu phân tích về quy trình mở tài khoản online — bao gồm cả phần xử lý OTP và eKYC. Hôm nay, đội phát triển hỏi bạn: "Hồi đó mình quyết định cho phép tối đa bao nhiêu lần nhập sai OTP?". Bạn biết chắc câu trả lời nằm đâu đó trong Confluence, nhưng không gian làm việc (space) đã có hơn 400 trang. Bạn gõ "OTP" vào ô tìm kiếm và nhận về 87 kết quả. Lúc này, kỹ năng search & discovery trong Confluence chính là thứ phân biệt một BA chuyên nghiệp với một người chỉ biết "scroll mỏi tay".
Confluence không phải là một thư mục chứa file tĩnh. Nó là một knowledge base sống, nơi tài liệu được liên kết, gắn nhãn (label), phân quyền và cập nhật liên tục. Giá trị thật sự của Confluence không nằm ở chỗ bạn viết được tài liệu, mà ở chỗ bạn — và cả team — tìm lại được đúng thông tin vào đúng lúc cần. Với một BA, mỗi phút lãng phí để tìm tài liệu là một phút không dùng để phân tích nghiệp vụ. Tệ hơn, nếu không tìm thấy, người ta sẽ viết lại từ đầu — tạo ra tài liệu trùng lặp, mâu thuẫn, và cuối cùng là "nguồn sự thật" bị phân mảnh.
Bài này tập trung duy nhất vào cách tìm và khám phá thông tin trong Confluence: từ ô Quick Search trên thanh top bar, đến ngôn ngữ truy vấn nâng cao CQL (Confluence Query Language), và các bộ lọc giúp bạn thu hẹp hàng trăm kết quả xuống còn đúng vài trang cần tìm. Chúng ta sẽ không bàn về cách tạo space hay viết template — đó là chủ đề của các bài khác. Ở đây, mục tiêu là biến bạn thành "thợ săn thông tin" thực thụ trong Confluence.
Khái niệm cốt lõi
Quick Search — ô tìm kiếm trên thanh top bar
Quick Search là điểm khởi đầu của mọi hành trình tìm kiếm. Nó nằm ngay trên thanh điều hướng phía trên cùng (top bar). Khi bạn gõ vào đây, Confluence tìm đồng thời trên ba loại nội dung: pages (trang), blog posts (bài blog) và attachments (tệp đính kèm — bao gồm cả nội dung text bên trong file PDF, Word, Excel đã được index).
Điểm quan trọng mà nhiều người bỏ qua: Quick Search tìm theo full-text — nghĩa là nó dò cả nội dung bên trong trang chứ không chỉ tiêu đề. Đó là lý do một từ khóa như "OTP" có thể ra hàng chục kết quả. Confluence cũng có cơ chế xếp hạng (ranking): kết quả khớp ở tiêu đề, kết quả trong space bạn hay truy cập, và kết quả mới cập nhật gần đây thường được đẩy lên đầu.
Một mẹo nhỏ nhưng cực kỳ hữu ích: nhấn phím tắt / (dấu gạch chéo) ở bất kỳ đâu trong Confluence sẽ nhảy con trỏ ngay vào ô search. Khi gõ, một dropdown gợi ý hiện ra ngay lập tức với các kết quả nhanh — bạn thường tìm thấy thứ cần ngay tại đây mà không phải mở trang kết quả đầy đủ.
Search filters — bộ lọc khi vào trang kết quả đầy đủ
Khi bạn nhấn Enter để mở trang kết quả đầy đủ, một bộ lọc bên trái (hoặc phía trên, tùy phiên bản) cho phép thu hẹp:
- Spaces: giới hạn tìm trong một hoặc vài space cụ thể. Đây là bộ lọc giá trị nhất với BA — vì bạn thường biết tài liệu nằm trong space dự án nào.
- Contributor / Author: lọc theo người tạo hoặc người chỉnh sửa. "Tài liệu này do chị Lan viết" — lọc theo Lan là xong.
- Type: page, blog post, attachment, comment, space.
- Last modified: hôm nay, tuần này, tháng này, năm nay, hoặc khoảng tùy chọn.
- Labels: lọc theo nhãn đã gắn — ví dụ tất cả trang gắn nhãn
brdhoặcrequirement.
Labels — xương sống của discovery
Nếu search là kéo thông tin về phía bạn, thì labels (nhãn) là cách thông tin tự tổ chức để dễ được tìm thấy. Label là những từ khóa ngắn bạn gắn vào trang (ví dụ: brd, api-spec, q3-2026, payment-module). Một trang có thể có nhiều label. Khi click vào một label bất kỳ, Confluence hiện ra tất cả trang cùng nhãn — bất kể chúng nằm ở space nào.
Với BA, labels là công cụ để tạo ra "bộ sưu tập ảo" xuyên suốt nhiều dự án. Bạn có thể gắn requirement cho mọi tài liệu yêu cầu, rồi dùng macro Content by Label để tự động liệt kê chúng ở một trang tổng hợp.
Advanced Search với CQL — Confluence Query Language
Đây là phần "nâng cao" và là điểm mạnh thật sự. CQL (Confluence Query Language) là ngôn ngữ truy vấn của Confluence, tương tự JQL trong JIRA mà bạn đã học. Thay vì gõ từ khóa mơ hồ, bạn viết một truy vấn có cấu trúc với trường (field), toán tử (operator) và giá trị (value).
Cú pháp cơ bản:
field operator value
Một vài ví dụ CQL thực dụng cho BA:
type = page AND space = "BAPRJ" AND label = "brd"
title ~ "OTP" AND lastModified >= now("-30d")
~ nghĩa là "chứa/khớp gần đúng" (contains).creator = currentUser() AND type = page ORDER BY created DESC
text ~ "eKYC" AND space.type = "global" AND label NOT IN ("archived", "draft")
Các trường CQL hay dùng: title, text, space, type, label, creator, contributor, created, lastModified, parent (trang cha), ancestor (tổ tiên trong cây trang). Các toán tử: =, !=, ~ (contains), !~, >=, <=, IN, NOT IN, kết hợp bằng AND, OR, NOT. Hàm thời gian như now("-7d") và sắp xếp bằng ORDER BY.
CQL được dùng ở hai nơi: trong ô Advanced Search (bạn có thể chuyển sang chế độ nhập CQL trực tiếp) và quan trọng hơn — bên trong các macro động như Content by Query / Content Report Table, giúp bạn tạo những trang tự động cập nhật danh sách tài liệu mà không phải sửa tay.
Tình huống thực tế
Tình huống 1 — Ngân hàng số tìm lại quyết định cũ
Tại một ngân hàng số ở TP.HCM (gọi là TPDigital), space "Core Onboarding" có 412 trang sau 18 tháng dự án. Anh Minh, BA trưởng, cần tìm lại quyết định về số lần nhập sai OTP. Gõ "OTP" cho ra 87 kết quả — quá nhiều.
Anh chuyển sang Advanced Search với CQL:
text ~ "OTP" AND space = "ONBOARD" AND label = "decision" AND lastModified >= "2025-01-01"
Vì team TPDigital có quy ước gắn nhãn decision cho mọi trang ghi quyết định, truy vấn này thu hẹp từ 87 xuống còn 4 kết quả — và trang đầu tiên chính là biên bản họp ghi rõ "tối đa 5 lần nhập sai trong 30 phút, sau đó khóa OTP 24 giờ".
Bài học: Search mạnh đến đâu cũng phụ thuộc vào kỷ luật gắn nhãn của team. CQL chỉ phát huy tối đa khi dữ liệu được tổ chức nhất quán. Là BA, hãy là người thúc đẩy quy ước labeling cho cả team.
Tình huống 2 — Công ty fintech và tài liệu trùng lặp
Một fintech tại Hà Nội phát hiện họ có ba phiên bản BRD cho cùng một tính năng "ví trả góp", do ba BA khác nhau viết ở ba thời điểm. Chị Hương được giao việc dọn dẹp. Thay vì mở từng space, chị dùng CQL xuyên không gian:
title ~ "trả góp" AND type = page ORDER BY created ASC
Kết quả cho thấy ngay ba trang cùng tên, tạo cách nhau vài tháng, ở các space khác nhau. Chị giữ bản mới nhất làm "nguồn sự thật duy nhất", gắn nhãn source-of-truth, và gắn nhãn deprecated cho hai bản cũ kèm một panel cảnh báo trỏ về bản chuẩn. Từ đó, bất kỳ ai search "trả góp" và lọc label = "deprecated" đều biết ngay trang nào đã lỗi thời.
Bài học: Search không chỉ để tìm — nó còn là công cụ audit (rà soát) để phát hiện trùng lặp và mâu thuẫn. Một BA giỏi dùng search định kỳ để giữ knowledge base sạch sẽ.
Tình huống 3 — Sàn TMĐT Đông Nam Á và trang tự động cập nhật
Tại một sàn thương mại điện tử khu vực (giả định tên ShopSEA), PM yêu cầu một trang "Tất cả yêu cầu đang chờ duyệt" luôn cập nhật. Anh Đức, BA, không muốn cập nhật danh sách thủ công mỗi ngày. Anh tạo một trang dùng macro Content Report Table với truy vấn CQL:
label = "requirement" AND label = "pending-review" AND space = "MARKET"
Mỗi khi BA nào đó gắn hai nhãn requirement và pending-review cho trang của họ, trang tổng hợp tự động hiện thêm dòng mới — không ai phải sửa tay. PM mở đúng một trang là thấy toàn bộ hàng đợi duyệt.
Bài học: CQL không chỉ để tìm một lần. Nhúng vào macro, nó tạo ra dashboard tài liệu sống — một trong những kỹ năng tạo giá trị cao nhất của BA trên Confluence.
Hướng dẫn từng bước
Bước 1 — Thử Quick Search trước. Gõ phím / để nhảy vào ô search, nhập từ khóa cốt lõi nhất. Xem dropdown gợi ý; nhiều khi bạn tìm thấy ngay mà không cần đi xa hơn.
Bước 2 — Mở trang kết quả đầy đủ và áp bộ lọc. Nếu kết quả quá nhiều, nhấn Enter. Ở trang kết quả, lọc ngay theo Space (bạn thường biết tài liệu thuộc dự án nào) rồi đến Last modified và Contributor. Hai ba bộ lọc thường đủ thu hẹp xuống mức quản lý được.
Bước 3 — Chuyển sang CQL khi cần độ chính xác. Vào Advanced Search, bật chế độ nhập CQL. Bắt đầu từ một điều kiện đơn giản (space = "..."), chạy thử, rồi nối thêm AND từng điều kiện một. Đừng viết truy vấn dài ngay từ đầu — xây dần và kiểm tra kết quả sau mỗi bước.
Bước 4 — Tận dụng ~ và hàm thời gian. Dùng title ~ "..." khi không nhớ chính xác tiêu đề, và lastModified >= now("-30d") để loại bỏ tài liệu cũ. Đây là hai mảnh ghép giải quyết phần lớn nhu cầu tìm kiếm hàng ngày.
Bước 5 — Lưu lại truy vấn hay dùng. Với những CQL bạn chạy lặp đi lặp lại, hãy nhúng vào một macro Content Report Table trên trang cá nhân hoặc trang team. Lần sau chỉ cần mở trang đó thay vì gõ lại.
Bước 6 — Gắn nhãn cho chính tài liệu bạn viết. Discovery là con đường hai chiều: bạn tìm được tài liệu của người khác dễ dàng vì họ gắn nhãn tốt. Hãy đáp lễ — mỗi trang bạn viết nên có 2–4 label nhất quán theo quy ước team.
Lỗi thường gặp & mẹo
Lỗi 1 — Dùng từ khóa quá chung. Gõ "tài liệu" hay "yêu cầu" ra hàng trăm kết quả vô dụng. Mẹo: dùng danh từ riêng, mã tính năng, hoặc cụm từ đặc thù ("eKYC", "ví trả góp", "SPRINT-23") thay vì từ chung chung.
Lỗi 2 — Quên rằng search phụ thuộc phân quyền. Bạn không tìm thấy trang không có nghĩa nó không tồn tại — có thể bạn không có quyền xem space đó. Mẹo: nếu chắc tài liệu tồn tại mà không ra, hãy hỏi quyền truy cập space, đừng vội viết lại tài liệu mới.
Lỗi 3 — Nhầm ~ với = trong CQL. title = "OTP" chỉ khớp tiêu đề đúng y hệt chữ "OTP"; title ~ "OTP" mới khớp mọi tiêu đề chứa "OTP". Nhầm chỗ này là nguyên nhân số một khiến truy vấn ra 0 kết quả. Mẹo: khi tìm theo nội dung, gần như luôn dùng ~.
Lỗi 4 — Không bao chuỗi có dấu cách bằng dấu nháy. space = BA PRJ sẽ lỗi; phải viết space = "BA PRJ". Mẹo: cứ bao mọi giá trị dạng chữ trong dấu nháy kép cho an toàn.
Lỗi 5 — Bỏ qua attachments. Câu trả lời nhiều khi nằm trong file Excel đính kèm chứ không phải trong text trang. Mẹo: khi search trống, kiểm tra bộ lọc Type và mở rộng sang attachment.
Mẹo vàng: Confluence index attachment có độ trễ vài phút sau khi upload. Nếu vừa tải file lên mà search chưa thấy, đợi một lát rồi thử lại — đó là độ trễ index bình thường, không phải lỗi.
Bài tập thực hành
- Quick Search: Trong space dự án của bạn (hoặc một space demo), gõ phím
/, tìm một từ khóa nghiệp vụ. Đếm số kết quả và quan sát thứ tự xếp hạng — kết quả nào lên đầu và vì sao?
- Bộ lọc: Mở trang kết quả đầy đủ. Lần lượt áp bộ lọc Space, rồi Last modified (tháng này), rồi Contributor. Ghi lại số kết quả giảm sau mỗi bộ lọc.
- CQL cơ bản: Viết và chạy truy vấn tìm mọi trang do chính bạn tạo trong 90 ngày qua, sắp xếp mới nhất lên đầu. Gợi ý: dùng
creator = currentUser(),created >= now("-90d"),ORDER BY created DESC.
- CQL nâng cao: Viết một truy vấn tìm tất cả trang có nhãn
brdhoặcrequirement, thuộc một space cụ thể, nhưng không có nhãnarchived. Kiểm tra kết quả có hợp lý không.
- Discovery có hệ thống: Chọn ba tài liệu bạn từng viết, gắn cho mỗi trang 2–3 label theo một quy ước bạn tự đặt (ví dụ
module,loại tài liệu,kỳ). Sau đó dùng search lọc theo label để kiểm tra xem bạn có tìm lại chúng nhanh hơn không.
Tóm tắt
Search & Discovery là kỹ năng "vô hình" nhưng quyết định việc một knowledge base Confluence có thực sự sống hay chỉ là một nghĩa địa tài liệu. Với một BA, tìm đúng tài liệu nhanh chóng đồng nghĩa với tránh trùng lặp, giữ một nguồn sự thật duy nhất, và phản hồi đồng đội tức thì.
Hãy ghi nhớ ba tầng công cụ: Quick Search trên top bar cho nhu cầu nhanh (tìm pages, blog posts, attachments theo full-text); bộ lọc (space, contributor, type, last modified, label) để thu hẹp kết quả; và CQL — Confluence Query Language cho độ chính xác cao, với các trường như title, text, space, label, creator, toán tử ~, IN, NOT IN, và hàm thời gian now(). Quan trọng nhất, sức mạnh của discovery đến từ kỷ luật gắn nhãn của cả team — và là BA, bạn nên là người khởi xướng quy ước đó. Khi CQL được nhúng vào macro, nó còn biến thành trang tài liệu tự cập nhật, đưa bạn từ người tìm thông tin lên người tổ chức thông tin cho cả tổ chức.