Design Project Release

Когда проект считается готовым к «вылету» в большой мир, его нужно выпустить (release) — процесс, важность которого часто недооценивают.

Без регламентированного и принципиально выверенного процесса выпуска отслеживание постоянно развивающегося продукта со временем может быть сопряжено с множеством подводных камней. Представьте, что вам нужно вернуться и выпустить предыдущую ревизию продукта — и вы обнаруживаете, что все необходимые исходные файлы проекта так и не были включены (в виде снимка) в тот выпуск! Ничего страшного; просто возьмите сгенерированные выходные файлы из соответствующей папки(папок) для этого выпуска — проверенные Gerber’ы и любую дополнительную информацию для изготовления и сборки; ведь по сути это и нужно. Но представьте, что эти «проверенные» выходные данные были перезаписаны или каким-то образом повреждены. Вот если бы процесс выпуска был более надежным.

Altium Designer отвечает на этот запрос, предоставляя мощное управление выпуском проектных данных с высокой целостностью. Процесс выпуска проекта автоматизирован, позволяя выпускать проекты без рисков, присущих ручным процедурам. При выпуске конкретного проекта создается снимок исходников проекта и архивируется вместе со всеми сгенерированными выходными данными — то есть с тем осязаемым продуктом, который изготавливается по этому проекту и продается компанией. Данные выпуска сохраняются в указанной папке/Zip на вашем жестком диске или в ревизиях соответствующего связанного с проектом Item в целевом Workspace:

• Source Data (PCB Project Design Item) — копия (снимок) основных файлов проекта с отметкой времени, включая все исходные документы. Выпускается в отдельный Item в Workspace, что позволяет хранить ценную интеллектуальную собственность отдельно от данных изготовления и сборки, необходимых внешним исполнителям для производства изделия.
• Fabrication Data (PCB Fabrication Data Item) — набор данных, необходимый производству печатных плат для изготовления «голой» платы (Gerber-файлы, файлы NC Drill и т. п.).
• Assembly Data (PCB Assembly Data Item) — набор данных, необходимый сборочному производству для монтажа указанных компонентов на «голую» плату в соответствии со спецификацией (Bill of Materials) (файлы Pick and Place, сборочные чертежи, BOM и т. п.). Для базового (полностью укомплектованного) исполнения и для каждого определенного варианта проекта (сборочные варианты) используется отдельный уникальный Item.

Сгенерированные данные проекта надежно хранятся в Workspace в виде ревизий связанных с проектом Items. Эти данные высокой целостности затем используются цепочкой поставок для изготовления требуемой ревизии продукта.

Итог — максимально возможный уровень целостности управления выпуском проектных данных. Под строгим контролем, резервным копированием и управлением версиями находится не только сам проект, но и его выпуски данных аналогичным образом в целевом Workspace — надежно, безопасно, защищенно.

Ключевые преимущества

• Интеграция с контролем версий. Если проект находится под управлением версий, система требует, чтобы перед выпуском все файлы были закоммичены и актуальны. Это гарантирует, что никакая «частная копия» важного проектного документа не останется на жестком диске инженера — с риском быть утерянной. Это простое правило может сэкономить многие часы в будущем, избавив от дорогостоящих поисков правильного набора проектных документов, по которым был сформирован выпущенный продукт.
• «Одноразовый выпуск» (one-shot releasing). Система позволяет выполнить выпуск только один раз в любую заданную ревизию целевого Item. Более того, успешный выпуск приводит к фиксации (сохранению) данных выпуска в указанной ревизии Item, после чего эта ревизия закрывается. Никакие дополнительные данные не могут быть сгенерированы и выпущены в ту же ревизию.
• Автоматизированный и повторяемый процесс выпуска. Выпуск «в одно касание» — без ручных этапов и рисков. От создания снимка проектных файлов, через валидацию и генерацию выходных данных — без взаимодействия с пользователем. Если какой-либо этап процесса не проходит, выпуск не выполняется. Вот и всё. При этом вы можете просмотреть все сгенерированные данные перед окончательной фиксацией данных выпуска в ревизии Item в целевом Workspace.

