Tạo & Lưu trữ Script
Sơ lược
- Tạo và lưu Dự án tập lệnh, đồng thời nắm rõ khi nào nên sử dụng Đơn vị tập lệnh hoặc Biểu mẫu tập lệnh.
- Tải dự án tập lệnh lên Workspace được kết nối, chỉnh sửa các tập lệnh đã lưu trữ và lưu các bản sửa đổi mới.
- Cài đặt các dự án tập lệnh cục bộ hoặc trong Workspace dưới dạng Dự án toàn cục để các dự án tập lệnh khác có thể sử dụng những thủ tục và hàm của chúng.
Các script Altium Designer thường được tạo và lưu trữ trong một Dự án Script (*.PrjScr), nhưng cũng có thể được thêm vào hoặc lưu trữ trong bất kỳ loại dự án nào.
Để bắt đầu viết script, hãy tạo một dự án script mới và thêm các tệp script vào dự án đó.
Tạo dự án script và script
Dự án Script giúp bạn quản lý các script và có thể được tạo bằng cách chọn File » New » Script » Script Project từ các menu chính.
Một dự án mới (Script_Project1.PrjScr) để lưu trữ script sẽ được liệt kê trong bảng Projects.
Để thêm một script mới vào dự án, nhấp chuột phải vào tên dự án và chọn Add New to Project từ menu ngữ cảnh.

Sau khi tạo dự án script mới, hãy thêm một script mới vào dự án.
Khi tạo script mới, có hai loại script để lựa chọn tùy theo yêu cầu của dự án – Đơn vị Script và Biểu mẫu Script.
Các loại script
Đơn vị Script
Đơn vị script là một tài liệu script có cú pháp ngôn ngữ cụ thể, ví dụ như DelphiScript.

Một Đơn vị Script chứa mã script.
Biểu mẫu Script
Biểu mẫu Script là một cửa sổ có thể chứa nhiều điều khiển như nút, ô văn bản nhiều dòng và hộp danh sách, có thể được gắn các trình xử lý sự kiện. Trong trình soạn thảo, Biểu mẫu Script có hai chế độ xem có thể chọn bằng các tab Code và Form, như có thể thấy ở cuối tài liệu script minh họa bên dưới.
Một Biểu mẫu Script đang mở với tab Code và Form.
Mối quan hệ giữa các script trong một dự án
Khi một dự án có nhiều script, bất kỳ script nào (sử dụng cùng một ngôn ngữ) trong dự án đó đều có thể truy cập các biến toàn cục và thủ tục. Về thực chất, tất cả script trong một dự án đều có thể “nhìn thấy” nhau, vì vậy một thủ tục trong script này có thể gọi một thủ tục khác trong script khác thuộc cùng dự án script.
Điều quan trọng là tên thủ tục và biến toàn cục của các script trong cùng một dự án phải là duy nhất. Một cách thực hiện là chuyển tất cả các thủ tục/hàm dùng chung được sử dụng trong các script khác nhau sang một script mới trong cùng dự án. Điều này cho phép dễ dàng tái sử dụng các thủ tục và hàm trong script dùng chung mới này cho các dự án script khác nhau.
► Tham khảo Viết script để xem ví dụ về cách gọi thủ tục từ một script khác.
Tải dự án script lên Workspace đã kết nối
Altium Designer, kết hợp với Workspace đã kết nối của bạn, cung cấp khả năng tạo và quản lý các Script trong Workspace. Các script này được tạo trực tiếp trong Workspace, với dự án script tương ứng (*.PrjScr) được tải lên một bản sửa đổi của Script đích trong Workspace. Quy trình như sau:
- Tạo một Mục Script mới trong Workspace đã kết nối bằng bảng Explorer. Tham khảo trang Tạo & chỉnh sửa nội dung để tìm hiểu thêm về cách tạo các Mục trong Workspace.
-
Nhấp chuột phải vào Mục Script cần dùng trong bảng Explorer và chọn lệnh Upload từ menu ngữ cảnh. Hộp thoại Open tiêu chuẩn của Windows sẽ xuất hiện để bạn duyệt đến tệp dự án script cần dùng (
*.PrjScr). -
Sau khi chọn tệp mong muốn, tiếp tục tải lên bằng cách nhấp vào nút Open. Tệp dự án cùng tất cả các tệp trong cùng thư mục sẽ được tải lên bản sửa đổi và có sẵn trên tab chế độ xem Details của bản sửa đổi đó, trong bảng Explorer.

