Выпуск в Workspace

Краткий обзор

Узнайте, как выпустить проект в подключенное рабочее пространство с помощью поэтапного процесса Online Mode инструмента Project Releaser в Altium Designer. В этой статье объясняется, как выбрать данные для выпуска, назначить задания Output Job, настроить именование элементов рабочего пространства и целевые ревизии, а затем пройти этапы проверки, формирования данных, просмотра и загрузки. Также рассматривается публикация в PLM, если она предусмотрена используемым процессом выпуска. Читайте дальше, чтобы настроить выпуск и понять, что происходит на каждом этапе.

- Определите, какие наборы исходных данных, данных для изготовления и сборки, данных вариантов исполнения и пользовательских данных следует включить в выпуск, а также как назначить необходимые задания Output Job.
- Ознакомьтесь с параметрами назначения выпуска, схемами именования элементов рабочего пространства и средствами управления целевыми ревизиями.
- Пройдите этапы выпуска и узнайте, как команды автоматизированного выпуска влияют на просмотр, формирование отчетов и публикацию в PLM.
Узнайте больше с ИИ:

В представлении Release в Online Mode процесс выпуска разделен на этапы. Элементы в левой части представления позволяют сразу определить, на каком этапе вы находитесь:

  1. Configure Server Release — на этом этапе процесса выпуска указываются типы данных, которые необходимо сформировать: исходные данные (формируются всегда), данные для изготовления и данные для сборки (для базового проекта и каждого обнаруженного варианта).

  2. Validate Project — этот этап процесса выпуска выполняется автоматически, если в назначенных файлах OutJob обнаружен хотя бы один отчет типа Validation. Выполняются все генераторы выходных данных для проверки, заданные в файле Output Job, назначенном выпускаемому элементу данных.

  3. Generate Data — этот этап процесса выпуска выполняется автоматически. На нем выполняются все остальные процедуры формирования выходных данных, заданные в файлах OutJob, назначенных включенным элементам данных. В результате формируются данные для выпуска в соответствующие целевые элементы рабочего пространства.

  4. Review Data — после успешного прохождения всех проверок и формирования выходных данных на этом этапе процесса выпуска можно просмотреть сформированные данные.

    Если выбрать команду Prepare & Release или Prepare & Release & Publish to PLM (в меню кнопки ), Project Releaser не будет останавливаться на этапе Review Data.

  5. Upload Data — переход к этому этапу выполняется автоматически после подтверждения выпуска на предыдущем этапе. Здесь отображается ход загрузки данных в ревизии соответствующих элементов данных в целевом рабочем пространстве.

  6. Execution Report — это заключительный этап процесса, на котором отображаются итоговые сведения о выпуске. Навигационные ссылки позволяют быстро перейти к созданным ревизиям элементов на панели Explorer. Если вы открыли Project Releaser в рамках процесса выпуска и публикации в PLM, будет отображаться кнопка . Нажмите ее, чтобы продолжить рабочий процесс и выполнить публикацию в PLM.

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

    Обратите внимание: учетные данные для входа в экземпляр PLM требуются только при первой публикации в него. Затем они сохраняются в рабочем пространстве. После этого все последующие публикации данного проекта в тот же экземпляр PLM будут выполняться напрямую в соответствии с заданным рабочим процессом и выбранным шаблоном публикации.
    Если публикация выполняется впервые и номера изделий на стороне PLM еще не связаны с проектом в рабочем пространстве, эти номера будут созданы в PLM и связаны с проектом при первой публикации. В ходе публикации также можно создать в экземпляре PLM записи для компонентов рабочего пространства, чтобы получить спецификацию компонентов в PLM (это необязательная возможность, которая зависит от шаблона, заданного и используемого при публикации проекта в экземпляр PLM).

Этап 1 в онлайн-режиме — настройка выпуска на сервер

На этом этапе процесса выпуска указываются типы данных, которые необходимо сформировать. Для выпуска доступны следующие элементы данных:

  • Source Data — снимок исходного проекта.
  • Fabrication Data — данные, необходимые производителю печатных плат для изготовления несмонтированной платы.
  • Assembly Data for the Base Design (no variations) — данные, необходимые сборочному предприятию для полного монтажа компонентов на плату в соответствии со спецификацией для базового проекта без вариантов исполнения.
  • Assembly Data for Design Variant n — данные, необходимые сборочному предприятию для монтажа компонентов на плату в соответствии со спецификацией для Variant n базового проекта.

Количество наборов данных для сборки соответствует базовому проекту (без вариантов исполнения) и всем обнаруженным вариантам, определенным для этого проекта.

