История проекта
Краткий обзор
- Узнайте, как открывать историю проекта и файлов, перемещаться между событиями и фильтровать временную шкалу с помощью поиска.
- Ознакомьтесь с требованиями к настройке, включая расширение Project History и встроенную систему контроля версий Git рабочего пространства.
- Узнайте, как просматривать изменения в коммитах, открывать ревизии в режиме только для чтения, сравнивать данные схем, печатных плат и спецификаций (BOM), а также управлять тегами коммитов.
Altium Designer в сочетании с подключенным рабочим пространством позволяет просматривать расширенную графическую Project History временную шкалу и взаимодействовать с ней. Специальное представление History отображает хронологию основных событий проекта печатной платы, многоплатной системы или кабельного жгута: создание, фиксации изменений, выпуски, копирование и обмен данными с MCAD. Для соответствующих событий доступны различные действия.
Доступ к истории проекта
Чтобы открыть представление History для проекта рабочего пространства в Altium Designer, щелкните правой кнопкой мыши его запись на панели Projects и выберите команду History & Version Contol » Show Project History в контекстном меню. Также можно выбрать команду History & Version Control » Show Project History в главном меню Project, чтобы открыть представление истории для активного проекта рабочего пространства. Представление History открывается как отдельный документ на вкладке (<ProjectName>.PrjPcb History).
Временная шкала истории — обзор
Представление History отображает временную шкалу основных событий, произошедших в ходе развития проекта. Ее можно условно разделить на три ключевых компонента, показанных на следующем изображении и описанных ниже.
Три ключевых компонента представления History .
- Main trunk of the timeline. События располагаются в хронологическом порядке снизу вверх. Первое событие — создание проекта — находится в нижней части временной шкалы. Последующие события отображаются выше, а самое последнее (наиболее актуальное) — в верхней части шкалы.
- Events. Каждый раз, когда в проекте происходит поддерживаемое событие (см. ниже), оно добавляется на временную шкалу в виде отдельной плитки. Каждому типу событий соответствует свой цвет плитки. Плитка либо соединяется непосредственно с основной линией временной шкалы, либо сопровождается дополнительным значком (как в случае событий обмена данными с MCAD).
-
Search. Нажмите элемент управления
в правом верхнем углу представления, чтобы открыть поле для простого поиска по истории проекта. По мере ввода поискового запроса временная шкала будет фильтроваться, отображая только соответствующие ему события. Подробнее см. в разделе Поиск с фильтрацией.
Поддерживаемые события
Временная шкала показывает последовательность событий, происходящих в течение жизненного цикла проекта. Каждое событие отображается на ней в виде отдельной «плитки события». В следующих раскрывающихся разделах описаны типы событий, которые в настоящее время поддерживаются и могут отображаться в истории проекта.
Создание проекта
Refer to: Создание проекта, Предоставление онлайн-доступа к существующему проекту
При создании проекта на временную шкалу добавляется плитка события Project Created. Это событие отмечает начало истории проекта, поэтому оно всегда находится в самом низу временной шкалы. Плитка этого события может отображаться в двух вариантах:
- Если в рабочем пространстве создан новый проект. Отображаются имя и фотография создателя проекта, а также дата и время создания проекта. Если при создании было введено описание проекта, оно также отображается на плитке.
- Если проект является копией существующего проекта. Отображаются имя пользователя, создавшего копию проекта, а также дата и время создания проекта. Если при копировании было введено описание проекта, оно также отображается на плитке. Доступна ссылка на исходный проект: при нажатии на нее открывается страница подробного управления этим проектом в браузерном интерфейсе рабочего пространства.
Фиксация изменений проекта
Каждый раз при фиксации изменений проекта в рабочем пространстве (где проект управляется с помощью встроенного Versioned Storage Git-репозитория) на шкалу истории добавляется карточка события Project Committed. В ней отображаются имя и фотография пользователя, выполнившего фиксацию (Save to Server), а также дата и время. Если при фиксации в диалоговом окне Commit to Version Control был добавлен комментарий и изменения были отправлены на сервер, этот комментарий также отображается в карточке.
Пример начальной карточки события Project Committed.
В карточке также отображаются результаты сравнения версий проекта, позволяющие подробнее узнать, что изменилось между текущей и предыдущей фиксациями. Поддерживается сравнение файлов, компонентов, цепей, вариантов и структуры печатной платы. В разделе сравнения карточки приведена сводка по элементам, затронутым при фиксации изменений. Они сгруппированы по следующим состояниям:
— элемент добавлен.
— элемент удален.
— элемент изменен.
Нажмите элемент управления
в карточке, чтобы развернуть раздел сравнения и просмотреть имена затронутых элементов.
Нажмите элемент управления
в правом верхнем углу карточки, чтобы открыть меню со следующими командами:
-
Download Sources - u — позволяет загрузить и открыть выбранную ревизию проекта печатной платы или жгута в панели Projects. Имя проекта будет содержать дату и время фиксации этой ревизии. Обратите внимание: эта ревизия доступна только для чтения; ее можно просматривать, но нельзя редактировать.

