История проекта
Altium Designer в сочетании с подключенным Workspace позволяет просматривать и использовать расширенную графически ориентированную Project History временную шкалу. Специальное History представление показывает последовательную временную шкалу основных событий, связанных с проектом PCB, Multi-board или Harness — его созданием, коммитами, релизами, копиями и обменами MCAD, — с поддержкой различных действий там, где это применимо.
Доступ к истории проекта
Чтобы открыть History представление для проекта Workspace из Altium Designer, щелкните правой кнопкой мыши по его записи на панели Projects и выберите команду History & Version Contol » Show Project History в контекстном меню. Либо выберите команду History & Version Control » Show Project History в главном меню Projects, чтобы открыть представление History для активного проекта Workspace. Представление History открывается как отдельный документ на вкладке (<ProjectName>.PrjPcb History).
, чтобы обновить временную шкалу и отобразить полные исторические данные о событиях.
Временная шкала истории — обзор
Представление History показывает временную шкалу основных событий, произошедших в ходе развития проекта. По сути, ее можно разделить на три ключевых раздела, как показано на следующем изображении и описано ниже.
Определение трех ключевых компонентов представления History .
- Main trunk of the timeline. Хронология событий направлена снизу вверх. Первое событие — создание проекта — отображается внизу временной шкалы. Последующие события располагаются выше, а самое последнее (текущее) событие отображается в верхней части шкалы.
- Events. Каждый раз, когда с проектом происходит поддерживаемое событие (см. ниже), оно добавляется на временную шкалу в виде отдельной плитки. Для каждого типа события используется плитка своего цвета; она либо напрямую связана с основным стволом временной шкалы, либо имеет рядом дополнительный значок (как в случае событий MCAD Exchange).
-
Search. Нажмите элемент управления
в правом верхнем углу представления, чтобы открыть поле поиска для базового поиска по истории проекта. По мере ввода поисковой строки к временной шкале будет применяться фильтрация, и будут отображаться только события, относящиеся к этому поиску. Дополнительные сведения см. в разделе Фильтрованный поиск.
Поддерживаемые события
Временная шкала показывает последовательность событий, происходящих в течение жизненного цикла проекта. Каждое из этих событий отображается на временной шкале в виде отдельной «плитки события». В следующих раскрывающихся разделах рассматривается диапазон событий, которые в настоящее время поддерживаются и могут отображаться как часть исторической временной шкалы проекта.
Project Creation
Refer to: Создание проекта, Размещение существующего проекта в сети
Когда проект создается, на временную шкалу добавляется плитка события Project Created. Это событие отмечает начало исторической временной шкалы проекта. Поэтому оно всегда находится внизу временной шкалы. Плитка этого события может отображаться в двух различных вариантах:
- Когда проект создается непосредственно в Workspace. Отображается имя (и изображение) создателя проекта, а также дата и время создания проекта. Описание проекта также отображается в плитке, если оно было введено при создании.
- Когда проект является копией существующего проекта. Отображается имя человека, создавшего копию проекта, а также дата и время создания проекта. Описание проекта также отображается в плитке, если оно было введено при копировании. Предоставляется ссылка на исходный проект; при нажатии на нее откроется страница подробного управления этим проектом в браузерном интерфейсе Workspace.
.
Project Commit
Каждый раз, когда вы выполняете Commit проекта в Workspace (где проект управляется во внутреннем Versioned Storage репозитории Git Workspace), на временную шкалу добавляется плитка события Project Committed. Отображается имя (и изображение) пользователя, выполнившего коммит (Save to Server), а также дата и время. Если во время коммита и отправки был добавлен комментарий — с использованием диалогового окна Commit to Version Control dialog — он также будет показан в плитке.
Пример начальной плитки события Project Committed.
Плитка также поддерживает и отображает информацию о различиях в проекте, показывая более подробные сведения о том, что изменилось между текущим и предыдущим коммитами. Поддерживаемые элементы включают файлы, компоненты, цепи, варианты и структуру PCB. Раздел сравнения в плитке суммирует различные элементы, затронутые событием коммита, сгруппированные по следующим состояниям:
— элемент добавлен.
— элемент удален.
— элемент изменен.
Щелчок по элементу управления 
в плитке развернет этот раздел сравнения и покажет затронутые элементы по именам.
в плитке, чтобы вернуться к сводному отображению.
Нажмите элемент управления 
в правом верхнем углу плитки, чтобы открыть меню со следующими командами:
-
Download Sources - uиспользуйте для загрузки и открытия этой конкретной ревизии проекта PCB или Harness на панели Projects. Имя проекта будет включать дату и время, когда эта ревизия была закоммичена. Обратите внимание, что эта ревизия доступна только для чтения; ее можно просматривать, но нельзя редактировать.
Вы можете открыть (только для просмотра) любую конкретную ревизию проекта — непосредственно из соответствующей плитки события Project Committed для этой ревизии. -
Compare: Schematic to, PCB to, BOM to — позволяет сравнить данные схемы, PCB или BOM проекта PCB в этом коммите с данными другого коммита или события выпуска. Используйте подменю, чтобы сравнить с предыдущим коммитом, либо выберите из всех доступных выпусков и коммитов. После выбора данных для сравнения результаты будут представлены в соответствующем представлении различий, которое откроется в новой вкладке браузера по умолчанию. Дополнительные сведения см. в Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
-
Create Tag — позволяет добавить один пользовательский тег с произвольным именем к любому коммиту проекта разработки (и только если этот проект хранится в Workspace под его внутренней системой Git VCS). Создать тег можно только для коммита, который уже сохранен в Workspace. После выполнения команды откроется диалоговое окно Create Tag. Введите нужный тег и нажмите Create.
Если введенный тег содержит недопустимый символ, в диалоговом окне Create Tag появится значок
. Наведите указатель на значок, чтобы увидеть подсказку о том, какие символы разрешены, а именно: буквы, цифры, точка ('.'), дефис ('-'), знак номера ('#') и подчеркивание ('_'); при необходимости исправьте тег.
Когда проект выпускается с помощью Project Releaser и его последний коммит еще не имеет тега, этому последнему коммиту тег будет назначен автоматически. Этот тег будет иметь вид RELEASE_<RevisionID>, где <RevisionID> — номер ревизии выпущенных исходных данных проекта (A.1, A.2 и т. д.), например, RELEASE_A.3.
Чтобы переименовать или удалить тег, нажмите 
, затем наведите указатель на запись Tag . Откроется диалоговое окно, в котором можно ввести новое имя тега. Если выбран Remove , тег будет немедленно удален.
- Make a copy — используется для создания копии из этой конкретной ревизии проекта. Откроется диалоговое окно Create Project Copy, в котором нужно ввести Project Name (по умолчанию это будет исходное имя проекта с суффиксом ' - Copy'), Description (не заполняется автоматически), путь Folder (внутри Workspace) и путь Local Storage (к рабочей копии). Проект будет создан, а на временную шкалу будет добавлена плитка события Project Copied.
, чтобы открыть диалоговое окно Choose Folder (упрощенную версию панели Explorer) и при необходимости изменить папку. Путь Local Storage по умолчанию будет использовать расположение, заданное на странице System - Default Locations диалогового окна Preferences. Нажмите , чтобы открыть стандартное диалоговое окно Windows и при необходимости изменить это расположение.
-
Revert to — используйте эту команду, чтобы вернуться к данным из этой конкретной ревизии проекта. Данные исходных документов проекта из этой конкретной ревизии перезапишут данные в вашей локальной рабочей копии проекта. Фактически проект на короткое время закрывается, а затем снова открывается с этими восстановленными данными. Если вы хотите завершить откат и сделать эти данные Head Revision (текущей версией), необходимо выполнить commit и push проекта обратно в Workspace.
Вы можете откатиться к любой конкретной ревизии проекта непосредственно из соответствующей плитки события Project Committed для этой ревизии.
. Последняя ревизия проекта (то есть последний коммит) отличается тем, что ее узел имеет белую заливку: 
.
Project Release
Related page: Выпуск проекта разработки
Каждый раз, когда вы выполняете выпуск проекта PCB с помощью Project Releaser в Altium Designer, на временную шкалу добавляется плитка события Project Released. Отображаются имя (и фотография) пользователя, выполнившего выпуск, а также дата и время. Если в момент публикации сгенерированных данных в Workspace через диалоговое окно Confirm Release dialog была добавлена заметка к выпуску, она также будет показана внутри плитки. Также будут перечислены все наборы данных, включенные в выпуск.
Пример плитки события Project Released.
Нажмите элемент управления 
в правом верхнем углу плитки, чтобы открыть меню со следующими командами:
- Download Sources — используйте эту команду, чтобы загрузить, а затем открыть (на панели Projects ) конкретную ревизию проекта, из которой был сформирован этот пакет выпуска. Имя проекта будет включать версию выпуска. Обратите внимание, что эта ревизия доступна только для чтения; вы можете просматривать ее, но не можете каким-либо образом редактировать.
- Compare: Schematic to, PCB to, Gerber to, BOM to — позволяет сравнить данные схемы, PCB или BOM в этом выпуске с данными другого выпуска или события коммита. Для сгенерированных Gerber можно сравнить данные этого выпуска с данными другого выпуска или, при использовании Altium 365 Workspace, с загруженным набором файлов Gerber. Используйте подменю, чтобы сравнить с нужным набором данных. После выбора данных для сравнения результаты будут представлены в соответствующем представлении различий, которое откроется в новой вкладке браузера по умолчанию. Дополнительные сведения см. в Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Copying a Project
Каждый раз, когда вы копируете проект — либо через браузерный интерфейс Workspace, либо из Altium Designer, — на временную шкалу добавляется плитка события Project Copied. Отображаются имя, фотография, дата и время пользователя, выполнившего копирование. Если во время копирования через окно Clone Project (в браузере) или диалоговое окно Create Project Copy (в Altium Designer) было добавлено описание, оно также будет показано внутри плитки. Предоставляется ссылка на скопированный проект. Щелчок по ней откроет подробную страницу управления этим проектом в браузерном интерфейсе Workspace.
Пример плитки события Project Copied.
в правом верхнем углу плитки. В появившемся меню выберите команду Make a copy .
.
MCAD Exchanges
Related page: Altium MCAD CoDesigner
При работе между областями электронной и механической разработки Workspace выступает мостом между ними, обеспечивая непосредственное совместное проектирование ECAD-MCAD. Каждый раз, когда в PCB-проект вносятся изменения и эти изменения отправляются в Workspace через соответствующую панель CoDesigner, на временную шкалу добавляется плитка события MCAD Changes Suggested. Отображаются имя (и фотография) пользователя, выполнившего отправку, а также дата и время. Если в момент отправки через панель MCAD CoDesigner (Altium Designer) или панель Altium CoDesigner (в поддерживаемом MCAD-программном обеспечении) было опубликовано сообщение, оно также будет показано внутри плитки.
Пример плитки события MCAD Changes Suggested.
Когда инженер MCAD вносит изменения в PCB в поддерживаемом MCAD-приложении и отправляет их обратно в Workspace, соответствующее событие отправки будет доступно на временной шкале истории проекта only после получения изменений из Workspace в Altium Designer.
Пример, показывающий два события, связанных с MCAD. Слева от основной линии временной шкалы — событие отправки со стороны ECAD, справа — событие отправки со стороны MCAD.
.
Local Changes
Если документы проекта PCB сохранены локально, но еще не отправлены в Workspace, в верхней части временной шкалы будет добавлена плитка события Local Changes. Человек, выполнивший локальное сохранение (то есть текущий пользователь), отображается по имени (и фотографии).
Пример плитки события Local Changes.
Нажмите элемент управления в правом верхнем углу плитки, чтобы открыть меню со следующей командой:
- Compare: Schematic to, PCB to, BOM to — позволяет сравнить локально сохраненные данные Schematic, PCB или BOM в этом коммите с данными коммита или события выпуска. Используйте подменю, чтобы сравнить с исходными данными предыдущего выпуска, исходными данными предыдущего коммита или выбрать из всех возможных выпусков и коммитов. После выбора данных для сравнения результаты будут показаны в соответствующем представлении различий, которое откроется в новой вкладке браузера по умолчанию. Дополнительную информацию см. в Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
.
Фильтрованный поиск
Нажмите элемент управления в правом верхнем углу представления, чтобы открыть поле поиска, с помощью которого можно быстро находить интересующие события на временной шкале. Средство поиска поддерживает базовый поиск по истории проекта с динамической фильтрацией по мере ввода поисковой строки — на странице остаются только события, относящиеся к этому поиску. Совпадающий текст внутри плитки события подсвечивается.
Пример поиска по истории проекта. Временная шкала динамически фильтруется по мере ввода поискового запроса (без учета регистра), а совпадающие записи подсвечиваются в каждой соответствующей плитке события.
Поиск работает со следующей информацией:
- Заголовок плитки события.
- Имя человека, выполнившего событие.
- Описательный текст (текст из комментария/заметки/описания, добавленного при возникновении соответствующего события).
- Текст данных сравнения — в плитке события Project Committed.
- Имя набора данных — в плитке события Project Released.
- Имя проекта — в плитке события Project Copied и плитке события Project Created (если создано путем копирования).
в крайней правой части поля. Либо нажмите элемент управления Clear Filter в блоке, где показано, сколько событий отображается (в верхней части представления).
Обновление при появлении новых событий
Каждый раз, когда в отношении проекта происходит поддерживаемое событие, оно автоматически обнаруживается и становится доступным в представлении History . Вскоре после возникновения события в нижней части представления появится уведомление — нажмите элемент управления , чтобы обновить временную шкалу и добавить новое событие.
в правом верхнем углу представления.
Создание отчета по истории проекта
Для проекта Workspace можно создать отчет Project History в формате PDF. В отчете отображается вся информация об истории проекта, включая создание, коммиты и выпуски, а также описание изменений относительно предыдущего события. Вы также можете задать период времени для отчета (описан ниже), чтобы получить именно тот отчет, который вам нужен.
Из OutJob
Чтобы создать отчет, в файле OutputJob (*.OutJob) щелкните правой кнопкой мыши по элементу [Add New Report Output], связанному с записью Report Outputs, затем выберите Project History, как показано ниже.
Подключите вновь созданный отчет к контейнеру вывода PDF. Задайте период времени для отчета, щелкнув правой кнопкой мыши по созданному выходному элементу и выбрав Configure. Включите нужный параметр времени Period: For all time (от создания проекта до текущего момента) или Specific releases (используйте раскрывающиеся списки поля From/To, чтобы задать нужные выпуски). Экспортированный отчет будет содержать информацию за выбранный вами период времени.
После того как отчет будет создан, связан с контейнером вывода PDF и настроен, в области контейнера PDF нажмите Generate content, или, при необходимости, вы можете сформировать отчет по истории проекта как часть процесса project release.
Из меню Reports
Локализовано с помощью ИИ