Управление проектами из Altium NEXUS

Главная страница: Управляемые проекты

Говоря кратко, управление проектами (Project management) сосредоточено на безопасном хранении и отслеживании изменений на протяжении всего процесса проектирования и, в конечном итоге, на передаче завершенного проекта производителю для создания физического элемента, такого как собранная печатная плата, которая будет использована в конечном продукте. Чтобы удовлетворить эти потребности, Altium NEXUS предлагает ряд подходов к управлению проектами, которые могут обеспечить продуктивность при растущем уровне сложности, но при этом упрощают процесс с точки зрения разработчика. Существуют разные виды инструментов, от локального хранилища файлов и управления проектами, до локального/удаленного хранилища с системой контроля версий (VCS), а так же до его расширенной и рекомендованной версии, в которой управление проектными данными осуществляется благодаря возможностям сервера Altium Workspace.

Подключенное рабочее пространство Altium Workspace и его встроенная система контроля версий, хранит проекты Altium NEXUS и управляет ими, а также обеспечивает упрощенные операции по контролю версий проекта, встроенные возможности совместной работы при проектировании, расширенный обмен проектными данными, отслеживание истории проекта, управление его жизненным циклом и многое другое. Доступ к проектам в Workspace может быть осуществлен прямо из Altium NEXUS, так же как с помощью панелей Projects или Explorer, а так же из самого Workspace через интерфейс браузера.

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

В этом документе рассмотрена работа с управляемыми проектами в Altium NEXUS, в том числе:

• Создание проекта – непосредственное создание или преобразование существующего неуправляемого проекта для доступа к нему онлайн.
• Публикация проекта – изменение прав доступа к проекту, чтобы нужные пользователи могли видеть проект и работать над ним.
• Открытие проекта – для возможности работать над ним.
• Клонирование проекта – для быстрого получения идентичной копии проекта без необходимости создания проекта с нуля, если следующий проект должен быть очень похожим на предыдущий.
• 'Мягкое' Удаление проекта – удаление всего проекта в хранилище Workspace Trash, в котором существует возможность окончательного удаления проекта или его восстановления на прежнем месте.
• Комментирование проекта – размещение заметок с тегами в документе, который хранится в Workspace. Они будут доступны для просмотра всем у кого есть доступ к документам проекта.
• Выпуск проекта – отправка проекта в виде комплектов данных для производства в присоединенный Workspace. Ими можно делиться с другими пользователями, например с вашей службой организации производства и сборки проектов печатных плат.
• Просмотр истории проекта – изучение временной шкалы основных событий, связанных с проектом: его создание, фиксации, выпуски, клонирования и обмены данными с MCAD-системой, с поддержкой различных действий, где это применимо.

Создание проекта

Существует два способа создания управляемого проекта из Altium NEXUS:

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

Типы создаваемых проектов

Проект печатной платы

В проекте печатной платы (PCB project), электрические цепи определяются документом схемы (Schematic), созданном с помощью библиотек символов компонентов. На схеме эти компоненты размещаются и соединяются в соответствии с замыслом разработчика.

Данные проекта передаются в редактор печатных плат (PCB editor) в котором каждый компонент представлен в виде посадочного места (Footprint) и соединения цепей превращаются в проводники на печатной плате. Определяется форма окончательной печатной платы, а также физические слои, которые она будет содержать. Правила проектирования определяют требования к компоновке, такие как ширина проводников и зазоры. Компоненты размещаются внутри границ платы, а затем соединительные линии заменяются топологией, вручную или автоматически.

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

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

Многоплатный проект

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

Многоплатный проект (*.PrjMbd) эффективно определяет электрические и физические связи между существующими проектами печатных плат посредством применения специального документа схемы (*.MbsDoc ) и синхронизированного документа сборки (*.MbaDoc).

► Узнайте больше о Многоплатных проектах.

Интегрированная библиотека

Интегрированная библиотека создается в проекте пакета библиотек (*.LibPkg), где схемные символы созданы с использованием Schematic Library (*.SchLib), а перекрестные ссылки определяют связи с другими типами моделей. В качестве таких связанных моделей могут выступать Посадочные места (Footprints), модели имитатора цепей, модели для определения целостности сигнала, а так же 3D модели.

Файлы в которых содержатся эти модели (PCBLibs, например) добавляются в файл Интегрированного пакета библиотек (*.LibPkg), или должны быть определены пути их точного расположения. Затем исходные библиотеки схемных символов и необходимые модели компилируются в один файл (*.IntLib), который называется Интегрированной библиотекой (Integrated Library).

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

► Узнайте больше о Управляемых компонентах.

Проект скрипта

Скрипт (*.pas) содержит набор инструкций (автоматических команд) которые интерпретируются при выполнении в Altium NEXUS. Скрипты пишутся и проходят отладку в единой среде встроенного редактора.

Существует два типа скриптов – "script units" и "script forms". Units - могут использовать программный интерфейс приложения X2 (API) для изменения или управления объектами проекта в документе проекта. Forms - содержат элементы управления в качестве пользовательского интерфейса и используют X2 API для создания диалоговых окон сценариев, которые действуют на активные документы проектов.

Script units, script forms и модели данных содержатся в проекте скрипта (Script project) (*.PrjScr).

В следующих разделах эти два способа создания проекта  рассмотрены подробнее.

Обзор диалогового окна Create Project

Новый управляемый проект может быть создан в Altium NEXUS с помощью диалогового окна Create Project (File » New » Project):

Определение настроек в диалоговом окне Create Project для создания нового управляемого проекта из Altium NEXUS. Обратите внимание, что опции Advanced будут заданы соответствующим образом по умолчанию.

1. В списке Locations выберите ваш Workspace (будет отображено его название). Вы должны быть подключены к Workspace, чтобы увидеть его в списке. Это целевой сервер, в котором будет хранится новый управляемый проект.
2. В списке Project Type выберите тип проекта, который вы хотите создать, и выберите нужный шаблон из доступных. Если существуют шаблоны проектов, созданные и выпущенные в Workspace, только они будут отображены в качестве доступных для выбора. При выборе строки <Empty> будет создан пустой проект без исходных документов.
3. Введите название проекта (Project Name) и, если необходимо, описание (Description).

• Название проекта должно начинаться с A-Z, a-z или 0-9, и может содержать эти символы. Допустимы подчеркивания, дефисы и пробелы, но пробелы могут быть только в середине имени (пробелы в начале и в конце будут игнорироваться). Вы не можете использовать следующие слова: AUX, COM1-COM9, LPT1-LPT9, CON, NUL и PRN. Кроме того, имя не может содержать следующие символы: \ . / ? % * : | " < >.

Помимо этого, диалоговое окно Create Project содержит следующие настройки:

• Включите опцию Version Control (включена по умолчанию) для применения к проекту всех возможностей системы контроля версий, таких как ведение истории проекта и расширенные возможности совместного доступа. Когда эта опция отключена, проект будет просто сохранен в Workspace и синхронизирован с его локальной копией – 'зеркальным проектом в формате Simple Sync. ►. Подробнее.

• Опция Version Control доступна только при подключении к Altium 365 Workspace. Для Workspace, расположенного на локальном сервере Altium Concord Pro, эта опция так же работает.

• Нажмите на кнопку Advanced чтобы определить пути к папкам.
  • Используйте поле Folder чтобы определить где будет находиться папка с проектом – структура разделов в Workspace, будет создана автоматически. Путь к новым проектам по умолчанию определяется на странице Admin – Settings – Projects интерфейса Workspace в браузере (по умолчанию это Projects\<ProjectName>). Нажмите на кнопку для просмотра и выбора другой папки на сервере, если это необходимо.
  • Используйте поле Local Storage чтобы указать, где на вашем жестком диске будет храниться локальная версия проекта. Местоположение по умолчанию определено на странице System – Default Locations диалогового окна Preferences. Нажмите на кнопку для просмотра и выбора другого расположения, если это необходимо. Это 'рабочая' папка вашего проекта и локальный  репозиторий Git в который выполняется фиксация (коммит) проекта. В конечном итоге или во время коммита проект, отправляется в централизованное хранилище данных Workspace на сервере (Versioned Storage), которое является удаленным Git репозиторием.
