Tạo & Lưu trữ Script

Các script của Altium Designer thường được tạo và lưu trong một Script Project (*.PrjScr), nhưng cũng có thể được thêm vào hoặc lưu trong bất kỳ loại project nào.

Để bắt đầu viết script, trước tiên hãy tạo một script project mới và thêm các file script vào project đó.

Tạo Script Project và Script

Script Project giúp bạn quản lý các script của mình, và có thể được tạo bằng cách chọn File » New » Script » Script Project từ menu chính.

Một project mới (Script_Project1.PrjScr) để lưu trữ script sẽ được liệt kê trong Projects panel.

Để thêm một script mới vào project, hãy nhấp chuột phải vào tên project và chọn Add New to Project từ menu ngữ cảnh.

Sau khi đã tạo xong một script project mới, hãy thêm một script mới vào project.

Khi tạo script mới, có hai loại script để lựa chọn tùy theo yêu cầu của project – Script Units và Script Forms.

Các loại Script

Script Units

Script unit là một tài liệu script có cú pháp ngôn ngữ cụ thể, ví dụ như DelphiScript.

Một Script Unit có chứa mã script.

Script Forms

Script Form là một cửa sổ có thể chứa nhiều loại control như nút bấm, memo và list box, đồng thời có thể gán các event handler. Trong trình soạn thảo, một Script Form 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 bên dưới.

Một Script Form với tab Code và tab Form đang mở.

Mối quan hệ giữa các script trong một Project

Khi một project có nhiều script, bất kỳ script nào (dùng cùng một bộ ngôn ngữ) trong project đó đều có thể truy cập các biến toàn cục và thủ tục. Trên thực tế, tất cả các script trong một project đều "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 một script khác thuộc cùng script project.

Điều quan trọng là phải đặt tên duy nhất cho các thủ tục và biến toàn cục của các script trong cùng một project. Một cách tiếp cận là chuyển tất cả các thủ tục/hàm dùng chung giữa nhiều script vào một script mới trong cùng project. Nhờ đó, các thủ tục và hàm trong script dùng chung mới này có thể dễ dàng được tái sử dụng cho các script project khác nhau.

► Tham khảo Writing Scripts để xem ví dụ về cách gọi một thủ tục từ script khác.

Tải Script Project lên Connected Workspace

Altium Designer, kết hợp với Workspace được kết nối của bạn, hỗ trợ khả năng tạo và quản lý Workspace Scripts. Các script này được tạo trực tiếp trong Workspace, với script project tương ứng (*.PrjScr) được tải lên một revision của Workspace Scripts đích. Quy trình thực hiện như sau:

1. Tạo một Script Item mới trong Workspace được kết nối của bạn bằng Explorer panel. Tham khảo trang Creating & Editing Content để tìm hiểu thêm về cách tạo Item trong Workspace.

2. Nhấp chuột phải vào Script Item cần dùng trong Explorer panel và chọn lệnh Upload từ menu ngữ cảnh. Hộp thoại chuẩn của Windows Open sẽ xuất hiện để bạn duyệt đến file script project cần dùng (*.PrjScr).

   Nếu Item chưa có revision được lên kế hoạch, việc tải lên sẽ thực hiện vào revision được lên kế hoạch kế tiếp, được tạo tức thời như một phần của quá trình tải lên.

   
   Chỉ định file script project sẽ được tải lên Script Item đích.

3. Khi đã chọn file mong muốn, tiếp tục tải lên bằng cách nhấp nút Open. File project, cùng với tất cả các file trong cùng thư mục, sẽ được tải lên revision đó và sẽ có sẵn trên tab chế độ xem Details cho revision đó, trong Explorer panel.

   
   Project đã tải lên, cùng với tất cả các file trong cùng thư mục, được liệt kê trên tab chế độ xem Details của revision thuộc Script Item.

Ngoài ra, một script project có thể được tải lên một Workspace Script mới bằng cách kéo file script project đã chọn và các file nguồn liên quan từ thư mục nguồn trong Windows Explorer rồi thả vào thư mục cần dùng trong Explorer panel. Hộp thoại Create New Item sẽ xuất hiện, với các file được kéo hiển thị trong vùng Sources. Name của Item sẽ là các tên file, 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 nếu cần. Item ID sẽ tuân theo quy tắc đặt tên Item được định nghĩa ở cấp thư mục. Nếu thư mục không có quy tắc đặt tên, việc đặt tên sẽ theo quy tắc $CONTENT_TYPE_CODE-{000000}.

Tải lên một script project và các file liên quan vào revision đầu tiên của một Workspace Script mới tạo bằng phương pháp kéo thả.

Chỉnh sửa Workspace Script

Bất kỳ lúc nào, bạn cũng có thể quay lại bất kỳ revision nào của một Workspace Script và chỉnh sửa trực tiếp. Nhấp chuột phải vào revision trong Explorer panel và chọn lệnh Edit từ menu ngữ cảnh. Revision đó sẽ được mở trong Altium Designer, nơi bạn có thể chỉnh sửa theo nhu cầu, sau đó lưu ngược trở lại Workspace thành revision kế tiếp bằng lệnh Save to server (phím tắt: Ctrl+Alt+S) – có sẵn trong menu ngữ cảnh khi nhấp chuột phải vào mục project trong Projects panel.

Truy cập lệnh để khởi chạy chỉnh sửa trực tiếp một revision hiện có của script.

Nếu bạn cần thay đổi project hoặc mã nguồn liên quan được lưu trong một Workspace Script, và bạn đã có các file nguồn đã cập nhật, bạn có thể tải các file đó lên Workspace Script đó – các file mới sẽ được lưu trong revision kế tiếp của Workspace Script đó.

Global Projects

Script project có thể được cài đặt bằng tính năng Global Projects để chúng được nạp sẵn và khả dụng khi phần mềm khởi động. Các biến toàn cục và thủ tục từ những script này có thể được dùng trong các script project đang mở khác.

Để biến một script project thành global, hãy chuyển đến trang Scripting System - Global Projects thông qua hộp thoại Preferences. Dùng nút Install để duyệt và chọn một project từ file hoặc Workspace. Lặp lại quy trình này cho tất cả các script project mà bạn muốn cho phép dùng toàn cục.

Workspace Script project đã cài đặt sẽ khả dụng cho Altium Designer bất cứ khi nào người dùng kết nối với Workspace. Lưu ý rằng Workspace Script project đã cài đặt được liệt kê theo vị trí hoặc "đường dẫn" của nó trong cấu trúc thư mục của Workspace và ID của Workspace Script chứa dữ liệu script project.

Sử dụng Scripting System – Global Projects từ hộp thoại Preferences để cài đặt script.

Global Projects cho phép các script từ một project cục bộ cùng loại sử dụng các routine từ các global script project đã cài đặt. Khi hộp thoại Select item to Run được mở (File » Run Script), các script project đã cài đặt sẽ xuất hiện cùng với các script project khác hiện đang mở trong Projects panel.