Dự án đã tải lên cùng tất cả các tệp trong cùng thư mục được liệt kê trên tab chế độ xem Details của bản sửa đổi thuộc Mục Script.
Ngoài ra, bạn có thể tải một dự án script lên một Script mới trong Workspace bằng cách kéo tệp dự án script đã chọn và các tệp nguồn liên quan từ một thư mục nguồn trong Windows Explorer rồi thả vào thư mục mong muốn trong bảng Explorer. Hộp thoại Create New Item sẽ xuất hiện, trong đó các tệp đã kéo được liệt kê ở vùng Sources. Name của Mục sẽ là tên các tệp, bao gồm cả phần mở rộng (các mục được phân tách bằng dấu chấm phẩy). Description sẽ có định dạng Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (các mục được phân tách bằng dấu chấm phẩy). Hãy thay đổi các giá trị này theo nhu cầu. Item ID sẽ tuân theo quy tắc đặt tên Mục được xác định ở cấp thư mục. Nếu thư mục chưa được xác định quy tắc đặt tên, tên sẽ tuân theo quy tắc $CONTENT_TYPE_CODE-{000000}.

Tải dự án script và các tệp liên quan lên bản sửa đổi đầu tiên của một Script mới tạo trong Workspace bằng phương pháp kéo và thả.
Chỉnh sửa Script trong Workspace
Bất cứ lúc nào, bạn cũng có thể quay lại bất kỳ bản sửa đổi nào của một Script trong Workspace và chỉnh sửa trực tiếp. Nhấp chuột phải vào bản sửa đổi trong bảng Explorer và chọn lệnh Edit từ menu ngữ cảnh. Thao tác này sẽ mở bản sửa đổi đó trong Altium Designer, nơi bạn có thể chỉnh sửa theo nhu cầu, rồi lưu trở lại Workspace dưới dạng bản sửa đổi tiếp theo bằng lệnh Save to server (phím tắt: Ctrl+Alt+S) – có trong menu ngữ cảnh khi nhấp chuột phải vào mục tương ứng với dự án trong bảng Projects.

Truy cập lệnh để bắt đầu chỉnh sửa trực tiếp một bản sửa đổi hiện có của script.
Nếu cần thay đổi dự án hoặc mã nguồn liên quan được lưu trong một Script trong Workspace và đã có các tệp nguồn cập nhật, bạn có thể tải các tệp đó lên Script trong Workspace này – các tệp mới sẽ được lưu trong bản sửa đổi tiếp theo của Script đó.
Dự án toàn cục
Các dự án script có thể được cài đặt bằng tính năng Global Projects để được tải sẵn và khả dụng khi phần mềm khởi động. Các biến và thủ tục toàn cục từ những script này có thể được sử dụng trong các dự án script đang mở khác.
Để đặt một dự án script thành dự án toàn cục, hãy chuyển đến trang Scripting System - Global Projects thông qua hộp thoại Preferences. Sử dụng nút Install để tìm và chọn một dự án từ tệp hoặc Workspace. Lặp lại quy trình này cho tất cả các dự án script mà bạn muốn cung cấp để sử dụng toàn cục.
Dự án Workspace Script đã cài đặt sẽ khả dụng trong Altium Designer bất cứ khi nào người dùng kết nối với Workspace. Lưu ý rằng dự án Workspace Script đã cài đặt được liệt kê theo vị trí hoặc “đường dẫn” trong cấu trúc thư mục của Workspace và ID của Workspace Script chứa dữ liệu dự án script.

Sử dụng Scripting System – Global Projects trong hộp thoại Preferences để cài đặt script.
Các dự án toàn cục cho phép script từ một dự án cục bộ cùng loại sử dụng các chương trình con từ những dự án script toàn cục đã cài đặt. Khi hộp thoại Select item to Run được mở (File » Run Script), các dự án script đã cài đặt sẽ xuất hiện cùng với những dự án script khác hiện đang mở trong bảng Projects .
