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


