Python
Dùng Python File để chạy một tệp .py đã chuẩn bị, hoặc Python Text để đọc/sửa mã trong cửa sổ trước khi chạy. Script chỉ đọc phù hợp cho bước kiểm đầu tiên; script sửa model cần tự quản lý Transaction và được kiểm trên bản sao RVT.
Mức kiểm chứng được nêu tại từng công cụ. Ảnh cửa sổ xác nhận các điều khiển đang thấy; kết quả tạo/chỉnh sửa phải được kiểm trực tiếp trong model, Properties và bản RVT đã lưu.
Các nút logo/Feedback/YouTube được giải thích tại nút chung ở chân cửa sổ.
File Python (Python File)
Chọn file .py trong hộp Open. Cancel trả về hủy; chọn file sẽ đọc và chạy bằng IronPython. Script nhận doc, uidoc, uiapp, __revit__; RevitAPI/RevitAPIUI được nạp cho engine. Không mặc nhiên có CPython/numpy hoặc một môi trường pip của máy.
Ca đọc an toàn: script hiển thị tên document bằng TaskDialog. Nếu sửa model, script phải tự quản lý Transaction phù hợp; lưu bản sao RVT trước chạy. Python Error hiển thị lỗi thực thi. Chạy file bất kỳ có thể thực hiện mã đầy đủ; dùng script bạn đã kiểm nội dung. Bộ bổ sung chưa chạy script trong Revit.
Text Python (Python Text)
Cửa sổ có File Path, … mở file, 💾 lưu script, ô code, Hướng dẫn cho AI và Chạy Script Python. Mở/lưu file không đồng nghĩa script đã chạy; nút Run mới thực thi code hiện tại. Đối chiếu đường dẫn sau Save để tránh sửa nhầm file mẫu.
Dùng script chỉ đọc trước; sau Run kiểm thông báo/đầu ra thực, rồi mới thử một Transaction trên model copy. Trợ giúp AI là nội dung hướng dẫn, không phải xác minh code hay thiết kế. Runtime cửa sổ và Run còn thiếu.
Thực hành chỉ đọc trước khi sửa model
Tải script Python chỉ đọc. Script đếm Rebar set toàn project và phần tử đang selected; hai số có phạm vi khác nhau, không phải tổng số thanh vật lý. Mẫu không mở giao dịch, không ghi file và không dùng mạng.
- Mở bản sao RVT có Rebar; chọn một hoặc vài phần tử và ghi số selected trên thanh trạng thái.
- Mở BimSpeed.GEN → Python → Python Text, bấm …, chọn tệp mẫu. Đối chiếu File Path và đọc code vừa nạp.
- Bấm Chạy Script Python. Hộp Read-only model check cho số Rebar set toàn dự án và số selected. Đóng thông báo để trở lại cửa sổ; kiểm không có hình học hoặc dữ liệu mới.
- Bỏ chọn hoặc chọn thêm một phần tử, mở/chạy lại mẫu để đối chiếu số selected. Tổng Rebar set phải giữ nguyên nếu bạn chưa chỉnh model.
- Muốn giữ phiên bản code đã sửa, dùng 💾 và chọn tên .py mới. Lưu script không lưu RVT; dùng lệnh Save của Revit riêng khi chủ động sửa model.
Đây là mẫu thực hành theo các biến môi trường của công cụ; kết quả chạy bằng entry command được ghi riêng khi đã kiểm chứng. Cửa sổ Text hiện có nhãn tiếng Việt cố định, kể cả khi chọn chế độ EN.
Tra cứu từng điều khiển
| Điều khiển | Nhập gì / điều kiện | Phạm vi, tác động và cách kiểm |
|---|---|---|
| Open của Python File | Chọn một tệp .py; Cancel hủy | Tệp được đọc và thực thi ngay sau khi xác nhận. Đọc code trước khi chọn; không có bước preview riêng của luồng File. |
| File Path trong Python Text | Chỉ đọc; thay bằng Open hoặc Save | Cho biết tệp code đang nạp/lưu. Không đổi đường dẫn bằng gõ trực tiếp vào ô. |
| … | Hộp chọn .py | Đọc code vào editor và cập nhật File Path; chưa chạy code. Kiểm nội dung trước Run. |
| 💾 | Editor phải có code không chỉ chứa khoảng trắng; chọn tên/đường dẫn .py | Lưu code hiện tại thành tệp đã chọn và cập nhật File Path. Code trống có thông báo yêu cầu nhập. |
| Editor code | Văn bản Python; hỗ trợ Enter, Tab, cuộn ngang/dọc | Nội dung hiện tại là phần được Run thực thi. Mã dài không tự xuống dòng; cuộn để đọc hết. File vừa nạp có thể sửa trước khi lưu/chạy. |
| Hướng dẫn cho AI | Mở hộp hướng dẫn cục bộ | Là trợ giúp viết code, không phải nút chạy hoặc xác minh kết quả. Đọc các phần cuộn; đóng để trở lại editor. |
| Chạy Script Python | Editor có code | Thực thi code hiện tại với doc, uidoc, uiapp, __revit__; phạm vi đọc/ghi do code quyết định. Code trống không chạy. |
| Thông báo thành công/lỗi | Kết quả thực thi | Thành công nghĩa engine kết thúc không ném lỗi, chưa chứng minh kết quả nghiệp vụ đúng. Đối chiếu output, ID và Properties; lỗi Python hiển thị nội dung exception. |
| ✕ của cửa sổ | Đóng | Không thay cho Save script hoặc Save RVT. Lưu code có ích trước khi đóng. |
Với script sửa dữ liệu, ghi ID/giá trị trước chạy và yêu cầu script mở/commit đúng Transaction. Sau chạy kiểm cùng ID trong Properties, thử Undo rồi lưu bản sao với tên kết quả. Nếu báo thiếu module, dùng các assembly/API có sẵn trong engine hoặc chuẩn bị môi trường tương thích; cài package cho CPython không tự làm module xuất hiện trong IronPython. Không xem thông báo thành công là bằng chứng mọi phần tử đã được xử lý.