PHM Modeling · PHM Archi · PHM Advance · Playbook

Tra cứu từng tool.
Từng nút, từng bước, có ảnh.

Gửi bạn — người sẽ dùng bộ tool này mỗi ngày. Chúng tôi viết playbook này để mỗi khi bạn lúng túng trước một nút bấm, chỉ cần mở trang là biết: tool đó để làm gì, khi nào nên dùng, từng ô trong bảng điều khiển nghĩa là gì, và bấm theo thứ tự nào thì đúng.

Hãy bắt đầu từ bước cài đặt bên dưới, xem qua Cách đọc, rồi khi làm việc cứ mở tab Tra cứu tool — mọi thứ xếp đúng theo tab › panel như bạn thấy trên ribbon Revit. Hi vọng playbook này giúp được các bạn.

— đội ngũ PHM-RevitTools

Revit 2022–2027 Có ảnh ribbon + icon từng tool Cho cả người mới dùng Revit

Bước 0 · Trước khi làm bất cứ việc gì

Cài đặt, đăng nhập và đồng bộ tài khoản.

Cài bộ tool bằng một file cài đặt (MSI) tải từ portal — không cần quyền admin. Sau khi cài, toàn bộ tool chỉ mở khoá khi bạn đăng nhập bằng tài khoản PHM: đây là bước quan trọng nhất của lần setup đầu tiên. Làm một lần cho mỗi máy, rồi quên nó đi.

Video 1,5 phút: panel Setup — vì sao ribbon chỉ có một panel lúc mới cài, đăng nhập mở khoá toàn bộ tool, đồng bộ máy với tài khoản portal, và ba nút Update · Language · About.
1 · Tải & cài bộ tool Mở portal (trang web quản lý tài khoản & license) phm-tools.pages.dev → thẻ Bước 1 có nút tải bộ cài (.msi) — tải được ngay, không cần tài khoản. Chạy file .msi: trình cài đặt theo người dùng (không hỏi quyền admin, không bị SmartScreen chặn) và tự cài cho mọi phiên bản Revit 2022–2027 có trên máy. Cài xong, mở Revit.
Lần đầu mở Revit — ribbon chỉ có một panel. Khi chưa đăng nhập, tab PHM Modeling chỉ hiện panel Setup với 4 nút: About · Login · Update · Language VI — đây là trạng thái bình thường, không phải lỗi cài đặt. Toàn bộ panel còn lại (và tab PHM Advance) sẽ xuất hiện ngay sau khi đăng nhập thành công.
Panel Setup khi chưa đăng nhập
2 · Tạo tài khoản (nếu chưa có) Trên portal, thẻ Bước 2 có nút Đăng ký (hoặc trong cửa sổ Login của Revit bấm link "Đăng ký" — mở đúng trang đó). Điền email, mật khẩu, tên công ty. Tài khoản mới được tặng 14 ngày dùng thử gói Basic — đăng nhập là dùng được ngay, chưa cần mua.
Công ty nhiều máy — bạn tự quyết cách vào tài khoản Mỗi công ty chỉ nên có một tài khoản chủ (đứng tên license, quản lý ghế trên portal). Máy nhân viên vào bằng một trong hai cách: đăng nhập chung tài khoản chủ (mỗi máy chiếm 1 ghế), hoặc nhập license key được phát. Đừng để mỗi nhân viên tự đăng ký một tài khoản mới trùng tên công ty — license sẽ không chung nhau.
3 · Đăng nhập trong Revit — mở khoá toàn bộ tool Bấm PHM Modeling ▸ Setup ▸ Login → nhập email + mật khẩu tài khoản PHM → Đăng nhập. Add-in tự lấy license của tài khoản và kích hoạt máy này — chiếm 1 ghế (ghế = một suất kích hoạt máy trong license; license N ghế thì N máy dùng cùng lúc); nếu tài khoản có nhiều key, Revit hiện danh sách cho bạn chọn key. Đăng nhập xong, ribbon nạp đầy đủ panel theo gói license (Basic/Full — nút ngoài gói hiển thị mờ). Cửa sổ mô phỏng dưới đây trích đúng theo giao diện thật; chi tiết đầy đủ (kèm cửa sổ nhập license key thủ công): xem tool Login ở mục tham khảo cuối trang này.

Cửa sổ "Đăng nhập PHM-RevitTools" (đã đăng nhập trước đó)

