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

Краткий обзор

Узнайте, как представление Project History в Altium Designer помогает отслеживать развитие проекта, подключенного к рабочему пространству, с помощью графической временной шкалы, на которой отображаются создание проекта, коммиты, выпуски, копии и обмен данными с MCAD. В этой статье рассказывается, как открыть временную шкалу и перемещаться по ней, как интерпретировать карточки событий и использовать действия с коммитами для просмотра изменений и предыдущих ревизий, сравнения проектных данных и управления тегами. Также объясняется, почему для доступа к истории коммитов важно использовать встроенную систему контроля версий рабочего пространства. Читайте дальше, чтобы эффективнее использовать историю своего проекта.

- Узнайте, как открывать историю проекта и файлов, перемещаться между событиями и фильтровать временную шкалу с помощью поиска.
- Ознакомьтесь с требованиями к настройке, включая расширение Project History и встроенную систему контроля версий Git рабочего пространства.
- Узнайте, как просматривать изменения в коммитах, открывать ревизии в режиме только для чтения, сравнивать данные схем, печатных плат и спецификаций (BOM), а также управлять тегами коммитов.
Узнайте больше с ИИ:

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

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

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

Информацию о работе с представлением History для проекта через браузерный интерфейс рабочего пространства см. в разделе История проекта.

Для доступа к истории проекта в Altium Designer необходимо установить программное расширение Project History . По умолчанию это расширение устанавливается вместе с Altium Designer. Его можно установить или удалить вручную.

Подробнее об управлении расширениями см. на странице Extending Your Installation (Altium Designer Develop, Altium Designer Agile, Altium Designer).

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

Чтобы открыть представление History для проекта рабочего пространства в Altium Designer, щелкните правой кнопкой мыши его запись на панели Projects и выберите команду History & Version Contol » Show Project History в контекстном меню. Также можно выбрать команду History & Version Control » Show Project History в главном меню Project, чтобы открыть представление истории для активного проекта рабочего пространства. Представление History открывается как отдельный документ на вкладке (<ProjectName>.PrjPcb History).

Если проект в вашем рабочем пространстве существовал до появления функции истории проекта, его история изначально будет неполной. При первом открытии представления History для этого проекта данные о его событиях будут автоматически переиндексированы. После завершения переиндексации в нижней части представления появится уведомление. Нажмите элемент управления , чтобы обновить временную шкалу и отобразить полную историю событий.
Чтобы открыть представление History для файла проекта рабочего пространства, то есть временную шкалу основных событий проекта, связанных с этим файлом, щелкните файл правой кнопкой мыши на панели Projects и выберите команду History & Version Control » Show File History в контекстном меню.

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

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

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

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

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

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

Поиск с фильтрацией

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

Поиск выполняется без учета регистра.

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

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

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

  • Заголовок плитки события.
  • Имя пользователя, выполнившего действие.
  • Описательный текст (текст из комментария, примечания или описания, введенного при соответствующем событии).
  • Текст данных сравнения — в плитке события Project Committed.
  • Имя набора данных — в плитке события Project Released.
  • Имя проекта — в плитке события Project Copied и плитке события Project Created (при создании путем копирования).
Чтобы сбросить текущую фильтрацию и вернуться к полной временной шкале, очистите поле поиска: выделите текущий текст и нажмите клавишу Backspace или нажмите элемент управления в правой части поля. Также можно нажать элемент управления Clear Filter в блоке с количеством отображаемых событий (в верхней части представления).

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

Каждое поддерживаемое событие, связанное с проектом, автоматически обнаруживается и становится доступным в представлении 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. При необходимости отчет об истории проекта также можно сформировать в рамках процесса выпуска проекта.

Из меню Reports

Историю проекта можно экспортировать в PDF, выбрав Reports » Project History в главном меню. Откроется диалоговое окно Project History Report Configuration , в котором можно задать Period для экспорта отчета: всю историю проекта либо период между определенными выпусками проекта (в том числе до последнего выпуска). Нажмите Export, затем в открывшемся окне Explorer введите имя экспортируемого PDF-файла и нажмите Save. Отчет PDF откроется в браузере.
AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Меню
Contents
Доступность функций

Доступные вам функции зависят от того, какое решение Altium вы используете: Altium Develop, Altium Agile Teams, Altium Agile Enterprise или Altium Designer (при активной подписке).

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

Устаревшая документация

Документация Altium Designer больше не разделена по версиям ПО. Если вам необходим доступ к документации по старым версиям Altium Designer, посетите раздел Устаревшая документация на странице Прочие установщики.

Contents