Thiết kế công cụ xuất STEP hàng loạt bằng NXOpen

Thiết kế công cụ xuất STEP hàng loạt bằng NXOpen

Xuất một chi tiết sang STEP bằng giao diện NX khá đơn giản, nhưng xuất hàng trăm tệp PRT theo cách tự động lại là một bài toán khác. Công cụ tốt phải quản lý việc mở và đóng part, chọn chuẩn STEP, đặt tên đầu ra, xử lý assembly, ghi log và tiếp tục chạy khi một tệp lỗi. Nếu chỉ lặp lại đoạn journal được ghi từ một thao tác đơn lẻ, batch export rất dễ dừng giữa chừng hoặc tạo dữ liệu không nhất quán.

1. Xác định phạm vi trước khi viết mã

Trước hết cần trả lời công cụ sẽ xuất loại dữ liệu nào:

• Mỗi tệp PRT thành một STEP độc lập.

• Một assembly hoàn chỉnh thành một STEP.

• Từng component duy nhất trong assembly.

• Chỉ solid, hay kèm surface, curve, PMI và coordinate system.

• STEP AP203, AP214 hay AP242 theo yêu cầu trao đổi dữ liệu.

Phạm vi quyết định cách duyệt file và cấu hình translator. Không nên để người dùng chọn một thư mục rồi ngầm xuất mọi thứ mà không có quy tắc về assembly, bản sửa đổi và tệp trùng tên.

2. Tách giao diện, xử lý và báo cáo

Một công cụ dễ bảo trì nên chia thành ba lớp. Lớp giao diện thu thập thư mục nguồn, thư mục đích và tùy chọn. Lớp xử lý thực hiện mở part, tạo STEP builder, commit và đóng part. Lớp báo cáo ghi kết quả từng tệp.

Nhờ tách lớp, có thể chạy cùng một engine từ Block UI Styler, menu NX hoặc chế độ command-line mà không viết lại logic xuất dữ liệu.

3. Duyệt tệp có kiểm soát

Chỉ nhận các phần mở rộng được hỗ trợ và bỏ qua tệp tạm. Chuẩn hóa đường dẫn, sắp xếp danh sách để log có thứ tự ổn định, đồng thời kiểm tra quyền ghi ở thư mục đích trước khi bắt đầu.

Tên đầu ra cần được làm sạch ký tự không hợp lệ. Khi hai PRT ở các thư mục khác nhau có cùng tên, không được âm thầm ghi đè. Có thể giữ cấu trúc thư mục tương đối, thêm mã dự án hoặc tạo quy tắc suffix rõ ràng.

4. Quản lý Session và PartLoadStatus

Trong NXOpen, cần lấy Session hiện tại và mở part qua PartCollection. Kết quả mở thường đi kèm PartLoadStatus; phải đọc cảnh báo thiếu component, reference hoặc font trước khi xuất. Đừng giả định rằng part mở được nghĩa là dữ liệu đã tải đầy đủ.

Sau mỗi tệp, đóng đúng part mà công cụ đã mở và giải phóng đối tượng trạng thái. Không đóng Work Part ban đầu của người dùng. Cách an toàn là ghi nhớ work/display part trước batch, rồi khôi phục bối cảnh sau khi hoàn tất.

5. Dùng STEP creator theo vòng đời Builder

NX cung cấp các builder xuất STEP qua DexManager, chẳng hạn Step214Creator ở các phiên bản tương ứng. Quy trình chung là tạo builder, gán input file hoặc đối tượng cần xuất, đặt output file, cấu hình object types và validation, sau đó Commit.

Builder phải được Destroy trong khối finally hoặc cơ chế tương đương, kể cả khi Commit phát sinh NXException. Nếu không hủy builder đúng cách, batch dài có thể giữ tài nguyên và làm NX chậm dần.

Tên lớp và tùy chọn có thể thay đổi giữa các phiên bản NX. Hãy ghi một journal từ thao tác xuất thủ công trên đúng phiên bản đang triển khai, rồi dùng API Reference để thay các lệnh FindObject mong manh bằng truy cập đối tượng có chủ đích.

6. Chọn kiểu dữ liệu và layer

