Releasing to a Workspace

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

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

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

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

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

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

  5. Upload Data – после подтверждения выпуска на предыдущем этапе автоматически выполняется следующий. Он просто показывает ход загрузки данных в ревизии соответствующих Data Items в целевом Workspace.

  6. Execution Report – это финальный этап процесса, предоставляющий сводку по выпуску. Даны ссылки навигации для быстрого перехода к сгенерированным ревизиям элементов (Item Revisions) в панели Explorer panel. Если вы открыли 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 Template, который хотите использовать (он отображается в форме <PLMInstance>:<PublishingTemplate>).

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

Online Stage 1 – Configure Server Release

На этом этапе процесса выпуска вы указываете тип(ы) данных, которые хотите сгенерировать. Data Items, которые можно выпустить:

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

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

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

Этап 1 процесса выпуска проекта — настройка того, что будет включено в выпуск (какие данные генерировать).
Этап 1 процесса выпуска проекта — настройка того, что будет включено в выпуск (какие данные генерировать).

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

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

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

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

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

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

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

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

Online Stage 2 – Validate Project

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

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

Если проверка прошла успешно, отображается значок с текстом Passed. Если нет — будет показан значок с текстом Failed.

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

Online Stage 3 – Generate Data

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

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

– ещё не запускалось/не сгенерировано.

– выполняется/генерируется.

– успешно сгенерировано.

– генерация не удалась.

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

Online Stage 4 – Review Data

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

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

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

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

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

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

Распространённый тест «готовности к выпуску», который используют многие разработчики, — сравнение Gerber-файлов, сформированных для текущего выпуска, с Gerber-файлами предыдущего выпуска. Нажмите ссылку Compare Gerber рядом с выходными данными Gerber и выберите предыдущий выпуск из выпадающего списка, чтобы сравнить подготовленные данные Gerber с данными выбранного выпуска. В браузере по умолчанию откроется ваш Company Workspace и будут показаны результаты.

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

Узнайте больше о функции Gerber Comparison (Altium 365 Workspace, Enterprise Server Workspace).

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

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

Если после просмотра данных вы понимаете, что нужно внести изменения, нажмите кнопку в правом нижнем углу. Появится диалог подтверждения, предупреждающий, что все сгенерированные данные будут потеряны — нажатие OK отменит выпуск, и вы вернётесь к этапу 1 процесса.

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

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

Подтверждение того, что будет выпущено (в терминах сформированных Item-Revisions), а также возможность изменить Name/Description и добавить примечания к выпуску.
Подтверждение того, что будет выпущено (в терминах сформированных Item-Revisions), а также возможность изменить Name/Description и добавить примечания к выпуску.

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

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

Этот этап лишь отражает прогресс загрузки сгенерированных данных в связанные Item-Revisions в Workspace.
Этот этап лишь отражает прогресс загрузки сгенерированных данных в связанные Item-Revisions в Workspace.

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

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

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

Используйте Navigation Links, чтобы быстро перейти к соответствующей ревизии элемента (Item Revision), содержащей выпущенные данные (Fabrication Data, Assembly Data и любые пользовательские наборы данных), в панели Explorer panel — вашем портале в Workspace.

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

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

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

Вот и всё — после выпуска проекта вы можете просто закрыть представление Release (кнопкой в правом нижнем углу). А когда в будущем потребуется повторно выпустить тот же проект, Project Releaser позволит сделать это быстро и легко, автоматически увеличивая целевые Item-Revisions.

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

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

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

Узнайте больше о Project History.

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

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

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

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

Диаграмма workflow для стандартного примера определения процесса Project Releaser with Publish
Диаграмма workflow для стандартного примера определения процесса Project Releaser with Publish

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

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

Project Releaser

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

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

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

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

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

Нажмите вкладку Diagram, чтобы увидеть базовый workflow процесса.

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

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

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

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

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

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

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

Content