• Используйте область Parameters чтобы добавлять и удалять пары параметров Name/Value созданные по-умолчанию, которые связаны с проектом и сохраняются в Workspace. Используйте кнопку чтобы добавить новую Name/Value пару параметров в список. Эти управляемые параметры проекта сохраняются в Workspace вместе с новым проектом и могут редактироваться прямо в Workspace. Напротив, параметры типа Project type сохраняются в файле проекта (*.PrjPcb), и могут меняться из Altium NEXUS. Оба типа параметров могут быть использованы в виде специальных строк в Altium NEXUS – и доступны в панели Properties с размещенной текстовой строкой выбранной в области проектирования. Параметры, определенные для проекта, также можно просмотреть на вкладке Parameters диалогового окна Project Options (Project » Project Options).

Когда настройки проекта заданы нужным образом, нажмите кнопку . Структура нового проекта будет создана в указанных локальной и удалённой (в Workspace) папках. Проект будет открыт на панели Projects, где будет отражено полностью синхронизированное состояние между файлами в удаленном репозитории (в Workspace) и в локальном репозитории (в рабочей копии) – это так же будет отображено соответствующими иконками . Если проект создан с выключенной опцией Version Control (доступно только в Altium 365 Workspace), зеркальный проект будет показан на панели Projects с соответствующей иконкой .

Вновь созданный проект для которого выполнена фиксация (коммит) в проектный репозиторий Versioned Storage вашего Workspace.

Настройки проекта (Project options)

Существующий или вновь созданный Проект зависит от ряда настроек (Project options), которые относятся именно к этому проекту. Они хранятся в файле проекта (например, *.PrjPcb) и будут меняться в зависимости от типа проекта. Обратите внимание, что Параметры сервера (Server Parameters) хранятся вместе с проектом в Altium Workspace.

Эти настройки можно изменить в диалоговом окне Project Options, в которое можно попасть с помощью вкладки главного меню Project » Project Options, или нажав ПКМ на имени проекта на панели Projects и выбрав Project Options из контекстного меню.

Другие настройки проекта которые определяются в других диалоговых окнах так же хранятся в файле проекта:

• Настройки аннотации схемы.
• Настройки выходных файлов; отчеты, настройки печати, Gerber файлы, и т.д. Обратите внимание, что это параметры выходных документов, доступ к которым осуществляется через меню редактора схемы или платы, а не параметры, определенные в документе OutJob.

Группы проектов

В Altium NEXUS вы можете открывать и редактировать множество проектов, и если требуется, сохранять комплект проектов в виде Группы проектов (Project Group) ( *.DsnWrk).

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

Работа с набором связанных проектов как с группой проектов.

Преобразование существующего проекта для онлайн-доступа

Вы также можете преобразовать существующий неуправляемый проект (локальный проект или проект, находящийся под управлением внешней системы контроля версий) для доступа к нему в Workspace – как простую зеркальную копию проекта (Simple Sync) в Altium 365 Workspace, или как проект в Workspace под управлением встроенной системы контроля версий Git. Это позволяет вам воспользоваться функциями управления проектами и совместной работы, доступными через Altium Workspace, а если для проекта включена встроенная в Workspace функция контроля версий (Version Control), воспользоваться дополнительными функциями платформы, такими как отслеживание истории проекта и расширенные возможности обмена проектами.

Для этого откройте существующий неуправляемый проект как обычно в Altium NEXUS, затем нажмите ПКМ на его названии на панели Projects и выберите Make Project Available Online из контекстного меню, это даст вам доступ к диалоговому окну Make Available Online. При использовании Workspace на базе локального сервера, например Altium Concord Pro, команда Make Project Available on Server откроет диалоговое окно Make Available On Server.

Преобразование существующего проекта для доступа к нему через Workspace – по сути, "регистрация" проекта в Workspace и создание его зеркальной копии.

Используйте диалоговое окно Make Available Online, чтобы изменить название (Name) проекта и добавить его описание (Description). По умолчанию будет задано то же название, что и у изначального проекта.

Включите опцию Version Control чтобы поместить проект под контроль встроенной в Workspace системы контроля версий (Git). Если опция выключена (только для Altium 365 Workspace), файлы проекта просто будут храниться в репозитории Workspace для обеспечения доступа и возможности обмена проектами с другими членами команды только для просмотра и комментирования –  размещение по принципу простой синхронизации (Simple Sync). Рекомендуется включать контроль версий, поскольку в этом случае у вас будет доступ ко всем функциональным возможностям, предлагаемым Workspace и платформой Altium 365.

Перейдите по ссылке Advanced, чтобы отобразить поле Folder. Это поле используется для определения того, в какой папке в структуре Workspace должна быть создана зеркальная копия проекта. Путь по умолчанию для новых проектов указан на странице Admin - Settings - Projects веб-интерфейса Workspace (по умолчанию это путь Projects\<ProjectName>). Нажмите кнопку для выбора другой папки на сревере, если это необходимо.

Когда свойства передачи проекта определены в диалоговом окне Make Available Online нужным образом, нажмите OK. Проекты, которые стали доступны онлайн через Workspace, будут отображены в панели Projects в Altium NEXUS следующим образом:

• (Только для Altium 365 Workspace) Для проекта который не находится под контролем внешней системы контроля версий и который размещен онлайн контроль версий не выполняется, проект показан только с иконкой . Это значит что проект был зарегистрирован в Workspace, что существует зеркальный проект, и что оба они синхронизированы с использованием Simple Sync. Сохраненные локальные файлы автоматически синхронизируются с их копиями в зеркальном проекте в Workspace.

• (Только для Altium NEXUS Workspace) Проект под контролем внешней системы контроля версий, отображается с иконкой чтобы показать что проект зарегистрирован в Workspace, что существует зеркальный проект, и что оба они синхронизированы с помощью методологии Simple Sync. Связанные иконки отображают полностью синхронизированное состояние между внешним проектным репозиторием и локальной рабочей копией. Как только сохраняются изменения в локальном файле и выполняется их коммит/передача во внешний проектный репозиторий, эти изменения автоматически синхронизируются с их зеркальными проектными копиями в Workspace.

• Для проекта, который не находится под внешним контролем версий и когда он доступен онлайн (в Altiium 365 Workspace, опция Enable Formal Version Control была включена), для проектов и файлов будет выполнен коммит и они будут переданы в проектный репозиторий Workspace с встроенным контролем версий (Versioned Storage). Панель Projects будет отражать полностью синхронизированное состояние, которое существует между репозиторием проекта в Workspace и локальным репозиторием (рабочей копией), что показано с помощью соответствующих иконок . Проект становится по-настоящему "управляемым" – не просто зарегистрированным в Workspace, но проектом для которого был выполнен коммит и для которого осуществляется встроенный в Workspace контроль версий. Любые изменения в проекте будут схранены в репозитории Workspace (коммит/выпуск).

Работа с GitHub

Использование платформы GitHub в качестве внешней системы контроля версий – это распространенный способ хранения и публикации проектов, и его легко интегрировать в Altium 365 Workspace с помощью Altium NEXUS. Как описано выше, существующая внешняя система контроля версий синхронизируется с Altium 365 Workspace, что позволяет использовать преимущества его эффективных возможностей управления данными и совместной работы.

