Mở đầu — vì sao bài này quan trọng
Hãy tưởng tượng bạn là BA của một dự án ngân hàng số. Bạn vừa viết xong một trang Confluence tổng hợp 25 yêu cầu nghiệp vụ (business requirements). Tuần sau, sếp hỏi: "Yêu cầu nào đã được duyệt, yêu cầu nào còn đang chờ, yêu cầu nào bị từ chối?". Nếu trang của bạn chỉ là một bảng chữ đen trên nền trắng, người đọc phải dò từng dòng, đọc từng câu để hiểu. Còn nếu mỗi yêu cầu có một nhãn màu — xanh "Đã duyệt", vàng "Đang chờ", đỏ "Từ chối" — thì chỉ cần liếc mắt là biết ngay tình hình.
Đó chính là sức mạnh của Macros trong Confluence. Một trang tài liệu BA viết tốt không chỉ là nội dung đúng, mà còn phải dễ quét bằng mắt (scannable), tự cập nhật khi dữ liệu thay đổi, và chuyên nghiệp trong mắt stakeholder. Macros là công cụ giúp bạn biến một trang text thuần thành một tài liệu sống động, có cấu trúc.
Trong bài này, chúng ta tập trung vào ba nhóm macro quan trọng nhất với công việc của BA: Status macro (nhãn trạng thái màu), Info/Note/Warning panels (các khung thông tin nổi bật), và Page Properties (biến trang thành nguồn dữ liệu tổng hợp được). Đây là ba macro mà gần như ngày nào một BA chuyên nghiệp cũng dùng. Nắm vững chúng, tài liệu của bạn sẽ khác biệt hẳn so với người chỉ biết gõ chữ.
Khái niệm cốt lõi
Macro là gì?
Macro là những khối nội dung dựng sẵn có thể tái sử dụng (reusable building blocks) mà bạn chèn vào trang Confluence để hiển thị nội dung động hoặc định dạng đặc biệt. Thay vì phải tự tay thiết kế một khung màu hay tự tổng hợp dữ liệu, bạn chỉ cần gõ ký tự / trong trình soạn thảo, chọn macro mong muốn, cấu hình vài thông số, và Confluence sẽ tự render ra phần hiển thị.
Điểm mấu chốt để hiểu macro: nó không phải là text tĩnh. Nhiều macro lấy dữ liệu từ nơi khác (từ chính trang, từ trang khác, từ JIRA) và tự cập nhật. Khi dữ liệu nguồn đổi, hiển thị của macro đổi theo, bạn không phải sửa tay.
Cách chèn macro nhanh nhất trong editor mới: gõ dấu / rồi nhập tên macro. Ví dụ gõ /status sẽ ra Status macro, gõ /info ra Info panel. Đây là thói quen bạn nên luyện cho thành phản xạ.
Status macro — nhãn trạng thái có màu
Status macro tạo ra một nhãn nhỏ có màu (color-coded label) đặt ngay trong dòng văn bản. Nó có hai thuộc tính chính: màu và chữ hiển thị.
Các màu chuẩn của Confluence và ý nghĩa BA thường gán:
- Xanh lá (Green): Hoàn thành, Đã duyệt, Đạt (Done, Approved, Passed)
- Vàng (Yellow): Đang làm, Đang chờ, Cần review (In Progress, Pending)
- Đỏ (Red): Bị chặn, Từ chối, Thất bại (Blocked, Rejected, Failed)
- Xanh dương (Blue): Mới, Thông tin (New, Info)
- Xám (Grey): Chưa bắt đầu, Đã hủy (Not Started, Cancelled)
Lưu ý quan trọng cho BA Việt Nam: hãy thống nhất một bộ quy ước màu và chữ cho cả team rồi ghi ra một trang "Quy ước trạng thái". Nếu mỗi người dùng màu một kiểu (người dùng vàng cho "đang làm", người khác dùng vàng cho "cảnh báo"), tài liệu sẽ gây hiểu lầm.
Info, Note, Warning, Tip panels — các khung thông tin nổi bật
Đây là nhóm macro tạo ra các khung nội dung có nền màu và biểu tượng để làm nổi bật một thông tin quan trọng tách khỏi dòng văn bản chính. Confluence có sẵn bốn loại panel chính:
- Info (khung xanh dương, biểu tượng chữ i): thông tin trung tính cần lưu ý, như "Tài liệu này áp dụng cho phiên bản hệ thống 2.x trở lên".
- Note (khung xám/tím nhạt): ghi chú bổ sung, ngữ cảnh phụ.
- Tip (khung xanh lá, bóng đèn): mẹo, gợi ý làm tốt hơn, thực hành nên theo.
- Warning (khung đỏ/vàng, dấu chấm than): cảnh báo, rủi ro, điều tuyệt đối không được làm sai.
Ngoài ra còn có Panel macro tổng quát cho phép bạn tự chọn màu nền, màu viền, tiêu đề — linh hoạt hơn khi bốn loại có sẵn không đủ.
Page Properties — biến trang thành dữ liệu tổng hợp được
Đây là cặp macro mạnh nhất nhưng cũng bị BA mới bỏ qua nhiều nhất, gồm hai phần đi đôi với nhau:
- Page Properties macro: bạn đặt macro này lên từng trang, bên trong chứa một bảng hai cột — cột trái là tên thuộc tính (ví dụ: Trạng thái, Người phụ trách, Ngày duyệt, Độ ưu tiên), cột phải là giá trị.
- Page Properties Report macro: đặt trên một trang tổng hợp, nó quét tất cả các trang có cùng một nhãn (label) và tự gom các thuộc tính kia thành một bảng tổng hợp.
Mẹo cực hay: kết hợp Status macro bên trong Page Properties. Khi đó cột "Trạng thái" trong bảng tổng hợp sẽ hiển thị các nhãn màu, vừa đẹp vừa dễ quét.
Tình huống thực tế
Tình huống 1: Bảng theo dõi yêu cầu tại công ty Fintech MoMo (giả định bối cảnh)
Một team BA gồm 4 người tại một công ty fintech ở TP.HCM phụ trách module "Ví trả góp". Họ có 30 yêu cầu nghiệp vụ trải dài trên 30 trang Confluence riêng. Ban đầu, trưởng nhóm BA duy trì một bảng Excel riêng để theo dõi trạng thái từng yêu cầu — nhưng cứ vài ngày bảng Excel lại lệch với thực tế vì không ai cập nhật kịp.
Giải pháp: Họ thêm Page Properties macro vào mỗi trang yêu cầu với các thuộc tính: Mã yêu cầu, Trạng thái (dùng Status macro), Người phụ trách, Ngày cập nhật, Độ ưu tiên. Mỗi trang được gắn nhãn vi-tra-gop-req. Sau đó họ tạo một trang "Bảng tổng hợp yêu cầu Ví trả góp" với Page Properties Report macro lọc theo nhãn đó.
Kết quả: Bảng Excel bị xóa bỏ. Giờ mỗi BA chỉ cần cập nhật trạng thái ngay trên trang yêu cầu mình phụ trách, bảng tổng hợp tự đổi theo. Cuộc họp tuần rút từ 60 phút xuống 25 phút vì sếp chỉ cần mở một trang, liếc các nhãn màu là biết 18 yêu cầu xanh (đã duyệt), 9 vàng (đang chờ), 3 đỏ (bị chặn).
Bài học: Page Properties + Report loại bỏ công việc cập nhật trùng lặp và xóa bỏ rủi ro dữ liệu lệch nhau. Đừng bao giờ duy trì một bảng theo dõi thủ công song song với tài liệu — hãy để chính tài liệu sinh ra bảng theo dõi.
Tình huống 2: Cảnh báo quy tắc nghiệp vụ tại dự án bảo hiểm Prudential
Một BA viết tài liệu đặc tả cho quy trình "Tính phí bảo hiểm nhân thọ". Trong đó có một quy tắc: hệ số phí khác nhau theo độ tuổi và phải khớp với biểu phí do Bộ Tài chính phê duyệt. Lần đầu, BA chỉ viết quy tắc này thành một đoạn văn bình thường giữa trang. Kết quả: một developer đọc lướt, bỏ qua, và code sai công thức cho nhóm tuổi trên 60. Bug lọt tới giai đoạn UAT, tốn 3 ngày sửa.
Giải pháp: BA viết lại tài liệu, đưa quy tắc nhạy cảm này vào một Warning panel màu đỏ với tiêu đề rõ "QUAN TRỌNG — Biểu phí theo quy định pháp lý". Ngay dưới đó là một Info panel dẫn link tới file biểu phí gốc và một Note panel ghi rõ ai là người chịu trách nhiệm khi biểu phí thay đổi.
Kết quả: Trong các sprint sau, không còn developer nào bỏ sót quy tắc này. Khối đỏ nổi bật khiến nó "không thể không thấy".
Bài học: Panel không chỉ làm đẹp — nó là công cụ quản trị rủi ro thông tin. Những gì quan trọng nhất phải được tách ra khỏi dòng văn bản và đóng khung. Một BA giỏi biết rằng "viết đúng" chưa đủ, phải "viết sao cho người đọc không thể bỏ sót".
Tình huống 3: Trạng thái sprint deliverable tại công ty outsourcing FPT Software
Một BA tại một team outsourcing làm cho khách hàng Nhật quản lý 12 hạng mục bàn giao (deliverable) trong một sprint: 5 tài liệu đặc tả, 4 mockup, 3 bộ test case. Khách hàng Nhật rất khắt khe và muốn báo cáo trạng thái rõ ràng, không mơ hồ.
Giải pháp: BA tạo một bảng trên Confluence liệt kê 12 hạng mục, mỗi hạng mục dùng Status macro ở cột trạng thái. Quy ước thống nhất: xanh "Approved", vàng "Under Review", xanh dương "Draft", đỏ "Rework Needed". Trên đầu bảng, một Info panel ghi rõ ý nghĩa từng màu để phía khách hàng không hiểu lầm.
Kết quả: Báo cáo trạng thái trở nên minh bạch tuyệt đối. Khách hàng Nhật chỉ cần mở trang là biết ngay tiến độ, giảm hẳn các email hỏi đi hỏi lại "cái này xong chưa". Niềm tin của khách hàng tăng, và team được khen về tính chuyên nghiệp của tài liệu.
Bài học: Khi làm việc xuyên văn hóa hay xuyên ngôn ngữ, màu sắc là ngôn ngữ chung. Status macro kèm một bảng chú thích (legend) giúp xóa bỏ mơ hồ — điều cực kỳ giá trị trong môi trường outsourcing.
Hướng dẫn từng bước
Bước 1 — Chèn Status macro:
- Trong trang đang soạn, đặt con trỏ vào vị trí muốn chèn nhãn.
- Gõ
/statusrồi Enter. - Một nhãn xuất hiện. Click vào nó để mở thanh cấu hình.
- Chọn màu (Green/Yellow/Red/Blue/Grey), nhập chữ hiển thị (ví dụ "Đã duyệt"), bật/tắt tùy chọn Subtle.
- Click ra ngoài để hoàn tất.
- Đặt con trỏ ở dòng mới.
- Gõ
/info(hoặc/warning,/note,/tip) rồi Enter. - Khung màu hiện ra. Gõ nội dung trực tiếp vào trong khung.
- Bạn có thể chèn link, danh sách, thậm chí Status macro vào bên trong panel.
- Trên trang tài liệu, gõ
/page propertiesvà chọn Page Properties macro. - Bên trong macro, tạo một bảng hai cột.
- Cột trái ghi tên thuộc tính (Trạng thái, Người phụ trách, Độ ưu tiên...), cột phải ghi giá trị. Có thể chèn Status macro vào cột giá trị.
- Quan trọng: gắn một nhãn (label) chung cho trang này — vào phần label ở cuối trang, thêm ví dụ
brd-vi-tra-gop. Mọi trang muốn được tổng hợp phải dùng cùng nhãn này.
- Tạo một trang mới làm trang tổng hợp.
- Gõ
/page properties reportvà chọn macro. - Trong cấu hình, nhập đúng nhãn đã dùng ở bước 3 (
brd-vi-tra-gop). - Chọn các cột thuộc tính muốn hiển thị (Confluence tự gợi ý dựa trên các thuộc tính đã có).
- Lưu trang. Bảng tổng hợp tự dựng và sẽ tự cập nhật mỗi khi trang con thay đổi.
Lỗi thường gặp & mẹo
Lỗi 1 — Quên gắn nhãn cho trang con. Đây là lỗi số một khiến Page Properties Report hiện bảng rỗng. Macro report hoạt động dựa trên label; nếu trang con không có đúng nhãn, nó không được gom vào. Luôn kiểm tra label trước khi than phiền "sao báo cáo không ra gì".
Lỗi 2 — Dùng màu Status tùy hứng, không thống nhất. Nếu mỗi người gán màu một kiểu, tài liệu mất ý nghĩa. Mẹo: tạo một trang "Quy ước Status" và pin nó trong space, bắt cả team theo.
Lỗi 3 — Lạm dụng panel. Khi mọi đoạn đều là Warning đỏ thì chẳng còn gì nổi bật — "cảnh báo lạm phát" khiến người đọc lờ luôn. Chỉ dùng panel cho thông tin thật sự cần tách bạch. Một trang chỉ nên có vài panel, không phải chục cái.
Lỗi 4 — Tên thuộc tính Page Properties không nhất quán giữa các trang. Nếu trang A ghi "Trạng thái" còn trang B ghi "Status", report sẽ tạo hai cột riêng và lệch lạc. Mẹo: dùng một template chuẩn cho mọi tài liệu cùng loại để tên thuộc tính luôn giống nhau (kết nối với bài về Page Templates).
Mẹo nâng cao: Status macro có thể đặt ngay trên tiêu đề trang, để khi ai mở trang là thấy ngay trạng thái tổng thể. Ví dụ tiêu đề "BRD Ví trả góp 🟢 Approved".
Mẹo về kiểu Subtle: khi một bảng có hàng chục Status, hãy dùng kiểu Subtle để mắt đỡ mỏi; để kiểu Bold cho những trạng thái cần báo động như "Blocked".
Bài tập thực hành
- Bài cơ bản: Tạo một trang Confluence mới tên "Theo dõi yêu cầu — [Tên dự án của bạn]". Liệt kê 5 yêu cầu giả định trong một bảng, mỗi yêu cầu gắn một Status macro với màu khác nhau (xanh/vàng/đỏ/xanh dương/xám). Thêm một Info panel ở đầu trang giải thích ý nghĩa từng màu.
- Bài panel: Viết một đoạn đặc tả ngắn cho một quy tắc nghiệp vụ bất kỳ. Dùng đúng ba loại panel: một Warning cho rủi ro pháp lý/kỹ thuật, một Info cho ngữ cảnh áp dụng, một Tip cho gợi ý thực hành tốt.
- Bài Page Properties (thử thách): Tạo 3 trang tài liệu con, mỗi trang đặt một Page Properties macro với cùng bộ thuộc tính (Trạng thái, Người phụ trách, Độ ưu tiên) và gắn cùng một nhãn. Sau đó tạo một trang tổng hợp với Page Properties Report quét nhãn đó. Đổi trạng thái trên một trang con và xác nhận bảng tổng hợp tự cập nhật.
- Bài suy ngẫm: Viết quy ước màu Status cho team của bạn (mỗi màu ứng với trạng thái gì), giải thích lý do chọn. Đây là tài liệu thật bạn có thể dùng trong công việc.
Tóm tắt
Macros là những khối dựng sẵn biến một trang Confluence text thuần thành tài liệu sống động, dễ quét và tự cập nhật. Với BA, ba macro quan trọng nhất là:
- Status macro — nhãn màu giúp người đọc nắm trạng thái chỉ bằng một cái liếc; sức mạnh nằm ở quy ước màu thống nhất toàn team.
- Info/Note/Warning/Tip panels — các khung nổi bật giúp tách bạch sắc thái thông tin và đảm bảo điều quan trọng không bị bỏ sót; dùng có chọn lọc, đừng lạm dụng.
- Page Properties + Page Properties Report — cặp đôi mạnh nhất, biến từng tài liệu thành nguồn dữ liệu và tự sinh bảng tổng hợp, loại bỏ công việc theo dõi thủ công và rủi ro dữ liệu lệch.
/status, /info, /page properties cho đến khi thành thói quen — tài liệu của bạn sẽ chuyên nghiệp hơn hẳn.