Создание и хранение сценариев

Created: января 31, 2023 | Updated: октября 07, 2025

Скрипты Altium Designer обычно создаются и хранятся в проекте скриптов (Script Project) (*.PrjScr), но их можно добавлять или хранить в проекте любого типа.

Чтобы начать писать скрипты, сначала создайте новый проект скриптов и добавьте в него файлы скриптов.

Создание проектов скриптов и скриптов

Проект скриптов помогает управлять вашими скриптами и может быть создан путем выбора File » New » Script » Script Project в главном меню.

Новый проект (Script_Project1.PrjScr) для хранения скриптов будет отображаться на панели Projects.

Чтобы добавить новый скрипт в проект, щелкните правой кнопкой мыши по имени проекта и выберите Add New to Project в контекстном меню.

После создания нового проекта скриптов добавьте в него новый скрипт.

Используйте File » Save Project As, чтобы сохранить проект под нужным именем. Аналогично используйте File » Save As, чтобы сохранить и переименовать новый скрипт.

При создании нового скрипта можно выбрать один из двух типов в зависимости от требований проекта — Script Units и Script Forms.

Типы скриптов

Script Units

Script Unit — это документ скрипта с синтаксисом конкретного языка, например DelphiScript.

Script Unit с кодом скрипта.

Script Forms

Script Form — это окно, которое может содержать различные элементы управления, такие как кнопки, многострочные поля и списки, для которых могут быть назначены обработчики событий. В редакторе Script Form имеет два представления, выбираемых вкладками Code и Form, как показано внизу документа скрипта ниже.

Script Form с открытыми вкладками Code и Form.

Взаимосвязи скриптов внутри проекта

Когда в проекте несколько скриптов, любой скрипт (использующий тот же набор языка) в рамках этого проекта имеет доступ к глобальным переменным и процедурам. По сути, все скрипты в проекте «видимы», поэтому процедура в одном скрипте может вызывать другую процедуру в другом скрипте в рамках того же проекта скриптов.

Важно, чтобы имена процедур и глобальных переменных в скриптах одного проекта были уникальными. Один из подходов — перенести все общие процедуры/функции, используемые в разных скриптах, в один новый скрипт в рамках того же проекта. Это позволяет легко повторно использовать процедуры и функции из этого общего скрипта в разных проектах скриптов.

► См. Writing Scripts для примера вызова процедуры из другого скрипта.

Загрузка проекта скриптов в подключенное рабочее пространство

Altium Designer совместно с вашим подключенным Workspace предоставляет возможность создавать и управлять скриптами Workspace. Такие скрипты создаются непосредственно в Workspace, при этом соответствующий проект скриптов (*.PrjScr) загружается в ревизию целевого Workspace Scripts. Процесс следующий:

Создайте новый Script Item в вашем подключенном Workspace с помощью панели Explorer. См. страницу Creating & Editing Content, чтобы узнать больше о создании Items в Workspace.
Щелкните правой кнопкой мыши по нужному Script Item на панели Explorer и выберите команду Upload в контекстном меню. Появится стандартное диалоговое окно Windows Open, в котором можно перейти к нужному файлу проекта скриптов (*.PrjScr).

Если у Item нет запланированной ревизии, загрузка будет выполнена в следующую запланированную ревизию, которая будет создана «на лету» в рамках процесса загрузки.

Указание файла проекта скриптов для загрузки в целевой Script Item.
Выбрав нужный файл, выполните загрузку, нажав кнопку Open. Файл проекта вместе со всеми файлами в той же папке будет загружен в ревизию и станет доступен на вкладке представления аспектов Details для этой ревизии на панели Explorer.

Загруженный проект вместе со всеми файлами в той же папке перечислен на вкладке представления аспектов Details для ревизии Script Item.

В качестве альтернативы проект скриптов можно загрузить в новый Workspace Script, перетащив выбранный файл проекта скриптов и связанные исходные файлы из исходной папки в Windows Explorer и сбросив их в нужную папку на панели Explorer. Появится диалоговое окно Create New Item, в области Sources которого будут перечислены перетаскиваемые файлы. Поле Name для Item будет содержать имена файлов, включая расширение (записи разделяются точкой с запятой). Поле Description будет в формате Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (записи разделяются точкой с запятой). При необходимости измените эти значения. Поле Item ID будет соответствовать схеме именования Item, заданной на уровне папки. Если для папки схема именования не определена, именование будет следовать схеме $CONTENT_TYPE_CODE-{000000}.

Загрузка проекта скриптов и связанных файлов в начальную ревизию вновь созданного Workspace Script методом перетаскивания.

Редактирование Workspace Script

