Конвертация базы данных

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

Внимание! Перед запуском конвертации необходимо создать резервную копию базы данных (см. Сохранение базы данных в файл).

Требования к проведению конвертации:

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

Рекомендации по сокращению времени конвертации:

• Перед конвертацией проведите процедуру удаления объектов, помеченных к удалению (см. Работа с объектами, помеченными к удалению).
• Для конвертации желательно использовать компьютер с объемом памяти 1 Гб ОЗУ и выше.
• В случае использования клиент-серверного варианта установки Business Studio проводите конвертацию на сервере баз данных, если на нем произведена установка сервера Business Studio.
• Перед конвертацией время конвертации необходимо закрыть все другие приложения.

Внимание! Процесс может занять продолжительное время в зависимости от объема информации в базе.

Конвертация баз данных проводится для обеспечения возможности для баз предыдущих версия Business Studio работать с версией 5. В рамках конвертации вносятся изменения в объектную модель базы данных, а также загружаются актуальные пакеты с данными (например, отчеты, пакеты импорта и др.). В версии 5 были внесены следующие важные изменения в объектную модель:

1. Осуществлен переход в параметрах объектной модели, содержащих системные наименования классов и параметров на идентификаторы (ID), что позволит решать большой спектр задач, таких как поддержка переименований классов и параметров, поддержка мультиязычности данных и др.
2. Часть классов и параметров были удалены, данные по части других были перемещены в другие места объектной модели (подробнее список таких классов и параметров см. в «Изменения в объектной модели в Business Studio 5»).
   Мы постарались обеспечить в рамках конвертации конвертацию таких классов и параметров, где это было возможно. В других местах, если вы использовали эти классы и/или параметры в своих наработках (фильтры, отчеты, пакеты импорта), может потребоваться доработка в соответствующих местах в соответствии с приведенными ниже инструкциями. В случае, если она может потребоваться, будут выданы соответствующие сообщения при конвертации (см. «Классы сообщений при проведении конвертации в версии 5»).
3. Благодаря п.1 появился контроль корректности информации, внесенной в параметрах Business Studio, поэтому по итогам конвертации система также сообщит вам и о таких местах в данных, требующих корректировки:
   • Места, где используются параметры и классы, удаленные в более ранних версиях программы.
   • Места, где используются пользовательские параметры и классы, удаленные или переименованные на текущий момент.

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

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

1. При конвертации категории прав, по умолчанию присутствующие в базах данных Business Studio (Права администратора, Ограничения для контролирующих лиц, Ограничения для ответственных лиц), будут удалены и заменены своими новыми версиями.
   Если Вы вносили изменения в эти категории и используете их в работе, перед конвертацией Вы можете сделать копии этих категорий, сохранить под другими названиями, и использовать в работе эти копии вместо оригиналов категорий, или повторно внести свои изменения в загруженные новые версии категорий прав после конвертации.
2. При конвертации значения из параметра "Руководитель проекта" справочника "Проекты" переедут в новый список "Участники проекта" со значением в колонке "Роль пользователя" = "Менеджер проекта".
   Для того, чтобы переезд прошел успешно, у физических лиц из параметра "Руководитель проекта" должна быть связь с объектами из справочника "Пользователи" в справочнике "Настройки пользователей Business Studio", иначе данные будут утеряны. Перед конвертацией для всех проектов проверьте, что такие связи присутствуют, в случае их отсутствия создайте соответствующие связи.
3. При конвертации отчеты из папки "Отчеты объектов/Шаблоны отчетов" и нижележащих могут быть удалены/заменены отчетами новых версий. Также могут быть удалены/заменены отчетами новых версий все отчеты, поставляемые вместе с Business Studio, даже если они были изменены или перемещены в другие папки из исходных.
   Перед конвертацией сделайте копии необходимых Вам отчетов и переместите эти копии за пределы папки "Шаблоны отчетов" (например, в папку "Отчеты объектов/Пользовательские отчеты").
4. При конвертации фильтры из папки "Хранимые фильтры/Фильтры отчетов/СТУ" и нижележащих могут быть удалены/заменены фильтрами новых версий. Также могут быть удалены/заменены фильтрами новых версий все фильтры, поставляемые вместе с Business Studio, даже если они были изменены или перемещены в другие папки из исходных.
   Перед конвертацией сделайте копии необходимых Вам фильтров и переместите эти копии за пределы папки "СТУ" (например, в папку "Хранимые фильтры/Пользовательские фильтры").
5. При конвертации объекты справочника "Пункты персональной страницы", используемые в объекте "Настройки портала по умолчанию" справочника "Настройки портала" могут быть удалены и/или заменены новыми версиями.
   Если Вы вносили изменения в такие объекты, то перед конвертацией сделайте копии этих измененных объектов и в свойствах используемых в Ваших порталах объектах справочника "Настройки портала" выберите эти копии вместо оригинальных объектов.
