Hướng dẫn cài đặt Web CAD API

1. Yêu cầu hệ thống

Windows 7 hoặc Windows server2008 trở lên 64 bit
Phiên bản JDK1.8

2.Cài đặt chương trình cấp phép

Cài đặt gói phần mềm trong thư mục “Hệ thống kiểm soát cấp phép”.
Mở “Virbox User Tool”，Nhấp vào Tạo tệp c2d ngoại tuyến và gửi tệp đến công ty Gstarsoft.

Gstarsoft sẽ tạo các tệp cấp phép dựa trên tệp c2d, nhấp vào Nhập tệp d2c ngoại tuyến, chọn tệp gói và nhấp vào nút Cập nhật để kích hoạt giấy phép.

3. Khởi động chương trình lập lịch tác vụ

Mở apache-zookeeper-3.7.1/conf/zoo.cfg, thay đổi vị trí nhật ký.

Mở apache-zookeeper-3.7.1/bin/zkServer.cmd và không đóng giao diện dòng lệnh.
Trước tiên, phải khởi động zookeeper, vì vậy trước khi bắt đầu, hãy chạy WebCADDWGTransfer.exe với tư cách quản trị viên và xem dịch vụ đã được khởi động chưa, nhấp vào nút Dừng nếu dịch vụ đã được khởi động và đợi zookeeper khởi động rồi mới bắt đầu dịch vụ chuyển đổi.

4. Bắt đầu dịch vụ cổng API

Tạo một thư mục làm thư mục gốc để lưu các tệp bản vẽ, chẳng hạn như D:\WebCADAPI\files, sau đó mở thư mục đó để tạo thêm hai thư mục nữa là cad và Swap.

Hãy nhớ đường dẫn của thư mục cad và thư mục Swap, chúng ta sẽ sử dụng sau này. Thư mục file cad được sử dụng để lưu bản vẽ và file sau khi chuyển đổi trong khi thư mục file Swap là không gian hoán đổi để chuyển đổi chương trình.

Mở tệp cấu hình gtfs-win64-en\application.properties, nếu nó không nằm trong đường dẫn mặc định là D:/WebCADAPI/files/cad, hãy thay đổi nó và chú ý đến hướng của các ký hiệu gạch chéo.

Sau đó nhấp đúp vào start.bat để bắt đầu dịch vụ hoặc bắt đầu dòng lệnh trong thư mục hiện tại, nhập java -Xmx1024m -Xms1024m -Xss256k -javaagent:sjt_agent.jar -jar GstarTransformServer-1.0.0.jar để bắt đầu dịch vụ. Vui lòng không đóng giao diện dòng lệnh.

5. Bắt đầu cấu hình và chương trình chuyển đổi

Nhấp chuột phải vào WebCADDWGTransfer-en/WebCADManager.exe, sau đó chọn Chạy với tư cách quản trị viên để mở.
Có nhiều thiết lập cấu hình trong chương trình, không thay đổi các thông số khác ngoài những thông số được đề cập bên dưới, sử dụng giá trị mặc định là được.

1. Nhiệm vụ khách hàng

Chọn Zookeeper，thêm 127.0.0.1:2181 vào cấu hình, vui lòng không thay đổi các thông số khác.

2.Cài đặt thư mục, chú ý đến hướng biểu tượng dấu gạch chéo

Dữ liệu, Bộ nhớ đệm, Temp: nhập thư mục gốc cho tất cả ba mục D:\WebCADAPI\files\cad
Không gian hoán đổi：D:\WebCADAPI\files\Swap
Phông chữ, Không gian phông chữ：thư mục phông chữ trong thư mục hiện tại D:\WebCADAPI\WebCADDWGTransfer\font

3. Bộ chuyển đổi dữ liệu bản vẽ

Nhấp vào nút ở cuối Quy trình và chọn WebCADDWGTransfer.exe trong thư mục tệp.
Nhấp vào nút Áp dụng ở góc dưới bên phải, sau đó nhấp vào nút “Cài đặt” và nhấp vào nút “Bắt đầu”.
Vui lòng nhấp vào Dừng trước khi sửa đổi bất kỳ tham số nào.
Nếu phần mềm cần được di chuyển đến thư mục khác, vui lòng dừng và gỡ cài đặt, sau đó cấu hình cài đặt trong thư mục mới để cài đặt và khởi động phần mềm.

Số lượng tối đa thường được thiết lập theo số lõi mà CPU có, ví dụ, với CPU 4 lõi, giá trị có thể được thiết lập thành 4 cho cả ba lõi. Bộ nhớ là một điều khác cần xem xét, mỗi lần đếm cần ít nhất 3G bộ nhớ, vì vậy để thiết lập giá trị thành 4, cần ít nhất 12G bộ nhớ.

Các thông số không được đề cập đến không cần phải sửa đổi, chỉ cần giữ nguyên mặc định.

