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

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-репозитории Worskpace), на шкалу добавляется плитка события Project Committed. Отображаются имя (и изображение) пользователя, выполнившего commit и push, а также дата и время. Если при commit и push был добавлен комментарий — через диалог Save to Server dialog — он также будет показан в плитке.

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

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

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

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

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

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

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

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

• View – используйте эту команду, чтобы открыть исходные данные проекта для выбранного коммита в Web Viewer как снимок (snapshot) состояния проекта на тот момент.
• Create Tag – добавить имя VCS-тега к текущему выбранному коммиту. Теги, привязанные к коммиту, отображаются в плитке History, в заголовке его snapshot-представления в Web Viewer, а также в любых комментариях, привязанных к этому snapshot-представлению. После добавления тега к коммиту команда меню плитки меняется на Tag и предлагает подопции для изменения (Edit) или удаления (Remove) тега коммита.

Выберите пункт меню Create Tag, чтобы добавить имя тега к событию History для коммита.

Snapshot-представление помеченного тэгом события History для коммита маркируется именем тега.

Когда комментарии просматриваются в живом WIP-дизайне, те, что были созданы в design snapshot помеченного тэгом коммита, будут включать связанное имя тега. Выберите ссылку с именем тега, чтобы открыть соответствующий snapshot коммита. Подробнее см. Web Viewer Comments о работе с комментариями.

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

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

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

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

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

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

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

Related page: Выпуск дизайн-проекта

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

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

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

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

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

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

• BOM To – позволяет сравнить данные ведомости материалов (BoM) в этом выпуске с данными другого выпуска. Используйте соответствующее подменю, чтобы сравнить с BOM-данными предыдущего выпуска, либо выбрать из всех выпусков, выполненных для проекта. После выбора цели сравнения результаты представляются в виде списка цветокодированных позиций BOM, отражающих элементы, изменившиеся между указанными событиями Commit/Release. Сводка изменений формируется в стандартном формате CSV и становится доступной для скачивания в ZIP-архиве. Подробнее см. BOM Comparison.
• Download Outputs – позволяет выбрать (в последующем окне subsequent window), какие наборы данных из пакета выпуска скачать. Сделав выбор, нажмите кнопку . Будет скачан один Zip-архив, содержащий папки для каждого выбранного набора данных.
• Download Sources– позволяет скачать снимок (snapshot) версии проекта, использованной для создания этого пакета выпуска, в виде Zip-архива.

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

Related page: Клонирование проекта (browser interface / Altium Designer)

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

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

Обмены MCAD

Related page: Altium MCAD CoDesigner

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

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

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

Фильтруемый поиск

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

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

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

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

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

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

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

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