Изменения в объектной модели в Business Studio 6.0

В версии 6.0 были произведены следующие изменения в объектной модели:

1. Удалены некоторые, в основном устаревшие, классы и параметры.
   Списки удаленных классов и параметров приведены ниже в разделах "Удаленные классы" и "Удаленные параметры" данной статьи.
2. Добавлены ключи в некоторые классы. Подробнее об этом см в разделе "Добавленные ключи" ниже.
3. Некоторые данные (в том числе из удаляемых параметров) переехали в другие места объектной модели, подробнее об этом см. в разделе "Данные, перемещенные в другие места в объектной модели" данной статьи.
4. Сделаны прочие важные изменения, описанные в разделе "Прочие изменения".

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

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

В данном разделе приведена видеоинструкция по решению наиболее частых задач после перехода на версию 6.0 и конвертации баз данных: задач переработки пользовательских шаблонов отчетов и фильтров.

Внимание! В видео разобрана только часть действий, необходимых при переходе на версию 6.0. Его просмотр не отменяет необходимости изучения остальной информации из раздела справки Изменения в объектной модели в Business Studio 6.0.

Требуемые действия (видеоинструкция):

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

Требуемые действия: Инструкции для того, чтобы решить данную проблему для тех параметров, где это требуется, приведены в соответствующей колонке Таблицы 2 и ниже под таблицей.

Видеоинструкция

См. выше в разделе Переработка пользовательских шаблонов отчетов в связи с переходом на Business Studio 6.0.

Текстовая инструкция

Самый важный этап в корректировке шаблонов отчетов и фильтров - найти места, требующие корректировки.

Корректировка привязок в шаблонах отчетов

Как понять, нужна ли вообще корректировка:

1. Если вы не изменяли поставляемые по умолчанию шаблоны отчетов и не разрабатывали свои шаблоны отчетов - никаких действий не требуется, при конвертации в базы данных будет загружен актуальный пакет шаблонов отчетов от вендора со всеми корректировками.
2. Если вы вносили изменения в поставляемые по умолчанию шаблоны отчетов и/или разрабатывали свои - может потребоваться внесение корректировок.

Существует несколько способов найти шаблоны отчетов и конкретные привязки, требующие корректировки:

1. Рекомендуемый. Если шаблонов отчетов, куда вносили изменения/которые разрабатывали, относительно немного, лучше открыть каждый из них в мастере отчетов, поочередно встать на каждую привязку в дереве привязок и посмотреть параметр Путь под деревом. Если в нем вместо названия какого-либо параметра будет численно-буквенное значение ID - значит это место отчета требует корректировки. Это значение ID - это идентификатор параметра, который был в базе в предыдущих версиях программы, и которого нет в версии 6.0.
   
2. Также можно развернуть рядом с основной версией базы ее копию под другим названием, в этой копии для всех отчетов, которые разработали или изменили, в справочнике Шаблоны отчетов объектов проставить флажок HTML и запустить выгрузку HTML-публикации по такой выборке объектов, чтобы все выбранные отчеты смогли выполниться.
   В результате формирования в нижней части окна Business Studio будет формироваться лог сообщений об ошибках, содержащих ID параметров, ссылки на проблемные привязки и названия шаблонов отчетов. По этой информации можно быстрее найти некоторые проблемные места, далее исправить их в Мастере отчетов по инструкциям из таблицы 2 выше, но не гарантируется, что будет найдено всё, т.к. выборка может не обеспечивать выполнение всех привязок всех отчетов.

Что делать с каждой найденной по инструкциям выше привязкой, требующей корректировки:

1. Найти, что это был за параметр по значению ID в колонке Удаленный параметр (системное название и ID) в таблице 2 в разделе Удаленные параметры выше.
2. Cкорректировать отчет в соответствии с инструкциями из колонки Требуемые действия, если что-то требуется этой же строки таблицы.

Если значение ID в табличке отсутствует, то рекомендуется найти параметр в базах предыдущих версий программы с помощью поиска в форме Объектной модели или в шаблоне отчета и понять, что это был за параметр. Возможные варианты:

1. ID соответствует пользовательскому параметру, который был заведен в классе "Бумажный документ" или "Электронный документ", которые в версии 6.0 прекратили свое существование (подробнее см. Данные, перемещенные в другие места объектном модели). Решением в данном случае является создание аналогичного пользовательского параметра в классе "Документы" и перенастройка привязки на этот параметр.
2. Проблема, скорее всего, не связана с обновлением до версии 6.0. Возможно ID соответствует пользовательскому параметру, который был ранее заведен пользователями, использован в шаблоне отчета, а потом удален пользователями. Для такой привязки нужно самостоятельно или с помощью техподдержки решить, что делать: удалить или заменить на какую-то другую.

Корректировка условий фильтров

Как понять, нужна ли вообще корректировка:

1. Если вы не изменяли поставляемые по умолчанию фильтры и не разрабатывали свои - никаких действий не требуется, при конвертации в базы данных будет загружен актуальный пакет шаблонов отчетов от вендора со всеми корректировками.
2. Если вы вносили изменения в поставляемые по умолчанию фильтры и/или разрабатывали свои - может потребоваться внесение корректировок.

Как найти фильтры, чьи условия требуют корректировки:

1. Открыть справочник "Условия", в нём:
   1. Вывести на показ параметр "Владелец".
   2. Установить группировку по параметру "Параметр".
   3. Установить сортировку по полю "Параметр".
   4. Найти блоки, в названиях которых буквенно-цифровая последовательность символов (ID) и слова "не найден". Следует среди всех найденных в первую очередь анализировать строки тех из этих блоков, чьи ID приведены в колонке Удаленный параметр (системное название и ID) в таблице 2 в разделе Удаленные параметры выше - именно для них, скорее всего, может потребоваться корректировка в результате конвертации в версию 6.0.
   5. Для каждой из строк этих блоков следует скопировать значение из поля "Владелец" и выполнить инструкции из п.2 ниже.
2. Открыть справочник "Шапки фильтра", в нём:
   1. Вывести на показ параметр "Фильтр текущей шапки фильтра",
   2. Ввести в строку поиска скопированное значение - в поле "Фильтр текущей шапки фильтра" найденной строки будет фильтр с искомым условием. Если значение пустое, значит условие не относится к какому-либо фильтру ("мусор") и не требуется его корректировка. Если значение заполнено, см. следующий пункт.
   3. Открыть найденный фильтр двойным кликом мышкой по значению в поле "Фильтр текущей шапки фильтра".
   4. Далее следует оценить (например, по значению параметра «Полный путь»), является ли фильтр пользовательским или относится к фильтрам из комплекта по умолчанию. В те фильтры из комплекта по умолчанию, где требуется вносить изменения, разработчик вносит их самостоятельно. Для пользовательских фильтров можно вызвать в меню "Действия" фильтра пункт "Анализ использования объекта". По информации на вкладке "Ссылки на объект" нужно самостоятельно оценить, используется для для вашей работы (имеется ввиду работа вашей организации в Business Studio) этот фильтр, если не используется - значит, корректировки вносить не нужно. Например, если там ссылка на привязку шаблона отчета – скорее всего фильтр используется, если пусто – большая вероятность, что не используется. Если решили вносить корректировки в фильтр, см. инструкцию ниже.

Что делать с фильтрами, для которых решили внести корректировки:

1. Вывести на показ в окне свойств фильтра поле "Полный путь".
2. Найти этот же фильтр в базе версии 5.1, посмотреть его условие, требующее корректировки. Далее открыть его же в версии 6.0 и, используя инструкции из колонки Требуемые действия, если что-то требуется таблицы 2 в разделе Удаленные параметры выше, сформировать новое условие, аналогичное старому.

Если вы анализируете условие на параметр, ID которого в табличке отсутствует, то проблема, скорее всего, не связана с обновлением до версии 6.0. Можно найти параметр в базах предыдущих версий программы с помощью поиска в форме Объектной модели, понять, что это был за параметр и самостоятельно или с помощью техподдержки решить, что делать с таким условием.

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

Требуемые действия в версии 5.1 до конвертации:

1. Проверить каждый из классов, указанных в таблице из раздела на предмет соблюдения правила уникальности.
2. Если это правило не соблюдается, нужно устранить проблемную ситуацию: изменить значения параметров или удалить строки, более подробные инструкции см. в соответствующей статье базы знаний.

В рамках изменений объектной модели роль некоторых, в том числе удаляемых (см. Удаленные параметры выше), параметров стали выполнять другие:

• Вместо присутствовавших во многих классах параметров "Комментарий" и "Описание" теперь используется новый параметр "Описание" класса "Предметные объекты", доступный во всех дочерних классах.
• Вместо параметров "Тип" классов "Показатели", "Цели", "Программные продукты" и "Организационные единицы" для класса "Предметные объекты" теперь используется параметр "Класс объекта", доступный во всех дочерних классах.

При конвертации баз данных ручных операций для применения описанных выше изменений от пользователей не требуется:

• Данные автоматически перемещаются из старых параметров в новые.
• В привязках шаблонов отчетов, пакетах импорта и других местах программы происходит автоматическая замена ссылок со старых на новые параметры.

В рамках изменений объектной модели роль некоторых, в том числе удаляемых (см. Удаленные классы выше), классов стали выполнять другие:

• Вместо каждой пары из перечисленных в таблице по ссылке классов связей объектов с бумажными и электронными документами теперь существует по одному классу связей просто с документами

При конвертации баз данных ручных операций для применения описанных выше изменений от пользователей не требуется:

• Данные автоматически перемещаются из старых классов в новые.

1. Класс "Стратегические карты" был помечен как устаревший и его роль теперь выполняет класс "Диаграммы стратегической карты".
Данные из справочника "Стратегические карты" в "Диаграммы стратегической карты" при конвертации переедут автоматически.
Пользовательские отчеты по классу "Стратегические карты" автоматически сконвертированы не будут.

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

2. Часть классов была удалена в текущей версии программы (в данном пункте речь про классы БизнесМодель.БумажныйДокумент и БизнесМодель.ЭлектронныйДокумент, объекты из них переедут в родительский класс БизнесМодель.Документы). Если в предыдущих версиях создавались пользовательские параметры в этих классах или со ссылками на эти классы, после конвертации баз данных они станут неработоспособными.

Требуемые действия для того, чтобы перенести данные из параметров, которые создавались в таких классах, в новую версию:

1. Выявить такие параметры на основе информации о том, какие классы будут удалены (см. Удаленные классы).
2. Выгрузить из них информацию в версии 5.1 с помощью самостоятельно созданных пакетов импорта по соответствующим классам (см. Настраиваемый обмен данными с другими системами).
3. Удалить эти параметры в версии 5.1.
4. В версии 6.0 после конвертации базы добавить аналогичные параметры в класс БизнесМодель.Документы (см. Редактирование метаданных).
5. Загрузить информацию в эти параметры из ранее выгруженных из версии 5.1 файлов с помощью самостоятельно созданных пакетов импорта.

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

Требуемые действия для того, чтобы перенести данные из параметров, которые ссылались на удаляемые классы (Бумажный документ и Электронный документ), в новую версию:

1. Выявить такие параметры, вызвав от удаляемых классов в контекстном меню в объектной модели команду "Поиск ссылок на класс". Важны те ссылки, которые ведут именно на искомый класс (например, БизнесМодель.БумажныйДокумент), а не какой-то из его родителей (например, Предметные объекты).
2. Через MetaEdit сменить ссылки на тот класс, где теперь будут находиться переехавшие объекты удаленных классов - БизнесМодель.Документы.

Также в объектную модель были внесены следующие важные изменения:

• Параметр "Является папкой" был переименован в "Может иметь потомков", что больше соответствует его смыслу. Также во многих справочниках изменилось поведение этого параметра, а именно у объектов многих справочников в нем теперь стоит флажок, вне зависимости от того, папка ли это или нет, т.к. такие объекты могут иметь потомков (например, Документы). В связи с изменением поведения данного параметра, он больше не подходит для определения, является ли объект папкой или нет.
  
  Требуемые действия: необходимо в тех местах, где были условия на значения данного параметра, заменить такие условия на условия на параметр "Класс объекта" (= Папка или НЕ = Папка соответственно).
  
  Найти фильтры с такими условиями можно, например, так:
  1. Открыть справочник "Условия", вывести на показ параметр "Владелец", установить группировку по параметру "Параметр" и найти блок параметр "Может иметь потомков".
  2. Скопировать значение из поля "Владелец" данной строки, открыть справочник "Шапки фильтра", вывести на показ параметр "Фильтр текущей шапки фильтра" и ввести в строку поиска скопированное значение - в поле "Фильтр текущей шапки фильтра" найденной строки будет фильтр с искомым условием.
  
  Найденный фильтр можно открыть на редактирование (команда контекстного меню или двойной клик мышкой) и внести в него требуемые изменения.