Đăng nhập PHM-RevitTools
Tài khoản trên máy này
Tài khoản: user@congty.vn
Tier: Full
License: PHM-XXXX-XXXX-XXXX
Hạn license: 2027-08-30
1
Đồng bộ ngay Đăng xuất (trả ghế máy này)
2
Đăng nhập bằng tài khoản PHM-RevitTools
Email:
user@congty.vn
Mật khẩu:
••••••••
👁
Đăng nhập và kích hoạt máy này
3
Chưa có tài khoản? Đăng ký trên portal · Nhập license key thủ công
4
1 Trạng thái hiện tại Nếu máy chưa từng đăng nhập/kích hoạt, khối này chỉ hiện một dòng "Chưa đăng nhập / chưa kích hoạt trên máy này." và 2 nút Đồng bộ/Đăng xuất bị ẩn.
2 Đồng bộ ngay / Đăng xuất Đồng bộ ngay gọi lại server lấy tier/hạn mới nhất (checkin) — dùng khi vừa đổi gói trên portal hoặc nghi ngờ máy bị gỡ ghế. Đăng xuất hỏi xác nhận rồi hủy kích hoạt license trên máy này, trả ghế lại cho tài khoản để máy khác dùng.
3 Form đăng nhậpluôn hiện, kể cả khi đã login Nhập email + mật khẩu (icon 👁 để hiện/ẩn mật khẩu) rồi bấm nút chính. Nếu tài khoản có nhiều license còn hiệu lực, form chuyển sang màn hình chọn 1 license trong danh sách (kèm tier/hạn/số ghế đang dùng) trước khi kích hoạt.
4 2 liên kết dưới form Đăng ký trên portalQuên mật khẩu? (cạnh ô Mật khẩu) mở trình duyệt hệ thống tới https://phm-tools.pages.dev. Nhập license key thủ công mở cửa sổ "Kích hoạt license" bên dưới — dành cho license key được cấp không kèm tài khoản portal.
4 · Đồng bộ với tài khoản (khi có thay đổi) Cửa sổ Login cũng là nơi đồng bộ máy với tài khoản: Đồng bộ ngay — kéo trạng thái mới nhất từ server về (sau khi gia hạn, nâng gói, hoặc bị gỡ ghế trên portal) · Đăng xuất — trả ghế để dùng cho máy khác, portal thấy ngay · Nhập license key thủ công — cho khách chỉ được phát key, không có tài khoản. Kiểm tra trạng thái bất cứ lúc nào bằng Setup ▸ About.
5 · Cập nhật phiên bản Setup ▸ Update — kiểm tra và cài bản mới nhất từ server, ribbon tự tải lại sau khi xong.
Đổi ngôn ngữ ribbon: Setup ▸ Language VI chuyển chữ trên ribbon giữa tiếng Việt và tiếng Anh, ghi nhớ cho lần mở Revit sau.
Gỡ cài đặt (khi cần): Windows Settings ▸ Apps ▸ PHM-RevitTools ▸ Uninstall — gỡ khỏi mọi phiên bản Revit. License trên server không bị ảnh hưởng: cài lại rồi đăng nhập là nhận lại nguyên trạng.

Tham khảo · Bốn nút của panel Setup

About · Login · Update · Language — chi tiết từng nút

Phần này là tài liệu đầy đủ của panel Setup (tab Tra cứu tool chỉ tham chiếu về đây). Bạn chỉ cần tới nó khi gặp tình huống ngoài quy trình chuẩn ở Bước 0: kiểm tra Machine ID, nhập license key thủ công, gỡ ghế máy cũ, đổi ngôn ngữ ribbon…

Panel · Setup

Panel duy nhất hiện ra khi vừa cài xong: kiểm tra bản/license, đăng nhập tài khoản để kích hoạt máy, cập nhật bản mới, đổi ngôn ngữ ribbon. Mọi panel khác của tab chỉ xuất hiện sau khi Login xong.

About

PHM Modeling ▸ Setup ▸ About

Mở nhanh một cửa sổ tóm tắt: bản add-in đang chạy, ai là tác giả, Machine ID của máy này và trạng thái license hiện tại (tài khoản, tier — gói license Basic/Full, còn hạn hay không). Dùng để kiểm tra nhanh trước khi báo lỗi cho support ("đang dùng bản nào"), hoặc lấy Machine ID khi cần nhờ quản trị viên gán license thủ công.

Trước khi mở
  • Không cần điều kiện gì — bấm được kể cả khi máy chưa đăng nhập/chưa kích hoạt.

Cửa sổ "PHM-RevitTools - About"

