Особенности экспорта-импорта 3.2.0

Проверка файла конфигурации перед импортом

Перед импортом файла конфигурации производится его проверка.


Результат проверки выводится списком.

– сообщения. Информируют о событиях на которые стоит обратить внимание:

  • перезагрузка сервера;
  • замена и переопубликация оргструктуры;
  • объединение справочников или документов;
  • демо-версия импорта.

– предупреждения. Информируют о событиях, способных повлиять на целостность данных:

  • невозможность импортировать некоторые метаданные или данные (например импортируется конфигурация, относящаяся к модулю, не активированному в системе)

– ошибки. Сообщают о невозможности импортировать конфигурацию:

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

 

Бэкапы
Перед импортом рекомендуется сделать бэкап базы данных.

 

Максимальная длина названия таблицы

Разные базы данных допускают разные максимальные размеры названия таблицы.
Максимальная длина имени импортируемой таблицы

  • для MS SQL – 29 символов;
  • для Fire Bird – 29 символов;
  • для Oracle – 28 символов.

Это следует учитывать при переносе метаданных (справочников, перечислений и документов) с одного типа сервера БД на другой.
Данный пункт применим только для баз данных, созданных в старых версиях ELMA. На момент написания статьи максимальная длина имени создаваемых таблиц для всех баз данных 28 символов.

 

Импорт в Демо-версии

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

 

Экспорт-импорт оргструктуры

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

 
Будьте внимательней при экспорте
Не выбирайте экспорт оргструктуры, если это не требуется.

 

Экспорт-импорт модели KPI

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

 

Экспорт-импорт отчетов

  • при экспорте выгружается черновик отчета;
  • при импорте отчет не будет опубликован автоматически.

 

Экспорт-импорт процессов

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

Правила импорта процессов

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

Объединение контекста процессов

При переносе процессов с одного сервера на другой имеется ряд ситуаций, требующих особый подход.
Пример: На Сервере 1 создают процесс и переносят его на Сервер 2. На Сервере 1 и на Сервере 2 в эти процессы добавляют свойство с одинаковым названием. После выгружают процесс с Сервера 2 на Сервер 1.
Перенос такого рода порождает конфликт. Для его решения введено объединение контекстов имеющегося и импортируемого процессов.

  • если в системе имеется процесс с Uid, соответствующим импортируемому, то их контексты будут объединены;
  • свойства разного типа не могут быть объединены;
  • свойства с разным типом связи не могут быть объединены;
  • при объединении процессов их Блоки объединяются по Uid и имени;
  • свойства внутри объединяемых блоков также объединяются;
  • при объединении свойств отображаемое имя имеющегося свойства будет заменено на отображаемое имя импортируемого;
  • при объединении свойств имя имеющегося свойства будет заменено на имя импортируемого;
  • при объединении свойств Uid имеющегося будет сохранен.
 
Особенность объединения контекста процессов
При объединении контекста имеющегося и импортируемого процессов, учитывается не только свойства и блоки текущей версии имеющегося процесса, но и ранее опубликованных версий.

 

Экспорт-импорт пользовательских расширений

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

 

Экспорт-импорт метаданных

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

Объединение метаданных

При переносе данных с одного сервера на другой имеется ряд ситуаций, требующих особый подход.

Пример 1: На Сервере 1 создают справочник и переносят его на Сервер 2. На Сервере 1 и на Сервере 2 в эти справочники добавляют атрибут с одинаковым названием. После выгружают справочник с Сервера 2 на Сервер 1.

Пример 2: На Сервере 1 создают справочник и переносят его на Сервер 2. На Сервере 2 переименовывают один из атрибутов. После выгружают справочник с Сервера 2 на Сервер 1.
Перенос такого рода порождает конфликт. Для его решения введено объединение метаданных и их свойств.

 
Свойства идентифицирующие метаданные при их импорте
Метаданные имеют ряд свойств, позволяющих идентифицировать их:
  • Отображаемое имя (DisplayName) – название, видимое пользователю. Совпадение отображаемых имен загружаемых и имеющихся метаданных не является признаком совпадения метаданных;
  • Имя (Name) – название, с которым оперируют администраторы системы и внедрение. Совпадение имен загружаемых и имеющихся метаданных не является признаком совпадения метаданных;
  • Уникальный идентификатор (Uid) – номер, по которому однозначно определяется уникальность типа объекта. Совпадение уникальных идентификаторов загружаемых и имеющихся метаданных является признаком совпадения метаданных. Метаданные считаются одинаковыми, если они имеют одинаковый Uid.