То, как вы сами обычно работаете с GitHub, зависит от применяемых в компании практик или от средств Git, которые есть у вас под рукой. Как правило, проект создается в локальном репозитории Git, после чего он передается в репозиторий GitHub (удаленный), либо существующий проект клонируется в локальный репозиторий из GitHub. Когда проект находится в локальном репозитории Git, можно открыть проект в Altium NEXUS - программное обеспечение опознает и будет использовать локальный или удаленный репозитории GitHub.

Когда зеркальная копия проекта на базе Git становится доступной в Altium 365 Workspace (Make Project Available Online), вы можете управлять проектом и работать с ним как с любым другим управляемым проектом, который содержится в Workspace. В этом случае, Workspace по-прежнему предоставляет все преимущества системы управления проектами и прозрачно взаимодействует с GitHub для выполнения ключевых действий системы контроля версий: фиксация, отправка, извлечение и т.д. Altium NEXUS запросит ваши учетные данные GitHub и сохранит их для последующего взаимодействия с GitHub.

Протоколы GitHub

Хотя существует ряд протоколов передачи данных, предлагаемых системой контроля версий Git, на текущий момент Altium NEXUS поддерживает только протокол HTTP/HTTPS для подключений к локальным репозиториям Git и его удаленным главным репозиториям. На практике, применяемый протокол задается URL-префиксом, указанным для подключения к удаленному репозиторию – https://<удаленный репозиторий>, ssh://<удаленный репозиторий>, git://<удаленный репозиторий> и т.п.

GitHub поддерживает как протокол SSH, так и HTTPS, и для подключений рекомендуется использовать URL-адреса HTTPS.

► Для получения более подробной информации перейдите на страницу Какую удалённую ссылку мне использовать? на GitHub.

Если ваша внешняя система контроля версий подключена с помощью протокола, отличного от HTTPS, такого как SSH-соединение GitHub, это будет задано в репозитории, клонированном из удаленного репозитория. Поскольку этот протокол несовместим с Altium NEXUS, то при попытке интегрировать проект с Altium 365 Workspace будет выдано сообщение об ошибке. Если вы не уверены в протоколе удаленного URL, который используется для локального репозитория Git, это можно проверить с помощью команды git remote - v.

Используйте интерфейс командной строки Git Bash для проверки настройки удаленного URL репозитория.

Репозиторий можно перенастроить для использования другого URL, например, использующего протокол HTTPS, для совместимости с Altium NEXUS с помощью команды git remote set-url <название> <URL>, где префикс URL указывает тип протокола.

Изменение протокола подключения к URL удаленного репозитория и последующее подтверждение с помощью удаленной команды.

Совместное использование проекта

Связанная страница: Совместное использование проекта из Altium NEXUS

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

ul>

• Владелец проекта, которым обычно является разработчик, создавший его (или сделавший его доступным в Workspace): с полными правами доступа (чтение/запись).
• Группа (роль) Администраторов: с полными правами (чтение/запись).

Элементы управления для публикации проекта из Altium NEXUS находятся в диалоговом окне Share, вызов которого осуществляется следующими способами:

• Для активного проекта – по нажатию кнопки в правом верхнем углу главного окна приложения или выбрав команду Project » Share из главного меню.
• Для выбранного на панели Projects panel проекта – щелкнув правой кнопкой мыши запись этого проекта, а затем выбрав команду Share из контекстного меню.

Если активного проекта нет, т.е. в данный момент не открыто какого-либо документа проекта, кнопка сработает для проекта, который в данный момент находится в фокусе в панели Projects.

Открытие диалогового окна Share – центра управления публикацией проекта из Altium NEXUS.

Поддерживаются следующие уровни публикации из Altium NEXUS:

• Share Project – поделитесь фактическим проектом на стадии разработки с другими членами вашей рабочей группы, если это необходимо. Используйте элемент управления доступом
• для определения прав доступа (Can View по-умолчанию). Просматривайте и комментируйте в Altium NEXUS или в интерфейсе Workspace. Используйте меню кнопки  чтобы установить права доступа к проекту для добавленных пользователей. Редактировать можно только через Altium NEXUS.

• При подключении к Workspace на платформе Altium 365, Вы также можете поделиться активным проектом на стадии разработки с теми, кто не входит в вашу команду, например, с внешними подрядчиками, без получения ими доступа ко всему вашему Workspace или проектным данным. Приглашенный пользователь должен быть зарегистрирован в AltiumLive и иметь доступ к общему проекту со своего Персонального пространства Altium 365 (или с помощью Workspace вашей организации, если имеется), или открыть его в клиенте Altium NEXUS для редактирования.

• Altium NEXUS предоставляет дополнительные функции, которые упрощают совместную работу над проектом с помощью использования инструментов Workspace, в том числе Комментирование документов и Предотвращение конфликтов при совместном проектировании.

• Snapshot on the Web – статический снимок проекта в определенный момент времени, которым можно поделиться с другими, возможно, для проверки проекта или, возможно, с производителем для оценки стоимости. Поддерживается два варианта обмена:
  • По ссылке –доступно любому через веб-браузер. Использование диалогового окна «Общий доступ» для совместного использования на этом уровне не требует ни активной подписки на лицензию Altium NEXUS, ни регистрации в AltiumLive. Получатель ссылки использует автономный просмотрщик Standalone Altium 365 Viewer чтобы просматривать (но не комментировать) проект через свой браузер. Просмотр не требует регистрации в AltiumLive, ссылка доступна в течение 48 часов.
  • С конкретными людьми – доступен для указанных людей через приглашение по электронной почте. Использование диалогового окна Sharing для совместного использования на этом уровне требует регистрации в AltiumLive, но не требует активной подписки и лицензии Altium NEXUS. Получатель ссылки получает доступ к моментальному снимку проекта через интерфейс Web Viewer платформы Altium 365 по приглашению в электронном письме. Для просмотра требуется регистрация в AltiumLive, но снимок доступен постоянно. Комментирование проекта так же доступно.

Открытие проекта

Для работы над управляемым проектом вы, по сути, извлекаете его в виде локальной рабочей копии. Это выполняется непосредственно из Altium NEXUS с помощью команды File » Open Project. Остальное зависит от того, являетесь ли вы участником команды Workspace либо проект был опубликован вам извне команды Workspace:

• Член команды Workspace – появится диалоговое окно Open Project, откуда вы сможете выбрать, какой управляемый проект открыть из подключенного Workspace (при подключении к Workspace, запись с его названием появится в области диалогового окна Locations, с иконкой, появляется с именем Workspace). В списке будут перечислены только те управляемые проекты, к которым вам предоставили доступ (или к которым у вас есть разрешение на доступ).

• После открытия проект появится под записью Workspace на панели Projects.
• 
• Выберите тот, который можно открыть из подключенного Workspace прямо в Altium NEXUS, из списка тех, которыми с вами поделились на данный момент.
• У вас есть возможность открыть проект по пути извлечения по умолчанию или использовать выпадающее меню чтобы указать собственный путь. Путь извлечения по умолчанию определяется как свойство репозитория проекта, в котором он находится. Для репозитория Git (например репозитория Versioned Storage встроенного в Workspace), это поле Local Path которое можно найти в диалоговом окне Git Repository. Для репозитория SVN, это поле Default Checkout Path которое можно найти в диалоговом окне SVN Design Repository. Получите доступ к диалоговому окну Properties, выбрав запись для репозитория – на странице Управление данными – Проектные репозитории диалогового окна Preferences – и по нажатию кнопки .
• Выберите вариант открытия проекта в виде копии (Project As Copy) чтобы создать клонированную версию проекта под другим именем.
• При просмотре проекта с помощью панели Explorer в Altium NEXUS, нажмите на кнопку , в правой верхней части панели, чтобы открыть проект в  Altium NEXUS (добавить его на панель Projects).

