Storage Manager Panel

Панель Storage Manager

Сводка

Панель Storage Manager предоставляет элементы управления для навигации по активному проекту с точки зрения хранения его файлов в Windows. Панель также предоставляет доступ к функции локальной истории для документов а также к системе контроля версий.

Доступ к панели

Панель можно открыть следующими способами:

• Нажмите кнопку Panels в правом нижнем углу рабочей области проектирования, затем нажмите Storage Manager.
• Выберите View » Panels » Storage Manager в главном меню.
• Щёлкните правой кнопкой мыши по файлу схемы или PCB в панели Projects , затем выберите пункт History & Version Control » Storage Manager в контекстном меню.

Содержимое и использование

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

Когда активный документ — это SVN Database Library (*.SVNDBLib), панель покажет локальную рабочую копию библиотек символов и посадочных мест полученных (checked out) из связанного репозитория Subversion. Панель служит центральным интерфейсом для фиксации (commit) изменений в репозиторий и обновления из репозитория. 

Панель Storage Manager можно использовать для:

• Общих функций управления файлами для файлов проекта или в структуре папок активного проекта.
• Управления библиотеками символов и посадочных мест, хранящимися в SVN-репозитории и связанными с SVN Database Library. Панель предоставляет доступ к локальному рабочему каталогу, в который выполняется получение (checkout) копии библиотек, хранящихся в репозитории. Фиксация изменений в репозиторий и получение обновлений из репозитория могут выполняться только через эту панель.
• Управления резервными копиями с помощью функции Local History (см. Data Management - Local History).
• В качестве SVN-совместимого интерфейса для ваших проектов.
• Выполнения физического и электрического сравнения любых двух версий в Local History.

Области панели

Панель Storage Manager разделена на три области:

• Project Folders область
• Project Files область

• Time line область

  

  • Щёлкните правой кнопкой мыши в области Time line, затем выберите Switch to Classic View, чтобы отобразить разделённый вид для VCS Revisions и Local History.

    

    Чтобы вернуться к виду Time line, щёлкните правой кнопкой мыши и выберите Switch to Combined View.

Область папок

Эта область отображает структуру папок активного проекта. Когда активный документ является частью проекта или SVN Database Library, имя проекта или библиотеки используется как заголовок этой области. Файл проекта указан в верхней части структуры и соответствует корневому каталогу, а все остальные папки и подпапки, находящиеся в этом каталоге, отображаются ниже в соответствии с иерархией хранения.

Если активный документ в окне редактора является частью проекта, эта структура хранения папок проекта будет оставаться отображённой. Если активный документ — свободный документ (т. е. не добавлен в проект), в области появится только запись для этого документа, представляющая корневой каталог, в котором он находится. Другие подпапки отображаться не будут, даже если они существуют на жёстком диске.

Если активный документ — файл SVN Database Library, будет показана структура папок для символов и посадочных мест, полученных (checked out) в локальный рабочий каталог. Этот каталог является локальным рабочим пространством, из которого изменения фиксируются (commit) в библиотеках связанного SVN-репозитория.

Когда вы щёлкаете по записи, документы, содержащиеся в корневом каталоге или подпапке, перечисляются в области Files.

Щёлкните правой кнопкой мыши в области Folders, чтобы получить доступ к следующим командам:

• Refresh - нажмите, чтобы обновить содержимое области после использования команды Delete или после внесения изменений в папки через Windows Explorer.
• Copy - нажмите, чтобы скопировать выбранный элемент. Это позволяет легко копировать папки между проектами. Если при выборе этой команды выделена запись самого проекта, будет скопирована вся структура папок.
• Paste - нажмите, чтобы вставить ранее скопированную папку или каталог проекта в структуру папок активного проекта. Содержимое будет вставлено в папку, находящуюся в фокусе в структуре. Содержимое буфера обмена можно вставить только один раз.

• Delete - нажмите, чтобы удалить выбранные папки из структуры папок. Перед удалением появится диалог с запросом подтверждения. Продолжение приведёт к безвозвратному удалению папок с жёсткого диска.

  • Папка (и входящие в неё документы) в репозитории контроля версий не затрагиваются — удаляются только локальные копии для данного экземпляра проекта, полученного (checked out).
  • Запись самого проекта удалить нельзя.