Nếu đối tác chỉ cần hình học khối, không nên mặc định xuất toàn bộ curve, datum và CSYS. Ngược lại, quy trình khuôn hoặc kiểm tra có thể cần surface và PMI. Hãy đưa các lựa chọn này thành cấu hình có tên thay vì các giá trị Boolean rải rác trong mã.

Layer mask cũng cần quy tắc rõ. “1-256” thuận tiện nhưng có thể đưa cả hình học phụ nội bộ ra ngoài. Một cấu hình tốt có preset như Manufacturing, Supplier và Archive, mỗi preset ánh xạ tới chuẩn STEP, loại đối tượng và layer riêng.

7. Xử lý assembly và component trùng lặp

Nếu xuất assembly nguyên khối, cần xác nhận translator xử lý cấu trúc sản phẩm hay chỉ tạo geometry phẳng. Nếu xuất từng component, hãy dùng prototype part làm khóa duy nhất để tránh xuất cùng một chi tiết nhiều lần do nhiều occurrence.

Component suppressed, lightweight hoặc không tải đủ phải được ghi trạng thái vào log. Không nên tự động bỏ qua mà vẫn báo batch thành công.

8. Ghi log và cô lập lỗi từng tệp

Mỗi tệp nên có các trường: đường dẫn nguồn, đường dẫn STEP, thời gian bắt đầu, thời gian xử lý, trạng thái và thông báo lỗi. Bọc từng lần xuất bằng try/catch riêng để một part hỏng không dừng toàn bộ lô.

Phân biệt ít nhất ba kết quả: thành công, thành công có cảnh báo và thất bại. Cuối phiên, hiển thị tổng số và đường dẫn log; người dùng không cần cuộn Listing Window để tìm lỗi.

9. Kiểm tra đầu ra thay vì chỉ thấy tệp tồn tại

Sau Commit, kiểm tra tệp STEP tồn tại và có dung lượng hợp lý. Với quy trình quan trọng, có thể thực hiện kiểm tra vòng hai: nhập một mẫu STEP vào phiên tạm, xác nhận số body hoặc dùng validation properties của translator nếu phiên bản hỗ trợ.

Không dùng kích thước tệp là bằng chứng duy nhất. Một STEP chứa header nhưng thiếu solid vẫn có thể có dung lượng khác không.

10. Hiệu năng và độ ổn định

Đừng cố tạo nhiều thread gọi NXOpen đồng thời trong cùng một phiên. Phần lớn thao tác NXOpen phụ thuộc session và không an toàn để chạy song song tùy ý. Tối ưu bằng cách giảm cập nhật màn hình, tránh mở lại cùng prototype và giải phóng builder/part đúng lúc.

Với lô rất lớn, nên chia checkpoint. Ghi log sau mỗi tệp, cho phép chạy lại chỉ các mục thất bại và tránh phải bắt đầu từ đầu khi NX hoặc máy trạm gặp sự cố.

Checklist triển khai

• Chốt AP203/AP214/AP242 và loại dữ liệu cần xuất.

• Kiểm tra thư mục đích cùng quy tắc chống ghi đè.

• Ghi nhớ work/display part ban đầu.

• Đọc PartLoadStatus và cảnh báo component.

• Destroy builder trong mọi nhánh thực thi.

• Đóng chỉ những part do công cụ mở.

• Ghi log thành công, cảnh báo và thất bại.

• Kiểm tra tệp đầu ra và chạy thử trên bộ dữ liệu nhỏ.

• Xác nhận kết quả với phần mềm nhận dữ liệu.

Kết luận

Giá trị của batch exporter không nằm ở vòng lặp qua danh sách file, mà ở khả năng tạo kết quả lặp lại, truy vết được và không phá bối cảnh làm việc hiện tại. Bắt đầu từ journal để hiểu API là hợp lý, nhưng trước khi dùng trong sản xuất cần bổ sung quản lý tài nguyên, lỗi, cấu hình và validation.

Nguồn gợi ý chủ đề: UGAPI – “UG二次开发NXOpen c++导出STP程序代码”: https://www.ugapi.com/thread-6121-1.html; UG爱好者 – “UG 批量导入 支持X_T PRT STP STEP”: https://www.ugsnx.com/thread-326363-1-1.html

Nội dung được biên soạn lại và mở rộng, không sao chép mã hay bản dịch nguyên văn.