• Приглашенные заинтересованные лица, вне команды вашего Workspace – появится диалоговое окно Open Project, откуда вы можете получить доступ к любому управляемому проекту, к которому вам предоставили доступ из расположения Shared With Me.

• После открытия, проект появится под записью Shared with me, на панели Projects. То, что вы можете делать с проектом, зависит от предоставленных вам прав доступа. Если вам были предоставлены права на редактирование, вы сможете редактировать проект в обычном режиме, так обычно происходит в случае найма внешнего подрядчика. Если у вас есть права только на просмотр, вы сможете комментировать проект на стадии разработки.
• Проекты, доступные в разделе Shared With Me это те проекты, для которых было предоставлено ваше имя для входа (ваша учетная запись AltiumLive) из Altium 365 Workspace. Обратите внимание, что Altium NEXUS не нужно подключать к Workspace для доступа к общим проектам.
• 
• Выберите, какой управляемый проект открыть в Altium NEXUS, из тех, которые в настоящее время доступны вам как внешнему заинтересованному лицу. Обратите внимание, что доступ к таким проектам осуществляется без доступа к Workspace.

У вас есть возможность открыть проект по пути извлечения по умолчанию или использовать выпадающее меню чтобы указать собственный путь. Путь по-умолчанию берётся из поля Document Path на странице System – Default Locations диалогового окна Preferences.

Клонирование проекта

Чтобы клонировать управляемый проекта из Altium NEXUS, щелкните ПКМ по строке проекта в панели Projects и выберите команду Clone из контекстного меню. Используйте диалоговое окно Clone Project, чтобы задать название проекта (Project Name), описание (Description, не будет заполнено автоматически), путь к папке в Workspace (Folder) и путь локального хранения рабочей копии (Local Storage).

Клонирование управляемого проекта из Altium NEXUS.

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

Работа с документами проекта

После того, как проект создан, документы могут быть в него добавлены, отредактированы или удалены. Эти операции можно выполнять на панели Projects, которая обеспечивает упорядоченное представление структуры проекта и составляющих его документов. Контекстные меню панели, вызываемые правой кнопкой мыши, предлагают большое количество команд, необходимых для работы с проектными документами.

► Для получения более подробной информации перейдите на страницу панели Projects.

Обратите внимание на то, что отображение документов на панели Projects не отражает того, хранятся они на жестком диске или где-то еще. Содержимое панели можно рассматривать как логическое представление проекта, тогда как физическое расположение и организация хранилища файлов документов (и его тип) зависят от вас — документы могут храниться в папке на вашем локальном компьютере или в локальной сети и, конечно же, размещаться в репозитории с контролем версий, предоставляемом системами Git/SVN или полностью управляемой системой, такой как Altium Worskpace.

► Смотрите страницу панели Storage Manager для получения более подробной информации по управлению проектными документами с точки зрения традиционного хранения файлов.

Подробнее о работе с документами проекта

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

[blank]	Closed – Документ не открыт.
	Open – Документ открыт в виде вкладки в окне редактора проекта.
	Hidden – Документ скрыт (открыт, но не отображается в Workspace).
	Modified – Документ открыт и изменен (еще не сохранен).
	Modified (project) – Этот значок появляется рядом с основным документом проекта, чтобы показать, что его структура была изменена (еще не сохранена).

► Смотрите раздел Значки состояния документов на странице панели Projects для получения более подробной информации об иконках статуса документов.

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

Добавление документов в проект и их удаление

Самый простой способ добавить в проект новые или существующие проектные документы — щелкнуть правой кнопкой мыши по имени проекта на панели Projects и выбрать из контекстного меню Add New to Project или Add Existing to Project. 

Добавление определенного или другого типа документа в проект.

В проект также могут быть добавлены другие типы документов, относящихся к проекту, например текстовые файлы, PDF-файлы, электронные таблицы и т. д. Для этого используйте вариант Add Existing to Project,  из выпадающего меню диалогового окна Choose Document to Add  выберите тип файла All Files (*.*) чтобы получить доступ к файлам всех типов .

Чтобы удалить документ из структуры проекта, нажмите правой кнопкой мыши на его название на панели Projects и выберите в меню Remove from Project. Обратите внимание на то, что это действие удаляет ссылку проекта на этот документ и не удаляет сам файл исходного документа.

Изменение порядка документов в проекте

Документы на панели Projects автоматически распределяются по логическим группам или «папкам», таким как исходные документы (Схема, Плата и т. д.), Документы настроек (Harness, Outjob и т. д.). Документы в каждой группе папок отображаются по умолчанию в том порядке, в котором они были добавлены, но их можно перетаскивать на новое место.

В случае нового иерархического проекта родительско-дочерние отношения между документами будут отображаться на панели Projects. Обратите внимание, что отношения связности нельзя определить путем перетаскивания документов схемы, поскольку соединения между листами и иерархия проекта фактически определяются обозначениями листов и определениями портов.

► Дополнительные сведения об иерархии проектов см. в разделах Создание связей в проекте и Net Identifier Scope вкладки Options диалогового окна Project Options.

Передача документов между проектами

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

Хотя это может быть удобным способом повторного использования установленных проектных документов, например, включая стандартную схему источника питания в нескольких проектах, такой подход не рекомендован к использованию, поскольку изменение документа повлияет на все проекты, с которыми он связан. Гораздо лучшим подходом к повторному использованию проекта будет, задание и применение управляемых листов (Managed Sheets).

► Для получения дополнительной информации о повторном использовании проектной документации и управляемых листов, смотрите страницу Управляемые листы.

СОхранение копии документа

Открытый документ проекта можно сохранить под новым именем с помощью команды File » Save As, которая создаст копию файла документа под новым именем. Этот процесс автоматически добавляет (связывает) новую копию документа с активным проектом вместо существующего (исходного) документа, который остается нетронутым в исходной папке. Если открытый документ не является частью проекта — свободный документ — новая копия просто открывается в редакторе вместо исходного документа.

Если вы хотите просто сделать резервную копию документа, используйте вариант Save Copy As. Эта команда создает переименованную копию файла документа, не затрагивая основной проект.

Если вы хотите переименовать документ, см. следующий раздел.

Переименование файлов проекта

Вы можете напрямую изменить имя проекта платы (*.PrjPcb) или любого из составляющих его файлов (*.PcbDoc, *.SchDoc, и т.д.) используя команду Rename – которая доступна из контекстного меню по нажатию ПКМ по проекту на панели Projects.

Примеры локального переименования проекта и одного из его файлов в Altium NEXUS. Эти изменения будут синхронизированы с Workspace при сохранении и отправке изменений в Workspace.

Выполнив переименование, сохраните изменения в Workspace с помощью команды Save to Server (доступной из того же контекстного меню проекта). Синхронизация переименования файлов поддерживается между локальной рабочей копией проекта и ее аналогом в Workspace. Кроме того, когда имя файла проекта было переименовано и проект сохранен на сервере, Workspace автоматически изменяет параметр имени (Name) управляемого проекта, чтобы он соответствовал.

И наоборот, когда имя управляемого проекта обновляется через интерфейс браузера Workspace, изменение распространяется на Altium NEXUS при следующем открытии проекта.

Чтобы отредактировать свойства существующего управляемого проекта в Workspace, выберите его наименование на странице Projects, нажмите на кнопку  над списком проектов и выберите команду Edit в соответствующем меню. Измените название проекта в появившемся окне Edit Project.

Когда обновленный проект открывается в Altium NEXUS (File » Open Project), стартовое диалоговое окно предоставляет возможность сделать одинаковыми имя локального файла проекта и новое имя проекта или принудительно привести имя проекта сервера в соответствие с существующим именем файла проекта.

Параметры доступны, если вы переименовали проект на стороне Workspace.

Рабочая копия проекта в Workspace, разрешение на синхронизацию проекта

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

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