• Rename - нажмите, чтобы переименовать выбранную папку или папку в фокусе в группе выбранных папок. Запись папки станет редактируемой. Введите новое имя папки.

  • Вы также можете переименовать выбранную папку, нажав F2.
  • Папка в репозитории контроля версий не затрагивается — переименовывается только локальная папка для данного экземпляра проекта, полученного (checked out).
  • Корневую папку переименовать нельзя.
• New - нажмите, чтобы создать новую подпапку под текущей выбранной папкой в структуре. После запуска команды папка будет добавлена на жёсткий диск, а запись станет редактируемой, что позволит сразу ввести имя папки. Если родительская папка уже содержит подпапки, новая папка будет добавлена ниже существующих в структуре.

Область файлов

Эта область панели перечисляет все документы, которые в данный момент хранятся в корневом каталоге или подпапке активного проекта. Для свободного документа будут показаны все документы, хранящиеся в том же месте, что и свободный документ.

Для документа SVN Database Library эта область перечисляет все библиотеки символов или посадочных мест в папке, выбранной в области Folders . Это не библиотеки из самого репозитория; вместо этого это те, которые были получены (checked out) в ваш локальный рабочий каталог.

Когда вы щёлкаете по записи в области Folders, содержимое документа будет отображено как показано.

Для каждого документа отображается следующая информация:

• File - имя файла включая расширение.
• Size - размер файла на диске в байтах.
• Kind - тип файла.
• Date Modified - дата и время последнего сохранения файла.
• Status - текущий статус документа относительно контроля версий.

Дополнительная информация о документе передаётся с помощью следующих приёмов отображения записей (большинство этих типов отображения относится только к документу, который является частью проекта):

• Bold текст - используется для выделения активного документа в окне редактора проектирования.
• Красный текст - используется для выделения документа, который был изменён и не сохранён. (Примечание: когда документ одновременно активен и изменён, он будет отображаться как выделенная красная запись).
• Серый текст - используется для выделения документа, который существует в папке, но не добавлен в проект. Запись в столбце Kind будет заключена в скобки (например, {TEXT}). Чтобы скрыть эти документы в списке и показывать только документы, добавленные в проект, установите флажок Only Show Files in Current Project в правом верхнем углу области.
• Italics - используется для выделения документа, который добавлен в проект, но не находится в иерархии хранения этого проекта (например, файл ограничений, входящий в установку).

Когда вы щёлкаете по записи документа, путь к локальной папке, в которой находится этот документ, отображается в верхней части панели (полный путь также показывается как всплывающая подсказка). Также будет показан статус связи с папкой репозитория в SVN Repository. Чтобы скрыть документы, которые существуют в папке, но фактически не добавлены в текущий проект, установите флажок Only Show Files in Current Project.

Щёлкните правой кнопкой мыши в области Files, чтобы получить доступ к следующим командам:

• Open - нажмите, чтобы открыть выбранный документ как активный документ в окне редактора проектирования. Если выбрана группа документов, все документы будут открыты как документы во вкладках в окне редактора проектирования, а запись в фокусе станет активным документом. (Двойной щелчок по записи документа также откроет его как активный документ в окне редактора проектирования.)
• Refresh - нажмите, чтобы обновить содержимое области, например, после использования команды Delete или после внесения изменений в документ через Windows Explorer. Команда также сравнивает файлы в рабочей папке с их аналогами в репозитории проектирования, соответствующим образом обновляя статус каждого документа.
• Copy- щелкните, чтобы скопировать выбранный(е) документ(ы). Это позволяет легко копировать документы между папками одного и того же проекта или в папку другого проекта.
• Paste - щелкните, чтобы вставить ранее скопированный(е) документ(ы) в папку, находящуюся в фокусе, для активного проекта. Содержимое буфера обмена можно вставить только один раз.
• Add Project Folder to Version Control - для проектов, которые еще не зафиксированы в системе контроля версий, эта команда откроет диалог Add to Version Control, в котором можно добавить в контроль версий всю папку проекта.

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

  • Документы в репозитории системы контроля версий не затрагиваются — удаляются только локальные копии для данного экземпляра проекта, взятого в работу (checked-out). В панели Storage Manager удаленные документы по-прежнему будут отображаться в списке, но информация о них не будет показана, поскольку локально они не существуют. Удаленный документ будет отображаться со статусом Missing.
  • Документ проекта нельзя удалить.