Объединение справочников/документов
  • если в системе имеется справочник/документ с Uid, соответствующим импортируемому, то они будут объединены;
  • при объединении справочников/документов отображаемое имя имеющегося справочника/документа будет заменено на отображаемое имя импортируемого справочника/документа;
  • в случае, если импортируемые метаданные заменяют или объединяются с имеющимися, происходит объединение их скриптов. При этом текст скрипта базовых метаданных комментируется, вместо него устанавливается текст скрипта импортируемых метаданных;
  • при объединении справочников/документов их свойства объединяются по Uid и имени;
  • свойства разного типа не могут быть объединены;
  • свойства с разным типом связи не могут быть объединены;
  • при объединении справочников/документов их Блоки объединяются по Uid’у и имени;
  • свойства внутри объединяемых блоков также объединяются;
  • при объединении свойств отображаемое имя имеющегося свойства будет заменено на отображаемое имя импортируемого;
  • при объединении свойств имя имеющегося свойства будет заменено на имя импортируемого;
  • при объединении свойств Uid имеющегося будет сохранен;
  • при объединении свойств, имеющих связь 1-N, Uid ключа связи будет сохранен;
  • импортируемые данные объединенных справочников так же будут объединены.

Пример объединения справочников
Имеется Справочник 1. Отображаемое имя "Наши клиенты", имя "OurCustomers", Uid "5882935F-43FB-4288-BE08-45660D4D995F".
Импортируется Справочник 2. Отображаемое имя "Наши новые клиенты", имя "OurCustomers", Uid "5882935F-43FB-4288-BE08-45660D4D995F".

Эти два справочника имеют одинаковые уникальные номера и имена. При импорте они будут объединены. Полученный в результате объединения справочник будет иметь отображаемое имя "Наши новые клиенты", имя "OurCustomers", Uid "5882935F-43FB-4288-BE08-45660D4D995F".

Этот пример применим к случаю, когда справочник был выгружен в файл конфигурации, ему сменили отображаемое имя, после чего импортировали его ранее выгруженную версию.
Пример неудачного объединения справочников
Имеется Справочник 1. Отображаемое имя "Наши клиенты", имя "OurCustomers", Uid "5882935F-43FB-4288-BE08-45660D4D995F".
Импортируется Справочник 2. Отображаемое имя "Наши клиенты", имя "OurCustomers", Uid "BC4D4F8A-06DD-4A9C-AD37-5097688059EB".

Эти два справочника несмотря на одинаковые имена и отображаемые имена имеют разные уникальные номера. Для системы это два разных справочника. Так как не могут существовать два разных справочника с одним именем, то Справочник 2 не только не будет объединен со Справочником 1, но и вообще не будет загружен в систему.

Этот пример применим к случаю, когда на двух разных серверах создали справочники с одинаковыми названиями и попытались перенести один из них на другой сервер.
Пример объединения свойств для объединяемых справочников
Объединяются имеющийся Справочник 1 и импортируемый Справочник 2.

Справочник 1 имеет:
  • Свойство 1-1 с отображаемым именем "ФИО", именем "FIO", Uid "5B341C74-9E74-46BB-B33F-7A727E398A68";
  • Свойство 1-2 с отображаемым именем "Месячная зарплата", именем "Salary", Uid "E950CCEC-E4D3-420C-BDD2-8E55E013456A";
  • Блок 1-3 с отображаемым именем "Выплаты", именем "Payments", Uid "E04C077A-A9DF-481C-ABC6-0CB86D6A269F".
Справочник 2 имеет:
  • Свойство 2-1 с отображаемым именем "ФИО", именем "FIO", Uid "5B341C74-9E74-46BB-B33F-7A727E398A68";
  • Свойство 2-2 с отображаемым именем "Зарплата", именем "Salary", Uid "BC4D4F8A-06DD-4A9C-AD37-5097688059EB";
  • Блок 2-3 с отображаемым именем "Выплаты", именем "Payments", Uid "E04C077A-A9DF-481C-ABC6-0CB86D6A269F" со свойством:
    • Свойство 2-3-1 с отображаемым именем "Выплата", именем "Vyplata", Uid "1C8C91EE-9B93-4700-9171-65AE6C686F5D".
