Chạy script

Sơ lược

Giúp bạn truy cập các tập lệnh dễ dàng hơn trong quá trình thiết kế với Altium Designer. Bài viết này hướng dẫn cách chạy tập lệnh từ trình soạn thảo Script hoặc hộp thoại Run Script, tự động tải các dự án thường dùng và biến tập lệnh thành các lệnh tùy chỉnh cho menu, thanh công cụ và phím tắt. Bài viết cũng trình bày các tiến trình thực thi tập lệnh hiện có và cách cấu hình tham số của chúng. Hãy đọc tiếp để có thể truy cập nhanh các tập lệnh ngay trong khi thiết kế.

- 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.
Tìm hiểu sâu hơn với AI:
 

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.

Nếu lệnh Set Project Startup Procedure chưa được thiết lập, hộp thoại Select Item To Run sẽ xuất hiện, nhắc bạn chọn tập lệnh và thủ tục cần thực thi.

Nếu tập lệnh có lỗi, tập lệnh sẽ bị dừng và bạn có thể sử dụng các lệnh gỡ lỗi khác nhau để khắc phục lỗi rồi thử chạy lại.

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.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.

Nếu tập lệnh có lỗi, sau khi nhấp vào OK trong hộp thoại Select Item To Run, một hộp thoại lỗi sẽ mở ra để thông báo rằng có lỗi. Hộp thoại sẽ cung cấp thông tin về lỗi, đồng thời tài liệu nguồn của tập lệnh sẽ được mở và dòng tập lệnh gây lỗi sẽ được tô sáng. Đóng hộp thoại này bằng cách nhấp vào nút OK và dừng hệ thống tạo tập lệnh bằng cách chọn lệnh Run » Stop từ các menu chính (phím tắt: Ctrl+F3).

Hộp thoại lỗi sẽ chỉ báo lỗi tập lệnh đầu tiên gặp phải. Có thể vẫn còn các lỗi khác và chúng sẽ được phát hiện trong những lần thử chạy tập lệnh tiếp theo.

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

Đối với dự án tập lệnh được lưu trữ trong Workspace, đường dẫn, và do đó cả mục tham số của lệnh, phải trỏ đến đúng vị trí trong Workspace – vị trí này dựa trên tham chiếu GUID của tập lệnh trong Workspace. Vì vậy, phải lấy liên kết tham chiếu này before khi thử tạo mục lệnh tập lệnh mới. Để lấy đúng các tham số cho tập lệnh được cài đặt từ Workspace, hãy mở hộp thoại Select Item To Run (File » Run Script), nhấp chuột phải vào thủ tục mong muốn trong tập lệnh và chọn lệnh Copy script parameters từ menu ngữ cảnh. 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.

Chọn tiến trình/thủ tục cần dùng trong dự án tập lệnh trên Workspace, sau đó sao chép các tham số của tập lệnh.
Chọn tiến trình/thủ tục cần dùng trong dự án tập lệnh trên Workspace, sau đó sao chép các tham số của tập lệnh.

 

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.

Có thể sao chép các tham số cần thiết từ mục script thực tế trong danh mục [Scripts] của hộp thoại Customize PCB Editor nếu script hiện đang được nạp. Để tạm thời nạp script, hãy duyệt đến và mở script bằng lệnh File » Run Script. Sau khi sao chép, hãy đảm bảo mục Categories không còn được đặt thành [Scripts] trước khi tạo lệnh bằng nút New .

► Xem hình minh họa

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.

Lưu ý rằng các lệnh được triển khai riêng cho từng máy chủ, vì vậy lệnh tùy chỉnh được tạo cho Trình chỉnh sửa PCB (như trên) sẽ không khả dụng cho các chức năng khác, chẳng hạn như Trình chỉnh sửa sơ đồ nguyên lý hoặc Hệ thống lập trình script.

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.

Có thể chỉnh sửa, nhân bản và xóa lệnh trực tiếp từ hộp thoại tùy chỉnh (trong trường hợp này là hộp thoại Customizing PCB Editor) bằng các nút ở cuối hộp thoại.

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.
Có thể kéo lệnh tùy chỉnh đến vị trí menu mong muốn.

Cũng có thể thêm lệnh bằng tùy chọn Chèn liên kết trong các tùy chọn khi nhấp chuột phải vào menu.

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.
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ụ.
Xóa lệnh đã được gán vào thanh công cụ.

Khi ở chế độ tùy chỉnh, bạn cũng có thể chỉnh sửa và xóa các lệnh được gán vào menu bằng cách nhấp chuột phải vào chính lệnh đó trên menu.

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.
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
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 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 đó.
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 đó.
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 đó.

AI-LocalizedBản địa hóa bằng AI
Nếu bạn phát hiện vấn đề, hãy chọn văn bản/hình ảnh và nhấnCtrl + Enterđể gửi phản hồi cho chúng tôi.
Nav
Contents
Tính khả dụng của tính năng

Các tính năng bạn có thể sử dụng phụ thuộc vào giải pháp Altium mà bạn đang có – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, hoặc Altium Designer (đang trong thời hạn hiệu lực).

Nếu bạn không thấy một tính năng được nêu trong tài liệu có trong phần mềm thực tế của mình, liên hệ Bộ phận Kinh doanh của Altium để tìm hiểu thêm.

Tài liệu cũ

Tài liệu Altium Designer không còn được phân phiên bản. Nếu bạn cần truy cập tài liệu cho các phiên bản cũ hơn của Altium Designer, hãy truy cập mục Tài liệu cũ trên trang Trình cài đặt khác.

Contents