Миграция проекта

В данном разделе описаны возможности THESIS Studio, связанные с миграцией проекта. Сведения предназначены для администратора или разработчика, выполняющего настройку и сопровождение решения.

Общее описание

В THESIS Studio реализован расширенный механизм миграции, который позволяет:

  • управлять операциями, выполняемыми при миграции;

  • просматривать описание операций и результаты их выполнения;

  • проверять проект на наличие изменений, которые не могут быть выполнены автоматически средствами THESIS Studio..

Доступность версий ТЕЗИС для расширенного механизма миграции

Версия плагина Версии ТЕЗИС
6.0 5.3.* → 5.4.0
6.1 5.2.* → 5.4.0
6.2 5.1.* → 5.4.0
6.3 5.0.* → 5.4.6
7 5.0.* → 5.5.1

Следует учитывать, что проверки и операции механизма миграции не описывают отдельно каждую промежуточную версию. Они включают все изменения, выпущенные между двумя версиями: 5.0–5.1.1, 5.1.1–5.2.1, 5.2.1–5.3.0, 5.3.0–5.4.1, 5.4.1–5.4.6 и 5.4.6–5.5.1.

Описание расширенного механизма миграции

Окно миграции

Окно миграции можно открыть через меню THESIS → Migrate Thesis Project либо с помощью кнопки Migrate в окне свойств проекта. После выбора целевой версии в левой части окна отображается дерево операций и проверок, выполняемых в рамках миграции.


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

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

  • выбор целевой версии ТЕЗИС для миграции проекта;

  • запуск миграции;

  • сохранение отчета с результатами миграции в формате HTML;

  • раскрытие всех ветвей дерева;

  • скрытие всех ветвей дерева;

  • отметка всех операций;

  • снятие отметки со всех операций;

  • выбор только проверок;

  • скрытие неактуальных результатов, включая пропущенные операции и операции или проверки, по которым не было найдено изменений;

  • отметка операции как обработанной.

При работе с окном миграции необходимо учитывать следующие особенности:

  • запуск миграции доступен только после выбора целевой версии ТЕЗИС;

  • сохранение отчета доступно только после выполнения миграции.

Результаты миграции

После выполнения миграции дерево операций обновляется автоматически.


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

  • Выполнено — все действия успешно выполнены;

  • Сделать самому — необходимо вручную проверить необходимость внесения изменений;

  • Возникла ошибка — при выполнении операции возникла ошибка, описание которой приводится в результате выполнения;

  • Не найдено объектов для изменения или проверки — в проекте не найдены объекты, требующие изменения или проверки;

  • Операция не выполнялась — перед запуском миграции с операции была снята отметка;

  • Выполнено частично — часть дочерних операций выполнена, но по отдельным операциям возникли ошибки или требуется ручная обработка.

В разделе Результат отображается текстовое описание результата выполнения операции. Описание может содержать ссылки на файлы, а в отдельных случаях — на конкретные строки файлов. При переходе по такой ссылке в IDE открывается соответствующий файл.

Важно!
Ссылки в результатах миграции могут стать некорректными, если файл, на который они указывают, был изменен после выполнения миграции.

Результаты миграции сохраняются в файле migration/migrationResults.xml в каталоге проекта. При открытии окна миграции отображаются результаты последней выполненной миграции. При повторном выполнении миграции новые результаты заменяют предыдущие. Если миграцию выполняют несколько специалистов, файл migration/migrationResults.xml можно добавить в Git-репозиторий проекта.

Отчет по миграции

Отчет по миграции представляет собой HTML-страницу с таблицами, содержащими описание выполненных операций и их результатов. В отчет не включаются операции со статусами Операция не выполнялась и Не найдено объектов для изменения.

Обрабатываемые объекты

При миграции обрабатываются изменения в Java-классах, экранах, конфигурационных файлах и файлах свойств. Отчеты, стили, процессы и ресурсы в текущей реализации не обрабатываются. Для Groovy-сценариев указывается только факт изменения.