Свойство 1-1 будет объединено со Свойством 2-1, так как они совпадают и по уникальному номеру и по имени.
Свойство 1-2 будет объединено со свойством Свойством 2-2, так как они совпадают по имени.
Блок 1-3 будет объединен с Блоком 2-3, так как они совпадают и по уникальному номеру и по имени.
Свойство 2-3-1 попадет в объединенный блок.

Полученный в результате объединения Справочник 3 будет иметь:
  • Свойство 3-1 с отображаемым именем "ФИО", именем "FIO", Uid "5B341C74-9E74-46BB-B33F-7A727E398A68";
  • Свойство 3-2 с отображаемым именем "Зарплата", именем "Salary", Uid "E950CCEC-E4D3-420C-BDD2-8E55E013456A";
  • Блок 3-3 с отображаемым именем "Выплаты", именем "Payments", Uid "E04C077A-A9DF-481C-ABC6-0CB86D6A269F" со свойством:
    • Свойство 3-3-1 с отображаемым именем "Выплата", именем "Vyplata", Uid "1C8C91EE-9B93-4700-9171-65AE6C686F5D".
Этот пример применим к случаю, когда справочник, имея только свойство "ФИО" и пустой блок "Выплаты", был выгружен из системы на другой сервер. На обоих серверах было добавлено свойство с именем "Salary", но разными отображаемыми именами. На втором сервере в блок "Выплаты" было добавлено свойство "Выплата". После чего справочник был выгружен со второго и импортирован на первый сервер.
Пример неудачного объединения свойств для объединяемых справочников
Объединяются имеющийся Справочник 1 и импортируемый Справочник 2.

Справочник 1 имеет:
  • Свойство 1-1 с отображаемым именем "Выплата", именем "Payment", Uid "8FB17373-020B-4630-AE57-8A3300AEAECB".
Справочник 2 имеет:
  • Свойство 2-1 с отображаемым именем "Выплата", именем "Vyplata", Uid "66D19D1E-D4B2-46F3-86F8-4078434226C7".

Свойство 2-1 не может быть ни объединено со Свойством 1-1 (так как у них разные имена и уникальные номера), ни добавлено в качестве второго свойства (так как нельзя иметь в справочнике два свойства одинаковыми отображаемыми именами). В результате Справчоник 2 не будет загружен в систему.

Этот пример применим к случаю, когда справочник выгрузили с одного сервера на другой. На втором случайно стерли свойство "Выплата" и решили его самостоятельно восстановить, создав новое с таким же отображаемым именем. При этом не обратили внимание на то, что созданное имя отличается от исходного. После чего попробовали перенести справочник обратно на первый сервер.
Объединение перечислений
  • если в системе имеется перечисление с Uid соответствующим импортируемому, то они будут объединены;
  • не допускается объединение перечислений имеющих один Uid, но разные имена;
  • при объединении перечислений отображаемое имя имеющегося перечисления будет заменено на отображаемое имя импортируемого перечисления;
  • объединение перечислений, имеющих значение с одинаковым именем, но разным значением не допускается;
  • при объединении значений перечислений отображаемое имя имеющегося значения будет заменено на отображаемое имя импортируемого значения.

 

Ошибки проверки файла конфигурации при импорте и их возможные причины


Ошибки системы или файла конфигурации

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

  • «В системе имеются опубликованные объекты, требующие перезапуска сервера. Перезагрузите сервер и запустите импорт заново».


Нарушена структура файла files.xml.

  • «Файл конфигурации импортируемых файлов содержит некорректные данные».


Нарушена структура файла config.xml.

  • «Файл конфигурации не содержит данных, либо версия экспорта-импорта файла конфигурации не соответствует текущей»;
  • «Файл конфигурации не содержит раздела ConfigurationData»;
  • «Файл конфигурации не содержит раздела MetadaData»;
  • «Файл конфигурации не содержит раздела Data».


Ошибки импорта метаданных

