Tạo & Lưu trữ Script

Sơ lược

Tìm hiểu cách tạo, sắp xếp và lưu trữ tập lệnh trong Altium Designer, từ việc thiết lập Dự án tập lệnh đến quản lý các bản sửa đổi trong Workspace được kết nối. Bài viết này giải thích về Đơn vị tập lệnh và Biểu mẫu tập lệnh, cách các tập lệnh chia sẻ biến và thủ tục trong cùng một dự án, cũng như cách Dự án toàn cục giúp bạn sử dụng tập lệnh qua nhiều phiên làm việc. Hãy đọc tiếp để tự tin hơn trong việc quản lý tập lệnh Altium Designer.

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

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.
Sau khi tạo dự án script mới, hãy thêm một script mới vào dự án.

Sử dụng File » Save Project As để lưu dự án với tên mong muốn. Tương tự, sử dụng File » Save As để lưu và đổi tên script mới.

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

  1. 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.
  2. 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).

    Nếu Mục chưa có bản sửa đổi được lên kế hoạch, dữ liệu sẽ được tải lên bản sửa đổi được lên kế hoạch tiếp theo, được tạo ngay trong quá trình tải lên.

    Chỉ định tệp dự án script cần tải lên Mục Script đích.
    Chỉ định tệp dự án script cần tải lên Mục Script đích.

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

Nhấp chuột phải vào mục cấp cao nhất của chính Script trong Workspace sẽ cho phép chỉnh sửa bản sửa đổi mới nhất của Script đó.

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

Để mở tệp dự án được lưu trong một bản sửa đổi của Script trong Workspace hoặc một trong các tệp nguồn liên quan, hãy chọn tệp đó – trên tab chế độ xem Details của bản sửa đổi trong bảng Explorer – rồi nhấp chuột phải và chọn lệnh Open từ menu ngữ cảnh. Dự án (bao gồm tất cả các tệp nguồn) hoặc các tệp nguồn (dưới dạng tài liệu độc lập) sẽ được mở trong Altium Designer.

Một Workspace Script có thể được sử dụng gián tiếp như một phần của bản sửa đổi của một mục Tùy chọn thiết kế – khi được cài đặt cùng với các tùy chọn đã phát hành đó, thông qua trang Scripting System – Global Projects của hộp thoại Preferences – trong một hoặc nhiều Environment Configurations đã xác định. Cấu hình môi trường được dùng để giới hạn môi trường làm việc của người thiết kế, chỉ cho phép sử dụng các thành phần thiết kế đã được công ty phê duyệt. Các cấu hình môi trường được xác định và lưu trữ trong Team Configuration Center – một dịch vụ được cung cấp thông qua Workspace. Sau khi bạn kết nối với Workspace và chọn (nếu có) một trong các cấu hình môi trường khả dụng, Altium Designer sẽ được cấu hình về việc sử dụng các tùy chọn. Nếu cấu hình môi trường đã chọn có xác định bản sửa đổi của một mục Tùy chọn thiết kế, bản sửa đổi đó sẽ được áp dụng ngay lập tức. Nếu cấu hình môi trường đã chọn áp dụng cho bạn không chỉ định bản sửa đổi của mục Tùy chọn thiết kế, bạn vẫn có thể xác định các tùy chọn theo cách thủ công. Nói cách khác, bạn có thể tự do sử dụng lại bản sửa đổi của một mục Tùy chọn thiết kế theo cách thủ công, hoặc sử dụng tệp tùy chọn được lưu cục bộ. Để biết thêm thông tin, xem Environment Configuration Management (Altium 365 Workspace, Enterprise Server Workspace). Tham khảo trang Truy cập, xác định & quản lý tùy chọn hệ thống để tìm hiểu thêm về cách lưu các tùy chọn thiết kế vào Workspace đã kết nối.

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

Các liên kết tham chiếu đến Workspace được tạo trong phần Tùy chọn bởi một dự án Workspace script đã cài đặt sẽ được giữ lại và do đó cũng sẽ được lưu kèm nếu bộ Tùy chọn hiện tại được lưu vào Workspace. Vì vậy, khi được sử dụng lại, bản sửa đổi của mục Tùy chọn thiết kế được tạo ra sẽ tự động cung cấp script Workspace đã liên kết. Tham khảo trang Truy cập, xác định & quản lý tùy chọn hệ thống để tìm hiểu thêm về cách lưu các tùy chọn thiết kế vào Workspace đã kết nối.
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