Chạy script
Sơ lược
- Tìm hiểu cách thực thi tập lệnh và xác định các lỗi được báo cáo khi chạy.
- Nắm được cách tạo lệnh tập lệnh tùy chỉnh bằng các tiến trình RunScript, RunScriptFile và RunScriptText.
- Khám phá cách gán lệnh tập lệnh cho menu và thanh công cụ của trình soạn thảo, đồng thời thiết lập phím tắt nếu cần.
Mặc dù hệ thống tạo tập lệnh của Altium Designer cung cấp phương tiện để tạo các tác vụ tự động hóa phức tạp cho Altium Designer, các tập lệnh được tạo ra cũng cần dễ dàng truy cập trong quá trình thiết kế. Ví dụ, một tập lệnh được tạo để thực hiện một chuỗi thao tác phức tạp khi chỉnh sửa PCB cần có sẵn ngay trong trình chỉnh sửa PCB để có thể thực thi chỉ bằng một hoặc hai lần nhấp chuột.
Altium Designer đáp ứng nhu cầu này bằng cách cho phép gán tập lệnh cho một trình khởi chạy tiến trình, từ đó tạo thành một lệnh có thể gán cho menu, thanh công cụ và phím tắt.
Thực thi tập lệnh
Khi được mở trong trình chỉnh sửa tập lệnh, tập lệnh có thể được thực thi bằng lệnh Run » Run của trình chỉnh sửa từ các menu chính (phím tắt: F9). Tập lệnh hiện được tham chiếu bởi lệnh Run » Set Project Startup Procedure sẽ được chạy.
Lệnh Run yêu cầu dự án tập lệnh phải đang mở trong Altium Designer; đây không phải là cách thuận tiện để truy cập một tập lệnh cần dùng, chẳng hạn trong quá trình thiết kế PCB. Ngoài ra, hộp thoại Select Item To Run (File » Run Script) cho phép bạn duyệt đến một tập lệnh trên ổ cứng cục bộ hoặc trong một Workspace được kết nối hoặc chọn một tập lệnh đang mở trong bảng Projects rồi chạy tiến trình mong muốn. Tập lệnh vẫn được nạp trong suốt phiên làm việc hiện tại.
Thực thi tập lệnh bằng trình khởi chạy tiến trình tập lệnh thông qua hộp thoại Select Item to Run.
Các tùy chọn và thành phần điều khiển trong hộp thoại Select Item to Run
- Grid - liệt kê các dự án tập lệnh có sẵn (*.PrjScr) và các tài liệu nguồn liên quan. Chọn mục tập lệnh mong muốn trong danh sách, sau đó nhấp vào OK để chạy tập lệnh.
-
Duyệt - nhấp để mở danh sách thả xuống, trong đó bạn có thể chọn duyệt:
- From File - nhấp để duyệt và chọn mục tập lệnh mong muốn từ hộp thoại Open tiêu chuẩn của Windows.
- From Server - nhấp để duyệt và chọn mục tập lệnh mong muốn từ hộp thoại Choose item (một phiên bản của bảng Explorer).
- Copy script parameters - nhấp chuột phải vào mục tập lệnh mong muốn để lấy đúng các tham số. Thao tác này sẽ sao chép toàn bộ đường dẫn, tên tiến trình và thủ tục vào bộ nhớ tạm.
Một phương pháp phù hợp hơn để truy cập tập lệnh thường dùng là cài đặt dự án dưới dạng Global Project từ trang Scripting System – Global Projects của hộp thoại Preferences. Trong trường hợp này, dự án được tự động nạp khi Altium Designer khởi động và có thể được thực thi bất cứ lúc nào thông qua lệnh File » Run Script.
Tuy nhiên, cách lý tưởng để truy cập chức năng của tập lệnh là tích hợp tập lệnh vào giao diện đồ họa của Altium Designer dưới dạng lệnh trên menu hoặc thanh công cụ. Quá trình này thường gồm hai bước: triển khai tập lệnh dưới dạng một lệnh (có thể kèm phím tắt), sau đó gán lệnh đó cho menu (tĩnh hoặc bật lên) hoặc thanh công cụ.
Tập lệnh dưới dạng lệnh
Có thể triển khai tập lệnh dưới dạng lệnh của ứng dụng bằng cách tận dụng các tiến trình máy chủ tích hợp sẵn của Altium Designer, hay cụ thể hơn là tiến trình ScriptingSystem:RunScript.
Lệnh đại diện cho một hành động được thực hiện và được hỗ trợ bởi một chuỗi tiến trình thông qua trình khởi chạy tiến trình được đóng gói. Đối với tiến trình ScriptingSystem:RunScript, chuỗi này bao gồm các tham số trỏ đến một tệp dự án tập lệnh cụ thể, một tệp tập lệnh thành phần (*.pas) và một tiến trình bên trong tập lệnh đó. Khi được sắp xếp phù hợp, các thành phần này tạo thành một chuỗi lệnh.
Ưu điểm của cách tiếp cận này là việc chạy tập lệnh dưới dạng tiến trình giúp tránh phải mở trực tiếp tập lệnh hoặc nạp tập lệnh dưới dạng dự án toàn cục. Ưu điểm thứ hai, cũng quan trọng hơn, của phương pháp chạy tập lệnh bằng tiến trình là có thể triển khai tập lệnh dưới dạng một lệnh dễ truy cập trong Altium Designer. Điều này được thực hiện bằng cách tùy chỉnh hệ thống menu của Altium Designer, trong đó tập lệnh có thể được gán cho một lệnh thuộc máy chủ được chỉ định – tức là một ứng dụng con như hệ thống tệp hoặc trình chỉnh sửa tài liệu thiết kế.
Tạo lệnh
Ví dụ, để gán tập lệnh HelloWorld làm lệnh cho trình chỉnh sửa PCB, trước tiên hãy mở một tài liệu PCB (đồng thời mở trình chỉnh sửa), rồi chọn View » Tools » Customize từ menu chính để mở hộp thoại Customizing PCB Editor. Bạn cũng có thể truy cập hộp thoại bằng cách nhấp chuột phải vào thanh menu hoặc thanh công cụ rồi chọn Customize từ menu thả xuống, hoặc nhấp đúp vào vùng trống (không có lệnh) trên thanh menu hoặc thanh công cụ.
Để tạo lệnh mới, nhấp vào nút New của hộp thoại để mở hộp thoại Edit Command, nơi bạn có thể nhập thông tin chi tiết về tiến trình máy chủ và đường dẫn tập lệnh – đảm bảo danh mục [Scripts] không được chọn khi tạo lệnh từ tập lệnh.
Các mục Action trong hộp thoại có dạng:
Process: ScriptingSystem:RunScript
Parameters: ProjectName|ProcName>Process
Tùy thuộc vào đường dẫn nguồn đến tập lệnh, chuỗi Parameters sẽ tương tự như sau:
ProjectName=C:\Users\Public\Documents\Altium\Delphiscript Scripts\General\HelloWorld.PRJSCR|ProcName=HelloWorld.pas>HelloWorld
Hộp thoại Edit Command cũng cung cấp các trường nhập cho nhãn lệnh, mô tả, phím tắt và ảnh bitmap đi kèm (BMP/GIF/PNG; 18 x 18 pixel). Các thiết lập này được lưu cùng với lệnh và áp dụng cho mọi vị trí mà lệnh được chèn vào menu, thanh công cụ và menu bật lên – như được mô tả trong phần Gán lệnh cho menu bên dưới.
Sau khi hoàn tất các thông tin và đóng hộp thoại chỉnh sửa , script HelloWorld sẽ có sẵn dưới dạng lệnh tùy chỉnh (trong [Custom]) cho Trình chỉnh sửa PCB.
Thực thi script bằng tiến trình RunScriptFile
Có thể thực thi script dạng unit DelphiScript của Altium Designer (có phần mở rộng *.pas) bằng tiến trình RunScriptFile. Lưu ý, chỉ có thể sử dụng script dạng unit DelphiScript – không dùng được script có biểu mẫu. Trong trường hợp này, các mục Action của hộp thoại có dạng:
Process: ScriptingSystem:RunScriptFile
Parameters: FileName|ProcName
Tùy vào đường dẫn nguồn đến tệp script, chuỗi Parameters sẽ tương tự như sau:
FileName=C:\Users\Public\Documents\Altium\Delphiscript Scripts\Processes\ShowNetList.pas|ProcName=RunNetList
Thực thi script bằng tiến trình RunScriptText
Có thể sử dụng tiến trình này để thực thi một chuỗi lệnh trong khối Begin End;. Trong trường hợp này, các mục Action của hộp thoại có dạng:
Process: ScriptingSystem:RunScriptText
Parameters: Text
Ví dụ, có thể khởi chạy một ứng dụng bên ngoài như Microsoft Notepad từ Altium Designer thông qua điều khiển bằng phần mềm. Trong trường hợp này, các mục tiến trình lệnh và tham số sẽ là:
Process: ScriptingSystem:RunScriptText
Parameters: Text=Begin RunApplication('notepad.exe'); End;
Trong trường hợp này, tiến trình phần mềm ScriptingSystem:RunScriptText thực sự chạy một chuỗi câu lệnh script, thay vì mở và chạy một tệp script cụ thể như mô tả ở trên.
Cách khác là tạo một script với vài dòng mã tương đương, sau đó tạo một mục lệnh ScriptingSystem:RunScript thông thường.
Procedure RunNotepad;
Begin
RunApplication('notepad.exe');
End;
Lưu ý rằng với cả hai cách triển khai lệnh Notepad bên ngoài, chỉ cần nhập 'notepad.exe' làm tham số cho RunApplication, thay vì chỉ định đường dẫn và tên tệp đầy đủ của ứng dụng. Các ứng dụng Windows như Calculator và Notepad đã được hệ điều hành chỉ định sẵn đường dẫn.
Để khởi chạy từ Altium Designer một ứng dụng không có sẵn đường dẫn trong Windows, cần chỉ định đường dẫn và tên tệp đầy đủ của ứng dụng (đặt trong dấu nháy đơn để xử lý các khoảng trắng trong đường dẫn). Vì vậy, ví dụ để khởi chạy phiên bản Altium Designer thứ hai, tiến trình RunApplication và các tham số sẽ là:
RunApplication('C:\Program Files\Altium\xx\X2.EXE') – trong đó xx đại diện cho tên thư mục phiên bản Altium Designer.
Gán lệnh cho menu
Khi một script đã được triển khai dưới dạng lệnh máy chủ tùy chỉnh thông qua chức năng Tùy chỉnh của Altium Designer (View » Toolbars » Customize) như trình bày ở trên, có thể gán lệnh đó vào giao diện đồ họa của máy chủ bằng thao tác kéo và thả đơn giản.
► Xem thêm Tùy chỉnh không gian thiết kế
Thanh công cụ
Ví dụ, để gán một lệnh tùy chỉnh vào menu chính hoặc menu thanh công cụ của Trình chỉnh sửa PCB, hãy mở hộp thoại Customizing PCB Editor, tìm lệnh tùy chỉnh rồi kéo lệnh đến vị trí menu mong muốn. Lưu ý rằng cần mở một tài liệu PCB để truy cập các menu của Trình chỉnh sửa PCB. Sau khi đóng hộp thoại tùy chỉnh, bạn có thể truy cập lệnh menu mới bất cứ lúc nào trong Trình chỉnh sửa PCB.