• Rename - щелкните, чтобы переименовать выбранный документ (или документ в фокусе в группе выбранных документов). Запись имени файла документа станет доступной для редактирования. Введите новое имя.

  • Вы также можете переименовать выбранный документ, нажав F2.
  • Документ в репозитории системы контроля версий не затрагивается — будет переименован только локальный документ для данного экземпляра проекта, взятого в работу (checked-out).
• Add to Version Control - эта команда доступна только если активный проект находится под контролем версий, и открывает диалог Add to Version Control, где выбранная папка в Folders списке будет добавлена в контроль версий в составе родительской папки проекта.

Команды контроля версий в контекстном меню

Если на компьютере установлено ПО для контроля версий, в контекстном меню (по правому щелчку) будут доступны дополнительные команды, связанные с контролем версий. Точный набор команд зависит от того, добавлены ли активный проект и его документы в репозиторий контроля версий, а также от типа используемой системы контроля версий. Ниже приведен список всех возможных команд. Команды, специфичные для определенного типа системы контроля версий, помечены соответствующим образом:

• Refresh - используйте эту команду, чтобы проверить связь между выбранным проектом в панели Storage Manager и соответствующим проектом, находящимся в базе данных контроля версий, и обновить статус локального проекта и его документов. После запуска команды статус проекта в фокусе и его документов сверяется с записями в базе данных контроля версий и обновляется. Эту команду можно использовать в любое время, но она особенно полезна, если вы выполняли действие напрямую в ПО контроля версий, например check in, check out или remove. Также можно использовать F5 горячую клавишу на панели Storage Manager, чтобы обновить статус документов.

• Commit Whole Project - используйте эту команду, чтобы зафиксировать (commit) в системе контроля версий проект, который уже был добавлен (на что указывает статус файлов Scheduled for addition, см. выше), либо массово выполнить check in изменений во всех файлах родительского проекта.

  После запуска команды появится диалог Commit to Version Control dialog. Все измененные файлы будут доступны для commit. Если есть другие файлы, которые еще не находятся под контролем версий, они также будут перечислены, но по умолчанию не будут выбраны. Выберите, что нужно зафиксировать и/или добавить в репозиторий контроля версий, при необходимости введите комментарий и нажмите Commit / Commit and Push — файлы будут добавлены в базу данных контроля версий, а в связанном поле No modification для документа(ов) в области Files панели появится запись Status .

  

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

  Обратите внимание: для Workspace-проектов на базе Git команда Commit Whole Project недоступна. Вы можете использовать команду Save to Server из контекстного меню записи проекта на панели Projects, чтобы одним действием выполнить commit Workspace-проекта в локальный репозиторий и отправить (push) его в удаленный репозиторий.

  При необходимости команду Commit Whole Project можно сделать доступной, включив параметр VCS.AllowGitCommit в диалоге Advanced Settings dialog.

• Update Whole Project - используйте эту команду, чтобы массово обновить устаревшие файлы в родительском проекте, обновляя рабочую копию каждого файла изменениями из последней ревизии этого файла в репозитории VCS.

  После запуска команды появится диалог Update from Version Control. Все устаревшие файлы будут доступны для обновления. Выберите, что нужно обновить, и нажмите Update — версии файлов будут синхронизированы: локальная версия каждого выбранного документа будет обновлена до последней ревизии из репозитория контроля версий. Статус каждого файла вернется к No Modification.