На любом этапе вы можете вернуться к любой ревизии Workspace Script и отредактировать ее напрямую. Щелкните правой кнопкой мыши по ревизии на панели Explorer и выберите команду Edit в контекстном меню. Это откроет данную ревизию в Altium Designer, где ее можно отредактировать, затем сохранить обратно в Workspace как следующую ревизию с помощью команды Save to server (сочетание клавиш: Ctrl+Alt+S) — доступной из контекстного меню правой кнопки мыши для записи проекта на панели Projects.

Щелчок правой кнопкой мыши по записи верхнего уровня для самого Workspace Script откроет для редактирования последнюю ревизию этого Workspace Script.

Доступ к команде запуска прямого редактирования существующей ревизии скрипта.

Если нужно изменить проект или связанные исходники, хранящиеся в Workspace Script, и у вас есть обновленные исходные файлы, вы можете загрузить эти файлы в данный Workspace Script — новые файлы будут сохранены в следующей ревизии этого Workspace Script.

Чтобы открыть файл проекта, хранящийся в ревизии Workspace Script, или один из связанных исходных файлов, выберите этот файл на вкладке представления аспектов Details для ревизии на панели Explorer, затем щелкните правой кнопкой мыши и выберите команду Open в контекстном меню. Проект (вместе со всеми исходными файлами) или исходный файл(ы) (как отдельный(е) документ(ы)) будет открыт в Altium Designer.

Workspace Script может использоваться косвенно как часть ревизии Design Preferences Item — когда он устанавливается как часть выпущенных настроек через страницу Scripting System – Global Projects page диалогового окна Preferences — в одной или нескольких определенных Environment Configurations. Конфигурация среды используется для ограничения рабочей среды разработчика так, чтобы применялись только утвержденные компанией элементы проектирования. Конфигурации среды определяются и хранятся в Team Configuration Center — сервисе, предоставляемом через Workspace. После подключения к Workspace и выбора (если применимо) из доступных вам конфигураций среды Altium Designer будет настроен в части использования настроек. Если выбранная конфигурация среды содержит определенную ревизию Design Preferences Item, она применяется сразу. Если применимая к вам конфигурация среды не содержит указанной ревизии Design Preferences Item, настройки останутся доступными для ручного определения. Иными словами, вы можете вручную повторно использовать ревизию Design Preferences Item или использовать локально сохраненный файл настроек. Дополнительные сведения см. Environment Configuration Management (Altium 365 Workspace, Enterprise Server Workspace). См. страницу Accessing, Defining & Managing System Preferences, чтобы узнать больше о сохранении настроек проектирования в подключенный Workspace.

Global Projects

Проекты скриптов можно устанавливать с помощью функции Global Projects, чтобы они предварительно загружались и были доступны при запуске программы. Глобальные переменные и процедуры из этих скриптов доступны для использования в других открытых проектах скриптов.

Чтобы сделать проект скриптов глобальным, перейдите на страницу Scripting System - Global Projects через диалоговое окно Preferences. Используйте кнопку Install , чтобы перейти к проекту и выбрать его из файловой системы или из Workspace. Повторите этот процесс для всех проектов скриптов, которые вы хотите сделать доступными глобально.

Установленный проект Workspace Script будет доступен в Altium Designer всякий раз, когда пользователь подключен к Workspace. Обратите внимание: установленный проект Workspace Script отображается по своему расположению или «пути» в структуре папок Workspace и по ID Workspace Script, содержащего данные проекта скриптов.

Используйте Scripting System – Global Projects в диалоговом окне Preferences, чтобы установить скрипты.

Global Projects позволяют скриптам из локального проекта того же типа использовать подпрограммы из установленных глобальных проектов скриптов. При запуске диалогового окна Select item to Run (File » Run Script) установленные проекты скриптов будут отображаться вместе с другими проектами скриптов, которые в данный момент открыты на панели Projects .

Ссылки на Workspace, созданные в Preferences установленным проектом Workspace script, сохраняются и, следовательно, будут включены, если текущий набор Preferences также сохраняется в Workspace. Ревизия получившегося Design Preferences Item при повторном использовании, таким образом, автоматически предоставит связанный скрипт Workspace. См. страницу Accessing, Defining & Managing System Preferences, чтобы узнать больше о сохранении настроек проектирования в подключенный Workspace.

Версия для печати

Локализовано с помощью ИИ

Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.

Доступность функциональных возможностей

Набор доступных функциональных возможностей зависит от вашего решения Altium – Altium Develop, редакция Altium Agile (Agile Teams или Agile Enterprise) или Altium Designer (на активной подписке).

Если вы не видите в своем ПО функцию, описанную здесь, свяжитесь с отделом продаж Altium, чтобы узнать больше.

Устаревшая документация

Документация Altium Designer больше не разделена по версиям ПО. Если вам необходим доступ к документации по старым версиям Altium Designer, посетите раздел Устаревшая документация на странице Прочие установщики.