Варианты возврата к синхронизации, если вы вручную изменили расположение локальной рабочей копии проекта.

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

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

Мягкое удаление

Доступна гибкая функциональность для удаления управляемых элементов дизайна, таких как проекты, компоненты и выпущенные данные, непосредственно из Altium NEXUS, из панели Explorer. Работая как мягкое удаление, процесс удаления предоставляет дополнительные возможности и информацию по мере продвижения, включая соответствующие ссылки на исходные элементы для целей проверки в Workspace, удаленные элементы перемещаются в специальную корзину (Trash), откуда их можно вернуть (Restore) или удалить полностью (Permanently Delete) со страницы Trash, интерфейса браузера Workspace.

Мягкое удаление в действии. Здесь удаляется проект вместе со связанным с ним релизом (если из каких-либо релизов были созданы производственные пакеты, они также будут удалены).

При мягком (обратимом) удалении управляемого элемента, об этом будет упомянуто в соответствующих областях в Altium NEXUS, где бы этот элемент ни использовался и где бы на него ссылались. Например, для мягко удаленного элемента типа компонент, это упоминается во время валидации (Validation) проекта и также в местах доступа к компонентам, таких как панель Properties и документ ActiveBOM проекта.

Пример мягко удаленного компонента, который отмечен в другом окне программы.

Комментирование проекта

Проекты Altium NEXUS при интеграции с Altium Workspace позволяют рассредоточенной команде разработчиков совместно работать над проектами, которые централизованно хранятся и управляются в этом Workspace . Для улучшения процесса совместной работы интерфейс поддерживает комментирование проектных документов. Комментарии — это добавленные пользователем примечания, они могут быть применены к точке, объекту или области в документе схемы или платы, и на них могут отвечать другие пользователи.

Размещенные комментарии доступны в режиме реального времени для сотрудничающих пользователей — тех, у кого есть общий доступ к документу — и сохраняются на сервере независимо от проекта, без какого-либо изменения документов. Функция комментирования управляется через панель Comments (View » Panels » Comments), который предоставляет средства для размещения, выбора, редактирования, разрешения и удаления комментариев. В редакторе документов комментарии эффективно «прикрепляются» к местам в  документе и доступны через соответствующее всплывающее окно.

Обратите внимание, что комментарии можно добавлять и управлять ими как в Altium NEXUS, так и в соответствующем Workspace через представление проекта в веб-интерфейсе. Функциональность двух систем комментирования практически одинакова, а поскольку данные проекта и комментирования хранятся в Workspace, системы работают вместе в режиме реального времени.

► Смотрите раздел Комментирование с помощью веб-просмотрщика для получения более подробной информации о системе комментирования в NEXUS Server Workspace.

Условия использования

Перед использованием инструмента комментирования, убедитесь, что вы вошли в свой Workspace, и открыли страницу Project и один из документов схемы или печатной платы. Воспользуйтесь командой File » Open Project для выбора проекта в Workspace из тех, которыми поделились с вами. Панель Comments предоставит текстовые подсказки для условий использования инструмента комментирования:

Размещение

Комментарии размещаются в пространстве редактора с помощью кнопки команды  на панели Comments или путём нажатия на кнопку   в правом верхнем углу области проектирования и может быть назначен объекту, определенной точке или области в активном документе. Команда вызывает режим размещения комментария, в котором курсор меняется на перекрестие, которое обнаруживает и выделяет объекты для выбора:

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

Затем действие размещения открывает диалоговое окно ввода комментария, которое предлагает поле для ввода текста комментария, а также дополнительные параметры для добавления к комментарию рисунка от руки () и ссылку «упоминание» на конкретного пользователя или группу (). Нажмите на  для подтверждения создания комментария, который свяжет комментарий с пронумерованным маркером булавки в документе, а также добавит сводную запись комментария на панели Comments.

Размещение комментария к объекту, упоминание в комментарии другого зарегистрированного пользователя, перемещение индикатора припрепления комментария и добавление к комментарию рисунка от руки.

Упоминания и назначения пользователей

Наряду с текстом в диалоговом окне ввода комментариев можно добавить ссылку «упоминание» для любого другого пользователя или роли, зарегистрированной в подключенной рабочей области, введя символ @ или щелкнув на кнопку  в диалоговом окне. Выберите имя/адрес электронной почты из раскрывающегося списка, чтобы добавить ссылку на пользователя (члена команды) в комментарий, а также в качестве записи Assign To. Снимите последний флажок, если вы не хотите, чтобы комментарий считался специально назначенным этому пользователю или группе. Группа ролей (скажем, «Инженеры») и, следовательно, входящие в нее пользователи также могут быть добавлены в качестве упоминания и/или назначения.

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

► См. дополнительные сведения о совместном использовании проекта.

Расположение

Расположение комментария в пространстве редактора меняется путем перетаскивания связанной с ним «булавки» в новое положение — во время или после ее размещения. Если булавка комментария выбрана, она включает линию, соединяющую связанный с ней объект или область.

Обратите внимание, что комментарий также можно разместить во время его первоначального размещения, щелкнув и перетащив его в режиме размещения. ► Пример.

Рисование

При размещении или редактировании комментария выберите инструмент  чтобы добавить рисунок от руки с помощью полученного курсора-пера. Щелкните и перетащите, чтобы создать линии, а затем щелкните правой кнопкой мыши, чтобы завершить и связать рисунок с текущим выбранным комментарием.

Комментарии на печатной плате

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

Работа с комментариями

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

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

Навигация по комментариям с помощью выбора маркеров булавок в пространстве редактора и выбора записей на панели Comments.

Диалоговое окно Comments

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

Вы можете последовательно просмотреть все доступные комментарии с помощью кнопок «предыдущий/следующий» () в шапке диалогового окна.

Предварительный просмотр

Выберите опцию Show original design screenshot в исходном комментарии, чтобы увидеть графическое изображение области редактора при размещении комментария.

Ответ на комментарий

Введите текст и, при желании, упоминание пользователя (@), в поле ответа, чтобы добавить новую запись в ветку комментариев. Нажмите для подтверждения.

Редактирование и удаление

Существующий комментарий может быть отредактирован автором этого комментария с помощью параметра Edit, доступного на странице меню комментирования . Нажмите на кнопку  чтобы подтвердить редактирование комментария.

Используйте опцию Delete, чтобы удалить текущий выбранный комментарий. Обратите внимание, что вся ветка будет удалена, если будет удален исходный комментарий (в отличие от Reply).

Решение комментария

В диалоговом меню нажмите на кнопку  для переключения состояния комментария между "Решено" (Resolved)  и "Не решено" (Unresolved, по-умолчанию). Разрешенный комментарий (закрытый как завершенный) неактивен и недоступен для редактирования, а его запись на панели Comments и его маркер в документе отображаются серым цветом.

Настройки панели Comments

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

Кнопка   переключает видимость маркеров комментариев в документе. Записи комментариев по-прежнему можно выбирать, как обычно, в списке панели комментариев.

Используйте раскрывающееся меню параметров () чтобы настроить фильтрацию видимости комментариев и уведомлений, а также связанную с ними кнопку  для переключения между фильтрованным и нефильтрованным представлением:

• All – все комментарии к проекту будут перечислены на панели.
• My – показывать только те комментарии, в которых упоминается мое имя пользователя и/или которые назначены на имя пользователя.
• From – показывать комментарии, оставленные только выбранным пользователем.
• Unresolved – комментарии, которые были разрешены, не выводятся на панель (или редактор документов).
• Current Document – список комментариев, которые были размещены в текущем активном документе, а не во всех документах проекта.
• Notifications – получать оповещения по электронной почте обо всех действиях с комментариями в этом проекте (All), только о тех комментариях, в которых вы упомянуты или назначены (My), или вообще не получать оповещения по электронной почте (None). ► Пример содержания электронного письма.