• Add Project Folder to Version Control - используйте эту команду, чтобы добавить выбранный проект в репозиторий/базу данных контроля версий. Эта команда доступна только тогда, когда проект еще не был (или ранее не был) добавлен в контроль версий. В результате будет создана копия проекта под контролем версий в выбранном целевом репозитории проектирования (Design Repository). VCS настроит файлы и параметры проекта так, чтобы при дальнейшей работе с этим проектом Altium Designer распознавал, что он находится под контролем исходников, и корректно отражал статус документов — например, когда документ был изменен или добавлен (но еще не зафиксирован) в VCS. 

  После запуска команды откроется диалог Add to Version Control (в зависимости от используемого ПО контроля версий), в котором потребуется выбрать целевой Design Repository или создать новую запись папки для текущего проекта. После определения области хранения проекта (и, следовательно, привязки проекта к базе данных) диалог будет заполнен проектом и входящими в него документами, при этом файл проекта уже будет выбран для добавления в базу данных контроля версий. При необходимости выберите другие файлы, которые вы хотите поместить под контроль версий на этом этапе.

  Выберите Design Repository в Add to Version Control диалоге, чтобы заполнить диалог предлагаемыми файлами для контроля версий.

  После нажатия OK файлы будут добавлены в базу данных контроля версий, и в связанном поле Status для документа(ов) в области Files появится запись Scheduled for addition.

• Commit - используйте эту команду, чтобы выполнить check in изменений, внесенных в рабочую копию выбранного файла (отличается статусом Modified), в репозиторий VCS. После запуска команды откроется диалог Edit Comment. Введите новый комментарий или выберите предыдущий и нажмите OK для фиксации (commit) документа(ов). Последняя копия файла из вашей рабочей папки будет зафиксирована, а связанный номер ревизии увеличится — см. Commit Whole Project выше.

  Обратите внимание: вы не сможете выполнить commit файла, если кто-то другой зафиксировал обновление после того, как вы сделали check out своей копии файла. В этом случае перед commit потребуется сначала выполнить Update.

  Обратите внимание: для Workspace-проектов на базе Git команда Commit недоступна. Вы можете использовать команду Save to Server из контекстного меню записи проекта на панели Projects, чтобы одним действием выполнить commit Workspace-проекта в локальный репозиторий и отправить (push) его в удаленный репозиторий.

  Видимость команды управляется параметром VCS.AllowGitCommit в диалоге Advanced Settings dialog. Диалог Advanced Settings открывается нажатием кнопки Advanced на странице System – General page диалога Preferences. Если в диалоге Advanced Settings внесены изменения, Altium Designer необходимо перезапустить, чтобы изменения вступили в силу.

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

  После запуска команды версии файлов будут синхронизированы: локальная версия каждого выбранного документа будет обновлена до последней ревизии этого документа из репозитория контроля версий. Статус каждого файла вернется к No Modification.

• Lock - используйте эту команду для блокировки активного документа в SVN Version Control. Только разработчик, заблокировавший документ, может выполнить commit документа с любыми изменениями в репозиторий. После выполнения этой команды в столбце статуса в панели Storage Manager появится «Locked by me». Подробнее см. Locking Files of an SVN Project.

• Unlock - используйте эту команду, чтобы разблокировать выбранный заблокированный документ в SVN Version Control. После разблокировки любой пользователь сможет выполнить commit документа с любыми изменениями в репозиторий. Подробнее см. Locking Files of an SVN Project.

• Resolve Conflict - используйте эту команду для разрешения конфликта (когда один и тот же файл был локально отредактирован и сохранён двумя пользователями Altium Designer, и один из них зафиксировал эти изменения), отклоняя изменения, зафиксированные в репозитории с момента вашего последнего обновления. Подробнее см. Revision Conflict.
• Revert Local Modifications - используйте эту команду, чтобы откатить файлы со статусом Modified и отбросить назначенные им локальные изменения. Перед окончательным выполнением действия вам будет предложено подтвердить изменения. Все локальные изменения документа будут потеряны, а файл будет возвращён к своей базовой ревизии (последней ревизии файла, полученной при checkout/обновлении в рабочую папку). Status файла, который был откатан, зависит от его предыдущего статуса. Например, файл, отображаемый как Modified , будет возвращён к No modification. Файл, который находился в Conflict , будет возвращён к Out of date (поскольку в репозитории существует более поздняя версия).

