Универсальная загрузка данных из табличного документа (ОФ)

    Обработка "Универсальная загрузка данных из табличного документа" - предназначена для загрузки данных из табличных документов в объекты базы данных.

    Описание:
    Обработка поддерживает загрузку следующих форматов файлов: CSV, MXL, ODS, XLS, XLSX, DBF, XML. Обработка поддерживает загрузку с интервалом указанным в минутах.

    Основные преимущества и возможности:
        - Настраиваемая загрузка в любые объекты базы данных и независимые регистры сведений.
        - Автоматическая загрузка с интервалом.
        - Более 5-ти форматов для загрузки.
        - Возможность выполнения списка команд и кода по определённым событиям.

    Порядок настройки загрузки:
        1) Добавить новую загрузку.
        2) Выполнить настройку:
            - Выбрать "Тип объекта загрузки".
            - Выбрать "Вид объекта загрузки".
        3) Выбрать в таблице необходимые реквизиты для загрузки и уточнить их режим поиска.
        4) Указать поле поиска объекта (Уникальное для объекта).
        5) Проверить соответствие порядка загружаемых реквизитов с колонками в загружаемой таблице.
        6) Выбрать папку загрузки, расширение файла, формат загружаемых данных и указать интервал автоматической загрузки.
        7) Включить "Автозагрузку" или выполнить принудительно кнопкой "Выполнить загрузку".

    Основные правила загрузки:
    1) Порядок колонок загружаемой таблицы должен соответствовать нумерации реквизитов на панели "Настройки загрузки".
    2) Установленный флаг для реквизита означает чтение данных ячейки из соответствующей колонки загружаемой таблицы и обработку данного реквизита. Установленный режим загрузки определяет порядок обработки реквизита:
        - Искать - Преобразует считанное значение ячейки к "Искомому типу" (для простого типа) или "Искомому типу подреквизита" (для объекта), если преобразование не удалось, устанавливает значение по умолчанию.
        - Устанавливать - Устанавливает для реквизита значение по умолчанию.
        - Вычислять - Вычисляет введённое выражение и помещает его результат в реквизит.
        - Пропускать - Только считывает значение ячейки, не обрабатывая реквизит.

    Особенности поиска по реквизитам:
    1) При поиске объекта по ссылке, поиск производится по уникальной ссылке объекта, в случае отсутствия такой ссылки в базе, обработка пробует создать объект с такой же ссылкой, а в случае неудачи выдаётся сообщение об ошибке создания объекта.
    2) При поиске объекта по коду, поиск производится по полному совпадению кода, а для справочников и планов видов характеристик - без учета подчинения родителю или владельцу.
    3) При поиске объекта по наименованию, поиск производится по полному совпадению наименования за исключением "хвостовых" пробелов.
    4) При поиске объекта "Документ" и "БизнесПроцесс" по номеру, поиск производится по полному совпадению номера, при наличии выбранного реквизита дата поиск осуществляется в пределах периодичности. Для объекта "Задача" поиск в пределах периодичности не производится.

    Пояснения и рекомендации по загрузке:
    1) Для иерархических объектов, в случае отсутствия объекта в базе, по умолчанию создаются элементы. Для возможности создания группы вместо элемента необходимо наличие выбранного реквизита "ЭтоГруппа" с режимом загрузки отличным от "Пропускать" и значением реквизита "Истина".
    2) Для загрузки подчинённых или иерархических объектов сначала необходимо загрузить их владельцев и родителей.
    3) При загрузке объекта "РегистрСведений" производится отбор по выбранному периоду (в случае наличия и выбора) и всем выбранным измерениям. При нахождении записей удовлетворяющих отбору и установленном флаге "ПерезаписыватьСуществующиеОбъекты" набор записей очищается и добавляются загружаемые данные. При отсутствии записей удовлетворяющих отбору и установленном флаге "СоздаватьНовыеОбъекты" будет создан новый набор записей состоящий из загружаемых данных.
    4) Для объектов "Справочник" и "ПланВидовХарактеристик" выполняется проверка использования полей (Для групп и элементов) автоматически при загрузке данных. Поля не соответствующие использованию в реквизитах не будут загружены в объект.

    Обработка написана для обычных форм. Тестирование проводилось на конфигурации «1С Предприятие УПП» с версией платформы 8.3.11.2831 и 8.3.10.2667. Автор также не несет ответственности за ущерб, причиненный в результате использования данной обработки. Замечания и предложения по улучшению приветствуются. Последующие обновления обработки могут быть получены на Email по запросу.

    Обработку можно применять совместно с обработкой "Универсальная выгрузка данных и анализ", находящейся по адресу //infostart.ru/public/1159142/

    История версий
    Версия 1.0:
        - Создание.

    Версия 1.0.1:
        - Исправлены ошибки.

    Версия 1.0.2:
        - Исправлены незначительные ошибки.

    Версия 1.0.3:
        - Для пустых значений теперь устанавливается значение из поля значение по умолчанию.
        - В выражении теперь можно обратиться к полю ТекстЯчейки.

    Версия 1.1 от 03.08.2020:
        - Исправлены ошибки при заполнении реквизитов иерархических и подчинённых объектов.
        - Исправлен поиск по подреквизитам.
        - Добавлена поддержка загрузки значений типа "ОписаниеТипов".
        - Добавлена поддержка загрузки значений типа "Перечисление".
        - Добавлена поддержка загрузки значений типа "УникальныйИдентификатор" и установки его в качестве поля поиска объекта.
        - Добавлена поддержка загрузки строковых значений в реквизит с типом "ХранилищеЗначения".
        - Исправлен поиск по коду для объектов "Справочник", "ПланВидовХарактеристик".
        - Исправлен поиск по номеру для объектов "Документ" и "БизнесПроцесс", теперь он может быть привязан к периодичности объекта.
        - Доработана установка значений по умолчанию в зависимости от искомого типа данных.

    Версия 1.1.1 от 12.08.2020:
        - Исправлены ошибки при подстановке объектов и набора записей установленных в событии "После обработки данных объекта".
        - Переработаны и расширены пункты меню "Работа с объектами" в окне результатов загрузки.

    Версия 1.1.2 от 20.08.2020:
        - Исправлены ошибки при заполнении объектов.
        - Поиск объектов и реквизитов теперь формируется запросом.
        - Переработаны параметры событий.
        - Исправлена загрузка из DBF файла.

    Версия 1.1.3 от 04.09.2020:
        - Исправлены ошибки при настройке загрузки по полю ссылки.
        - Изменены некоторые картинки.

    Версия 1.1.4 от 04.02.2021:
        - При открытии простых типов в полях "Искомый тип" и "Искомый тип подреквизита" теперь можно увидеть их квалификаторы.
        - Исправлены известные ошибки.

    Версия 1.2 от 23.05.2022:
        - Добавлена возможность загрузки данных в транзакции.
        - Проверена совместимость с платформой 8.3.10.2667.

    Версия 1.2.1 от 27.05.2022:
        - Добавлена возможность загрузки каждого объекта в транзакции.
        - Исправление неточностей описания и других ошибок.

    Версия 1.2.2 от 23.09.2022:
        - Теперь в выражении можно обратиться к массиву "ТекстыЯчеек".
        - Мелкие правки таблицы настройки загрузки.

    Версия 1.2.3 от 02.08.2023:
        - Исправлены известные ошибки.

    Версия 1.2.4 от 03.08.2023:
        - Исправлены известные ошибки.

    Версия 1.3 от 02.10.2023:
        - Добавлен флаг "Тест" для предварительной загрузки данных без записи в базу данных.

    Версия 1.3.1 от 09.10.2023:
        - Исправлены известные ошибки.
    
    Версия 1.3.2 от 15.10.2023:
        - Оптимизация поиска объектов.
        - Добавлена возможность сохранения тестовой таблицы в файл.
        - Исправление ошибок при определении пустых типов реквизитов.

    Версия 1.3.3 от 10.04.2024:
        - Корректировка ошибок заполнения полей метаданных регистров сведений.

    Версия 1.3.4 от 12.04.2024:
        - Корректировка ошибок.