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

Parent page: Проекты Workspace

Workspace Enterprise Server предлагает элегантное решение задачи получения исторического обзора активности по проекту в виде выделенного интерактивного представления History. Доступное через браузерный интерфейс Workspace или из Altium Designer, это представление проекта History показывает прогрессирующую временную шкалу ключевых событий, связанных с проектом. К таким событиям относятся создание проекта, коммиты, релизы, клонирование и обмены с MCAD; при этом там, где это применимо, для событий будут доступны команды действий.

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

Доступ к представлению History для проекта осуществляется со страницы детального CAD-ориентированного управления этим проектом — страницы Projects Management. Нажмите пункт History в левой панели.

Сама страница Projects Management открывается с основной страницы Projects двойным щелчком по записи проекта, щелчком по его названию или выбором пункта Open в меню . Дополнительные сведения см. в разделе Управление конкретным проектом.

Откройте историю проекта со страницы детального управления этим проектом.

Временная шкала истории — обзор

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

Определение трёх ключевых компонентов представления History .

1. Main trunk of the timeline. Направление хронологии событий — снизу вверх. Первое событие — создание проекта — отображается внизу шкалы. Последующие события располагаются выше, а самое новое (текущее) — вверху шкалы.
2. Events. Каждый раз, когда происходит поддерживаемое событие (см. ниже), связанное с проектом, оно добавляется на шкалу в виде отдельной плитки. Для каждого типа события используется плитка своего цвета; она либо напрямую связана с основным «стволом» временной шкалы, либо имеет рядом значок связи (как в случае событий MCAD Exchange; ).
3. Search. Нажмите элемент управления в правом верхнем углу представления, чтобы открыть поле поиска для базового поиска по истории проекта. По мере ввода строки поиска к шкале применяется фильтрация, и отображаются только события, соответствующие запросу. Дополнительные сведения см. в разделе Поиск с фильтрацией.

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

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

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

Related pages: Создание нового проекта Workspace (браузерный интерфейс / Altium Designer), Публикация существующего проекта онлайн, Клонирование проекта (браузерный интерфейс / Altium Designer)

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

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

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

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

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

Каждый раз, когда вы сохраняете проект в Worskpace (где проект управляется во внутреннем репозитории Versioned Storage Git Workspace), на временную шкалу добавляется плитка события Project Committed. Отображается имя (и изображение) пользователя, выполнившего commit и push, а также дата и время. Если при commit и push был добавлен комментарий — через диалог Save to Server dialog — он также будет показан в плитке.

Пример начальной плитки события Project Committed.

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

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

– элемент удалён.

– элемент изменён.

Нажатие на элемент управления в плитке разворачивает этот раздел diff и показывает затронутые элементы по именам.

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

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

• Clone – используйте эту команду, чтобы создать клон из конкретной ревизии проекта. Появится окно Clone Project, в котором можно определить Name проекта, Description, а в параметрах Advanced — целевые Server Folder и Repository. Обратите внимание: текст в заголовке окна отражает, из какой ревизии проекта создаётся клон. Задав необходимые сведения, нажмите кнопку . Проект будет создан, и на временную шкалу будет добавлена плитка события Project Cloned.

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

• Download Snapshot – используйте эту команду, чтобы скачать исходники проекта для конкретной ревизии в виде Zip-архива. Имя Zip-файла и файла проекта PCB будет включать дату и время (в UTC), когда эта ревизия проекта была закоммичена и отправлена (push) в Workspace.

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

Релиз проекта

Related page: Релиз дизайна платы

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

Пример плитки события Project Released.

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

• View – открывает выделенный производственный портал (в отдельной вкладке браузера), в котором можно более детально изучить выпущенные данные. В этом портале вы можете просматривать и навигировать по выпущенным файлам, проверять BOM, а также просматривать и комментировать снимок самого дизайна — источник этих выпущенных данных. Также будут доступны элементы управления для скачивания производственных данных с разной степенью детализации (от полного набора(ов) данных до отдельных сгенерированных выходных файлов). Выбранный релиз также можно отправить — как Manufacturing Package — напрямую вашему производителю. Дополнительные сведения см. в разделе просмотра Release Package в Manufacturing Portal.

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

• BOM To– позволяет сравнить данные спецификации (BoM) в этом релизе с данными другого релиза. Используйте соответствующее подменю, чтобы сравнить с BoM предыдущего релиза, либо выберите любой релиз из всех, созданных для проекта. Функция сравнения данных выявляет различия в исходных данных BoM между указанными релизами проекта и также доступна из представления проекта Releases view в Workspace. Результаты сравнения предоставляются в виде скачиваемого CSV-файла, в котором подробно указано, какие данные BoM изменились — добавлены, удалены или обновлены — между выбранными релизами проекта.

• Download – позволяет выбрать, в последующем окне, какие наборы данных из пакета релиза нужно скачать. После выбора нажмите кнопку . Будет загружен один Zip-архив, содержащий папки для каждого выбранного набора данных.
• Download Snapshot – позволяет скачать снимок версии проекта, которая использовалась для создания пакета релиза, в виде Zip-архива.

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

Related page: Клонирование проекта (интерфейс браузера / Altium Designer)

Каждый раз при клонировании проекта — через браузерный интерфейс Workspace или из Altium Designer — на временную шкалу добавляется плитка события Project Cloned. Отображается имя (и изображение) пользователя, выполнившего клонирование, а также дата и время. В момент клонирования в плитку добавляется автоматически сгенерированное описание, которое можно переопределить, введя новое описание. Также предоставляется ссылка на клонированный проект — при нажатии откроется подробная страница управления этим проектом в отдельной вкладке браузера.

Пример плитки события Project Cloned.

Обмены с MCAD

Related page: Altium MCAD CoDesigner

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

Когда MCAD-инженер вносит изменения в PCB в своём поддерживаемом MCAD ПО и отправляет их обратно в Workspace, соответствующее событие отправки будет доступно на временной шкале истории проекта only после получения (pull) изменений из Workspace в Altium Designer.

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

Фильтрованный поиск

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

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

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

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

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

Обновление при появлении новых событий

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

Также доступно ручное обновление — нажмите элемент управления в правом верхнем углу представления.