Документация iSZN

Загрузка данных из файлов XML

С помощью файлов XML экземпляры Системы КИС iSZN могут обмениваться между собой различными данными. Для обмена данными на одном экземпляре Системы выполняется выгрузка данных в файл XML, а на другом экземпляре Системы выполняется загрузка этих данных из файла.

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

  1. Пользователем, обладающим ролью «Администратор справочников», добавить в справочник источников данных для импорта источник данных, соответствующий экземпляру Системы, из которого получен файл XML (если такого источника данных ещё нет).
  2. Пользователем, обладающим ролью «Главный специалист», запустить задачу «Серверные операции».
  3. На странице «Выбор серверной операции» выбрать необходимую серверную операцию.
  4. На странице «Параметры операции» в качестве значения параметра «Источник данных для загрузки» выбрать источник данных, соответствующий экземпляру Системы, из которого получен файл XML.
  5. На странице «Входной файл» выбрать файл, данные из которого требуется загрузить.
  6. На странице «Режим запуска» выбрать пункт «Запустить операцию сейчас».
  7. На странице «Задание параметров протоколирования» при необходимости внести изменения в предлагаемые параметры.
  8. После завершения серверной операции установить соответствие между записями справочников Системы, из которой получены данные, и Системой, в которую загружаются данные.
    • Вызвать задачу «Просмотр протоколов» нажав на кнопку «Открыть файл протокола» на странице «Завершено».
    • Найти в файле протокола (включив режим отображения записей предупреждений) предупреждения о неудавшихся попытках выполнить перекодировку ссылок на сущности.
    • Открыть справочник источников данных для импорта XML-дампов людей/коллективов.
    • Вызвать диалог свойств источника данных для источника данных, соответствующего Системе, из которой получены данные для загрузки.
    • Перейти на любую из двух вкладок:
    • Выделить в списке сущность (или реквизит персонального документа, в котором используется ссылка на эту сущность) и нажать на кнопку «Открыть справочник» для вызова справочника, предназначенного для работы с экземплярами выбранной сущности.
    • Определить по справочнику экземпляр сущности в Системе, которая является приёмником данных, соответствующий экземпляру сущности в Системе, которая является источником данных, и запомнить идентификатор этого экземпляра сущности (то есть, например, нужно убедиться, что в справочнике улиц Системы-приёмника существует улица Ленина, соответствующая улице Ленина Системы-источника). Если в справочнике нет соответствующего экземпляра сущности, то его нужно добавить и запомнить его идентификатор (например, добавить в справочник улицу, если её нет в справочнике Системы-приёмника).
    • На вкладке «Сущности» (или «Реквизиты персональных документов») диалога свойств свойств источника данных выполнить команду «Соответствие ключей...».
    • В открывшемся диалоге отображения ключей сущности (или диалоге отображения ключей реквизита персонального документа) найти экземпляр сущности, для которого не удалось выполнить перекодировку ссылки. В этом диалоге для экземпляров сущности, перекодировку ссылки которых не удалось выполнить автоматически, столбец «Внутр. ID» не заполнен. Для удобства поиска записи можно отсортировать список по этому столбцу, щёлкнув левой кнопкой мыши по наименованию столбца.
    • Выполнить команду «Свойства...» для экземпляра сущности, перекодировка ссылки которого не была выполнена автоматически.
    • В открывшемся диалоге свойств записи соответствия ключей сущности ввести идентификатор внутренней записи экземпляра сущности.
    • Закрыть диалог свойств записи соответствия ключей сущности, а также все его родительские диалоги, нажав на кнопку OK.
  9. Повторно выполнить серверную операцию, использовавшуюся для загрузки данных, с теми же параметрами и тем же входным файлом (например, воспользовавшись кнопкой «Ещё раз» на странице «Завершено» задачи «Серверные операции»). Убедиться, что в файле протокола нет записей с предупреждениями. Если предупреждения есть, то необходимо повторно установить соответствие между записями справочников Системы, из которой получены данные, и Системой, в которую загружаются данные, и повторить загрузку данных.

См. также