Có thể kéo lệnh tùy chỉnh đến vị trí menu mong muốn.
Trong ví dụ này, do lệnh tùy chỉnh mới đã được gán vào PCB Active Bar, bạn có thể thấy lệnh trong danh mục lệnh PCB Active Bar của hộp thoại Customizing PCB Editor.

Khi được gán vào một menu, lệnh script tùy chỉnh sẽ xuất hiện trong danh mục của menu đó ở hộp thoại tùy chỉnh.
Để xóa lệnh khỏi menu, hãy mở hộp thoại tùy chỉnh rồi kéo biểu tượng lệnh trên menu trở lại hộp thoại.

Xóa lệnh đã được gán vào thanh công cụ.
Menu
Có thể gán lệnh tùy chỉnh vào menu ở bất kỳ cấp nào bằng cùng thao tác kéo và thả được mô tả ở trên.
Khi máy chủ ở chế độ tùy chỉnh, các menu vẫn phản hồi với con trỏ chuột và sẽ mở rộng hoặc thu gọn tương ứng. Ví dụ, để đặt một lệnh vào menu Reports của Trình chỉnh sửa PCB, hãy kéo lệnh vào menu rồi di chuyển xuống danh sách để thả vào vị trí phù hợp. Sau khi đóng hộp thoại tùy chỉnh, có thể truy cập lệnh menu mới – ở đây là Notepad – từ menu Reports .