Любую ревизию проекта можно открыть (только для просмотра) непосредственно из соответствующей ей карточки события Project Committed. -
Compare: Schematic to, PCB to, BOM to — позволяет сравнить данные схемы, печатной платы или спецификации BOM проекта печатной платы в этой фиксации с данными другой фиксации или события выпуска. Используйте подменю, чтобы выполнить сравнение с предыдущей фиксацией или выбрать нужный вариант из всех доступных выпусков и фиксаций. После выбора данных результаты сравнения отображаются в соответствующем представлении различий, которое открывается на новой вкладке браузера по умолчанию. Дополнительную информацию см. в разделе Design Data Comparisons (Рабочее пространство Altium 365, Рабочее пространство Enterprise Server).
-
Create Tag — позволяет добавить одну метку с произвольным именем к любой фиксации проекта (только если проект хранится в рабочем пространстве под управлением его встроенной системы Git VCS). Создать метку можно только для фиксации, уже сохраненной в рабочем пространстве. После выполнения команды открывается диалоговое окно Create Tag. Введите нужную метку и нажмите Create.
Если введенная метка содержит недопустимый символ, в диалоговом окне Create Tag появляется значок
. Наведите указатель на значок, чтобы увидеть подсказку с допустимыми символами: буквы, цифры, точка ('.'), дефис ('-'), знак решетки ('#') и символ подчеркивания ('_'). При необходимости исправьте метку.
Если проект выпускается с помощью Project Releaser и его последняя фиксация еще не имеет метки, ей автоматически назначается метка. Эта метка имеет вид RELEASE_<RevisionID>, где <RevisionID> — номер ревизии выпущенных исходных данных проекта (A.1, A.2 и т. д.), например RELEASE_A.3.
Чтобы переименовать или удалить метку, нажмите
, затем наведите указатель на пункт Tag . Откроется диалоговое окно, в котором можно ввести новое имя метки. При выборе Remove метка удаляется немедленно.
- Создать копию — позволяет создать копию выбранной ревизии проекта. Открывается диалоговое окно Create Project Copy, в котором необходимо указать Project Name (по умолчанию используется исходное имя проекта с суффиксом ' - Copy'), Description (это поле изначально не заполнено), путь Folder (в рабочем пространстве) и путь Local Storage (к рабочей копии). После создания проекта на шкалу истории добавляется карточка события Project Copied.
-
Revert to — используйте эту команду, чтобы вернуться к данным указанной ревизии проекта. Данные исходных документов проекта из этой ревизии перезапишут данные в вашей локальной рабочей копии проекта. По сути, проект на мгновение закрывается, а затем снова открывается с восстановленными данными. Чтобы завершить возврат и сделать эти данные последней ревизией (текущей версией), необходимо выполнить коммит и отправить проект обратно в рабочее пространство.
Вы можете вернуться к любой ревизии проекта непосредственно из соответствующей ей карточки события Project Committed.
Выпуск проекта
Related page: Выпуск проекта
Каждый раз при выпуске проекта печатной платы с помощью Project Releaser в Altium Designer на временную шкалу добавляется карточка события Project Released. На ней отображаются имя и фотография пользователя, выполнившего выпуск, а также дата и время. Если при передаче сформированных данных в рабочее пространство в диалоговом окне Confirm Release было добавлено примечание к выпуску, оно также отображается в карточке. Кроме того, перечисляются все наборы данных, включенные в выпуск.
Пример карточки события Project Released.
Нажмите элемент управления
в правом верхнем углу карточки, чтобы открыть меню со следующими командами:
- Download Sources — используйте эту команду, чтобы скачать и затем открыть (на панели Projects ) ту ревизию проекта, на основе которой был сформирован данный пакет выпуска. Имя проекта будет включать версию выпуска. Обратите внимание: эта ревизия доступна только для чтения — ее можно просматривать, но нельзя редактировать.
- Compare: Schematic to, PCB to, Gerber to, BOM to — позволяет сравнить данные схемы, печатной платы или BOM этого выпуска с данными другого выпуска или коммита. Для сформированных файлов Gerber можно сравнить данные этого выпуска с данными другого выпуска, а при использовании рабочего пространства Altium 365 — также с загруженным набором файлов Gerber. Выберите нужный набор данных для сравнения в подменю. После выбора данных результаты сравнения появятся в соответствующем представлении различий, которое откроется на новой вкладке браузера по умолчанию. Дополнительные сведения см. в разделе Design Data Comparisons (Рабочее пространство Altium 365, Рабочее пространство Enterprise Server).
Копирование проекта
Каждый раз при копировании проекта через браузерный интерфейс рабочего пространства или из Altium Designer на временную шкалу добавляется карточка события Project Copied. На ней отображаются имя и фотография пользователя, выполнившего копирование, а также дата и время. Если при копировании в окне Clone Project (в браузере) или в диалоговом окне Create Project Copy (в Altium Designer) было добавлено описание, оно также отображается в карточке. В карточке есть ссылка на копию проекта. Нажатие на нее открывает страницу подробного управления этим проектом в браузерном интерфейсе рабочего пространства.
Пример карточки события Project Copied.
Обмен данными с MCAD
Related page: Altium MCAD CoDesigner
При совместной работе над электронной и механической частями изделия рабочее пространство служит связующим звеном между ними, обеспечивая прямое совместное проектирование ECAD-MCAD. Каждый раз, когда в конструкцию печатной платы проекта вносятся изменения и передаются в рабочее пространство через соответствующую панель CoDesigner, на временную шкалу добавляется карточка события MCAD Changes Suggested. На ней отображаются имя и фотография пользователя, отправившего изменения, а также дата и время. Если при отправке через панель MCAD CoDesigner (в Altium Designer) или панель Altium CoDesigner (в поддерживаемой системе MCAD) было добавлено сообщение, оно также отображается в карточке.
Пример карточки события MCAD Changes Suggested.
Когда инженер-механик изменяет печатную плату в поддерживаемой системе MCAD и отправляет изменения обратно в рабочее пространство, соответствующее событие отправки появляется на временной шкале истории проекта only после получения этих изменений из рабочего пространства в Altium Designer.
Пример двух событий, связанных с MCAD. Слева от основной линии временной шкалы — событие отправки из ECAD, справа — событие отправки из MCAD.
Локальные изменения
Если документы проекта печатной платы сохранены локально, но еще не сохранены в рабочем пространстве, в верхней части временной шкалы добавляется плитка события Local Changes. Для пользователя, выполнившего локальное сохранение (т. е. текущего пользователя), отображаются имя и фотография.