Выпуск проекта 

В сочетании с Altium Workspace, программное обеспечение Altium NEXUS обеспечивает расширенный подход к организации, отслеживанию и хранению выходных файлов проекта, необходимых для создания проекта печатной платы. При этом используется автоматизированный процесс, который «выпускает» определенный набор выходных файлов проекта на сервер в виде версий, доступных только для чтения, которые в совокупности соответствуют физическому объекту, который может быть изготовлен. Редакции проекта, созданные этим процессом выпуска (Project Release), хранятся в репозитории Workspace под управлением системы контроля версий, и представляют собой технологическую копию проекта платы на момент создания выпуска.

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

Проект платы, который выпущен или «зафиксирован» в Workspace (как набор ревизий, управляемых жизненным циклом), обычно содержит:

• Исходные данные – копия (моментальный снимок) основных файлов проекта с отметкой времени (схема, плата, файл проекта и т.д.)
• Данные для производства – данные, необходимые производителю для создания платы (файлы Gerber, файлы NC Drill и т.д.)
• Данные для сборки – данные, необходимые сборочному цеху для сборки печатного узла в соответствии со спецификацией, как с изменениями конструкции, так и без них (файлы Pick and Place, сборочные чертежи, спецификации и т. д.).

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

• Altium NEXUS зарегистрирован в Workspace, в котором размещен целевой репозиторий для выпуска проекта.
• Проект печатной платы в Altium NEXUS содержит файлы Output Jobs – генераторы выходных данных проекта (для выходных данных, таких как печать, файл или PDF). Если OutJob-файлы недоступны, Project Releaser предложит создать подходящие Outjobs Fabrication и Assembly файлы для запуска процесса.
• Проект, полученный в процессе выпуска, содержит все необходимые элементы: исходные данные действительны и актуальны, пользователь имеет достаточные права для выпуска этого проекта на сервер и т.д.

Основы этих требований изложены ниже.

Выходные файлы (Outjob)

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

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

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

Редактор Output Job Editor позволяет настраивать широкий спектр генераторов проектных выходных данных на соответствующие выходные контейнеры (файлы, принтеры, пути расположения и т. д.) и сохранять конфигурацию в виде файла OutJob.

Являясь основным механизмом совместного создания файлов изготовления и сборки для проекта платы, файлы заданий (OutJob) в Altium NEXUS предлагают следующие дополнительные возможности:

• Любое количество файлов OutJob может быть добавлено к проекту, так что для конкретных задач, таких как создание выходных данных для изготовления, сборки, архивирования, закупок и документации,  будут доступны необходимые конфигурации.
• Файлы OutJob на самом деле мобильны и могут быть переданы в любой проект, где требуется стандартизированный набор выходных проектных данных. Выберите PCB document, а не конкретный файл проекта в качестве источника, чтобы создать общее (и, следовательно, переносимое) задание (OutJob-файл).
• Файлы OutJob могут включать в себя файлы проверок проекта, таких как ERC и DRC, а так же сравнение посадочных мест с источниками. Таким образом, OutJob-файлы являются специализированным «активным» инструментом, с помощью которого проверяется весь проект, а выводимый документ (например, в формате PDF) демонстрирует результаты процесса проверки.
• Файлы OutJob обеспечивают поддержку вариантов собранной платы, когда требуются разные наборы выходных файлов для создания альтернативных версий проекта, таких как стандартные или улучшенные версии продукта, в которых используются дополнительные компоненты или другие решения. См. раздел Варианты проекта для получения дополнительной информации.
  Обратите внимание, что выбор варианта (Variant Choice), назначенный выходным заданием (Output Job), не применяется, когда исходное задание используется в процессе выпуска проекта. В этом случае выбор варианта автоматически обнаруживаeтся и/или специально назначаeтся в самом релизере.

► Смотрите раздел Подготовка большого числа выходных файлов с помощью файла задания (OutJob) для получения дополнительной информации о файлах Output Jobs.

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

Инструмент Project Releaser

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

► Смотрите раздел работа с инструментом Project Releaser для получения более подробной информации.

Чтобы получить доступ к инструменту Project Releaser и настроить его, откройте окно Release из главного меню Altium NEXUS (Project » Project Releaser) или нажмите ПКМ на названии проекта на панели Projects и выберите Project Releaser.

Project Releaser запускает автоматизированный процесс, который проходит через последовательность проверок и этапов генерации выходных файлов, отправляя их на сервер Altium или в локальную папку/zip.

Окно Release инструмента Project Releaser содержит страницу начальных настроек, которые соответствуют первому этапу процесса выпуска – Configure Server Release. Оно содержит ряд разделов связанных с выпуском проекта, определяющих тип выходных данных, которые будут созданы и отправлены на сервер, таких как исходные данные (моментальный снимок файлов проекта), данные изготовления и данные сборки.

Автоматический инструмент выпуска проекта (Releaser) будет:

• пытаться применить подходящие наборы OutJob файлов к группам данных для сборки по префиксам имени (ass, fab) доступных для проекта файлов OutJob.
• создавать подходящие OutJob файлы для сборки узла и изготовления платы по умолчанию, если в проекте нет существующих файлов OutJob.
• обнаруживать Варианты которые были определены для активного проекта, и создавать подходящие наборы данных сборки для создания выходных файлов, относящихся к этим вариантам.
• определять правильный режим выпуска — автономный или онлайн — в зависимости от текущих условий (состояние подключения к рабочей области, управляемый или локальный тип проекта). В этом случае данные проекта будут выпущены в онлайн-режиме.

Дополнительные «пользовательские» разделы могут быть добавлены (Add Section) для создания отдельных, проименованных наборов выходных данных. Первоначальная конфигурация для основных разделов данных (или любых добавленных пользовательских разделов) может быть отредактирована, добавлена или перенастроена через диалоговое окно Project Release Options, которое открывается по нажатию на кнопку .

Будут запущены выходные задания, определенные файлом OutJob (например, Assembly), и данные полученные из них будут собраны в целевом разделе (например, Assembly Data).

Основные настройки выпуска проекта, это:

• Release Target – выберите или найдите и выберите размещение версии выпуска онлайн в Altium Workspace или в локальную папку (режим оффлайн).
• Output Jobs – в каждом из перечисленных разделов (Source Data, Fabrication Data и т. д.) выберите, какие из доступных OutJob (и составляющих их генераторов вывода) будут использоваться в выпуске. Обратите внимание, что разделы выпуска — это просто предопределенные имена разделов данных, которые могут включать данные, сгенерированные любым выбранным файлом задания OutJob.
• Вкладка Item Naming– задайте имя элементов, которые будут созданы на сервере, или найдите и выберите (или создайте) существующий раздел на сервере, в который будет направлен выпуск проекта (Project Release).
  • Settings – позволяет просматривать или редактировать базовые шаблоны именования редакций данных (Revisions), которые будут выпущены на сервер.

►Смотрите диалоговое окно Настроек выпуска проекта для получения более подробной информации.

Подготовка к выпуску

После того, как релиз проекта настроен нужным образом, вызовите процесс подготовки инструмента Releaser с помощью кнопки . Это вызовет серию предварительных проверок, например, будут ли файлы проекта сохранены (и зафиксированы ли они в системе контроля версий), а также убедитесь, что целевые расположения будут доступны. Во время этой части процесса инструмент Releaser создаст целевые редакции выпуска в Altium Workspace. На следующем этапе обработки будет выполнена проверка проекта (ERC, DRC и т. д.), если отчет о проверке включен в файлы OutJob.

На последнем этапе процесса подготовки будут сгенерированы наборы всех выходных данных, определенные назначенными файлами OutJob — они будут направлены в локальное временное местоположение перед загрузкой этих данных в Workspace.