Кроме того, можно добавлять и настраивать разделы Custom Data, создавая собственный набор данных для выпуска. Эта возможность предназначена главным образом для обратной совместимости или нестандартных потоков данных. Ссылки создаются только для исходных данных. В рамках выпуска можно добавить и настроить любое количество пользовательских наборов данных (нажмите элемент управления Add Section под списком уже заданных элементов данных).

Этап 1 процесса выпуска проекта — настройка состава выпуска (выбор данных для формирования).
Этап 1 процесса выпуска проекта — настройка состава выпуска (выбор данных для формирования).

Элемент Source Data всегда включается в выпуск. Остальные элементы данных включаются по необходимости.

Настроив необходимые элементы данных, которые будут созданы при выпуске, нажмите кнопку в правом нижнем углу представления, чтобы продолжить.

Кнопка имеет два режима работы. При нажатии на нее запускается стандартная команда Prepare. Процесс выпуска будет выполнен до этапа Review Data, что позволит еще раз убедиться, что все в порядке, прежде чем подтвердить выпуск данных. Если вы не хотите останавливаться для проверки, откройте раскрывающееся меню этой кнопки и выберите команду Prepare & Release.

В ходе подготовки выполняется несколько предварительных проверок, в том числе:

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

При обнаружении проблем будут предложены способы их устранения, например сохранение локально измененных файлов и фиксация изменений в VCS.

Если в выпускаемом проекте обнаружены внешние документы (документы, связанные с проектом, но хранящиеся вне папки проекта и ее подпапок), откроется диалоговое окно External files со списком внешних документов (). Во избежание возможных проблем рекомендуется хранить все связанные с проектом документы в папке проекта или ее подпапке.

На этом этапе создается элемент Source Data: снимок исходных файлов проекта выпускается в целевую ревизию элемента.

Онлайн-этап 2 — Проверка проекта

После успешного завершения этапа 1 этот этап процесса выпуска запускается автоматически, если в назначенных файлах OutJob обнаружен хотя бы один отчет типа Validation. Запускаются все генераторы проверочных выходных данных, заданные в файле Output Job, назначенном выпускаемому элементу данных. В их число входят:

  • Differences Report — использование средства сравнения для проверки согласованности исходных документов проекта и документа печатной платы.
  • Electrical Rules Check — проверка исходной схемы на соответствие электрическим правилам и правилам оформления.
  • Design Rules Check — проверка документа печатной платы на соответствие заданным ограничениям проектирования платы.
  • BOM Checks — проверка возможных нарушений, связанных с элементами проекта или вариантами выбора компонентов в исходном документе спецификации (*.BomDoc), если он имеется.
  • Footprint Comparison Report — сравнение посадочных мест на плате с исходной библиотекой, чтобы убедиться в их актуальности и соответствии.
  • Component State Checking — проверка наличия компонентов, находящихся в состояниях с ограничениями. При настройке для каждого существующего состояния в каждом определении жизненного цикла целевого рабочего пространства задается действие: ничего не делать, выдать предупреждение или сформировать ошибку. В последнем случае выпуск проекта будет заблокирован. Кроме того, при проверке создается удобный HTML-отчет, позволяющий сразу увидеть, какие компоненты проекта находятся в недопустимых состояниях.
  • Environment Configuration Compliance Check — проверка того, что используются только элементы данных, разрешенные конфигурацией среды, доступной назначенной вам роли (если применимо). Эта проверка также позволяет убедиться, что все элементы проекта получены из рабочего пространства.

При успешной проверке отображается значок с текстом Passed. В противном случае отображается значок с текстом Failed.

Если хотя бы одна проверка не пройдена, выпуск завершится неудачей.
Нажатие в правом нижнем углу представления останавливает процесс выпуска.

Онлайн-этап 3 — Формирование данных

После успешного завершения этапа 2 этот этап процесса выпуска запускается автоматически. На нем формируются все остальные выходные данные, заданные в файлах OutJob, назначенных включенным элементам данных, для последующего выпуска в соответствующие целевые элементы рабочего пространства.

Как и на других этапах, ход формирования отображается с помощью значков. На этом этапе они особенно полезны, поскольку он занимает больше времени:

— выполнение или формирование еще не началось.

— выполняется или формируется.

— успешно сформировано.

— ошибка формирования.

Нажатие в правом нижнем углу представления останавливает процесс выпуска.

Онлайн-этап 4 — Просмотр данных

После успешного прохождения всех проверок и формирования выходных данных этот этап процесса выпуска позволяет просмотреть сформированные данные.

Если выбрать команду Prepare & Release в меню кнопки , Project Releaser не будет останавливаться на этапе Review Data.

Просмотрите сформированные данные и убедитесь, что все в порядке, прежде чем подтвердить выпуск и загрузить данные в рабочее пространство.
Просмотрите сформированные данные и убедитесь, что все в порядке, прежде чем подтвердить выпуск и загрузить данные в рабочее пространство.

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