6.Lên lịch cổng API chuyển đổi

Truy cập bằng trình duyệt: http://localhost:7088/docs.html các chức năng cổng liên quan sẽ được hiển thị.
Lấy hàm chuyển đổi ocf làm ví dụ, gửi yêu cầu http post đến cổng này bằng các tham số sau. Có luồng tệp và url được hỗ trợ cho tệp CAD, chỉ cần chọn một trong hai.

Nhấp vào Gỡ lỗi để gửi trực tiếp yêu cầu văn bản bằng giao diện, chọn tệp hoặc nhập địa chỉ tải xuống bản vẽ CAD và nhấp vào nút Gửi để trả về kết quả, có ID tác vụ có thể được sử dụng để kiểm tra kết quả.

Nhấp và kiểm tra kết quả thực hiện tác vụ, nhập ID tác vụ để có kết quả chuyển đổi. Sau đó tải ocf xuống máy chủ tệp bằng địa chỉ tải xuống url ocf.

{
"rtnCode": "0000000",
"msg": "success",
"ts": 1679977119909,
"bizData": {
"taskType": "MAKEOCF",
"requestId": "f52d3778-9931-45a6-b4d8-614bdb385f92",
"status": 2,
"resultCode": 0,
"resultMsg": "OK",
"transformStartTime": "2023-03-28 12:02:48",
"transformEndTime": "2023-03-28 12:02:48",
"extData": "123sdfsdfsdfgsdsdfsd",
"localPath": "D:/WebCADAPI/files/cad/ocf/2023/03/28/0000000001.1.ocf",
"ocfUrl": "http://localhost:7088/openapi/v1/download?fileId=55223d90-b990-4d3f-b40b-4ecd0f4ee184",
"ocfName": "0000000001.1.ocf",
"version": "1.07",
"layout": "*Model_Space",
"layouts": [
"31",
"*Model_Space",
"Model",
"88",
"*Paper_Space",
"Layout1",
"93",
"*Paper_Space0",
"2222"
]
}
}

Mã rtnCode

 

Giá trị	Sự miêu tả
0000000	Thành công
0000001	Chức năng này không được phép, vui lòng liên hệ với quản trị viên
0000002	Máy chủ đang bận, vui lòng thử lại sau
0000003	Các thông số bất thường
0000004	Tên tệp không được để trống
0000005	Không tìm thấy tập tin
0000006	Nhiệm vụ chuyển đổi không tồn tại
0000007	Vui lòng tải lên tệp dwg
0000008	Vui lòng tải lên tệp ocf
0000009	Vui lòng tải lên tệp bản vẽ 3D
0000010	Vui lòng tải lên tệp ocf3
0000011	Vui lòng tải lên tệp dwg/ocf
0000012	Vui lòng tải lên tệp rvt/stl/ifc/ocf3
0000013	Lưu dưới dạng các loại tệp khác: chỉ được hỗ trợ trong dwg/dxf
0000014	lưu dưới dạng các phiên bản khác: 0^ ~5
0000015	Vui lòng tải lên tệp pdf
0000018	Tên miền của tệp url không đúng, vui lòng xác minh và thử lại
0000019	Đã xảy ra lỗi trong khi tải xuống tệp url, vui lòng xác minh url và thử lại.
0000020	Đã xảy ra lỗi khi nhận luồng file, vui lòng xác minh và thử lại

 

Trạng thái trong bizData hiển thị trạng thái chuyển đổi bản vẽ:

0 : Chưa bắt đầu
1 : Đang xử lý
2: Việc chuyển đổi hoàn tất chỉ có nghĩa là chương trình chuyển đổi ở phía sau đã trả về kết quả, không có nghĩa là OCF đã được tạo, việc chuyển đổi có thể đã thất bại và không có OCF nào được tạo.
resultCode giống với mã trong tham số trả về của Linux phiên bản cũ, ngoại trừ 0 có nghĩa là ocf được tạo và tất cả các trường hợp khác có nghĩa là không tạo được ocf.

 

Mã số	Sự miêu tả
0		Chuyển đổi thành công, nếu không thì không thành công
2		Không đúng lớp nhiệm vụ tham số
404		Không tìm thấy bản vẽ tương ứng
800		Chuyển đổi không thành công chủ yếu là do file bản vẽ và cần có từng file bản vẽ riêng để tìm ra nguyên nhân gây ra lỗi.
801		Tham số đầu vào không đúng
802		Tệp cấu hình không đúng

Phiên bản hiện tại chỉ hỗ trợ chuyển đổi bản vẽ 2D sang định dạng dwg và dxf, chuyển đổi bản vẽ 3D vẫn đang được phát triển và dự kiến hoàn thành vào nửa cuối năm nay, do đó có thể bỏ qua các cổng liên quan đến 3D.