Все данные и файлы, сгенерированные для выпуска, можно просмотреть перед отправкой на сервер Altium.

На этом этапе сгенерированные данные можно просмотреть в окне Release. Для интересующего набора данных выберите ссылку Details  чтобы развернуть полный отчет о файлах, созданных для этого раздела, и используйте ссылку Explore чтобы открыть (временную) папку, содержащую сгенерированные файлы. Кроме того, используйте ссылку View чтобы открыть указанную запись в ее родном редакторе/просмотрщике.

Выпуск в Workspace

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

За завершенным процессом выпуска будет следовать формирование отчета о выполнении (Execution Report), в котором представлено сводное дерево процесса выпуска и навигационные ссылки (вверху) к ревизиям сбора данных в Workspace.

 Выберите ссылку в разделе генерации выходных файлов, чтобы открыть версию из выпуска на сервере.

Дополнительно этап Publish to PLM может быть доступен, если соответствующий процесс был активирован в NEXUS Server Workspace. Смотрите раздел Инструмент Project Releaser – Публикация в PLM для получения более подробной информации.

Просмотр выпущенного проекта

Наименования выпусков проекта (Project Releases) расположены на панели Explorer (View » Panels » Explorer) в соответствующей области, там же будут расположены последующие выпуски проекта, создающие новый набор ревизий выпуска (нумерация ревизий увеличивается). В дальнейшем информацию о выпуске проекта можно будет найти в веб-просмотрщике (web-viewer), целевого Workspace, доступ к которому предоставляется по кнопке   на панели Explorer.

На панели Explorer кнопка Open in Web используется для получения доступа к релизам в Workspace.

С помощью веб-просмотрщика (Web Viewer) в Workspace, все релизы связанные с проектом можно найти в области Releases – или в окне Manufacture в Workspace на базе сервера, например Altium Concord Pro. На странице перечислены все выпуски проекта, причем самая новая запись находится вверху, где отдельный выпуск можно открыть на производственном портале (Manufacturing Portal) в Workspace с помощью кнопки ().

Окно Manufacturing Portal предоставляет более подробную информацию о выбранном выпуске проекта, которая включает все входящие в его состав пакеты файлов (в разделе Files), полный комплект проектной документации (в разделе Design Snapshot), и сведения о производителях и поставщиках компонентов (в разделе Supply). Обратите внимание на то, что функция Send to Manufacturer доступна только для Altium 365 Workspace. ► Смотрите страницу Altium 365 Workspace область Releases для получения более подробной информации.

История проекта

Altium NEXUS,в паре с Altium Workspace, позволяют вам просматривать и взаимодействовать с расширенной графически ориентированной хронологией Истории проекта. Отдельное окно History предоставляет прогрессивную временную шкалу основных событий, связанных с проектом — его создание, коммиты, выпуски, клонирование и обмен с MCAD — с различными поддерживаемыми действиями, где это применимо.

Включение записи истории проекта

Функциональность истории проекта предоставляется через специально созданное расширение — расширение Project History.

Расширение Project History.

Эта функция доступна только при условии установки расширения Project History  в качестве части основной установки Altium NEXUS. Это расширение устанавливается по умолчанию при установке программного обеспечения, но в случае непреднамеренного удаления его можно найти на вкладке Purchased страницы Extensions & Updates (нажмите на элемент управления текущим пользователем (например, ) в правом верхнем углу главного окна приложения, затем выберите Extensions and Updates в соответствующем меню).

Доступ к истории проекта

Для доступа к окну истории проекта (History) для проекта в Altium NEXUS щелкните ПКМ по его названию на панели Projects и выберите команду History & Version Contol » Show Project History из контекстного меню. Окно History представляет собой отдельный документ с вкладками (<ProjectName>.PrjPcb History).

Доступ к истории проекта из Altium Nexus.

Для проекта уже существовавшего в вашем Workspace до появления функции Project History его история изначально не будет полной. Переиндексация данных событий для этого проекта будет выполняться автоматически при первом доступе к окну History для этого проекта. Уведомление появится в нижней части окна после завершения переиндексации — щелкните значок  для обновления временной шкалы с полными данными о хронологии событий.

Хронология истории проекта

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

Выявление трех ключевых компонентов окна History.

1. Основной ствол хронологии. Направление хронологии событий – снизу вверх. Первое событие - это создание проекта, он появится внизу временной шкалы. Последующие события отображаются выше, а самое последнее (самое последнее событие) отображается вверху временной шкалы.
2. События. Каждый раз, когда поддерживаемое событие (см. ниже) происходит в связи с проектом, это событие добавляется на временную шкалу в виде специальной плитки. Каждый тип события будет иметь плитку другого цвета и будет либо напрямую связан с основным стволом временной шкалы, либо иметь дополнительный значок рядом с ним (как в случае с событиями обмена данными с MCAD).
3. Поиск. Нажмите на кнопку  в правом верхнем углу окна, для доступа к полю поиска, которое облегчает базовый поиск по истории проекта. Когда вы вводите что-либо в строку поиска, к временной шкале будет применяться фильтрация, чтобы отображать только события, относящиеся к объекту поиска. Для получения дополнительной информации см. Поиск с использованием фильтров.

Поддерживаемые события

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

Создание проекта

Ссылки на: Создание проекта, Как сделать существующий проект доступным онлайн, Клонирование проекта

При создании проекта плитка события Project Created будет добавлена на временную шкалу. Это событие знаменует собой начало хронлогии событий связанных с проектом. Таким образом, его всегда можно найти в нижней части временной шкалы. Плитка для этого события может отображаться в двух различных вариантах:

• Когда проект только что был создан в Workspace. Создатель проекта представлен именем (и изображением), а также датой и временем создания проекта. Описание проекта также отображается внутри плитки, если оно было введено во время создания.

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

Плитка события Project Created физически соединена с основным стволом временной шкалы сплошной синей линией соединения и узлом .

Коммит проекта (Project commit)

Этот тип события поддерживается только для проекта, который полностью управляется и хранится в собственной системе контроля версий Workspace (в репозитории Git под управлением системы контроля версий). Для неуправляемого проекта, который был сделан доступным для Altium 365 Workspace, но не находится под формальным контролем версий (использующий Simple Sync), вы не увидите никаких событий типа коммит, связанных с системой контроля версий, на временной шкале History. Чтобы получить эту информацию, вы можете изменить стиль онлайн-доступности, включив параметр Version Control на вкладке General диалогового окна Project Options. Это переводит проект под управление встроенной системы контроля версий Workspace.

Для проекта, который был доступным для Altium 365 Workspace, и уже находится под управлением внешней системой контроля версий, вы также не увидите никаких событий фиксации, связанных с контролем версий, на временной шкале истории. Используйте внешний клиент управления версиями, чтобы просмотреть историю управления версиями проекта. Кроме того, вы можете переключиться на встроенную систему контроля версий Workspace. Что вы можете сделать, так это создать моментальный снимок вашего проекта, что наиболее эффективно и качественно выполняется с помощью инструмента Altium NEXUS Project Packager. Это отключит проект от внешней системы контроля версий и от Workspace (если он уже доступен там), после чего вы можете снова сделать его доступным в Workspace, но под управлением встроенной системы контроля версий — начиная как бы заново. Подробную информацию о том, как это сделать, см. раздел Переход с внешней системы контроля версий на встроенную в Workspace систему контроля версий.

Каждый раз, когда вы фиксируете проект в Workspace (выполняете коммит проекта) (если проект находится под управлением встроенной системы контроля версий), на временную шкалу будет добавлена плитка события Project Committed. Человек, выполнивший коммит (сохранение на сервер), представлен по имени (и изображению), а также дате и времени. Если комментарий был добавлен во время коммита и передачи— через диалоговое окно Commit to Version Control – то это также будет отображаться на плитке.