• Add To Version Control - используйте эту команду, чтобы добавить выбранный(е) файл(ы) в ваш репозиторий системы контроля версий. После запуска команды статус файла(ов) изменится на Scheduled for addition. Как и в случае добавления целого проекта, финальный шаг Commit откроет диалог Edit Comment .

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

  Обратите внимание: чтобы выбранный(е) файл(ы) могли быть корректно checked in, они должны входить в родительский проект. Если добавляемый файл сейчас открыт, перед добавлением в систему контроля версий его следует сохранить, поскольку в VCS попадает последняя сохранённая версия файла, а не текущая копия в памяти.

• Remove From Version Control - используйте эту команду, чтобы удалить выбранный проект из вашего репозитория системы контроля версий. Эта команда доступна только когда проект уже добавлен в систему контроля версий. После запуска команды появится диалог Remove from Version Control, при этом запись проекта будет уже выбрана.

  Связанные документы проекта также перечислены, и вы можете выбрать любые или все из них для удаления из базы данных системы контроля версий. После нажатия OK проект и любые другие выбранные документы будут переведены в статус Scheduled for deletion.

  

  Последующая команда Commit (Commit Whole project или просто Commit для отдельных файлов) удалит файлы проекта из базы данных системы контроля версий, и эти документы будут отображаться со статусом Not in version control.

  Обратите внимание: удаляя сам проект из базы данных системы контроля версий, вы запрашиваете не связывать проект с контролем версий, и связь между Altium и вашим ПО контроля версий будет удалена. Удаление только проекта не удаляет все связанные документы проекта из базы данных системы контроля версий. Они останутся там, но поскольку связи из Altium с контролем версий больше нет, Altium будет вести себя так, как будто их нет в базе данных системы контроля версий. Они снова будут отображаться как checked in только когда проект будет добавлен обратно в систему контроля версий и будет выполнено обновление (refresh) для повторной синхронизации системы.

• VCS Properties - используйте эту команду для отображения информации о свойствах, относящейся к записи выбранного документа в репозитории SVN.

  После запуска команды появится диалог Properties . В диалоге отображается информация о свойствах, относящаяся к выбранному документу, включая:

  • Путь к локальному документу (в вашей рабочей папке).
  • URL расположения документа в репозитории VCS.
  • Корень репозитория (Repository Root) и UUID.
  • Текущая ревизия документа в вашей локальной рабочей папке.
  • Автор последнего изменения.
  • Ревизия последнего изменения.
  • Время последнего изменения.
  • Есть ли у документа конфликт.

  Интерфейс диалога и отображаемая информация зависят от используемого ПО контроля версий, но обычно включают такие сведения, как тип файла, размер, версия и находится ли файл сейчас в состоянии checked out.

Область Time line

Область Time line  перечисляет исторические события и события системы контроля версий во времени для текущей выбранной папки или файла.

Эту область можно переключать между представлением по умолчанию (совмещённым) и «классическим» представлением VCS/History через меню правой кнопки мыши.

Команды и функции общие для обоих типов представления и ниже описаны для классического режима с двумя представлениями.

Ревизии VCS 

Если активный проект в области Folders находится под контролем версий и вы используете системы контроля версий SVN, то при выборе документа, принадлежащего этому проекту (в области Project Files панели), область VCS Revisions будет заполнена историческим списком ревизий для этого документа.

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

Список истории ревизий может содержать следующие типы записей:

• Document - версия документа, которая в данный момент открыта в рабочей области. В этот документ могли быть внесены изменения, и он ещё не сохранён.
• Last Saved Contents - последняя сохранённая версия документа (в вашей локальной рабочей папке).
• RevisionNumber - ревизия документа в репозитории VCS. Когда вы изменяете документ, сохраняете его и затем выполняете commit в репозиторий VCS, его копия будет сохранена, а номер ревизии увеличен. Самая новая ревизия в VCS будет указана первой.

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

