Форматы файлов для обновления справочника:
Для обновления справочника с помощью файла могут быть использованы 3 типа файлов с возможностью выбора кодировки данного файла:
- XML;
- CSV;
- ZIP.
На каждый из типов файлов накладываются свои, особые ограничения.
Обновление справочника:
Частичное обновление данных происходит по следующему алгоритму:
- для каждой строки файла система пытается найти соответствие в справочнике по значению ключевого атрибута;
- если совпадение найдено, система обновляет строку справочника информацией из файла;
- если совпадения не найдено, система добавляет строку из справочника в файл.
Если структура файла не соответствует существующей структуре справочника, обновление не будет произведено.
Для частичного обновления данных справочника необходимо выполнить следующие действия:
1. Перейти на страницу Списка справочников (рисунок 1);
Рисунок 1 - Страница списка справочников
2. Найти в списке справочник, который необходимо обновить;
3. Перейти на страницу просмотра справочника;
4. В области просмотра метаинформации данного справочника нажать кнопку Обновление справочника из файла (рисунок 2);
Рисунок 2 - Обновление справочника из файла
5. ЕСНСИ отобразит экранную форму Обновление справочника (рисунок 3);
Рисунок 3 - Форма обновления справочника
6. Выбрать файл – Для этого необходимо перетащить файл с обновлением справочника в активную область или выполнить следующие действия:
- нажать кнопку Загрузить вручную (рисунок 3);
- выбрать файл для импорта;
- название выбранного файла отобразится в поле Файл.
7. Опция Частичное обновление данных включена по умолчанию (при данном режиме для данных файла обновления должны быть указаны базы для автоключа) (рисунок 4);
Рисунок 4 - Частичное обновление данных справочника
8. При необходимости включить опцию Удаление данных, исключенных из справочника при обновлении – данная опция позволяет удалить все записи справочника, отсутствующие в файле обновления;
9. Нажать кнопку Обновить;
10. ЕСНСИ отобразит уведомление о запросе на обновление (рисунок 5);
Рисунок 5 - Уведомление о запросе на обновление справочника из файла
11. Система запустит проверку на наличие ошибок в файле обновлений, если ошибок выявлено не будет пользователь увидит уведомление о создании новой ревизии файла (рисунок ).
12. Произойдет возврат к списку записей справочника;
13. В случае, если в файле обновлений будут выявлены ошибки в области отображения метаинформации справочника пользователю будет отображена информация о выявленных нарушениях с возможностью просмотра или скачиванию протокола ошибок в формате CSV (рисунок 6).
Рисунок 6 - Ошибки в файле обновлений
Для работы с нарушениями при обновлении необходимо нажать на кнопку-ссылку «Выявленные нарушения», ЕСНСИ отобразит страницу работы с протоколом проверки.
Выбор вида кодировки обновления файла:
Для удобства пользования системой предусмотрена возможность выбора текущей кодировки файла обновления справочника, при этом автоматический выбор кодировки основан на типе файла обновления, для файлов типа XML – по умолчанию автоматически выбирается кодировка UTF-8, для файлов типа CSV – по умолчанию автоматически выбирается кодировка Windows-1251.
В случае, если кодировка отличается от кодировки, выбранной системой, пользователь может сам переставить флаг, в этом случае произойдет автоматическое декодирование файла с текущей кодировки, на требуемую системой. Данная опция предназначена во избежание ситуаций с некорректным отображением символов в записях справочников.