• Возможность валидировать проект как неотъемлемую часть процесса выпуска. Процесс выпуска работает с «заблокированным» снимком исходников проекта (включая зависимости), и предпусковая проверка почти наверняка уже была выполнена до запуска выпуска. Но для дополнительного спокойствия и обеспечения целостности проектных данных вы можете при необходимости добавить проверки валидации в «поток» процесса выпуска через соответствующим образом настроенные Output Job Configurations. Стандартные проверки ERC для исходных схем и DRC для PCB, а также возможность проверить синхронизацию исходного проекта и PCB и сравнить посадочные места на плате с их исходной библиотекой, чтобы убедиться, что они актуальны и совпадают. Выпуск будет прерван, если какие-либо проверки валидации не будут успешно пройдены.

  • При проектировании с подключенным Workspace и использовании компонентов Workspace в проекте можно добавить и настроить дополнительную проверку валидации — Component State Checking. Она выявляет компоненты, находящиеся в ограниченных состояниях. В рамках настройки вы определяете действие для каждого текущего состояния в каждом текущем определении жизненного цикла (lifecycle definition) в целевом Workspace: ничего не делать, выдать предупреждение или сформировать ошибку. Последний вариант предотвратит выпуск проекта. Кроме того, запуск проверки сформирует удобный отчет в формате HTML, позволяющий с первого взгляда увидеть, какие компоненты проекта находятся в недопустимых состояниях.
  • Также можно включить Environment Configuration Compliance Check. Это дает возможность однозначно проверить и принудительно обеспечить использование в проекте элементов данных, разрешенных компанией. Проще говоря, если вы используете элементы данных, не разрешенные конфигурацией среды, доступной для вашей назначенной роли, выпуск завершится неудачей. Это предотвращает «самодеятельный» подход к проектированию и обеспечивает соблюдение и соответствие рабочим средам проектирования, централизованно определенным на уровне предприятия. Подробнее см. Environment Configuration Management (Altium 365 Workspace,  Enterprise Server Workspace).
• Все сгенерированные файлы данных процесса выпуска могут при необходимости получать префикс с Item ID и Item Revision ID, что исключает неоднозначность относительно того, для какой ревизии какого Item должны использоваться данные при изготовлении.
• Публикация. Возможность публиковать данные выпуска напрямую из Workspace в общее хранилище, например Amazon S3, FTP-серверы, Box.com или простую сетевую папку. Это упрощает безопасный обмен данными Workspace без предоставления внешним сторонам доступа к самому Workspace.

Project Releaser

Altium Designer предоставляет мощное управление выпуском проектных данных с высокой целостностью благодаря Project Releaser. Благодаря интуитивно понятному интерфейсу вы можете одновременно сформировать все производственные данные для проекта — данные для изготовления, данные для сборки, исходники проекта и т. д. Project Releaser также позволяет генерировать сборочные данные сразу для нескольких обнаруженных вариантов (variants) вашего PCB-проекта. Вам даже не нужно беспокоиться, если вы не создали файлы Output Job — при необходимости он сделает это за вас!

С Project Releaser вы сможете генерировать производственные данные проще и с максимальной целостностью. Кроме того, вы сможете оценить результаты генерации до того, как зафиксируете выпуск окончательно (например, просмотрев Gerber/ODB++ данные в CAM-редакторе), чтобы убедиться, что сформированные данные — именно те, которые нужны для изготовления вашего проекта вовремя и с первого раза.

Предварительные условия для выпуска проекта в Workspace:

• Altium Designer подключен к Workspace, в котором размещен целевой репозиторий для выпуска.
• Проект включает подходящие Output Jobs — генераторы выходных данных проекта (для таких выходов, как печать, файл или PDF). Если OutJobs отсутствуют, Project Releaser предложит создать подходящий(е) Outjob(ы) для управления процессом.
• Проект, используемый процессом выпуска, содержит все необходимые элементы — исходные данные корректны и актуальны, у пользователя достаточно прав для выпуска этого проекта в Workspace и т. д.