• Date Modified - для записей Document и Last Saved Contents это время, когда рабочая копия документа была сохранена в последний раз. Для записей ревизий VCS это время, когда файл был зафиксирован (committed).
• Author - имя пользователя, который в данный момент вошёл в ПО VCS.
• Comment - любой применённый комментарий к ревизии VCS, добавляемый при выполнении commit файла в репозиторий VCS. 

Щелчок правой кнопкой мыши в области VCS Revisions откроет контекстное меню с доступом к следующим командам:

• Compare - эта команда становится доступной, когда в области выбраны две версии. Используйте её для выполнения сравнения между документами (см. Comparing Documents).
• Open - используйте эту команду, чтобы открыть выбранную версию документа в окне редактора. Имя открытого документа будет иметь префикс с номером ревизии, например, [Revision 1.2] Buzzer.SchDoc. Обратите внимание: эта команда недоступна, если в области выбрано несколько записей версий. Двойной щелчок по ревизии в списке также откроет эту ревизию в Altium Designer.
• Switch to Combined View - переключить область на альтернативное (одиночное) представление Time line, как упоминалось выше.

Локальная история

Система управления Local History позволяет вести историю и отслеживать изменения документов локально без необходимости в системе контроля версий (VCS).

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

Local History настраивается на странице Data Management – Local History диалога Preferences. Можно настроить количество дней хранения истории файла: история события сохранения будет храниться в течение указанного периода (до 10 дней). Также можно включить опцию Use global repository и указать расположение Global repository, в котором будет храниться история всех проектов, при этом каждый набор файлов проекта сохраняется в подпапке проекта.

Файлы Local History сохраняются в сжатом формате ZIP с добавленным числовым суффиксом в имени файла (например: SheetZ.~(3).SchDoc.Zip), который указывает его последовательную версию — наибольшее число соответствует самой новой версии.

Функции управления историей документов доступны через панель Storage Manager. Эти функции включают возможность просматривать различия между документами — как физические, так и логические — и возвращаться к ранее сохранённой версии документа. Управление локальной историей документов также работает согласованно с активной VCS. Отдельные разработчики могут управлять своими изменениями с помощью системы локальной истории, а VCS обеспечивает полноценную командно-ориентированную систему управления документами.

Область Local History панели отображает локальную историю для документа, который в данный момент находится в фокусе в области Files панели.

Список истории может содержать следующие записи:

• Document - версия документа, которая в данный момент открыта в рабочей области. В этот документ могли быть внесены изменения, и он не был сохранён.
• Last Saved Contents - последняя сохранённая версия документа.
• Version n - локальная (ручная) резервная версия документа. Когда вы сохраняете документ, версия, которая была указана как Last Saved Contents, будет сохранена как резервная запись Version 1. Следующее сохранение создаст резервную копию Last Saved Contents как Version 2 и т. д., формируя историю документа.
• Version n [label] - локальная (ручная) резервная версия документа, к которой применена метка.
• Version n [AutoSave Date Time] - автоматически созданная резервная копия документа, отличающаяся меткой AutoSave-Date/Timestamp.

История перечисляется так, что самая свежая версия находится сверху, например:

• Document
• Last Saved Contents
• Version 3
• Version 2 [AutoSave 2015-01-28 14~14~17-935]
• Version 1 [Original Draft]

Щёлкните правой кнопкой мыши в области Local History, чтобы получить доступ к следующим командам:

• Compare- эта команда становится доступной, когда в области выбраны две версии. Используйте её для выполнения сравнения документов (см. Сравнение документов).
• Open — используйте эту команду, чтобы открыть выбранную версию документа в окне редактора проекта. Эта команда будет недоступна, если в области выбрано несколько записей версий. Двойной щелчок по версии/ревизии в списке также откроет эту версию/ревизию в Altium Designer.
• Apply Label — используйте эту команду, чтобы добавить осмысленную метку к выбранной версии (например, чтобы легко распознавать её назначение). Откроется диалог Apply Label dialog, где нужно ввести имя метки (до 64 символов). Запись будет отображаться как Version n [Label]. После применения метки сохранённая резервная копия станет доступной только для чтения.
• Revert to — используйте эту команду, чтобы откатиться к выбранной версии файла. Последняя сохранённая версия будет помещена в резервную копию, и к ней будет применена метка, указывающая, к какой версии затем был выполнен откат. Выбранная историческая версия станет текущей и отобразится в окне редактора проекта.
• Delete - используйте эту команду, чтобы удалить выбранную(ые) версию(и) файла. Файл(ы) будут безвозвратно удалены с жёсткого диска. Примечание: нельзя удалять записи Document или Last Saved Content.