6. Часто в пользовательских отчетах используются фильтры из поставляемых с Business Studio отчетов (такая ситуация возникает, например, если пользовательский отчет создавался копированием поставляемого с Business Studio отчета).
   Перед конвертацией следует сделать копии таких фильтров, переместить эти копии за пределы папки "Хранимые фильтры/Фильтры отчетов/СТУ" (например, в папку "Хранимые фильтры/Пользовательские фильтры") и назначить для соответствующих привязок отчета эти копии вместо поставляемых с Business Studio фильтров. Это необходимо в связи с тем, что условия в фильтрах, поставляемых с Business Studio, могут изменяться, и эти фильтры могут стать неработоспособными в пользовательских отчетах после конвертации.
7. При конвертации будут удалены для замены новыми версиями следующие объекты справочника "Пакет импорта": "Импорт функциональной блок-схемы из Visio", "Импорт схемы BPMN из Visio".
   Также будут удалены следующие пакеты импорта: "Экспорт/импорт оргструктуры в DIRECTUM", "Импорт метаданных DIRECTUM в программные продукты BS", "Импорт ролей DIRECTUM" и "Импорт видов документов DIRECTUM".
   Если Вы изменяли пакеты импорта с такими названиями или создали свои пакеты с такими названиями и хотите использовать их в дальнейшем – перед конвертацией переименуйте эти пакеты, чтобы новые названия не входили в приведённый выше список.
8. При конвертации будут удалены для замены новыми версиями следующие объекты справочника "Набор соответствий фигур": "Visio Набор соответствий функциональной блок-схемы" и "Visio Набор соответствий схемы BPMN".
   Если Вы изменяли наборы соответствий с такими названиями или создали свои наборы соответствий с такими названиями и хотите использовать их в дальнейшем – перед конвертацией переименуйте эти наборы соответствий, чтобы новое названия не входили в приведённый выше список.
9. Если в базах есть объекты в справочнике "Порталы", требуется после конвертации вручную добавить справочник "Физические лица" на вкладку "Справочники портала" в Окнах свойств каждого из этих порталов. Это связано с тем, что в версии 5 пользователю предоставляется выбор, выгружать ли этот справочник в портал (в версии 4.2 он выгружался всегда). Для новых порталов справочник "Физические лица" будет добавляться в число выгружаемых справочников автоматически (при необходимости можно его оттуда удалить).
10. При конвертации в базе данных меняется структура объектной модели, в результате чего определенные классы удаляются (см. Классы, удаленные в Business Studio 5).
    Если в вашей базе данных созданы пользовательские параметры (типа "Объект" или "Список"), ссылающиеся на какие-то из этих классов, то до конвертации необходимо внести изменения: удалить такие параметры или сослаться в них на другие, не удаляемые классы.
11. При конвертации в версию 5 параметр информация из параметра "Изменение" класса "Список статусов процесса", который поддерживал редактирование в редакторе RTF, будет преобразована в обычный текст.
    Если требуется, Вы можете сохранить эту информацию в исходном виде (с поддержкой форматирования текста, картинок и т.п.) в текущем виде и загрузить в созданный пользовательский параметр. Подробнее о том, как это сделать, см. transfer_of_values_from_parameter_changes_from_bs4.2_to_bs5.
12. При конвертации тип параметра "Категория" класса "Тип контакта" изменится с объектного на "Перечисление". Правила конвертации:
    • Название содержит слово "телефон" - категория "Телефон".
    • Название эквивалентно строке "Домашний адрес" - категория "Адрес".
    • Название эквивалентно строке "Электронная почта" или "e-mail" - категория "Электронная_почта".
    • В остальных случаях – категория "Прочее".

1. Выделить компьютер, на котором будет проводиться тестовая конвертация (желательно, чтобы это был не тот компьютер, где ведется повседневная работа в Business Studio во избежание простоев). Также это не должен быть сервер, на котором развернут Business Studio Portal.
2. Скопировать в любую папку на этом компьютере папку с Business Studio 4.2 (если установлена на этом компьютере – с этого, если не установлена – с другого компьютера, где она установлена).
3. Установить на этот компьютер Business Studio 5.
4. Для каждой базы:
   1. Сделать резервную копию рабочей базы данных.
   2. Ознакомиться с разделом "Информация по переносу данных из предыдущих версий" и провести в рабочей базе данных требуемые корректировки.
   3. Сделать резервную копию рабочей базы данных после корректировок.