Нарушение структуры БД или файла конфигурации, повлекшее недопустимую попытку импорта системных перечислений.

  • «Импортируемое перечисление является системным»;
  • «Имеющееся перечисление является системным».


Объединение перечислений с разными именами не допускается. Для устранения ошибки переименуйте перечисление.

  • «Импортируемое перечисление имеет имя отличное от имени имеющегося перечисления».
Имена перечислений могут использоваться в запросах источников данных отчетов
Перед переименованием убедитесь, что изменение имени перечисления не нарушит работу отчетов

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

  • «Для перечисления числовое значение импортируемого значения отличается от имеющегося числового значения».


Невозможность объединить значения объединяемых перечислений без нарушения правил создания перечислений.

  • «Невозможно добавить значение в перечисление: Значение с таким именем уже существует»;
  • «Невозможно добавить значение в перечисление: Числовое значение уже существует в перечислении».


Нарушение структуры БД или файла конфигурации.

  • «Невозможно добавить значение в перечисление: Имя значения должно быть корректным идентификатором (допускаются только буквы английского алфавита, цифры и знак подчеркивания)»;
  • «Невозможно добавить значение в перечисление: Не допускаются ключевые слова C#».


Нарушение структуры БД или файла конфигурации, повлекшее недопустимую попытку импорта системных метаданных.

  • «Импортируемые системные метаданные имеют Uid соответствующий Uid имеющихся пользовательских метаданных»;
  • «Импортируемые системные метаданные имеют имя несоответствующее имеющимся системным метаданным»;
  • «Импортируемые системные метаданные имеют тип несоответствующий типу имеющихся системных метаданных»;
  • «Импортируемые пользовательские метаданные имеют Uid соответствующий Uid имеющихся системных метаданных».


Нарушение структуры БД или файла конфигурации.

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


Попытка импорта конфигурации, несоответствующей конфигурации сервера.

  • «Ошибка считывания метаданных: Тип метаданных не определен»;
  • «Ошибка считывания метаданных: описание метаданных отсутствует».


Невозможность объединить свойства объединяемых справочников/документов без нарушения правил наименования свойств.

  • «Невозможно добавить импортируемое свойство в метаданные: Свойство с таким отображаем именем уже существует».


Нарушение структуры БД или файла конфигурации.

  • «Невозможно добавить импортируемое свойство в метаданные: Не указано имя свойства»;
  • «Невозможно добавить импортируемое свойство в метаданные: Имя свойства не должно совпадать с именем объекта»;
  • «Невозможно добавить импортируемое свойство в метаданные: Имя свойства должно быть корректным идентификатором (допускаются только буквы английского алфавита, цифры и знак подчеркивания)»;
  • «Невозможно добавить импортируемое свойство в метаданные: Нельзя использовать имя Id»;
  • «Невозможно добавить импортируемое свойство в метаданные: Не допускаются ключевые слова C#».


Невозможность объединить свойства объединяемых справочников/документов без нарушения правил наименования свойств в базе данных.

  • «Невозможно добавить импортируемое свойство в метаданные: Свойство с именем поля уже существует».


Нарушение структуры БД или файла конфигурации.

  • «Невозможно добавить импортируемое свойство в метаданные: Имя поля не может начинаться со знака подчеркивания»;
  • «Невозможно добавить импортируемое свойство в метаданные: Имя поля должно быть корректным идентификатором (допускаются только буквы английского алфавита, цифры и знак подчеркивания)»;
  • «Невозможно добавить импортируемое свойство в метаданные: Нельзя использовать имя Id».


Невозможно установить связь 1-N, т.к. связанном объекте отсутствует указанная ключевая колонка.

  • «Невозможно добавить импортируемое свойство в метаданные: Невозможно установить связь 1-N, отсутствует ключевая колонка».


Невозможность объединить блоки объединяемых справочников/документов без нарушения правил наименования свойств.

  • «Невозможно добавить импортируемый блок в метаданные: Свойство с таким отображаем именем уже существует»;
  • «Невозможно добавить импортируемый блок в метаданные: Свойство с таким именем уже существует»;
  • «Невозможно добавить импортируемый блок в метаданные: Имя объекта совпадает с именем одного из свойств».