Доступ к Project Releaser

Сам процесс выпуска выполняется с помощью Project Releaser Altium Designer, пользовательский интерфейс которого предоставляется через отдельное представление — Release view. Доступ возможен следующими способами:

• Выбрать команду Project » Project Releaser в главном меню (при открытом исходном документе нужного проекта как активном документе).
• Щелкнуть правой кнопкой мыши по записи нужного проекта в панели Projects panel и выбрать команду Project Releaser в контекстном меню.

Release view — пользовательский интерфейс для Project Releaser.

Публикация в PLM

Related page: Интеграция с PLM (Altium 365 Workspace, Enterprise Server Workspace)

Если у вас активирован процесс публикации в экземпляр PLM как часть Project Releaser, то он будет представлен в подменю Project Releaser для проекта. Запуск этого процесса добавит в представление дополнительный этап, предназначенный именно для этого.

Пример определения процесса Publish to PLM (User selects) доступен в вашем Workspace — как часть темы процессов Project Activities — для выполнения стандартной публикации (т. е. не публикации как части Project Releaser, как описано ранее). Этот процесс позволяет публиковать выпущенные выходные данные проекта в интегрированный экземпляр PLM, при этом пользователь может выбрать, какие именно выходные данные будут опубликованы. Диаграмма рабочего процесса показана ниже.

Диаграмма рабочего процесса для стандартного примера определения процесса Publish to PLM (User selects)

Процессы стандартной публикации в PLM доступны из Altium Designer через подменю Project » Project Activities для активного проекта.

Доступ к активированному процессу стандартной публикации выпущенных данных проекта Workspace в экземпляр PLM из Altium Designer.

В браузерном интерфейсе Workspace активированное определение процесса доступно на странице Projects. Выберите нужный проект, затем нажмите кнопку .

Режим/цель выпуска

Компонент Project Releaser поддерживает все типы проектов разработки — локальные/не находящиеся под контролем версий, находящиеся под управлением внешней VCS, или под нативным контролем версий подключенного Workspace — предлагая два режима работы:

• Managed (Online) Mode – выпуск всех сгенерированных данных в ревизии Items в целевом Workspace. Вам даже не нужно помнить об увеличении ревизий Item — система сделает это за вас. И если у вас определен процесс выпуска в экземпляр PLM через Project Releaser, запуск этого процесса добавит в представление дополнительный этап для выполнения этой операции.
• Unmanaged (Offline) Mode – выпуск всех сгенерированных данных в структуру на основе папок, которую при необходимости можно упаковать в один Zip-файл.

Компонент Project Releaser пытается автоматически определить, какой режим выпуска использовать и какова цель выпуска. Там, где возможен выбор — обычно когда проект был выпущен в один Workspace, а вы активно подключены к другому — система предоставит доступные вам варианты.

Определение файлов Output Job

Основной способ генерации выходных данных проекта в Altium Designer — использование набора доступных генераторов выходных данных (Output Generators), которые создают файлы данных и графику, необходимые для изготовления реального изделия — другими словами, печать схем и PCB, производственные файлы Gerber и NC Drill, ведомость материалов (BOM), файлы Pick and Place для сборки, производственные чертежи и т. д., которые требуются для изготовления и сборки изделия.

Выбранные генераторы выходных данных и конкретные выходные файлы, которые они создадут для проекта, в совокупности определяются с помощью Output Job Editor, который сохраняет конфигурации сопоставления «генератор → выход» в файле Output Job (*.OutJob) — создаваемом командой File » New » Output Job File.

Будучи основным механизмом коллективной генерации производственных файлов для проекта, Output Job в Altium Designer предоставляет следующие дополнительные возможности:

• К одному проекту можно добавить любое количество OutJob, чтобы конфигурации были доступны для конкретных задач, таких как генерация выходных данных для производства, сборки, архивирования, закупок и документации.
• Файлы OutJob фактически являются переносимыми и могут применяться к любому проекту, где требуется стандартизированный набор выходных данных. Например, выберите [Project] в качестве источника документа, а не конкретный файл проекта, чтобы создать универсальный (и, следовательно, переносимый) Output Job.
• OutJob могут включать файлы для проверок валидации проекта, таких как электрические проверки (ERC), проверки правил (DRC) и сравнение посадочных мест с источником. Таким образом, валидационные output job — это специализированный «активный» случай, когда проект проверяется, а фактический выход (например, PDF-документ) представляет результаты процесса валидации.
• OutJob поддерживают вариации собранной платы, когда для изготовления альтернативных версий проекта требуются разные наборы выходных файлов — например, стандартные или усиленные версии изделия, использующие дополнительные компоненты или другие типы. См. Design Variants для получения дополнительной информации о вариациях конструкции платы.
  Обратите внимание: Variant Choice, назначенный Output Job, не применяется, когда OutJob используется в процессе Project Release. В этом случае выбор Variant автоматически определяется и/или явно задается в самом Releaser.

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

• Для проекта разработки PCB:
  • Assembly.OutJob – со следующими определенными выходными данными:
    • Documentation Outputs: PCB 3D Print, Schematic Prints
    • Assembly Outputs: Generates pick and place files, Assembly Drawings
    • Report Outputs: Bill of Materials
    • Export Outputs: Export STEP
  • Fabrication.OutJob – со следующими определенными выходными данными:
    • Documentation Outputs: PCB Prints
    • Fabrication Outputs: Gerber Files, NC Drill Files, и IPC-2581
    • Validation Outputs: Design Rules Check, Footprint Comparison Report
    • Export Outputs: Save As/Export PCB

  Эти файлы Output Job по умолчанию берутся из следующей папки установки по умолчанию: \Users\Public\Documents\Altium\AD<Solution/Version>\OutputJobs.

• Для проекта разработки жгута:
  • Assembly.OutJob – со следующими определенными выходными данными:
    • Documentation Outputs: Draftsman
    • Report Outputs: Bill of Materials
    • Validation Outputs: Electrical Rules Check

  Этот файл Output Job по умолчанию берется из следующей папки установки по умолчанию: \Users\Public\Documents\Altium\AD<Solution/Version>\OutputJobs\Harness.

Определение вариантов (Variants)

Для проектов PCB важной возможностью Project Releaser является то, что он обнаружит определенные variants для вашего проекта и создаст наборы Assembly Data для каждого из них, готовые к выпуску. Каждый набор Assembly Data будет отображаться с (по умолчанию) именованием целевого item в виде:

PCBA-[ProjectName]-[VariantName]

Суффикс [VariantName] гарантирует, что при генерации данных из назначенных файлов OutJob будет использован правильный вариант.

Дополнительные наборы Assembly Data, созданные на основе обнаружения вариантов, определенных для проекта.

Процесс выпуска

Процесс выпуска — это поэтапный поток, при этом записи в левой части представления Release показывают вам «с первого взгляда», на каком этапе вы находитесь.

Чтобы узнать больше о процессе выпуска для онлайн-режима, см. страницу Releasing to a Workspace. Чтобы узнать больше о специфике офлайн-режима, см. страницу Releasing Locally.

Публикация выпущенных данных

Related page: Работа с направлениями публикации

Для выпущенных данных, сгенерированных из проекта разработки PCB (только PCB Fabrication Data, PCB Assembly Data и PCB Project Design Items), у вас есть возможность напрямую публиковать эти данные из вашего Workspace или Output Job в хранилище, например Box.com, Amazon S3, FTP-сервер или простую папку в общей сетевой локации. С точки зрения распространения и совместной работы это дает непревзойденное преимущество в мире, где участники общей «команды продукта» — команда разработки, команда производства и все остальные, вовлеченные в процесс превращения идеи в реальный продукт, — часто распределены по всему миру.