Нажмите элемент управления Details, чтобы переключить отображение сформированных данных соответствующего раздела с простого на подробное. Для возврата нажмите элемент управления Hide Details.
Нажмите элемент управления Details, чтобы переключить отображение сформированных данных соответствующего раздела с простого на подробное. Для возврата нажмите элемент управления Hide Details.

В компактном представлении сформированных данных нажмите ссылку View, чтобы открыть соответствующий файл данных или набор файлов в подходящем редакторе Altium Designer (например, в CAM-редакторе для файлов Gerber или сжатых/несжатых файлов ODB++) либо во внешнем приложении (например, в Microsoft Excel для спецификации). В подробном представлении дважды щелкните запись, чтобы просмотреть только этот файл.

Многие разработчики проверяют готовность к выпуску, сравнивая файлы Gerber, сформированные для текущего выпуска, с файлами Gerber предыдущего выпуска. Нажмите ссылку Compare Gerber рядом с выходными данными Gerber и выберите предыдущий выпуск в раскрывающемся меню, чтобы сравнить подготовленные данные Gerber с данными выбранного выпуска. В браузере по умолчанию откроется рабочее пространство вашей компании и отобразятся результаты.

Доступ к функции сравнения Gerber из Project Releaser перед выпуском данных в рабочее пространство.
Доступ к функции сравнения Gerber из Project Releaser перед выпуском данных в рабочее пространство.

► Подробнее о функции Gerber Comparison (рабочее пространство Altium 365, рабочее пространство Enterprise Server).

В компактном представлении раздела Source Data нажатие ссылки View открывает Проводник Windows во временной папке, в которой сохранен снимок исходных файлов проекта. Эта функция также доступна по ссылке Explore справа от заголовка раздела. Такой элемент управления есть в каждом разделе: он позволяет быстро перейти к подпапке с соответствующими данными во временной папке.

В подробном представлении команды контекстного меню, вызываемого правой кнопкой мыши, позволяют открыть документ и перейти к папке, в которой он был сформирован (во временной папке). Также можно добавить столбцы с расположением папки и датой создания: щелкните правой кнопкой мыши область заголовков таблицы и выберите команду Select Columns, чтобы открыть диалоговое окно настройки отображаемых данных.

Если после проверки данных потребуется внести изменения, нажмите кнопку в правом нижнем углу представления. Появится диалоговое окно подтверждения с предупреждением о том, что все сформированные данные будут потеряны. Нажатие OK отменит выпуск и вернет вас к этапу 1.

Система не допускает изменения файлов проекта в промежутке между подготовкой выпуска и выпуском данных в рабочее пространство. Если вы каким-либо образом измените файлы проекта, процесс выпуска будет прерван и вы вернетесь к начальному этапу, предшествующему подготовке выпуска.

Если все сформированные данные в порядке, продолжите выпуск, нажав кнопку (также в правом нижнем углу представления). Откроется диалоговое окно Confirm Release со сводкой конфигураций проекта, которые будут выпущены в рабочее пространство. Здесь также можно добавить Name (по умолчанию здесь указано [ProjectName]), Description и необходимые примечания к выпуску.

Подтверждение состава выпуска с указанием создаваемых ревизий элементов и возможность изменить имя/описание и добавить примечания к выпуску.
Подтверждение состава выпуска с указанием создаваемых ревизий элементов и возможность изменить имя/описание и добавить примечания к выпуску.

Онлайн-этап 5 — загрузка данных

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

Этот этап лишь отображает ход загрузки сформированных данных в связанные ревизии элементов в рабочем пространстве.
Этот этап лишь отображает ход загрузки сформированных данных в связанные ревизии элементов в рабочем пространстве.

Онлайн-этап 6 — отчет о выполнении

Это заключительный этап процесса, на котором представлена сводка по выпуску.

Итоговый отчет о выпуске.
Итоговый отчет о выпуске.

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

Просмотр выпущенных данных проекта непосредственно в рабочем пространстве с помощью панели Explorer.
Просмотр выпущенных данных проекта непосредственно в рабочем пространстве с помощью панели Explorer.

Параметры, заданные для вариантов проекта, включаются в соответствующие ревизии наборов данных для сборки. При просмотре проекта в Classic View на панели Explorer выберите нужную ревизию набора данных для сборки и перейдите на вкладку представления Parameters, чтобы увидеть параметры варианта.

Параметр варианта VariantLabel = A добавлен в вариант проекта Default. Выпущенный набор данных для сборки содержит этот параметр; его можно найти на вкладке представления Parameters панели Explorer.
Параметр варианта VariantLabel = A добавлен в вариант проекта Default. Выпущенный набор данных для сборки содержит этот параметр; его можно найти на вкладке представления Parameters панели Explorer.