• Purge History — удалить файлы локальной истории для выбранного(ых) документа(ов). Откроется диалог Confirm purge document history, в котором можно точно определить, какие файлы локальной истории нужно очистить. Можно выбрать очистку всех версий, версий старше заданного количества дней или версий старше указанной даты. Кроме того, можно оставить заданное количество версий, что используется совместно с другими параметрами, но имеет приоритет над ними, гарантируя, что разрывы в истории не приведут к нежелательной потере истории. Версии с метками по умолчанию защищены, но при необходимости эту защиту можно отключить.

  

  После нажатия OK все записи Version n (где n — номер ревизии) в области Local History для выбранного(ых) документа(ов) будут удалены в соответствии с заданными параметрами очистки. Если включена опция включать в очистку версии файла(ов) с метками, то соответствующие записи Version n [label] также будут удалены.

• Show Autobackups — используйте эту команду, чтобы включить отображение автоматически сохранённых версий файлов в списке локальной истории, созданных с помощью функции Auto Save.

  • Автоматически созданная резервная копия документа отличается меткой AutoSave-Date/Timestamp в формате Version n [AutoSave Date Time].
  • Функция Auto Save включается и настраивается на странице Data Management - Backup page диалога Preferences
  • Чтобы автоматически сохранённые документы добавлялись в локальную историю, и, следовательно, отображались в соответствующей области панели Storage Manager при использовании этой команды Show Autobackups, нужно включить опцию Add autosaved documents to history в области Local History на странице Data Management - Local History page диалога Preferences
• Switch to Combined View — переключить область панели обратно в представление Time line view , которое отображает события VCS/History в одной области.

Сравнение документов

Важным преимуществом работы с Version Control является возможность сравнивать исторические ревизии файлов проекта, что обеспечивается встроенной в Altium Designer функцией Difference Comparator и доступно с панели Storage Manager. При совместном использовании с панелью Differences можно выполнять логическое или графическое сравнение ревизий VCS, интерактивно исследуя затронутые объекты.

Выбрав нужный документ в области Files панели Storage Manager , выделите две записи (в областях VCS Revisions или Local History при режиме Classic View либо в области Time line при режиме Combined View), затем щёлкните правой кнопкой и выберите Compare в контекстном меню.

Выполняется сравнение двух документов; результат зависит от типа документа:

• Для документов схемы или PCB (проектных или библиотечных) выполняется графическое сравнение, а обнаруженные различия перечисляются на панели Differences. Когда две версии документа открыты рядом в окне редактора проекта, различия можно просматривать графически. Щелчок по папке верхнего уровня для обнаруженного различия одновременно подсветит это различие в обоих документах.

• Для текстовых ASCII-документов откроется диалог CompareForm, показывающий графический «diff» двух версий документа. Выбранные документы отображаются рядом. За счёт цветового кодирования диалог подсвечивает различия между двумя версиями документа: добавленные строки (розовый), изменённые строки (зелёный) и удалённые строки (синий). Сводка изменений и легенда цветов представлены в нижней левой части диалога.

  Диалог предназначен только для сравнения — изменения в загруженный документ вносить нельзя.

  

  Используйте колесо мыши для синхронной прокрутки двух документов. Используйте элементы управления стрелками вверх/вниз в левом верхнем углу диалога, чтобы переходить к следующему найденному различию вверх/вниз в документе, над которым в данный момент находится курсор. Используйте кнопку в левом верхнем углу, чтобы быстро вернуть оба документа к первой строке (переход в начало документа).

Настройки

