Главная страница: Выпуск проекта платы
Перед тем, как отправить проект на производство, его необходимо выпустить, а значение процесса выпуска зачастую недооценивается.
Altium NEXUS предлагает мощные интегрированные инструменты управления выпуском проектов, доступные через средство выпуска проектов Project Releaser. Благодаря интуитивно понятному интерфейсу, вы можете сформировать все данные для производства одновременно – данные для изготовления, данные для сборки, исходные данные и т.д. Средство выпуска проектов также позволяет формировать данные для сборки одновременно множества вариантов проекта. Вам даже не нужно беспокоиться о создании файлов Output Job – средство выпуска сделает это при необходимости.
Средство Project Releaser позволяет управлять выпуском всех типов проектов платы: неуправляемые/не в системе контроля версий, под управлением внешней системы VCS или управляемые сервером данных – и предлагает два режима работы:
- Управляемый (онлайн) режим – выпуск всех сформированных данных в ревизии объектов на активный сервер управляемых данных. Нет необходимости запоминать ревизии объектов – средство выпуска контролирует их самостоятельно.
- Неуправляемый (офлайн) режим – выпуск всех сформированных данных в структуру папок, которую опционально можно упаковать в единый zip-архив.
С помощью средства Project Releaser вы можете легко сформировать целостный набор данных для производства. Вы также сможете изучить результаты этого формирования перед подтверждением выпуска (например, просмотрев данные Gerber/ODB++ в редакторе CAM), чтобы убедиться, что сформированные данные – это именно те данные, которые необходимы для производства платы.
В этом документе рассматривается процесс выпуска на сервер управляемых данных. Если вы не используете сервер управляемых данных или не вошли на сервер, вы будете использовать средство выпуска
Project Releaser в неуправляемом (офлайн) режиме, который рассматривается
здесь.
Доступ к Project Releaser
Графическим интерфейсом средства Project Releaser является страница Release, доступ к которой осуществляется одним из следующих способов:
- Выбор команды Project » Project Releaser из главного меню (исходный документ требуемого проекта должен быть открыт и активирован).
- Щелчок ПКМ по пункту требуемого проекта в панели Projects и выбор команды Project Releaser из контекстного меню.
Если для Project Releaser у вас активирован процесс публикации в инстанцию PLM, то он будет представлен в подменю Project Releaser проекта. При запуске этого процесса будет добавлен дополнительный этап публикации. Для получения более подробной информации перейдите в раздел Публикация в инстанцию PLM.
Страница Release – интерфейс средства выпуска Project Releaser. Наведите курсор мыши на изображение, чтобы увидеть, как выглядит интерфейс, если вы запустили процесс выпуска и последующей публикации в инстанцию PLM.
Режим выпуска/Цель
Средство выпуска Project Releaser пытается автоматически определить, какой режим выпуска использовать – управляемый (онлайн) или неуправляемый (офлайн) – и место выпуска данных. Если существует выбор, например, когда проект был выпущен на один сервер управляемых данных, а вы в данный момент подключены к другому, система предложит доступные опции.
При выпуске на сервер управляемых данных, в файле проекта в качестве атрибута сохраняется целевой сервер. Таким образом, целевой сервер, сохраненный с проектом, может отличаться от сервера, к которому вы в данный момент подключены.
Если проект не является управляемым и не находится под контролем VCS, будет автоматически выбран офлайн-режим выпуска.
Обнаружение файлов Output Job
Если ваш проект не содержит связанных с ним файлов Output Job, средство выпуска Project Releaser обнаружит это и предложит создать файлы по умолчанию. Если вы согласитесь, будут созданы следующие файлы:
Fabrication.OutJob
– с заданными выходными данными:
- Documentation Outputs (Выходные документы):
PCB Prints
- Fabrication Outputs (Выходные данные для изготовления печатной платы):
Gerber Files
, NC Drill Files
и IPC-2581
- Validation Outputs (Выходные данные валидации):
Design Rules Check
, Footprint Comparison Report
- Export Outputs (Выходные данные экспорта):
Save As/Export PCB
Assembly.OutJob
– с заданными выходными данными:
- Documentation Outputs (Выходные документы):
PCB 3D Print
, Schematic Prints
- Assembly Outputs (Выходные данные для изготовления печатного узла):
Generates pick and place files
, Assembly Drawings
- Report Outputs (Выходные отчеты):
Bill of Materials
- Export Outputs (Выходные данные экспорта):
Export STEP
Эти файлы Output Job находятся в папке установки по умолчанию: \Users\Public\Documents\Altium\NEXUS<Версия>\OutputJobs
.
Вы можете использовать эти файлы по умолчанию как они есть, настроить их под собственные требования либо создать дополнительные файлы Output Job – создайте их в папке по умолчанию или в собственной папке. Если вы используете собственную папку, укажите ее расположение в поле
OutputJob Path на странице
System - Default Locations диалогового окна
Preferences. Все файлы Output Job, заданные в этой папке, будут добавлены в проект.
Если в вашем проекте есть хотя бы один файл OutJob, автоматическое создание этого файла предлагаться не будет.
Обнаружение вариантов
Очень мощным аспектом средства Project Releaser является обнаружение заданных в проекте вариантов и формирование для каждого из них набора данных для сборки. У каждого такого набора будет имя целевого объекта по умолчанию в формате:
PCBA-[НазваниеПроекта]-[НазваниеВарианта]
Обратите внимание, что для каждого заданного варианта также добавляется трехзначный числовой идентификатор, автоматически назначенный системой (001
, 002
и т.д.). Он может быть удален при настройке схем именования серверных объектов (описано в следующем разделе).
Набор данных для базового проекта будет PCBA-[НазваниеПроекта]-[NO VARIATIONS]
.
Суффикс [НазваниеВарианта]
обеспечивает использование правильного варианта для формирования набора данных по назначенному файлу OutJob.
Дополнительные наборы данных для сборки, сформированные на основе найденных вариантов исполнения проекта.
Настройка схем именования объектов сервера
При первом выпуске проекта на активный сервер управляемых данных вы можете задать именование целевых объектов данных на этом сервере. Это осуществляется на вкладке Item Naming диалогового окна Project Release Options, которое открывается нажатием кнопки
в левом нижнем углу страницы (или нажатием по ссылке Target Revision для выпускаемого набора данных и выбором Edit из контекстного меню). На этой вкладке вы можете:
- Определить имя проекта. По умолчанию будет использоваться текущее имя проекта.
- Определить схему именования по умолчанию для различных объектов данных, которые могут быть сформированы в процессе выпуска.
Объект проекта не является объектом, созданным для получения выпущенных данных – он является своего рода опорной точкой для представления общего вида выпущенных данных с точки зрения проекта, а также связи этих объектов при просмотре управляемого проекта в панели
Explorer. Для получения более подробной информации см.
Просмотр выпущенного управляемого проекта.
Чтобы изменить любую из схем именования, нажмите по кнопке Settings – будет открыто диалоговое окно Naming Template Settings.
Задайте целевую папку и именование формируемых объектов на сервере управляемых данных. Здесь поля не доступны для редактирования, поскольку проект был выпущен ранее.
Поддерживаются следующие форматы шаблонов именования:
- На основе параметров – использование параметров, заключенных в квадратные скобки (например
[ProjectName]
, [VariantName]
, [ProjectParameter]
).
- На основе чисел – использование чисел, заключенных в фигурные скобки (например
{0000}
, {9000}
).
На вкладке Item Naming диалогового окна Project Release вы можете нажать прямо в поле схемы именования и изменить его необходимым образом. Это, например, единственный способ удалить трехзначный числовой идентификатор, который система автоматически добавляет в именование наборов данных вариантов. Либо вы можете нажать кнопку в правой части поля, чтобы открыть диалоговое окно Choose Item (инкарнация панели Explorer), где вы можете указать существующий объект на активном сервере управляемых данных.
Именование объектов может быть в любой момент изменено на первом этапе страницы Release при настройке выпускаемых на сервер данных. После того, как данные для определенного набора сформированы и выгружены на сервер, соответствующие имена нельзя изменить.
Процесс выпуска
После того, как именование объектов сервера было задано необходимым образом, вы можете начать выпуск. Это поэтапный процесс, пункты которого обозначены в левой части страницы Release, что позволяет быстро определить, на каком этапе вы в данный момент находитесь.
Онлайн-этап 1 – Configure Server Release (Настройка выпуска на сервер)
На этом этапе процесса выпуска вы задаете тип(ы) данных, которые хотите сформировать. Объекты данных, которые могут быть выпущены:
- Source Data (Исходные данные) – слепок исходного проекта.
- Fabrication Data (Данные изготовления печатной платы) – данные, необходимые производству для изготовления платы (без компонентов).
- Assembly Data for the Base Design (no variations) (Данные базового проекта для изготовления печатного узла (без вариаций)) – данные, необходимые производству для монтажа компонентов на плату в соответствии с составом базового проекта, без вариаций.
- Assembly Data for Design
Variant n
(Данные варианта n проекта для изготовления печатного узла) – данные, необходимые производству для монтажа компонентов на плату в соответствии со составом проекта в определенном варианте.
Число наборов данных для изготовления печатного узла соответствует базовому проекту (без вариаций) и всем обнаруженным вариантам этого проекта.
Кроме того, вы можете добавить и настроить разделы Custom Data для формирования пользовательских наборов выпускаемых данных. Это может быть необходимо для обратной совместимости или для собственных рабочих процессов. Ссылки не будут созданы, кроме ссылок на исходные данные. Для выпуска может быть сформировано и настроено любое количество пользовательских наборов данных (нажмите Add Section под списком заданных объектов данных).
Этап 1 процесса выпуска проекта – настройка данных, которые будут включены в выпуск (какие данные будут сформированы).
Объект Source Data
(Исходные данные) всегда включен в выпуск. Остальные данные могут быть добавлены опционально.
Назначение файлов Output Job
Для данных изготовления печатной платы (Fabrication Data
) и изготовления печатного узла (Assembly Data
), включенных в выпуск, необходим по крайней мере один назначенный им файл OutputJob. Если у вас есть файлы Output Job files, имена которых начинаются с подстрок 'fab
' и 'ass
', то эти файлы будут автоматически назначены разделам Fabrication Data
и Assembly Data
соответственно при первом открытии страницы Release. В противном случае вам необходимо назначить необходимые файлы OutJob вручную. Это можно сделать на вкладке Release Options диалогового окна Project Release Options (нажмите кнопку
в нижней левой части страницы, чтобы открыть его).
Назначьте файлы OutJob соответствующим наборам данных.
Выбор режима выпуска
На вкладке Release Options диалогового окна Project Release Options вы также можете изменить назначение выпуска, переключаясь между управляемым (онлайн) и неуправляемым (офлайн) режимами. Доступны три варианта:
Unmanaged - Folder
(Неуправляемый режим – Папка): сформированные данные будут выпущены в локальную папку. Путь к корневой папке указан на вкладке Output Path диалогового окна. По умолчанию он задан [OutputPath]
(используется путь, заданный в поле Output Path на вкладке Options диалогового окна Project Options).
Unmanaged - Zip
(Неуправляемый режим – Zip-архив): сформированные данные будут выпущены в локальную папку. Данные будут упакованы в единый zip-архив. Путь и название архива задается на вкладке Output Path диалогового окна. По умолчанию он задан [OutputPath][ProjectName].zip
(используется путь, заданный в поле Output Path вкладки Options диалогового окна Project Options).
Managed - <ИмяСервера>
(Управляемый режим – Сервер): сформированные данные будут выпущены на сервер управляемых данных, к которому вы в данный момент подключены.
Выберите цель выпуска – место, куда будут отправлены сформированные данные.
Управление целевой ревизией
Нажмите по ссылке возле записи Target Revision на главной странице, чтобы открыть меню команд, показанных на рисунке и описанных ниже.
Открытие элементов управления для указания целевой ревизии набора данных, которые будут сформированы в процессе выпуска – наведите курсор мыши на изображение, чтобы увидеть.
Доступные команды зависят от того, был ли объект выпущен изначально или нет. Ниже представлен список всех возможных команд:
- Auto <RevisionID> – эта команда позволяет системе управлять ревизиями, поэтому вам не нужно создавать запланированные ревизии, которых на данный момент не существует.
RevisionID
показывает следующую ревизию для объекта на том же уровне в рамках назначенной системы именования ревизий (например, если текущей ревизией является A.1
, то команда покажет целевую ревизию A.2
).
- Next <RevisionID> – эта запись доступна, только после изначального выпуска объекта. Она позволяет увеличить целевую ревизию на следующий уровень в рамках назначенной схемы именования ревизий.
RevisionID
показывает следующую ревизию (например, если текущей ревизией является A.1
, то команда назначит целевую ревизию B.1
).
- Custom – эта запись позволяет назначить специальную ревизию целевому объекту заданием пользовательского идентификатора ревизии в диалоговом окне Custom Revision ID.
- Browse – эта запись позволяет указать существующий целевой объект и ревизию, в который следует произвести выпуск. Для этого будет открыто диалоговое окно Choose Target Item (инкарнация панели Explorer).
- Edit – эта запись открывает вкладку Item Naming диалогового окна Project Release Options, из которого вы можете изменить имя целевого объекта (и его начальную ревизию), который будет создан.
- Navigate – эта запись позволяет быстро перейти к объекту в панели Explorer (где он уже выпущен и существует следующая ревизия в запланированном состоянии).
Пункт наверху меню показывает текущую выбранную/заданную целевую ревизию.
Подробная информация о формировании данных
Нажмите Details справа от заголовка набора данных, чтобы открыть подробную информацию о том, что именно будет сформировано для этого набора. Чтобы свернуть эту часть для набора, нажмите Hide Details. Набор формируемых данных определяется одним или несколькими файлами Output Job (за исключением набора Source Data
). Вы можете быстро открыть исходный файл OutJob, нажав Configure.
Откройте подробную информации о наборе формируемых данных. Наведите курсор на изображение, чтобы увидеть.
Дополнительные настройки
Существует ряд дополнительных настроек, относящихся к процессу выпуска, которые задаются на странице Data Management - Servers диалогового окна Preferences:
- Папку, используемую для временного хранения сформированных файлов перед их выгрузкой на активный сервер управляемых данных, можно использовать по умолчанию (
\Users\<ИмяПользователя>\AppData\Local\Temp\Releases
) или задать вручную.
- Включите параметр Delete contents after exiting release mode, чтобы очищать папку временного хранения по окончании процесса выпуска.
- Название каждого формируемого выходного документа можно предварительно задать с использованием идентификаторов объекта и ревизии (например,
[FAB-Kame_FMU-A.1] Validation.PDF
). Для этого включите параметр Prepend revision HRID to file names.
Дополнительные настройки, относящиеся к процессу выпуска проектов.
После того, как объекты данных, которые будут сформированы в процессе выпуска, настроены необходимым образом, нажмите кнопку
в правой нижней части страницы, чтобы начать процесс.
У кнопки
![](/documentation/sites/default/files/wiki_attachments/301291/PrepareButton.png)
есть два состояния. Нажмите на нее, чтобы выполнить стандартную команду
Prepare – вы перейдете на этап
Review Data, где вы сможете снова проверить, что все в порядке, до подтверждения выпуска данных. Если вы не хотите останавливаться на проверку, используйте выпадающее меню кнопки и выберите команду
Prepare & Release.
Перед выпуском производится несколько проверок в рамках подготовки, в том числе:
- Проверка того, что проект и все файлы были сохранены.
- Проверка того, что проект и все файлы зафиксированы в VCS, если применимо.
- Проверка того, что каждому объекту задано имя.
- Проверка того, что у пользователя есть права на создание целевого объекта (и ревизии).
- Создание требуемых целевых объектов (и запланированных ревизий) на сервере управляемых данных, где они в данных момент не существуют, а также проверка того, что для объектов используется следующая ревизия, если они существуют.
При обнаружении какой-либо проблемы будет предложено ее решение (например, сохранение локально измененных файлов и их фиксация в VCS).
В этот момент создается объект Source Data
, со слепком исходных файлов проекта, выпускаемых в ревизию целевого объекта.
Онлайн-этап 2 – Validate Project (Валидация проекта)
После завершения этапа 1 без ошибок вы автоматически перейдете на следующий этап, если в назначенных файлах OutJob будет обнаружен один или несколько отчетов для валидации. Будут запущены все заданные генераторы выходных файлов валидации, которые определены в файле Output Job, назначенном объекту выпускаемых данных. Они могут включать в себя:
- Differences Report (Отчет о различиях) – использование компаратора для определения того, что документы схемы и платы корректно синхронизированы.
- Electrical Rules Check (Проверка электрических правил) – проверка корректности схемы с точки зрения размещения электрических и графических объектов.
- Design Rules Check (Проверка правил проектирования) – проверка корректности документа платы с точки зрения ограничений, заданных на уровне платы.
- BOM Checks (Проверка состава изделия) – проверка на возможные нарушения, связанные с проектными объектами и вариантами выбора компонентов в исходном документе BOM (
*.BomDoc
), если это применимо.
- Footprint Comparison Report (Отчет о сравнении посадочных мест) – сравнение посадочных мест на плате и в исходных библиотеках для проверки их актуальности и соответствия.
- Component State Checking (Проверка состояния компонентов) – проверка того, что компоненты находятся в разрешенных состояниях. В ходе настройки вы можете задать предпринимаемое действие для каждого заданного в данный момент состояния каждой определенной на сервере стадии жизненного цикла: не предпринимать действие, выдать предупреждение или выдать ошибку. Последний вариант не допустит дальнейший процесс выпуска. Кроме того, при проверке будет создан HTML-отчет, позволяющий быстро увидеть, какие компоненты имеют недопустимое состояние.
- Environment Configuration Compliance Check (Проверка соответствия настройки среды) – проверка того, что используются только объекты, разрешенные настройкой среды, доступной для использования назначенной вам ролью (если применимо). Также проверяется, что источником всех объектов является сервер управляемых данных.
Если проверка проходит успешно, будут показаны иконка
и текст Passed
. В противном случае, будут показаны иконка
и текст Failed
.
Выпуск не будет завершен, если какая-либо из проверок не будет пройдена.
Нажмите
![](/documentation/sites/default/files/wiki_attachments/301291/CancelButton.png)
в правой нижней части страницы, чтобы остановить процесс выпуска.
Онлайн-этап 3 – Generate Data (Формирование данных)
После завершения этапа 2 без ошибок будет автоматически запущен этот следующий этап. Здесь будет запущено формирование всех прочих выходных документов, определенных в назначенных объектам файлах OutJob, для выпуска соответствующих объектов на сервер.
Для обозначения процесса формирования используются следующие иконки:
– не запущено/не сфомировано.
– запущено/формируется.
– сформировано успешно.
– формирование не удалось.
Нажмите
![](/documentation/sites/default/files/wiki_attachments/301291/CancelButton.png)
в правой нижней части страницы, чтобы остановить процесс выпуска.
Онлайн-этап 4 – Review Data (Просмотр данных)
После того, как все проверки пройдены и выходные данные сформированы, вы можете просмотреть на этом этапе сформированные документы.
Если вы использовали команду
Prepare & Release (из меню кнопки
![](/documentation/sites/default/files/wiki_attachments/301291/PrepareButton.png)
), средство
Project Releaser не будет останавливаться на этапе
Review Data.
Просмотр сформированных данных перед подтверждением их выпуска и фиксацией на сервере управляемых данных, чтобы убедиться, что всё в порядке.
По умолчанию на странице показан простой (компактный) вид сформированных данных. Чтобы просмотреть более подробную информацию, нажмите Details у необходимого раздела.
Нажмите Details, чтобы переключить простой вид отображения сформированных данных на подробный. Чтобы переключиться обратно, нажмите Hide Details.
Состояния выходной документации в подробном виде
В таблице ниже приведены возможные состояния выходных документов в режиме просмотра подробных данных:
Состояние
|
Описание
|
![](/documentation/sites/default/files/wiki_attachments/301291/State_Missing.png)
|
Выходной документ еще не был сформирован/не существует.
|
![](/documentation/sites/default/files/wiki_attachments/301291/State_OutofDate.png)
|
Выходной документ сфомирован, но был изменен в проекте, что делает его состояние проверки неактуальным.
|
![](/documentation/sites/default/files/wiki_attachments/301291/State_Running.png)
|
Выходной документ находится в процессе формирования.
|
![](/documentation/sites/default/files/wiki_attachments/301291/State_Passed.png)
|
Документ является выходным документом валидации, и в процессе его формирования не возникло ошибок. Для отчета проверки электрических правил, ошибок не возникло, либо уровень ошибок попадает в указанный предельно допустимый уровень для этого отчета.
|
![](/documentation/sites/default/files/wiki_attachments/301291/State_UpToDate.png)
|
Выходной документ (за исключением выходных документов валидации) сфомирован успешно.
|
![](/documentation/sites/default/files/wiki_attachments/301291/State_Failed.png)
|
Выходной документ не был сфомирован успешно. Для выходных документов валидации это означает, что существуют ошибки в исходных проектных документах. Для обычного выходного документа это значит, что он не может быть сфомирован. Возможно, существуют критические ошибки валидации, либо что-то не так с настройкой генератора в файле Output Job.
|
В компактном виде отображения раздела Source Data
нажмите ссылку View, чтобы открыть связанный файл или набор файлов в соответствующем редакторе Altium NEXUS (например, редакторе CAM) или внешнем приложении (например, Microsoft Excel). В подробном виде дважды щелкните ЛКМ по пункту, чтобы открыть только этот файл.
В компактном режиме отображения раздела Source Data
нажмите ссылку View, чтобы открыть в Проводнике Windows временную папку хранения слепка исходных файлов проекта. То же самое происходит при нажатии по ссылке Explore справа от заголовка раздела. У каждого раздела есть такая ссылка для быстрого перехода в подпапку данных во временной директории.
В подробном режиме отображения, команды контекстного меню позволяют открыть документ и открыть временную папку, в которой он был сфомирован. Вы также можете добавить столбцы данных о расположении папки и дате создания – щелкните ПКМ по строке заголовка таблицы и выберите команду Select Columns – будет открыто диалоговое окно, в котором вы можете настроить отображение данных.
Если в ходе просмотра вы обнаружили, что необходимо внести изменения в данные, нажмите кнопку
в правой нижней части страницы. Появится диалоговое окно для подтверждения, предупреждающее о том, что все сформированные данные будут потеряны – нажмите OK, чтобы отменить выпуск и вернуться на этап 1.
Система не позволяет вносить изменения в проектные файлы между подготовкой выпуска и выпуском данных на сервер управляемых данных. Если вы всё же внесете изменения, процесс выпуска будет прерван, и вы вернетесь на начальный этап, предшествующий подготовке выпуска.
Если с сформированными данными всё в порядке, нажмите кнопку
(в правой нижней части страницы). Появится диалоговое окно Confirm Release со сводкой конфигурации проекта, который будет выпущен на сервер управляемых данных. Здесь у вас есть возможность добавить имя Name (по умолчанию [ProjectName]
), описание Description, а также подходящую информацию о выпуске.
Подтверждение выпуска, касательно созданных объектов и ревизий, с возможностью изменить имя/описание и добавить информацию о выпуске.
Онлайн-этап 5 – Upload Data (Выгрузка данных)
После подтверждения выпуска на предыдущем шаге, следующий этап будет запущен автоматически. Здесь представлен прогресс выгрузки данных в ревизии соответствующих объектов на сервере управляемых данных.
На этом этапе показан прогресс выгрузки сформированных данных в связанные объект-ревизии на сервер управляемых данных.
Онлайн-этап 6 – Execution Report (Отчет о выполнении)
На этом финальном этапе предоставляется отчет о результатах выпуска.
Финальный отчет о выпуске
Используйте ссылки в разделе Navigation Links для быстрого доступа к связанным ревизиям объектов, содержащим выпущенные данные (данные для изготовления печатной платы, данные для изготовления печатного узла, пользовательские наборы данных), в панели Explorer, который является порталом в сервер управляемых данных.
Просмотр выпущенных данных проекта на сервере управляемых данных в панели Explorer.
Просмотр выпущенного управляемого проекта
Если ваш проект является управляемым проектом, то по окончании процесса выпуска вам доступна еще одна функциональная возможность. Нажмите по ссылке Project Page (последняя в разделе Navigation Links страницы Execution Report), чтобы открыть панель Explorer, где будет представлен проект в виде Project View, доступном только для управляемых проектов.
Если ранее вы просматривали проект в виде
Classic View, необходимо вручную переключиться на вид
Project View с помощью команды доступной из меню кнопки
![](/documentation/sites/default/files/wiki_attachments/301291/ExplorerPanelOptionsButton.png)
в правой верхней части панели
Explorer.
Вы можете получить подробную информацию об управляемом проекте в режиме Project View панели Explorer.
Вкладка Releases вида отображает каждый выпуск проекта, где самый новый выпуск отображен в верхней части списка. Каждая запись в левой части показывает отметку о дате/времени выпуска, а также пакеты, включенные в выпуск. Используйте поле Search для быстрого поиска определенного выпуска (очень полезно, если проект был выпущен множество раз). Если щелкнуть ЛКМ по записи выпуска слева, вкладки справа будут заполнены следующей информацией об этом выпуске:
- Details (Подробности) – графическое представление того, как сформированные данные связаны друг с другом, в рамках родительского проекта. Также представлены дата и время выпуска, кем был произведен выпуск и ревизия VCS.
- Parameters (Параметры) – список параметров, заданных на уровне проекта, либо в Altium NEXUS (на вкладке Parameters диалогового окна Project Options), либо через сервер, а также сформированные системой параметры, специфичные для данного выпуска.
- Part List (Список компонентов) – простой список всех управляемых компонентов в выпущенном проекте, со следующей информацией:
- Название
- Item ID
- Описание
- Позиционное обозначение
- Количество
- Статус ревизии
Обратите внимание, что список показывает все компоненты, используемые в выпущенном проекте, независимо от сформированных пакетов вариантов сборки. Иными словами, список не отфильтрован по вариантам.
После того, как проект выпущен, закройте страницу Release с помощью кнопки
внизу справа. Когда понадобится выполнить повторный выпуск проекта в будущем, Project Releaser позволит сделать это легко и быстро, и он автоматически увеличит целевую ревизию объекта.
Неуправляемый (офлайн) режим выпуска
Наряду с управляемым (онлайн) режимом выпуска, Project Releaser также позволяет осуществлять локальный, неуправляемый (офлайн) выпуск. Обычно этот режим используется, если у вас нет сервера управляемых данных либо если вы в данный момент не можете подключиться к серверу. Хотя Project Releaser определяет режим автоматически, где это возможно, либо предлагает выбор, когда нет однозначности, вы всегда можете задать использование офлайн-режима настройкой Release Target на вкладке Release Options диалогового окна Project Release Options (нажмите кнопку
на этапе 1 процесса выпуска), выбрав один из следующих вариантов:
Unmanaged - Folder
(Неуправляемый режим – Папка): сформированные данные будут выпущены в локальную папку. Путь к корневой папке указан на вкладке Output Path диалогового окна. По умолчанию он задан [OutputPath]
(используется путь, заданный в поле Output Path на вкладке Options диалогового окна Project Options).
Unmanaged - Zip
(Неуправляемый режим – Zip-архив): сформированные данные будут выпущены в локальную папку. Данные будут упакованы в единый zip-архив. Путь и название архива задается на вкладке Output Path диалогового окна. По умолчанию он задан [OutputPath][ProjectName].zip
(используется путь, заданный в поле Output Path вкладки Options диалогового окна Project Options).
Вы можете использовать записи [ProjectName]
, [<VariantParameterName>]
, [<ProjectParameterName>]
при определении выходного пути.
Вы можете быстро определить, что Project Releaser настроен на офлайн-режим, следующим образом:
- В заголовке этапа 1 написано
Configure Local Release
вместо Configure Server Release
(как при онлайн-режиме).
- В заголовке этапа 5 написано
Pack Data
вместо Upload Data
(как при онлайн-режиме).
Средство выпуска Project Releaser в локальном, неуправляемом (офлайн) режиме.
Процесс выпуска схож с описанным выше для управляемого (онлайн) режима, только данные выпускаются в локальную папку. Чтобы не повторять информацию, указанную выше, здесь обозначим только задействованные этапы с указанием различий.
Офлайн-этап 1 – Configure Local Release (Настройка локального выпуска)
Здесь вы настраиваете, какие данные необходимо сформировать из проекта. Исходные данные всегда включаются в выпуск, с возможностью добавить данные для изготовления печатной платы, изготовления печатного узла (для базового проекта и/или вариантов) и любые другие пользовательские данные, которые необходимы.
Для каждого формируемого набора данных необходимо указать папку, в которую они будут сохранены. Названия папок, используемые по умолчанию:
- Source Data (Исходные данные) – будут сформированы в папке
Sources
.
- Fabrication Data (Данные изготовления печатной платы) – будут сформированы в папке
Fabrication
.
- Assembly Data for no variant (Данные для изготовления печатного узла без вариаций) – будут сформированы в папке
Assembly
.
- Assembly Data for <VariantName> (Данные варианта n проекта для изготовления печатного узла) – будут сформированы в папке
Assembly <VariantName>
.
- Custom Data <Custom - n> (Пользовательские данные) – будут сформированы в папке
<Custom - n>
.
Вы можете изменить это именование по умолчанию необходимым образом. Для этого щелкните ЛКМ по записи Target Folder, введите новое имя папки и нажмите Enter.
При выпуске в локальную папку или zip-архив имейте в виду, что повторный выпуск в папки с теми же именами перезапишет существующие в этих папках данные.
После настройки данных, которые будут сформированы в процессе выпуска, нажмите кнопку
в правой нижней части страницы.
У кнопки
![](/documentation/sites/default/files/wiki_attachments/301291/PrepareButton.png)
есть два состояния, которые отличаются для двух возможных вариантов неуправляемого выпуска:
Unmanaged - Folder
(Неуправляемый режим – Папка): нажмите эту кнопку, чтобы запустить стандартную команду Prepare. Процесс перейдет на этап Review Data, что позволит повторно проверить, что всё в порядке, перед выпуском в целевые папки. Если вы не хотите останавливаться на проверку, откройте выпадающее меню кнопки и выберите команду Prepare & Explore.
Unmanaged - Zip
(Неуправляемый режим – Zip-архив): нажмите эту кнопку, чтобы запустить стандартную команду Prepare. Процесс перейдет на этап Review Data, что позволит повторно проверить, что всё в порядке, перед упаковкой данных в zip-архив. Если вы не хотите останавливаться на проверку, откройте выпадающее меню кнопки и выберите команду Prepare & Pack.
Будет произведено несколько предварительных проверок, в том числе:
- Проверка того, что проект и все файлы были сохранены.
- Проверка того, что проект и все файлы зафиксированы в VCS, если применимо.
- Проверка того, что каждому объекту данных задана целевая папка.
При обнаружении какой-либо проблемы будет предложено ее решение (например, сохранение локально измененных файлов и их фиксация в VCS).
На этом этапе формируются данные Source Data
со слепком исходных файлов проекта, выпускаемых в целевую папку.
Офлайн-этап 2 – Validate Project (Валидация проекта)
После завершения этапа 1 без ошибок вы автоматически перейдете на следующий этап, если в назначенных файлах OutJob будет обнаружен один или несколько отчетов для валидации. Будут запущены все заданные генераторы выходных файлов валидации, которые определены в файле Output Job, назначенном объекту выпускаемых данных. Этот этап проходит аналогично этапу в управляемом (онлайн) режиме.
Выпуск не будет завершен, если какая-либо из проверок не будет пройдена.
Нажмите
![](/documentation/sites/default/files/wiki_attachments/301291/CancelButton.png)
в правой нижней части страницы, чтобы остановить процесс выпуска.
Офлайн-этап 3 – Generate Data (Формирование данных)
После завершения этапа 2 без ошибок будет автоматически запущен этот следующий этап. Здесь будет запущено формирование всех прочих выходных документов, определенных в назначенных объектам файлах OutJob, для выпуска объектов в соответствующие целевые папки. Этот этап проходит аналогично этапу в управляемом (онлайн) режиме.
Нажмите
![](/documentation/sites/default/files/wiki_attachments/301291/CancelButton.png)
в правой нижней части страницы, чтобы остановить процесс выпуска.
Офлайн-этап 4 – Review Data (Просмотр данных)
После того, как все проверки пройдены и выходные данные сформированы, вы можете просмотреть на этом этапе сформированные документы. Этот этап проходит во многом аналогично этапу в управляемом (онлайн) режиме.
Если вы использовали команду Prepare & Explore (для варианта Unmanaged - Folder
) или Prepare & Pack (для варианта Unmanaged - Zip
), то этот этап будет недоступен – данные сразу будут выпущены, т.е. соответственно выпущены целевые в папки или упакованы в целевой архив.
Просмотр сформированных данных перед подтверждением их выпуска и передачей в целевые папки или упаковкой в zip-архив, в соответствии с выбранным вариантом неуправляемого режима.
В компактном виде отображения сформированных данных нажмите ссылку View, чтобы открыть связанный файл или набор файлов в соответствующем редакторе Altium NEXUS (например, редакторе CAM) или внешнем приложении (например, Microsoft Excel). В подробном виде дважды щелкните по пункту, чтобы открыть только этот файл.
Если в ходе просмотра вы обнаружили, что необходимо внести изменения в данные, нажмите кнопку
в правой нижней части страницы. Появится диалоговое окно для подтверждения, предупреждающее о том, что все сформированные данные будут потеряны – нажмите OK, чтобы отменить выпуск и вернуться на этап 1.
Система не позволяет вносить изменения в проектные файлы между подготовкой выпуска и выпуском данных в целевые папки. Если вы всё же внесете изменения, процесс выпуска будет прерван, и вы вернетесь на начальный этап, предшествующий подготовке выпуска.
Если с сформированными данными всё в порядке, нажмите кнопку
(в правой нижней части страницы). Что произойдет дальше, зависит от выюранного варианта выпуска:
Unmanaged - Folder
: сформированные файлы будут выпущены в целевые папки, и процесс перейдет на завершающий этап – Execution Report.
Unmanaged - Zip
: процесс перейдет на следующий этап – Pack Data.
Офлайн-этап 5 – Pack Data (Упаковка данных)
После подтверждения выпуска на предыдущем этапе, вы автоматически перейдете на этот этап, и данные будут упакованы в единый локальный zip-архив. Путь и название архива задается на вкладке Output Path диалогового окна Project Release Options. По умолчанию он задан [OutputPath][ProjectName].zip
(используется путь, заданный в поле Output Path вкладки Options диалогового окна Project Options).
Этот этап применим только в случае использования варианта выпуска Unmanaged - Zip
.
Офлайн-этап 6 – Execution Report (Отчет о выполнении)
На этом финальном этапе предоставляется отчет о выпуске.
Финальный отчет о выпуске при использовании варианта выпуска Unmanaged - Folder
. Наведите курсор мыши на изображение, чтобы увидеть отчет при использовании варианта Unmanaged - Zip
.
С помощью ссылки Navigation Link вы можете быстро перейти к выходной папке или к архиву в Проводнике Windows.
Быстрый переход к локальной папке, непосредственно из этапа Execution Report. Наведите курсор мыши на изображение, чтобы увидеть пример отображения локально выпущенного zip-архива.
Публикация в инстанцию PLM
Связанные страницы: Интеграция с PLM, Публикация в PLM
У вас есть возможность публиковать проекты в инстанцию PLM в рамках запущенного процесса Project Releaser в Altium NEXUS. Публикация использует шаблон публикации, заданный в рамках конфигурации интеграции с инстанциями этой PLM, для управления тем, как данные должны быть переданы в PLM. Эта функциональная возможность доступна через процесс, настроенный соответствующим образом. В рамках установки предоставлен пример определения процесса (Project Releaser with Publish
), рабочий процесс которого включает публикацию в инстанцию интегрированной PLM в виде дополнительного этапа средства Project Releaser. Диаграмма рабочего процесса показана ниже.
Это определение процесса не может быть активировано и использовано как есть. Оно больше похоже на шаблон – измените его в соответствии с требованиями предприятия и сохраните его как новое определение процесса, которое затем можно активировать и использовать.
![](/documentation/sites/default/files/wiki_attachments/301291/ANS_Processes-ProjectReleaserwithPublishDiagram_3_0.png)
После активации процесса для публикации в инстанцию PLM в рамках выпуска проекта, его можно открыть из Altium NEXUS с помощью подменю Project » Project Releaser из активного проекта.
![](/documentation/sites/default/files/wiki_attachments/301291/ProjectReleaser_Access-PLM_3_0.png)
Процесс также доступен из контекстного подменю
Project Releaser, доступного по щелчку ПКМ по записи проекта в панели
Projects.
Будет открыто средство Project Releaser с дополнительным этапом Online Stage 7 - Publish to PLM. Кроме того, из меню кнопки
доступна команда Prepare & Release & Publish to PLM, если вы хотите запустить Project Releaser без остановки на формирование данных и получение отчета о выполнении.
![](/documentation/sites/default/files/PLMProcessAccess-ProjectReleaser_3_0.png)
При запуске Project Releaser с помощью стандартной команды Prepare, после просмотра и выпуска данных, на этапе Execution Report будет отображена кнопка
. Нажмите ее, чтобы продолжить рабочий процесс для публикации в PLM. Будет открыто диалоговое окно Login Credentials. Введите имя пользователя (Username) и пароль (Password) для вашей инстанции PLM и выберите шаблон PLM, который вы хотите использовать (появится в формате <ИнстанцияPLM>:<ШаблонПубликации>
).
Если вы выберите команду
Prepare & Release & Publish to PLM, будет сразу открыто диалоговое окно
Login Credentials. Средство
Project Releaser не остановится на этапе
Execution Report, и кнопка
![](/documentation/sites/default/files/wiki_attachments/301291/PublishToPLMButton.png)
не будет показана.
Обратите внимание, что учетные данные для доступа к инстанции PLM необходимы только при первой публикации в эту инстанцию Далее они будут сохранены в NEXUS Server. После этого, публикации этого проекта в ту же инстанцию PLM будут осуществляться напрямую, в соответствии с заданным рабочим процессом и выбранным шаблоном публикации.
![](/documentation/sites/default/files/wiki_attachments/301291/ProjectReleaser_PLMPublish-LoginCredentials_3_0.png)
Нажмите по вкладке Diagram, чтобы увидеть рабочий процесс.
![](/documentation/sites/default/files/wiki_attachments/301291/ProjectReleaser_PLMPublish-LoginCredentials-Diagramtab_3_0.png)
Нажмите кнопку
, чтобы начать процесс публикации, в соответствии с этим рабочим процессом.
При первой публикации, если номера компонентов (на стороне PLM) еще не связаны с управляемым проектом, эти номера компонентов будут созданы в PLM и связаны с проектом в рамках этой первой публикации. У вас есть возможность определить записи компонентов для управляемых компонентов NEXUS в инстанции PLM в рамках операции публикации, чтобы получить перечень компонентов в PLM (опционально, на основе шаблона публикации, заданного и используемого при публикации проекта в инстанцию PLM).
Проверьте состояние процесса публикации в PLM через веб-интерфейс NEXUS Server на виде Activities страницы Projects Management этого проекта.
Чтобы открыть страницу
Projects Management, выберите нужный проект, нажмите
![](/documentation/sites/default/files/wiki_attachments/301291/Morebutton.png)
над списком проектов и выберите
Open в открывшемся меню. Либо дважды щелкните ЛКМ по нужному проекту в списке. Страница будет открыта в новой вкладке браузера.
![](/documentation/sites/default/files/wiki_attachments/301291/ProjectReleaser_PLMPublish-Browser_3_0.png)
Та же самая информация о статусе доступа в панели Explorer в Altium NEXUS. При просмотре проекта в режиме Project (а не в режиме Classic) щелкните ЛКМ по вкладке Activities.
Вы всегда можете увидеть, что именно было создано, например номера компонентов в инстанции PLM, в истории рабочего процесса (вкладка History).