1. Перед конвертацией каждой базы данных обязательно восстановить базу данных из сделанной в рамках подготовки к конвертации резервной копии под другим именем (далее – тестовая база).
2. Запустить тестовую конвертацию этой тестовой базы данных.
3. Далее действовать в зависимости от результата конвертации:
   • Если тестовая конвертация прервана из-за критической ошибки:
     1. Сохранить информацию из окна об ошибке.
     2. В текущей рабочей базе данных на основе информации из раздела «Критические сообщения» проанализировать проблему и принять действия по решению проблемы (если сообщение непонятно и в указанной статье нет информации о решении такого класса проблем – для получения решения обратитесь на техподдержку, приложив текст ошибки и ссылку для скачивания бэкапа базы данных до конвертации).
     3. Создать резервную копию текущей рабочей базы данных.
     4. Восстановить тестовую базу данных из этой резервной копии под другим именем.
     5. Запустить конвертацию этой тестовой базы данных.
     6. Действовать в соответствии с тем, как пройдет конвертация (см. п.3).
   • Если тестовая конвертация закончена:
     • Если по итогам конвертации не выдалось сообщений об ошибках:
       1. Запланировать время в которое будет осуществлена конвертация рабочей базы данных (например, вечернее время после завершения рабочего дня).
       2. Уведомить всех сотрудников о том, когда будет осуществляться переход на версию 5, и проконтролировать, чтобы все завершили работу у программе и вышли из нее до этого времени
       3. Сделать резервную копию рабочей базы данных (см. Сохранение базы данных в файл) и резервную копию портала Business Studio при его наличии, если требуется сохранить обсуждения и статистику по оценкам и посещениям страниц портала (см. Создание резервной копии портала и загрузка портала из резервной копии, раздел "Создание резервной копии портала").
          Внимание! На сервере портала перед первым запуском портала в новой версии программы необходимо включить логирование, выполнив файл из архива https://download.businessstudio.ru/utils/BS5_Debug_OnPortal.zip, на вопрос о внесении изменений в реестр отвечать утвердительно.
       4. Провести конвертацию рабочей базы данных.
       5. Сделать резервную копию базы данных.
       6. Установить Business Studio версии 5 на все компьютеры, где установлена Business Studio.
       7. Уведомить пользователей о том, что можно работать в базе данных.
     • Если по итогам конвертации выдались сообщения об ошибках:
       1. Скопировать полностью лог ошибок и сохранить в отдельном файле. Эта информация может потребоваться в дальнейшем для общения с коллегами, работающими в Business Studio или со службой технической поддержки Business Studio по вопросам решения возникших проблем.
       2. На основе информации из раздела «Классы сообщений при проведении конвертации» проанализировать их, принять решение о том, требуют ли эти ошибки какой-то реакции, насколько возможен переход с учетом необходимости после него внести требуемые изменения(если какие –либо сообщения непонятны и в указанной статье нет информации о решении такого класса проблем – для получения решения обратитесь на техподдержку, приложив тексты сообщений ошибки и ссылку для скачивания резервной копии базы данных до конвертации).
       3. Если по итогам предыдущего пункта принято положительное решение о переводе базы данных на версию 5, запланировать время в которое будет осуществлена конвертация рабочей базы данных (например, вечернее время после завершения рабочего дня).
       4. Уведомить всех сотрудников о том, когда будет осуществляться переход на версию 5, и проконтролировать, чтобы все завершили работу у программе и вышли из нее до этого времени
       5. Сделать резервную копию рабочей базы данных (см. Сохранение базы данных в файл) и резервную копию портала Business Studio при его наличии, если требуется сохранить обсуждения и статистику по оценкам и посещениям страниц портала (см. Создание резервной копии портала и загрузка портала из резервной копии, раздел "Создание резервной копии портала").
          Внимание! На сервере портала перед первым запуском портала в новой версии программы необходимо включить логирование, выполнив файл из архива https://download.businessstudio.ru/utils/BS5_Debug_OnPortal.zip, на вопрос о внесении изменений в реестр отвечать утвердительно.
       6. Провести конвертацию рабочей базы данных.
       7. Скопировать полностью лог ошибок и сохранить в отдельном файле. Эта информация может потребоваться в дальнейшем для общения с коллегами, работающими в Business Studio или со службой технической поддержки Business Studio по вопросам решения возникших проблем.
       8. Сделать резервную копию базы данных.
       9. Установить Business Studio версии 5 на все компьютеры, где установлена Business Studio.
       10. Уведомить пользователей о том, что можно работать в базе данных.
       11. Заняться устранением ошибок, выданных в логе, в соответствии с инструкциями из «Классы сообщений при проведении конвертации».

На рисунке 1 ниже показан в графическом виде алгоритм конвертации базы данных в Business Stuido 5. Для просмотра увеличенной версии рисунка кликните по нему мышкой.

Invalid Link

Рисунок 1. Алгоритм конвертации базы данных в Business Stuido 5

Ссылки, которые встречаются на Рисунке 1 (выделены жирным и подчеркиванием) приведены ниже в таблице 1:

Внимание! После перехода на версию 5 необходимо сохранить бэкап базы данных, сделанный до конвертации, чтобы в случае необходимости можно было обратиться к нему, и хранить его в течение длительного времени (рекомендуется – до выхода следующей версии Business Studio с конвертацией базы).

• transfer_of_values_from_parameter_changes_from_bs4.2_to_bs5