PHM-RevitTools — About
PHM-RevitTools
Version 2.11.0.0
PHM Group
License
Machine ID:
7F3A91C2-4B0E-...
Tài khoản: user@congty.vn
Trạng thái: Tier Full · còn hạn đến 2027-08-30
1
Đồng bộ ngayĐóng
1 Khối License Machine ID là mã định danh của máy này (dùng để gán license thủ công qua quản trị viên). Tài khoản/Trạng thái đọc từ cache license cục bộ; ngay khi form mở, một dòng "Đang kiểm tra trạng thái license..." hiện tạm bên dưới trong lúc form gọi server làm mới.
  1. Bấm About. Form mở ngay với version/tác giả có sẵn; đồng thời gọi server kiểm tra license nền.
  2. Bấm Đồng bộ ngay nếu muốn ép làm mới Tier/hạn ngay lập tức thay vì chờ.
  3. Bấm Đóng để thoát.
Máy chưa đăng nhập thì khối License chỉ hiện Machine ID; muốn gửi mã máy cho quản trị viên, dùng nút "Sao chép" trong cửa sổ Nhập license key thủ công (mở từ Login) — cùng một Machine ID.

Login

PHM Modeling ▸ Setup ▸ Login

Cách chính để kích hoạt license cho máy này: đăng nhập bằng tài khoản đã đăng ký trên portal (https://phm-tools.pages.dev) — add-in tự lấy license của tài khoản đó và kích hoạt vào Machine ID của máy hiện tại (1 tài khoản/công ty có 1 license với N ghế; các máy chỉ khác nhau ở Machine ID). Cửa sổ này cũng là nơi đồng bộ lại trạng thái (kiểm tra tier/hạn mới nhất, phát hiện nếu ghế đã bị gỡ trên portal) và đăng xuất để trả ghế cho máy khác dùng. Với khách chỉ được cấp license key (không có tài khoản portal), có lối riêng "Nhập license key thủ công".

Trước khi mở
  • Cần một tài khoản đã đăng ký trên portal (bấm "Đăng ký trên portal" ngay trong form nếu chưa có) và máy có kết nối internet để gọi license server.
  • Lần đầu cài add-in: ribbon PHM Modeling chỉ có panel Setup (About/Login/Update/Language). Đăng nhập thành công ở đây thì các panel còn lại (Settings, Levels and Gridline, Annotate, Modify…) mới hiện ra, theo đúng tier của license (Basic/Full).

Cửa sổ "Đăng nhập PHM-RevitTools" (đã đăng nhập trước đó)

Đăng nhập PHM-RevitTools
Tài khoản trên máy này
Tài khoản: user@congty.vn
Tier: Full
License: PHM-XXXX-XXXX-XXXX
Hạn license: 2027-08-30
1
Đồng bộ ngay Đăng xuất (trả ghế máy này)
2
Đăng nhập bằng tài khoản PHM-RevitTools
Email:
user@congty.vn
Mật khẩu:
••••••••
👁
Đăng nhập và kích hoạt máy này
3
Chưa có tài khoản? Đăng ký trên portal · Nhập license key thủ công
4
1 Trạng thái hiện tại Nếu máy chưa từng đăng nhập/kích hoạt, khối này chỉ hiện một dòng "Chưa đăng nhập / chưa kích hoạt trên máy này." và 2 nút Đồng bộ/Đăng xuất bị ẩn.
2 Đồng bộ ngay / Đăng xuất Đồng bộ ngay gọi lại server lấy tier/hạn mới nhất (checkin) — dùng khi vừa đổi gói trên portal hoặc nghi ngờ máy bị gỡ ghế. Đăng xuất hỏi xác nhận rồi hủy kích hoạt license trên máy này, trả ghế lại cho tài khoản để máy khác dùng.
3 Form đăng nhậpluôn hiện, kể cả khi đã login Nhập email + mật khẩu (icon 👁 để hiện/ẩn mật khẩu) rồi bấm nút chính. Nếu tài khoản có nhiều license còn hiệu lực, form chuyển sang màn hình chọn 1 license trong danh sách (kèm tier/hạn/số ghế đang dùng) trước khi kích hoạt.
4 2 liên kết dưới form Đăng ký trên portalQuên mật khẩu? (cạnh ô Mật khẩu) mở trình duyệt hệ thống tới https://phm-tools.pages.dev. Nhập license key thủ công mở cửa sổ "Kích hoạt license" bên dưới — dành cho license key được cấp không kèm tài khoản portal.

Cửa sổ "Kích hoạt license" (mở từ liên kết "Nhập license key thủ công")

Kích hoạt license - PHM-RevitTools
Trạng thái hiện tại:
Chưa kích hoạt trên máy này.
Làm mới trạng thái
Nhập license key PHM-RevitTools:
PHM-XXXX-XXXX-XXXX
Chưa có key? Gửi mã máy cho quản trị viên
Mã máy:
7F3A91C2-4B0E-...
Sao chép
email/SĐT liên hệ
Gửi mã máy Kiểm tra kích hoạt
Hủy kích hoạt máy này Kích hoạtĐóng
1 Ô license key Dán key được vendor cấp trực tiếp (không qua tài khoản portal), bấm Kích hoạt.
2 Khối "Chưa có key?" Cách kích hoạt không cần key lẫn tài khoản: Sao chép Mã máy (Machine ID), gửi kèm email/SĐT/tên công ty cho quản trị viên qua Gửi mã máy để họ gán vào license trên portal, rồi quay lại bấm Kiểm tra kích hoạt để tự nhận license vừa được gán.
3 Hủy kích hoạt máy này Trả ghế license đang gán cho máy này — dùng khi đổi máy hoặc hết nhu cầu dùng license key đó.
  1. Bấm Login. Khối trạng thái hiện lên trên cùng; lần đầu ghi "Chưa đăng nhập".
  2. Nhập Email + Mật khẩu của tài khoản đã đăng ký trên portal, bấm Đăng nhập và kích hoạt máy này (hoặc Enter trong ô mật khẩu).
  3. Nếu tài khoản có nhiều license, chọn 1 dòng trong danh sách rồi bấm Kích hoạt license đã chọn.
  4. Kích hoạt thành công → form tự đóng, một hộp thoại báo "Đăng nhập & kích hoạt thành công", các nút ribbon cập nhật ngay theo tier mới.
Thao tác Sau khi login lần đầu (hoặc đổi tier license), nếu panel/nút mới vẫn chưa thấy trên ribbon dù nút cũ đã bật đúng quyền — khởi động lại Revit một lần; việc bật/tắt trạng thái nút thì không cần khởi động lại.
Bạn tự quyết Máy dùng chung nhiều người (ví dụ máy trạm văn phòng) nên đăng nhập bằng tài khoản công ty rồi để nguyên; máy cá nhân có thể Đăng xuất khi xong việc để nhường ghế cho đồng nghiệp khác dùng license đó.
Không có trình duyệt nhúng — "Đăng ký" và "Quên mật khẩu?" luôn mở trình duyệt mặc định của Windows tới portal, không đăng nhập OAuth ngay trong Revit.

Update

PHM Modeling ▸ Setup ▸ Update

Kiểm tra bản mới trên server, tải về, xác minh rồi tự mở trình cài đặt — không cần vào lại portal để tải MSI thủ công. Toàn bộ là chuỗi hộp thoại TaskDialog của Revit, không có cửa sổ riêng.

Trước khi mở
  • Máy có kết nối internet. Nên lưu file đang mở trước vì bước cài cần đóng Revit.
  1. Bấm Update. Add-in gọi server so version hiện tại với bản mới nhất theo channel/năm Revit đang dùng.
  2. Không có bản mới → báo "Đang dùng bản mới nhất (x.y.z)." và dừng.
  3. Có bản mới → hộp thoại xác nhận "Có bản cập nhật mới … Tải và cài đặt ngay?" — chọn Yes để tiếp tục hoặc No để huỷ.
  4. Add-in tải file cài đặt về %TEMP% và xác minh chữ ký/checksum trong lúc Revit vẫn đang chạy bình thường.
  5. Xác minh xong → hộp thoại nhắc "Đóng TẤT CẢ cửa sổ Revit trước, sau đó bấm OK để chạy trình cài đặt." Chọn OK để chạy ngay trình cài đặt, hoặc Cancel để tự chạy sau (đường dẫn file được báo lại).
Trình cài đặt để ở chế độ tương tác, không tự đóng Revit: nếu bạn bấm OK mà Revit vẫn còn mở, Inno Setup sẽ báo "tập tin đang được sử dụng" — đóng hết Revit rồi bấm Retry trong cửa sổ cài đặt.
Tải/xác minh thất bại thì add-in không cài gì cả — báo lỗi và giữ nguyên bản đang dùng, an toàn để bấm lại sau.

Language

PHM Modeling ▸ Setup ▸ Language VI

Nút bật/tắt ngôn ngữ hiển thị của toàn bộ ribbon PHM (tên nút, tên panel, tên pulldown, tooltip) giữa tiếng Việt và tiếng Anh. Không cần mở cửa sổ nào — bấm một cái là đổi ngay tại chỗ.

  1. Bấm Language. Ribbon chuyển ngay sang ngôn ngữ còn lại (VI ↔ EN); lựa chọn được ghi nhớ và tự áp dụng lại ở lần mở Revit kế tiếp.
Chỉ đổi chữ trên ribbon (tên nút/panel/tooltip). Chữ hiển thị bên trong mỗi cửa sổ công cụ (label, tiêu đề cột…) giữ nguyên như tác giả viết, không đổi theo.