Публикация заключается в определении Publishing Destination и последующей загрузке выпущенных данных для требуемой ревизии Item в это назначение. От производственной площадки в Китае до команд разработки в Киеве, Stanstead Abbotts и Сан-Диего, и до руководителя проекта, летящего где-то над Тихим океаном — всех, кому нужно знать о новом выпуске, можно пригласить по ссылке на опубликованную папку: общий (и контролируемый) доступ для просмотра, обсуждения и использования данных, на основе которых будет изготовлен Item.

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

Глобальный обмен данными производственного пакета

Ключевой аспект проектов, хранящихся в Workspace Altium 365, — возможность создавать и делиться релизом Build Package с другими. Если поделиться им напрямую с вашим производителем, его можно рассматривать как Manufacturing Package, поскольку это пакет, который производитель может просматривать, скачивать и использовать для изготовления и сборки платы.

Для поддержки возможности делиться таким пакетом с другими и с вашим производителем (который обычно находится вне вашей организации) платформа Altium 365 предоставляет выделенный Manufacturing Package Viewer — элемент поддержки Global Sharing платформы — который позволяет другим просматривать производственный пакет из любого веб-браузера — из любой точки мира — но вне вашего Workspace, чтобы сами ваши проекты и другая ценная интеллектуальная собственность оставались недоступными.

Каждый пользователь, с которым поделились, получит приглашение по электронной почте со ссылкой для просмотра производственного пакета через Manufacturing Package Viewer. Общие производственные пакеты отображаются на странице Shared with Me в браузерном интерфейсе платформы Altium 365.

Сам Manufacturing Package Viewer позволяет ключевым участникам — и прежде всего производственному персоналу — видеть сводный обзор проекта с ключевыми данными по плате, а также просматривать структуру исходных данных, данных для изготовления и сборки (и при необходимости скачивать любой отдельный файл). Также доступны подстраницы просмотра данных Fabrication, Assembly и BOM; при этом на странице Fabrication представлен Gerber Viewer и предусмотрена возможность добавлять комментарии всем пользователям, которым был открыт доступ к пакету.

В итоге производственный персонал может скачать Build Package просмотренного релиза — с любой страницы Viewer — чтобы физически реализовать эту ревизию платы.

Производственный пакет, которым с вами поделились, доступен со страницы Shared with Me. Человек, который поделился с вами производственным пакетом, получит приглашение по электронной почте для доступа к этому пакету через Altium 365. После нажатия кнопки  в письме он будет перенаправлен на страницу Altium 365 Sign In (если он уже не вошёл в платформу или в свою учётную запись AltiumLive). После входа он попадёт в Manufacturing Package Viewer, где пакет будет загружен. Если у человека нет учётной записи AltiumLive, сначала потребуется зарегистрировать её — ссылка доступна на странице Altium 365 Sign In.

Web Viewer

Related page: Web Viewer (Altium 365 Workspace, Enterprise Server Workspace)

Интерфейс Web Viewer Workspace обеспечивает универсальный доступ к документам PCB-проекта через стандартный веб-браузер. Это гораздо больше, чем просто веб-просмотрщик: Web Viewer's передовые браузерные технологии позволяют пользователям перемещаться по структуре проекта, взаимодействовать с проектными документами, извлекать информацию об элементах в проекте и выделять области или объекты для добавления комментариев.

При просмотре документов визуальное качество схем и печатных плат не ухудшается из‑за веб-формата; также доступны полноценные панорамирование и масштабирование, а также поиск, кросс‑пробинг, выбор и инспектирование компонентов и цепей (nets) по всему проекту.

Интерфейс Web Viewer Workspace обеспечивает глубокий и интерактивный опыт ревью, например, исходных документов схемы и PCB в вашем проекте. Здесь показана схема в интерфейсе Web Viewer Altium 365 — наведите курсор на изображение, чтобы увидеть PCB (в 3D).

Как независимая браузерная платформа просмотра, интерфейс Web Viewer предоставляет интерактивный доступ «только для чтения» к проектным документам без необходимости открывать проект в среде редактирования. Другие участники, работающие над проектом, например инженер, который им «владеет», не будут затронуты действиями в пространстве Web Viewer — за исключением связанных уведомлений о комментариях.