Если проект был локальным, неуправляемым проектом, который впоследствии стал доступен онлайн, то описание, введенное в диалоговом окне Make Available Online будет использовано для обеих плиток событий Project Created и Initial Project Committed, поскольку фиксация проекта выполняется как часть предоставления доступа к проекту онлайн — при условии, конечно, что опция контроля версий (Version Control) была включена.

Пример плитки события Первичного коммита проекта (Initial Project Committed).

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

– элемент был добавлен.

– элемент был удален.

– элемент был изменен.

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

Используйте команды Show More и Show Less запросить полный список для каждого типа элемента. Нажмите на кнопку   на плитке чтобы вернуться к отображению сводной информации.

Нажмите на кнопку  в правом верхнем углу плитки для доступа в меню со следующим набором команд:

• Open Snapshot – используйте эту команду, чтобы загрузить, а затем открыть конкретную версию проекта (на панели Projects). Имя проекта будет содержать дату и время фиксации этой версии проекта. Обратите внимание, что эта версия доступна только для чтения; можно просматривать, но не редактировать.

Вы можете открыть (только для просмотра) любую конкретную ревизию проекта — непосредственно из соответствующей плитки событий Project Committed для этой ревизии.

• Schematic to – позволяет сравнить данные схемы в одном коммите с данными из другого коммита или выпуска. Используйте подменю для сравнения с предыдущим коммитом или выберите из всех возможных выпусков и коммитов. После выбора для сравнения нужного выпуска/коммита, результаты сравнения схем будут отображены в окне Compare, которое открывается в виде новой вкладки в веб-браузере по умолчанию. Для получения дополнительной информации см. раздел Сравнение схем.
• Revert to – используйте эту команду, чтобы вернуться к использованию данных из этой конкретной версии проекта. Данные из исходных документов проекта в этой конкретной редакции перезаписывают данные в вашей локальной рабочей копии проекта. По сути, проект на мгновение закрывается, а затем снова открывается с этими возвращенными данными. Если вы затем захотите завершить реверсию и сделать эти данные главной редакцией (текущей версией), вам нужно будет зафиксировать и отправить проект обратно в Workspace.

Вы можете вернуться к любой конкретной версии проекта — непосредственно из соответствующей плитки события Project Committed для этой версии.

После возврата к определенной версии и перед новым коммитом вы можете снова вернуть локальную рабочую копию к последней версии с помощью команды Revert to, связанной с последней плиткой события Project Committed на временной шкале.

Плитка события Project Committed физически соединена с основным стволом временной шкалы сплошной синей линией соединения и узлом: . Последняя версия проекта (т. е. последняя фиксация) отличается белой заливкой узла: .

Клонирование проекта

Ссылка на: Клонирование проекта

Каждый раз, когда вы клонируете проект — либо через интерфейс браузера Workspace, либо из Altium NEXUS – в хронологию добавляется плитка события Project Cloned. Человек, выполнивший клонирование, представлен по имени (и изображению), а также дате и времени. Если описание было добавлено во время клонирования – через окно Clone Project (в браузере) или диалоговое окно Clone Project (в Altium NEXUS) – то это также будет отображено в плитке. Предоставляется ссылка на клонированный проект — щелкнув по ней, вы получите доступ к подробной странице управления для этого проекта через интерфейс браузера Workspace.

Пример плитки события клонирования проекта (Project Cloned).

Команду клонирования, доступную в Altium NEXUS (щелкните ПКМ по имени проекта на панели Projects или нажмите кнопку , в правом верхнем углу панели Explorer при просмотре проекта) или на странице Projects интерфейса браузера Workspace можно применять на последнюю (или верхнюю в хронологии) версию проекта. При доступе к окну History для проекта через интерфейс браузера Workspace у вас также есть возможность клонировать определенную версию этого проекта. Для этого найдите плитку события Project Committed для требуемой версии проекта, затем нажмите кнопку  в правом верхнем углу плитки. В следующем меню выберите команду Clone.

Плитка события клонирования проекта (Project Cloned) физически соединена с основным стволом временной шкалы пунктирной зеленой линией соединения и незаполненным узлом: .

Обмен данными с MCAD

Связанная страница: Узнайте больше о совместной работе ECAD и MCAD

При работе между областями электронного и механического проектирования Workspace выступает в качестве моста между ними, облегчая прямое совместное проектирование ECAD-MCAD. Всякий раз, когда в конструкцию печатной платы проекта вносятся изменения, и эти изменения передаются в Workspace через соответствующую панель CoDesigner, в хронологии появится плитка события связанного с MCAD и предполагающего обмен изменениями (MCAD Changes Suggested). Так же на плитке будут отражены имя человека, выполнившего передачу данных (push), а также дата и время. Если сообщение было опубликовано во время отправки — через панель MCAD CoDesigner (Altium NEXUS) или панель Altium CoDesigner (в поддерживаемом ПО MCAD) — оно также будет отображаться на плитке.

На данный момент поддерживаются только события Push.

Пример плитки события связанного с MCAD, в котором предполагается внесение изменений.

Когда инженер MCAD вносит изменения в плату в поддерживаемом им программном обеспечении MCAD и отправляет их обратно в Workspace, соответствующее событие передачи, будет доступно на временной шкале проекта только после переноса изменений из Workspace в Altium NEXUS.

Пример, показывающий два события, связанных с MCAD. Слева от ствола временной шкалы — событие push со стороны ECAD, а справа — событие push со стороны MCAD..

Плитка события связанного с MCAD, которое предполагает внесение изменений, физически не подключена к основному стволу временной шкалы. Вместо этого используется символ стрелки направления, указывающий на основной ствол временной шкалы: .

Поиск с использованием фильтров

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

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

Инструмент поиска работает со следующей информацией:

• Название плитки события.
• Имя человека который создал событие.
• Текст описания (текст, полученный из комментария/примечания/описания, когда произошло соответствующее событие).
• Текст содержащий отличия данных – на плитке события Project Committed.
• Название набора данных – на плитке события Project Released.
• Имя проекта – на плитках событий Project Cloned и Project Created  (при создании путём клонирования).

Чтобы очистить текущую фильтрацию и вернуться к полной временной шкале, очистите поле поиска — либо выделив текущий текст, либо нажав кнопку Backspace, или путём нажатия на кнопку  в дальней правой части поля. В качестве альтернативы щелкните на кнопку Clear Filter в поле, отображающем количество отображаемых событий (в верхней части окна).

Обновление новыми событиями

Всякий раз, когда поддерживаемое событие происходит в отношении проекта, это событие будет автоматически обнаружено и доступно для просмотра в окне History. Уведомление появится в нижней части экрана вскоре после того, как произойдет событие — щелкните значок  чтобы обновить хронологию и увидеть новое событие.

Также предусмотрено ручное обновление, выполняемое нажатием кнопки  в правой верхней части окна.

Инструмент упаковки данных проекта (Project Packager)

Инструмент Project Packager предназначен для ситуаций, когда необходимо создать резервную копию всего проекта или перенести его в другое место.

Инструмент (Помощник по упаковке проектов) архивирует полный проект в Altium NEXUS, дерево проектов или проектную группу (и входящие в нее проекты) в указанное место в виде одного zip-файла с отметкой времени. Помощник доступен в главном меню (Project » Project Packager) или щелкнув ПКМ по имени проекта и выбрав Project Packager из контекстного меню.

Используйте инструмент Project Packager для передачи всего проекта (или дерева проектов) и его связанных документов в zip-файл с отметкой времени.

Помощник содержит настройки для определения:

• Места где будет храниться архив.
• Как обрабатываются пути к каталогам файлов.
• Включены ли какие-либо сгенерированные, системные или внешние файлы.
• Включена ли история проекта.
• Какие из связанных документов проекта включены в окончательный архив.
• и многое другое...