Защита от смены структуры нужна, чтобы случайный или измененный файл поставщика не сломал привязанные профили импорта. После успешного получения рабочего файла Eofferix запоминает принятую структуру: состав колонок, XML/JSON-узлов, атрибутов или других элементов, важных для настройки источника.
При следующем обновлении источник сравнивает новую структуру с принятой. Сервис не хранит в этом блоке весь большой файл как справочник для пользователя; он проверяет короткое представление структуры, достаточное для понимания, что именно изменилось.
Где настроить защиту
Откройте карточку источника после того, как рабочий файл уже получен. Блок Защита от смены структуры появляется в настройках источника и содержит два основных параметра: режим контроля и учет порядка колонок или узлов.
Что означают режимы контроля
- Строгая сигнатура - новый файл не принимается автоматически, если структура отличается от принятой. Сервис покажет предупреждение, сравнение новой и старой структуры документа и будет ожидать ручного подтверждения новой структуры. Используйте для критичных источников, где изменение колонок или узлов может испортить импорт.
- Только поля и колонки - проверяется состав структурных элементов без учета порядка. Для таблиц это набор листов и колонок, для XML - пути узлов и атрибутов, для JSON - ключи. Подходит, если поставщик меняет порядок или оформление файла, но сохраняет смысл полей.
- Только предупреждать - файл принимается, но в карточке источника остается предупреждение. Используйте для источников, где важнее не остановить обновление, чем заблокировать риск.
- Не проверять - защита выключена. Этот вариант подходит только для источников, где изменения структуры не влияют на дальнейшую обработку.
Учет порядка колонок и узлов
Параметр Учитывать порядок колонок и узлов определяет, считается ли перестановка элементов изменением структуры. Если у поставщика CSV или XLSX, где порядок колонок важен для правил, оставьте порядок включенным. Если поставщик часто переставляет колонки, но названия остаются прежними, можно выбрать вариант Нет, важен только состав: сервис сравнит набор полей, и перестановка колонок с теми же заголовками не остановит источник.
Что происходит при смене структуры
Если режим блокирует новый файл, Eofferix показывает окно с отличиями. В нем видно, какая структура была принята раньше, какая пришла сейчас, какие поля или узлы пропали и какие добавились. Пока новая структура не принята, источник не заменяет рабочий файл на рискованную версию.
Кнопка Пока не принимать закрывает окно без изменения принятой структуры. Кнопка Принять новую структуру делает новую структуру рабочей для следующих обновлений. После принятия стоит проверить привязанные профили: если пропали поля, которые использовались в снапшоте или преобразованиях, правила нужно обновить.