Các menu vẫn hoạt động trong quá trình tùy chỉnh, cho phép kéo lệnh tùy chỉnh vào menu thả xuống.
Menu bật lên
Có thể gán lệnh vào menu bật lên khi nhấp chuột phải theo cách tương tự như mô tả ở trên, không bị giới hạn bởi số cấp menu con.
Trong ví dụ này, lệnh được kéo qua đường dẫn menu PCB Popups » Right Mouse Click Free Space và thả vào menu con như hình bên dưới. Sau khi được gán, lệnh script Notepad tùy chỉnh sẽ khả dụng trong Trình chỉnh sửa PCB khi nhấp chuột phải vào vùng trống.

Lệnh tùy chỉnh được gán vào menu con khi nhấp chuột phải
Gán trực tiếp script
Thay vì tạo một lệnh tùy chỉnh có thể tái sử dụng từ script rồi gán vào menu, bạn có thể gán trực tiếp script vào menu như một cách làm nhanh, chỉ dùng cho một vị trí.
Cách này bỏ qua bước tạo lệnh tùy chỉnh bằng cách gán trực tiếp script đã nạp vào menu. Do không có lệnh tùy chỉnh tương ứng để có thể gán vào nhiều menu dưới dạng một lệnh được cấu hình đầy đủ, phương pháp trực tiếp này chỉ cung cấp quyền truy cập script tại một vị trí menu riêng lẻ. Vì vậy, các thiết lập của lệnh như Nhãn, Mô tả, Hình ảnh và Phím tắt chỉ áp dụng cho vị trí được gán.
Để gán trực tiếp script vào menu, hãy nạp dự án script, mở hộp thoại Customizing của máy chủ (View » Toolbars » Customize), chọn [Scripts] trong danh sách Categories, tìm script mong muốn rồi kéo script đến một vị trí trên menu. Nhấp vào
để đóng hộp thoại Edit Command.