Пример плитки события Local Changes.
Нажмите элемент управления
в правом верхнем углу плитки, чтобы открыть меню со следующей командой:
- Compare: Schematic to, PCB to, BOM to — позволяет сравнить локально сохраненные данные схемы, печатной платы или BOM в этом коммите с данными события коммита или выпуска. Используйте подменю, чтобы сравнить их с исходными данными предыдущего выпуска, предыдущего коммита или выбрать из всех доступных выпусков и коммитов. После выбора данных для сравнения результаты отображаются в соответствующем представлении различий, которое открывается на новой вкладке браузера по умолчанию. Подробнее см. Design Data Comparisons (рабочее пространство Altium 365, рабочее пространство Enterprise Server).
Поиск с фильтрацией
Нажмите элемент управления
в правом верхнем углу представления, чтобы открыть поле поиска и быстро найти нужные события на временной шкале. Поддерживается простой поиск по истории проекта с динамической фильтрацией по мере ввода поискового запроса — на странице остаются только события, соответствующие запросу. Совпадающий текст в плитке события выделяется.
Пример поиска по истории проекта. Временная шкала динамически фильтруется по мере ввода поискового запроса (без учета регистра), а совпадающий текст выделяется в каждой соответствующей плитке события.
Поиск выполняется по следующей информации:
- Заголовок плитки события.
- Имя пользователя, выполнившего действие.
- Описательный текст (текст из комментария, примечания или описания, введенного при соответствующем событии).
- Текст данных сравнения — в плитке события Project Committed.
- Имя набора данных — в плитке события Project Released.
- Имя проекта — в плитке события Project Copied и плитке события Project Created (при создании путем копирования).
Обновление при появлении новых событий
Каждое поддерживаемое событие, связанное с проектом, автоматически обнаруживается и становится доступным в представлении History . Вскоре после события в нижней части представления появляется уведомление — нажмите элемент управления
, чтобы добавить новое событие на временную шкалу.
Создание отчета об истории проекта
Для проекта рабочего пространства можно создать отчет об истории проекта в формате PDF. Отчет содержит всю информацию об истории проекта, включая создание, коммиты и выпуски, а также описание изменений относительно предыдущего события. Кроме того, можно задать период, за который формируется отчет (см. ниже), чтобы получить именно те сведения, которые вам нужны.
Из OutJob
Чтобы создать отчет, в файле OutputJob (*.OutJob) щелкните правой кнопкой мыши [Add New Report Output], связанный с записью Report Outputs, затем выберите Project History, как показано ниже.
Подключите созданный отчет к выходному контейнеру PDF. Задайте период отчета: щелкните правой кнопкой мыши созданный выходной документ и выберите Configure. Выберите нужный временной Period: For all time (с момента создания проекта до настоящего времени) или Specific releases (используйте раскрывающиеся списки полей From/To, чтобы задать нужные выпуски). Экспортированный отчет будет содержать информацию за выбранный период.
После создания отчета, его подключения к выходному контейнеру PDF и настройки нажмите Generate content, в области контейнера PDF. При необходимости отчет об истории проекта также можно сформировать в рамках процесса выпуска проекта.


, чтобы открыть диалоговое окно Choose Folder (сокращенную версию панели Explorer) и при необходимости изменить папку. По умолчанию для Local Storage будет использоваться расположение, заданное на странице 

