История проекта
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 в главном меню Project, чтобы открыть представление History для активного проекта Workspace. Представление History открывается как отдельный документ с вкладкой (<ProjectName>.PrjPcb History).
, чтобы обновить временную шкалу полными историческими данными событий.
Временная шкала истории — обзор
Представление History показывает временную шкалу основных событий, произошедших в ходе развития проекта. По сути, ее можно разделить на три ключевых секции, как показано на следующем изображении и описано ниже.
Определение трех ключевых компонентов представления History .
- Main trunk of the timeline. Хронология событий идет снизу вверх. Первое событие — создание проекта — отображается внизу временной шкалы. Последующие события отображаются выше, а самое последнее (текущее) событие — вверху временной шкалы.
- Events. Каждый раз, когда с проектом происходит поддерживаемое событие (см. ниже), это событие добавляется на временную шкалу в виде отдельной плитки. Для каждого типа события используется плитка своего цвета, которая либо напрямую связана с основным стволом временной шкалы, либо имеет рядом дополнительный значок (как в случае событий MCAD Exchange).
-
Search. Нажмите элемент управления
в правом верхнем углу представления, чтобы открыть поле поиска, позволяющее выполнять базовый поиск по истории проекта. По мере ввода строки поиска к временной шкале применяется фильтрация, и отображаются только события, относящиеся к этому запросу. Дополнительные сведения см. в разделе Filtered Searching.
Поддерживаемые события
На временной шкале отображается последовательность событий, происходящих в течение жизненного цикла проекта. Каждое из этих событий появляется на временной шкале как отдельная «плитка события». В следующих раскрывающихся разделах рассматривается диапазон событий, которые в настоящее время поддерживаются и могут быть представлены как часть исторической временной шкалы проекта.
Project Creation
Refer to: Создание проекта, Публикация существующего проекта в интернете
При создании проекта на временную шкалу добавляется плитка события Project Created. Это событие отмечает начало исторической временной шкалы проекта. Поэтому оно всегда находится внизу временной шкалы. Плитка этого события может отображаться в двух различных вариантах:
- Когда проект создается непосредственно в Workspace. Указывается имя создателя проекта (и его фотография), а также дата и время создания проекта. Если при создании было введено описание проекта, оно также отображается в плитке.
- Когда проект является копией существующего проекта. Указывается имя человека, создавшего копию проекта, а также дата и время создания проекта. Если при копировании было введено описание проекта, оно также отображается в плитке. Предоставляется ссылка на исходный проект; при нажатии на нее открывается страница подробного управления этим проектом в браузерном интерфейсе Workspace.
.
Project Commit
Каждый раз, когда вы выполняете Commit проекта в Workspace (если проект управляется во внутреннем Versioned Storage Git repository 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 – позволяет сравнить данные Schematic, PCB или BOM в этом коммите с данными другого события коммита или релиза. Используйте подменю, чтобы сравнить с предыдущим коммитом или выбрать из всех возможных релизов и коммитов. После выбора данных для сравнения результаты отображаются в соответствующем представлении различий, которое открывается как новая вкладка в браузере по умолчанию. Дополнительные сведения см. в 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 , тег удаляется немедленно.
- Создать копию – используется для создания копии из этой конкретной ревизии проекта. Откроется диалоговое окно 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 (текущей версией), необходимо выполнить коммит и отправить проект обратно в 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 – позволяет сравнить данные Schematic, 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 — позволяет сравнить локально сохраненные данные схемы, PCB или BOM в этом коммите с данными коммита или события выпуска. Используйте подменю, чтобы сравнить с исходными данными предыдущего выпуска, исходными данными предыдущего коммита или выбрать из всех возможных выпусков и коммитов. После выбора данных для сравнения результаты будут представлены в соответствующем представлении различий, которое откроется в новой вкладке браузера по умолчанию. Дополнительную информацию см. в Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
.
Поиск с фильтрацией
Нажмите элемент управления в правом верхнем углу представления, чтобы открыть поле поиска, с помощью которого можно быстро находить интересующие события на временной шкале. Средство поиска поддерживает базовый поиск по истории проекта с динамической фильтрацией по мере ввода поисковой строки — на странице остаются отображаться только события, относящиеся к этому запросу. Совпадающий текст в плитке события будет подсвечен.
Пример поиска по истории проекта. Временная шкала динамически фильтруется по мере ввода поискового запроса (без учета регистра), а совпадающие записи подсвечиваются в каждой соответствующей плитке события.
Поиск работает со следующей информацией:
- Заголовок плитки события.
- Имя пользователя, выполнившего событие.
- Описательный текст (текст из комментария/заметки/описания, добавленного при возникновении соответствующего события).
- Текст данных сравнения — в плитке события Project Committed.
- Имя набора данных — в плитке события Project Released.
- Имя проекта — в плитке события Project Copied и плитке события Project Created (если она создана путем копирования).
в крайней правой части поля. Либо нажмите элемент управления Clear Filter в блоке с информацией о количестве отображаемых событий (в верхней части представления).
Обновление при появлении новых событий
Каждый раз, когда происходит поддерживаемое событие, связанное с проектом, оно будет автоматически обнаружено и станет доступно в представлении History . В нижней части представления вскоре после возникновения события появится уведомление — нажмите элемент управления , чтобы обновить временную шкалу и добавить новое событие.
в правом верхнем углу представления.
Создание отчета по истории проекта
Для проекта Workspace можно создать отчет по истории проекта в формате 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
Локализовано с помощью ИИ