Готово! Проект выпущен, и теперь можно просто закрыть представление Release (кнопкой в правом нижнем углу). Если в дальнейшем потребуется повторно выпустить этот же проект, Project Releaser позволит сделать это быстро и легко, автоматически увеличив номера целевых ревизий элементов.

При каждом выпуске проекта Project Released На временную шкалу в представлении History проекта будет добавлена плитка события. На ней отображаются имя (и фотография) пользователя, выполнившего выпуск, а также дата и время. Если при выпуске сгенерированных данных в рабочую область через диалоговое окно Confirm Release было добавлено примечание к выпуску, оно также появится на плитке. Кроме того, будут перечислены все наборы данных, включенные в выпуск.

Обратите внимание: если у последнего коммита проекта еще нет тега, он будет назначен автоматически. Этот тег будет иметь вид RELEASE_<RevisionID>, где <RevisionID> — номер ревизии выпущенных исходных данных проекта (A.1, A.2 и т. д.), например RELEASE_A.3.

Пример плитки события Project Released в представлении History проекта. Поскольку у последнего коммита проекта не было тега, он был назначен после выпуска.
Пример плитки события Project Released в представлении History проекта. Поскольку у последнего коммита проекта не было тега, он был назначен после выпуска.

► Подробнее об истории проекта.

Публикация в экземпляре PLM

Related pages: Интеграция с PLM (рабочая область Altium 365, рабочая область Enterprise Server), Публикация в PLM

Вы можете опубликовать проект в экземпляре PLM при запуске Project Releaser в Altium Designer. Для управления передачей данных в PLM при публикации используется шаблон публикации, заданный в конфигурации интеграции этого экземпляра PLM. Эта возможность доступна через соответствующим образом настроенный процесс. В состав установки входит пример определения процесса — Project Releaser with Publish, — рабочий процесс которого позволяет выполнять публикацию в интегрированном экземпляре PLM в качестве дополнительного этапа работы Project Releaser. Схема рабочего процесса показана ниже.

Это определение процесса нельзя активировать и использовать в исходном виде. Поэтому его следует рассматривать скорее как «шаблон»: отредактируйте его в соответствии с требованиями вашей компании, задайте имя и сохраните как новое определение процесса, которое вы can затем сможете активировать и использовать.

Схема рабочего процесса для стандартного примера определения процесса Project Releaser with Publish
Схема рабочего процесса для стандартного примера определения процесса Project Releaser with Publish

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

Доступ к процессу публикации в экземпляре PLM в рамках Project Releaser
Доступ к процессу публикации в экземпляре PLM в рамках Project Releaser

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

Дополнительная команда для запуска Project Releaser без остановки для просмотра сгенерированных данных и отчета о выполнении
Дополнительная команда для запуска Project Releaser без остановки для просмотра сгенерированных данных и отчета о выполнении

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

Если вы выбрали команду Prepare & Release & Publish to PLM, в итоге сразу откроется диалоговое окно Login Credentials. При этом Project Releaser не будет останавливаться на этапе Execution Report, а кнопка не появится.
Обратите внимание: учетные данные для входа в экземпляр PLM требуются только при первой публикации в нем. Затем они сохраняются в рабочей области. После этого любая публикация данного проекта в том же экземпляре PLM будет выполняться напрямую, в соответствии с заданным рабочим процессом и выбранным шаблоном публикации.

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

Перейдите на вкладку Diagram, чтобы просмотреть рабочий процесс.

Вкладка Diagram диалогового окна Login Credentials
Вкладка Diagram диалогового окна Login Credentials

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

Если публикация выполняется впервые и номера изделий на стороне PLM еще не связаны с проектом рабочей области, они будут созданы в PLM и связаны с проектом в ходе этой первой публикации. В рамках публикации вы также можете создавать в экземпляре PLM записи для компонентов рабочей области, чтобы получить спецификацию компонентов в PLM (это необязательная возможность, зависящая от шаблона публикации, заданного и используемого при публикации проекта в экземпляре PLM).
Проверить состояние процесса публикации в PLM можно через браузерный интерфейс рабочей области, в представлении Activities на странице подробного управления проектом. Чтобы открыть эту страницу, выберите нужный проект на странице Projects браузерного интерфейса рабочей области, нажмите элемент управления над списком проектов и выберите пункт Open в открывшемся меню. Также можно дважды щелкнуть запись нужного проекта в списке. Страница откроется в новой вкладке браузера. В истории рабочего процесса (вкладка History) всегда можно увидеть, что именно было создано, например номера изделий в экземпляре PLM.
AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Меню
Contents
Доступность функций

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

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

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

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

Contents