Нарушение структуры БД или файла конфигурации.

  • «Невозможно добавить импортируемый блок в метаданные: Не указано имя свойства»;
  • «Невозможно добавить импортируемый блок в метаданные: Имя свойства не должно совпадать с именем объекта»;
  • «Невозможно добавить импортируемый блок в метаданные: Нельзя использовать имя Id»;
  • «Невозможно добавить импортируемый блок в метаданные: Не допускаются ключевые слова C#».


Допускается объединение свойств только одного типа.

  • «Для метаданных тип импортируемого свойства отличается от типа имеющегося свойства»;
  • «Для метаданных тип связи импортируемого свойства отличается от типа связи имеющегося свойства».


Нарушение структуры БД или файла конфигурации.

  • «Имя таблицы недопустимо: Имя таблицы не может быть пустым»;
  • «Имя таблицы недопустимо: Имя таблицы не может начинаться со знака подчеркивания»;
  • «Имя таблицы недопустимо: Имя таблицы должно быть корректным идентификатором (допускаются только буквы английского алфавита, цифры и знак подчеркивания)»;
  • «Имя таблицы недопустимо: Имя таблицы не должно быть более 28 символов».


Невозможность импорта справочника/документа без нарушения правил наименования таблиц в базе данных.

  • «Имя таблицы недопустимо: Таблица с таким именем уже существует».


Ошибки импорта процессов

Невозможность объединить свойства объединяемых контекстов без нарушения правил наименования свойств.

  • «Невозможно добавить импортируемое свойство в контекст:  Свойство с таким отображаем именем уже существует»;
  • «Невозможно добавить импортируемое свойство в контекст:  Не указано имя свойства»;
  • «Невозможно добавить импортируемое свойство в контекст:  Имя свойства не должно совпадать с именем объекта»;
  • «Невозможно добавить импортируемое свойство в контекст: Свойство с таким именем уже существует»;
  • «Имена полей совпадают».


Допускается объединение свойств только одного типа.

  • «Для контекста тип импортируемого свойства отличается от типа имеющегося свойства»;
  • «Для контекста тип связи импортируемого свойства отличается от типа связи имеющегося свойства».


Нарушение структуры БД или файла конфигурации.

  • «Невозможно добавить импортируемое свойство в контекст: Имя свойства должно быть корректным идентификатором (допускаются только буквы английского алфавита, цифры и знак подчеркивания)»;
  • «Невозможно добавить импортируемое свойство в контекст:  Нельзя использовать имя ID»;
  • «Невозможно добавить импортируемое свойство в контекст:  Не допускаются ключевые слова C#»;
  • «Невозможно добавить импортируемое свойство в контекст: Не указано имя поля»;
  • «Невозможно добавить импортируемое свойство в контекст: Свойство с именем поля уже существует»;
  • «Невозможно добавить импортируемое свойство в контекст: Имя поля не может начинаться со знака подчеркивания»;
  • «Невозможно добавить импортируемое свойство в контекст: Имя поля должно быть корректным идентификатором (допускаются только буквы английского алфавита, цифры и знак подчеркивания)»;
  • «Невозможно добавить импортируемое свойство в контекст: Нельзя использовать имя Id».


Попытка импорта конфигурации, несоответствующей конфигурации сервера.

  • «Невозможно добавить импортируемое свойство в контекст: Тип свойства отсутствует в системе».


Невозможность объединить блоков объединяемых контекстов без нарушения правил наименования блоков.

  • «Невозможно добавить импортируемый блок в контекст: Свойство с таким отображаем именем уже существует»;
  • «Невозможно добавить импортируемый блок в контекст: Не указано имя свойства»;
  • «Невозможно добавить импортируемый блок в контекст: Имя свойства не должно совпадать с именем объекта»;
  • «Невозможно добавить импортируемый блок в контекст: Свойство с таким именем уже существует».


Нарушение структуры БД или файла конфигурации.

  • «Невозможно добавить импортируемый блок в контекст: Имя свойства должно быть корректным идентификатором (допускаются только буквы английского алфавита, цифры и знак подчеркивания)»;
  • «Невозможно добавить импортируемый блок в контекст: Нельзя использовать имя  ID»;
  • «Невозможно добавить импортируемый блок в контекст: Не допускаются ключевые слова C#»;
  • «Невозможно добавить импортируемый блок в контекст: Имя объекта совпадает с именем одного из свойств».