• Функциональность version control включается/выключается, а тип системы выбирается на странице Data Management - Version Control диалога Preferences.
• Чтобы просматривать библиотеки символов и посадочных мест для активного файла SVN Database Library, необходимо выполнить checkout копии этих библиотек в назначенную локальную рабочую папку. Этот каталог задаётся на странице Data Management - SVN Libraries диалога Preferences. Также необходимо убедиться, что на странице Data Management - Version Control диалога Preferences в качестве системы контроля версий выбрано SVN - Subversion .
• Версия файла Last Saved Contents — это фактическая мастер-копия файла, сохранённая в папке проекта. Ручные резервные копии (Version 1, Version 2 и т. д.) хранятся в подпапке проекта. Вы можете хранить все локальные резервные копии файлов в одном месте хранения по вашему выбору. Включите опцию Use global repository на странице Data Management - Local History диалога Preferences и укажите требуемую папку хранения.
• Можно создавать любое количество локальных (вручную создаваемых) резервных копий в зависимости от личных предпочтений и доступного места. Резервные копии будут храниться на жёстком диске до истечения заданного времени (в днях) — также задаётся на странице Data Management - Local History диалога Preferences. Можно указать от 1 до 10 дней хранения созданных резервных документов в локальной истории, после чего они будут удаляться (по временной метке) по мере создания новых резервных копий.
• Открытые документы могут автоматически сохраняться в резервные копии с помощью функции Auto Save, которая настраивается на странице Data Management - Backup диалога Preferences.

Примечания

• Поддерживаются стандартные возможности множественного выбора: Ctrl+Click и Shift+Click. Кроме того, множественный выбор документов в областях Files, VCS Revisions и Local History панели можно выполнять с помощью щелчка и перетаскивания.

• К локальной истории активного документа в окне редактора проекта также можно получить доступ с помощью команды Project » History & Version Control » Local History (Legacy) из главного меню. Откроется диалог Local History, показывающий текущую версию открытого документа, последнюю сохранённую версию документа и любые ранее сохранённые и сохранённые в хранилище резервные копии.

  

  Список истории может содержать следующие записи:

  • Open Document — версия документа, в данный момент открытая в рабочей области (если применимо). В этот документ могли быть внесены изменения, и он ещё не был сохранён.
  • Last Saved Contents — последняя сохранённая версия документа.
  • Version n — локальная (ручная) резервная копия документа. При сохранении документа версия, которая была указана как Last Saved Contents, будет сохранена в резервную копию как запись Version 1. При следующем сохранении Last Saved Contents будет сохранена как Version 2 и т. д., формируя историю документа.
  • Version n [label] — локальная (ручная) резервная копия документа, к которой применена метка.

  История отображается так, что самая последняя версия находится вверху, например:

  • Открыть документ
  • Содержимое последнего сохранения
  • Версия 3
  • Версия 2
  • Версия 1 [Исходный черновик]

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

  Выберите в списке две версии документа, затем нажмите кнопку Compare, чтобы выполнить сравнение документов.

  Список Local History в диалоговом окне аналогичен тому, который представлен в области Local History панели Storage Manager при настройке в Classic View.

• Для документов схем, PCB и библиотек две версии одного и того же документа также можно сравнить графически с помощью команды Project » Show Physical Differences. Перед открытием убедитесь, что предыдущая версия (обычно резервная копия) сохранена под другим именем. Резервную версию документа не нужно добавлять в проект; ее можно открыть как свободный документ. Запустите команду, чтобы открыть диалоговое окно Choose Documents To Compare, которое при настройке в режиме Advanced можно использовать для выбора двух версий документа для сравнения.

  

  Нажмите OK, чтобы продолжить сравнение; обнаруженные различия будут отображены на панели Differences panel.

• Для навигации внутри панели можно использовать следующие сочетания клавиш:
  • Up Arrow — выбрать предыдущую запись в области.
  • Down Arrow — выбрать следующую запись в области.
  • Right Arrow — развернуть запись верхнего уровня или подпапку.
  • Left Arrow — свернуть запись верхнего уровня или подпапку.