Cũng có thể gán trực tiếp một script, thay vì một lệnh, vào menu.
Cũng như với mọi mục được thêm vào menu, nếu mục menu mới vẫn giữ các thiết lập mặc định (tên hiển thị, phím tắt, v.v.), bạn có thể điều chỉnh bằng cách nhấp chuột phải vào mục menu đó rồi chọn Edit từ menu con. Thao tác này sẽ mở hộp thoại Edit Command để bạn nhập các thiết lập phù hợp.

Trong chế độ Tùy chỉnh, nhấp chuột phải vào một menu để truy cập các tham số của menu đó.
Sau khi được cấu hình, menu mới sẽ có sẵn trong quá trình thiết kế mà không cần phải tải riêng dự án script hoặc cài đặt dự án đó làm Dự án toàn cục.
Lưu ý rằng cách gán script cho menu này sẽ tự động tạo lệnh cần thiết. Đây không phải là lệnh tùy chỉnh được cấu hình đầy đủ và có thể gán lại như mô tả trong các phương pháp ở trên, mà là lệnh được tạo riêng cho mục menu đó.
Bạn có thể thấy điều này trong mục danh mục menu tương ứng của hộp thoại Customizing . Với ví dụ ở trên, bạn có thể thấy lệnh được cấu hình riêng trong danh mục Reports của hộp thoại Customizing PCB Editor.

Khi gán trực tiếp một script cho menu, lệnh tương ứng sẽ chỉ được tạo cho mục menu đó.






