Выпуск в Workspace

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

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

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

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

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

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

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

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

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

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

  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 требуются только при первой публикации в него. Затем они сохраняются в Workspace. После этого любая публикация данного проекта в тот же экземпляр PLM будет выполняться напрямую, в соответствии с заданным рабочим процессом и выбранным шаблоном публикации.
    Если публикация выполняется впервые и номера изделий на стороне PLM ещё не связаны с проектом Workspace, эти номера будут созданы в PLM и связаны с проектом при первоначальной публикации. Кроме того, в ходе публикации можно создавать записи для компонентов Workspace в экземпляре 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 — проверка возможных нарушений, связанных с элементами проекта или вариантами выбора компонентов в исходном документе BOM (*.BomDoc), при его наличии. — сравнение посадочных мест на плате с их исходной библиотекой для проверки их актуальности и соответствия.
  • 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, чтобы увидеть параметры варианта.

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

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

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

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

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

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

Публикация в экземпляре 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. Схема рабочего процесса показана ниже.

Это определение процесса нельзя активировать и использовать в исходном виде. Оно скорее служит «шаблоном»: отредактируйте его в соответствии с требованиями вашей компании, присвойте имя и сохраните как новое определение процесса, которое затем 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. Выберите нужный шаблон PLM (он отображается в виде <PLMInstance>:<PublishingTemplate>) и введите Username и Password для своего экземпляра PLM либо войдите с помощью SSO.

Если вы выбрали команду Prepare & Release & Publish to PLM, в итоге сразу откроется диалоговое окно Login Credentials. Выполнение Project Releaser не будет приостановлено на этапе Execution Report, и кнопка не появится.

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

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

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

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

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

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

Проверить состояние процесса публикации в PLM можно в браузерном интерфейсе Workspace, в представлении Activities на странице подробного управления проектом. Чтобы открыть эту страницу, выберите нужный проект на странице Projects браузерного интерфейса Workspace, нажмите элемент управления над списком проектов и выберите пункт 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