Выпуск в Workspace
Краткий обзор
- Определите, какие наборы исходных данных, данных для изготовления и сборки, данных вариантов исполнения и пользовательских данных следует включить в выпуск, а также как назначить необходимые задания формирования выходных данных.
- Разберитесь в параметрах назначения выпуска, схемах именования элементов рабочего пространства и настройках целевых ревизий.
- Пройдите этапы выпуска и узнайте, как команды автоматизированного выпуска влияют на просмотр результатов, формирование отчетов и публикацию в PLM.
В представлении Release в Online Mode процесс выпуска разделён на этапы. Элементы в левой части представления позволяют сразу определить, на каком этапе вы находитесь:
-
Configure Server Release — на этом этапе процесса выпуска указываются типы данных, которые необходимо сформировать: исходные данные (формируются всегда), данные для изготовления и данные для сборки (для базового проекта и каждого обнаруженного варианта).
-
Validate Project — следующий этап процесса выпуска запускается автоматически, если в назначенных файлах OutJob обнаружен хотя бы один отчёт типа Validation. Выполняются все генераторы проверочных отчётов, заданные в файле Output Job, назначенном выпускаемому элементу данных.
-
Generate Data — следующий этап процесса выпуска запускается автоматически. На нём выполняются все остальные операции вывода, заданные в файлах OutJob, назначенных включённым элементам данных, чтобы сформировать данные для выпуска в соответствующие целевые элементы в Workspace.
-
Review Data — после успешного прохождения всех проверок и формирования выходных данных на этом этапе процесса выпуска можно просмотреть сформированные данные.
-
Upload Data — после подтверждения выпуска на предыдущем этапе переход к этому этапу выполняется автоматически. На нём отображается ход загрузки данных в ревизии соответствующих элементов данных в целевом Workspace.
-
Execution Report — заключительный этап процесса, на котором приводится сводка по выпуску. Ссылки позволяют быстро перейти к сформированным ревизиям элементов на панели Explorer. Если вы открыли Project Releaser в рамках процесса выпуска и публикации в PLM, отобразится кнопка
. Нажмите её, чтобы продолжить соответствующий рабочий процесс и выполнить публикацию в PLM.
-
Publish to PLM — этот этап доступен только при выполнении выпуска в рамках соответствующего активированного процесса (для выпуска с последующей публикацией в PLM). Переход к этому этапу выполняется автоматически при нажатии кнопки
на предыдущем этапе (или напрямую, если использовалась команда Prepare & Release & Publish to PLM из меню кнопки Откроется диалоговое окно Login Credentials. Введите Username и Password для вашего экземпляра PLM и выберите нужный шаблон PLM (он отображается в виде <PLMInstance>:<PublishingTemplate>).
Онлайн-этап 1 — настройка выпуска на сервер
На этом этапе процесса выпуска указываются типы данных, которые необходимо сформировать. Выпускать можно следующие элементы данных:
- Source Data — снимок исходных данных проекта.
- Fabrication Data — данные, необходимые изготовителю печатных плат для производства платы без компонентов.
- Assembly Data for the Base Design (no variations) — данные, необходимые сборочному производству для полного монтажа компонентов на плату в соответствии со спецификацией базового проекта без вариантов.
-
Assembly Data for Design
Variant n— данные, необходимые сборочному производству для монтажа компонентов на плату в соответствии со спецификацией дляVariant nбазового проекта.
Количество наборов данных для сборки соответствует базовому проекту (без вариантов) и всем обнаруженным вариантам, заданным для этого проекта.

Этап 1 процесса выпуска проекта — настройка состава выпуска (выбор данных для формирования).
Элемент Source Data всегда включается в выпуск. Остальные элементы данных включаются по необходимости.
Назначение заданий вывода
Чтобы включить элементы Fabrication Data и Assembly Data в выпуск, каждому из них необходимо назначить хотя бы один файл Output Job. Если имена файлов Output Job начинаются с подстрок «fab» и «ass», эти файлы OutJob будут автоматически назначены разделам Fabrication Data и Assembly Data соответственно при первом открытии представления Release. В противном случае соответствующие файлы OutJob потребуется назначить вручную. Это можно сделать на вкладке Release Options диалогового окна Project Release Options (чтобы открыть его, нажмите кнопку
в левом нижнем углу представления).

При необходимости назначьте файлы OutJob соответствующим наборам данных.
Изменение места назначения выпуска
На вкладке Release Options диалогового окна Project Release Options также можно изменить место назначения выпуска, переключаясь между управляемым (Online) и неуправляемым (Offline) режимами работы. Доступны три варианта:
-
Unmanaged - Folder(Offline): выберите этот вариант для выпуска сформированных данных в локальную папку. Путь к корневой папке задаётся на вкладке Output Path диалогового окна. По умолчанию используется[OutputPath](на основе пути, заданного в поле Output Path на вкладке Options диалогового окна Project Options). -
Unmanaged - Zip(Offline): выберите этот вариант для выпуска сформированных данных в локальную папку. Данные будут упакованы в один ZIP-файл. Путь и имя ZIP-файла задаются на вкладке Output Path диалогового окна. По умолчанию используется[OutputPath][ProjectName].zip(на основе пути, заданного в поле Output Path на вкладке Options диалогового окна Project Options). -
Managed - <WorkspaceName>(Online): выберите этот вариант для выпуска в Workspace (сWorkspaceName), к которому вы подключены в данный момент.

Измените место назначения выпуска — куда будут отправляться сформированные данные — в параметрах выпуска проекта.
Настройка схем именования элементов рабочего пространства
При первом выпуске проекта в целевое рабочее пространство можно определить, как будут называться целевые элементы данных в этом рабочем пространстве (в ревизии которых будут помещаться сформированные данные). Это настраивается на вкладке Item Naming диалогового окна Project Release Options, которое открывается нажатием кнопки
в левом нижнем углу представления (или щелчком по ссылке Target Revision для выпускаемого набора данных и выбором пункта Edit в контекстном меню). На этой вкладке можно:
- Задать имя проекта. По умолчанию в поле подставляется текущее имя проекта.
-
Задать схемы именования по умолчанию для различных элементов данных, которые могут быть сформированы в ходе выпуска. Щелкните поле в столбце Item ID, затем нажмите кнопку
справа от поля, чтобы открыть диалоговое окно Choose Item (вариант панели Explorer), в котором можно выбрать существующий элемент в подключенном рабочем пространстве.
Чтобы изменить любую из схем именования, нажмите кнопку Settings и откройте диалоговое окно Naming Template Settings.

Задайте имя проекта и определите имена формируемых элементов данных в целевом рабочем пространстве. Здесь поля доступны для редактирования, поскольку проект еще не выпущен.
В шаблоне именования поддерживаются следующие форматы макросов:
-
Parameter-based — поддерживает использование параметров в квадратных скобках (например,
[ProjectName],[VariantName],[ProjectParameter]). -
Numeric-based — поддерживает использование числовых квантификаторов в фигурных скобках (например,
{0000},{9000}).
Управление целевой ревизией
Вернувшись в основное представление, щелкните ссылку рядом с записью Target Revision, чтобы открыть меню команд, показанное на следующем изображении:

Доступ к средствам выбора целевой ревизии для набора данных, формируемого в ходе выпуска — наведите указатель на изображение, чтобы увидеть их.
Доступные команды зависят от того, был ли уже выполнен первый выпуск элемента. Ниже перечислены все возможные команды:
-
Auto <RevisionID> — этот пункт позволяет системе управлять ревизиями, избавляя вас от необходимости создавать запланированные ревизии там, где их пока нет. В
RevisionIDотображается следующая ревизия элемента на том же уровне назначенной схемы именования ревизий (например, если текущая ревизия —A.1, эта команда укажет в качестве целевой ревизиюA.2). -
Next <RevisionID> — этот пункт доступен только после первого выпуска элемента. Он позволяет быстро повысить целевую ревизию на следующем уровне назначенной схемы именования ревизий. В
RevisionIDотображается следующая ревизия (например, если текущая ревизия —A.1, эта команда переключит целевую ревизию наB.1). -
Custom — этот пункт позволяет выбрать определенную ревизию целевого элемента, задав пользовательский идентификатор ревизии в диалоговом окне Custom Revision ID. В зависимости от используемой схемы именования ревизий в диалоговом окне может быть до трех полей идентификаторов уровней. Обратите внимание: идентификатор первой запланированной ревизии элемента можно изменить в любой момент после создания элемента и до выпуска данных в эту начальную ревизию (то есть пока она находится в состоянии
Planned). - Browse — этот пункт позволяет выбрать существующую ревизию целевого элемента для выпуска данных. Для этого откроется диалоговое окно Choose Target Item (вариант панели Explorer).
- Edit — этот пункт открывает вкладку Item Naming диалогового окна Project Release Options, где можно изменить имя создаваемого целевого элемента (и его начальной ревизии).
- Navigate — этот пункт позволяет быстро перейти к элементу на панели Explorer (если он уже был выпущен, а следующая ревизия существует в запланированном состоянии).
Пункт в верхней части меню отражает текущую выбранную или заданную целевую ревизию.
Просмотр сведений о формировании данных
Нажмите элемент управления Details в правой части заголовка набора данных, чтобы узнать, какие именно данные будут сформированы этим набором. Чтобы свернуть подробное представление, нажмите элемент управления Hide Details. За исключением набора Source Data, данные формируются на основе одного или нескольких назначенных файлов заданий на формирование выходных данных (Output Job). Быстро открыть исходный файл OutJob можно с помощью элемента управления Configure.

Откройте подробное представление набора данных, чтобы увидеть, какие данные будут сформированы — наведите указатель на изображение, чтобы увидеть их.
Дополнительные настройки
Дополнительные параметры выпуска проекта можно задать на странице Data Management – Servers диалогового окна Preferences:
-
Для временного хранения сформированных файлов перед загрузкой в подключенное рабочее пространство можно использовать автоматически выбранную папку (
\Users\<ProfileName>\AppData\Local\Temp\Releasesпри установке по умолчанию) или вручную указать другую папку. - Включите параметр Delete contents after exiting release mode, чтобы папка временного хранения очищалась после завершения процесса выпуска.
- К имени каждого сформированного выходного файла при необходимости можно добавить префикс с идентификатором элемента и идентификатором ревизии (например,
[FAB-Kame_FMU-A.1] Validation.PDF). Для этого включите опцию Prepend revision HRID to file names.
Настроив нужным образом элементы данных, которые будут созданы при выпуске, нажмите кнопку
в правом нижнем углу представления, чтобы продолжить.
В ходе подготовки выполняется ряд предварительных проверок, в том числе:
- Проверка того, что проект и все файлы сохранены.
- Проверка того, что проект и все соответствующие файлы зафиксированы в системе контроля версий (VCS), если она используется.
- Проверка того, что каждому включенному элементу данных присвоено имя.
- Проверка наличия у пользователя прав на создание целевого элемента и его ревизии.
- Создание необходимых целевых элементов и запланированных ревизий в рабочем пространстве, если они еще не существуют, и проверка того, что для уже существующих элементов используется следующая ревизия.
При обнаружении проблем вам будут предложены способы их устранения, например сохранение локально измененных файлов и их фиксация в VCS.
На этом этапе создается элемент Source Data: снимок исходных файлов проекта выпускается в целевую ревизию элемента.
Онлайн-этап 2 — Проверка проекта
После успешного завершения этапа 1 следующий этап процесса выпуска запускается автоматически, если в назначенных файлах OutJob обнаружен хотя бы один отчет типа Validation. Запускаются все генераторы проверочных выходных данных, заданные в файле Output Job, назначенном выпускаемому элементу данных. Сюда входят следующие проверки:
- Differences Report — использование компаратора для определения того, правильно ли синхронизированы исходные документы проекта и документ печатной платы.
- Electrical Rules Check — проверка электрической и графической корректности исходной схемы проекта.
- Design Rules Check — проверка соответствия документа печатной платы заданным ограничениям проектирования на уровне платы.
-
BOM Checks — проверка возможных нарушений, связанных с элементами проекта или вариантами выбора компонентов в исходном документе BOM (
*.BomDoc), при его наличии.— сравнение посадочных мест на плате с их исходной библиотекой для проверки их актуальности и соответствия. - Component State Checking — проверка наличия компонентов в недопустимых состояниях. При настройке вы задаете действие для каждого существующего состояния в каждом определении жизненного цикла целевого рабочего пространства: ничего не делать, выдать предупреждение или сформировать ошибку. В последнем случае выпуск проекта будет заблокирован. Кроме того, по результатам проверки формируется удобный HTML-отчет, позволяющий сразу увидеть, какие компоненты проекта находятся в недопустимых состояниях.
- Environment Configuration Compliance Check — проверка того, что используются только элементы данных, разрешенные конфигурацией среды, доступной для назначенной вам роли (если применимо). Эта проверка также позволяет убедиться, что все элементы проекта получены из рабочего пространства.
Если проверка прошла успешно, отображается значок
с текстом Passed. В противном случае отображается значок
с текстом Failed.
Онлайн-этап 3 — Формирование данных
После успешного завершения этапа 2 следующий этап процесса выпуска запускается автоматически. На этом этапе запускается формирование всех остальных выходных данных, заданных в файлах OutJob, назначенных включенным элементам данных. Полученные данные предназначены для выпуска в соответствующие целевые элементы рабочего пространства.
Как и на других этапах, ход формирования данных отображается с помощью значков. На этом этапе они особенно полезны, поскольку его выполнение занимает больше времени:
— еще не запущено / не сформировано.
— выполняется / формируется.
— успешно сформировано.
— ошибка формирования.
Онлайн-этап 4 — Просмотр данных
После успешного прохождения всех проверок и формирования выходных данных на этом этапе можно просмотреть полученные данные.

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

Нажмите элемент управления Details, чтобы переключить соответствующий раздел с упрощенного на подробное представление сформированных данных. Для возврата нажмите элемент управления Hide Details.
Состояния формирования выходных данных в подробном представлении
В следующей таблице перечислены возможные состояния выходных данных при их формировании и просмотре в подробном представлении:
Состояние |
Описание |
|---|---|
|
Выходные данные еще не сформированы / не существуют. |
|
Выходные данные сформированы, но с тех пор в проект были внесены изменения, поэтому эти данные больше не являются актуальными. |
|
В данный момент выполняется формирование выходных данных. |
|
Выходные данные основаны на проверке, по результатам которой сформирован отчет без ошибок. Для отчета ERC это означает, что ошибки отсутствуют либо их уровень не превышает максимально допустимый уровень, заданный для этого отчета. |
|
Выходные данные (за исключением данных, основанных на проверке) успешно сформированы. |
|
Не удалось успешно сформировать выходные данные. Для данных, основанных на проверке, это означает, что в исходных документах проекта есть ошибки, из-за которых некоторые проверки не проходят. Для обычных выходных данных это означает, что их не удалось сформировать. Возможно, при предварительной проверке перед формированием обнаружены критические ошибки либо неверно настроен соответствующий генератор выходных данных в файле Output Job. |
В компактном представлении сгенерированных данных нажмите ссылку View, чтобы открыть соответствующий файл данных или набор файлов в подходящем редакторе Altium Designer (например, в CAM-редакторе для файлов Gerber или сжатых/несжатых файлов ODB++) либо во внешнем приложении (например, в Microsoft Excel для спецификации). В подробном представлении дважды щелкните запись, чтобы просмотреть только этот файл.
Один из распространенных способов проверки готовности к выпуску — сравнение файлов Gerber, сгенерированных для текущего выпуска, с файлами Gerber предыдущего выпуска. Нажмите ссылку Compare Gerber рядом с выходными данными Gerber и выберите предыдущий выпуск в раскрывающемся меню, чтобы сравнить подготовленные данные Gerber с данными выбранного выпуска. В браузере по умолчанию откроется рабочее пространство вашей компании с результатами сравнения.

Доступ к функции сравнения Gerber из Project Releaser перед выпуском данных в рабочее пространство.
► Подробнее о функции Gerber Comparison (Рабочее пространство Altium 365, Рабочее пространство Enterprise Server).
Если после проверки данных потребуется внести изменения, нажмите кнопку
в правом нижнем углу представления. Появится диалоговое окно подтверждения с предупреждением о том, что все сгенерированные данные будут потеряны. Нажатие OK отменит выпуск и вернет вас к этапу 1 процесса.
Если все сгенерированные данные в порядке, продолжите выпуск, нажав кнопку
(также в правом нижнем углу представления). Появится диалоговое окно Confirm Release со сводкой конфигураций проекта, которые будут выпущены в рабочее пространство. Здесь также можно добавить Name (по умолчанию указано [ProjectName]), Description и необходимые примечания к выпуску.

Подтверждение состава выпуска с указанием создаваемых ревизий элементов, а также возможность изменить имя и описание и добавить примечания к выпуску.
Онлайн-этап 5 — Загрузка данных
После подтверждения выпуска на предыдущем этапе переход к этому этапу выполняется автоматически. На нем отображается ход загрузки данных в ревизии соответствующих элементов данных в рабочем пространстве.

На этом этапе отображается ход загрузки сгенерированных данных в связанные ревизии элементов в рабочем пространстве.
Онлайн-этап 6 — Отчет о выполнении
Это заключительный этап процесса, на котором представлена сводная информация о выпуске.
Используйте навигационные ссылки для быстрого перехода к соответствующей ревизии элемента с выпущенными данными (данными для изготовления, данными для сборки и любыми наборами пользовательских данных) на панели Explorer — вашей точке доступа к рабочему пространству.

Просмотр выпущенных данных проекта непосредственно в рабочем пространстве с помощью панели Explorer.
Просмотр выпущенного проекта
После завершения выпуска проекта рабочего пространства вам доступна еще одна возможность. Нажмите ссылку Project Page — последнюю из навигационных ссылок в верхней части страницы Execution Report, — чтобы открыть панель Explorer, на которой проект отображается в Project View. Эта возможность доступна только для проектов рабочего пространства.

Вы можете подробнее изучить проект рабочего пространства на панели Explorer с помощью Project View.
В области Releases (внизу слева) отображается сводка выпусков проекта, включающая краткую информацию о каждом выпуске и входящих в него пакетах. Нажмите кнопку
в этой области, чтобы открыть диалоговое окно Batch state change, в котором можно за одну пакетную операцию изменить состояние жизненного цикла сразу нескольких элементов, относящихся к одному выпуску.
Дополнительная информация о выпусках проекта доступна в веб-просмотрщике целевого рабочего пространства, который открывается кнопкой
на панели Explorer. В веб-просмотрщике рабочего пространства все выпуски, связанные с проектом, доступны в представлении Releases или в представлении Manufacture для рабочего пространства на локальном сервере. На странице перечислены все выпуски проекта, начиная с самого нового. Отдельный выпуск можно открыть в Manufacturing Portal рабочего пространства с помощью кнопки открытия Представление Manufacturing Portal содержит более подробную информацию о выбранном выпуске, включая файлы входящих в него пакетов выпуска, полный набор проектных документов, а также сведения о производителях и поставщиках компонентов. Обратите внимание, что функция Send to Manufacturer доступна только в рабочем пространстве Altium 365. ► Дополнительную информацию см. на странице Представление Releases рабочего пространства Altium 365.
Готово! Теперь, когда проект выпущен, можно закрыть представление Release кнопкой
в правом нижнем углу. Когда в дальнейшем потребуется повторно выпустить этот же проект, Project Releaser позволит сделать это быстро и просто, автоматически увеличивая номера целевых ревизий элементов.
Публикация в экземпляре PLM
Related pages: Интеграция с PLM (Altium 365 Workspace, Enterprise Server Workspace), Публикация в PLM
Вы можете опубликовать проект в экземпляре PLM в ходе выполнения Project Releaser в Altium Designer. Операция публикации использует шаблон публикации, заданный в конфигурации интеграции с этим экземпляром PLM, для управления передачей данных в PLM. Эта возможность доступна через соответствующим образом настроенный процесс. В состав установки входит пример определения процесса — Project Releaser with Publish, рабочий процесс которого позволяет выполнять публикацию в интегрированном экземпляре PLM в качестве дополнительного этапа Project Releaser. Схема рабочего процесса показана ниже.

Схема рабочего процесса для стандартного примера определения процесса Project Releaser with Publish
После активации процесс публикации в экземпляре PLM в рамках Project Releaser будет доступен в Altium Designer из подменю Project » Project Releaser активного проекта или из контекстного подменю Project Releaser, которое открывается щелчком правой кнопкой мыши по записи проекта на панели Projects.

Доступ к процессу публикации в экземпляре PLM в рамках Project Releaser
Откроется Project Releaser с дополнительным этапом — 7. Publish to PLM. Кроме того, в меню кнопки
доступна команда Prepare & Release & Publish to PLM, позволяющая запустить Project Releaser без остановки для просмотра сформированных данных и отчёта о выполнении.

Дополнительная команда для запуска Project Releaser без остановки для просмотра сформированных данных и отчёта о выполнении
Если запустить Project Releaser с помощью стандартной команды Prepare, после просмотра и выпуска данных на этапе Execution Report появится кнопка
. Нажмите её, чтобы продолжить рабочий процесс и выполнить публикацию в PLM. Откроется диалоговое окно Login Credentials. Выберите нужный шаблон PLM (он отображается в виде <PLMInstance>:<PublishingTemplate>) и введите Username и Password для своего экземпляра PLM либо войдите с помощью SSO.

Диалоговое окно Login Credentials, открываемое при первой публикации в экземпляре PLM.
Перейдите на вкладку Diagram, чтобы просмотреть рабочий процесс.

Вкладка Diagram диалогового окна Login Credentials
Нажмите кнопку
, чтобы продолжить публикацию в соответствии с этим рабочим процессом.

).

