Универсальная загрузка табличных частей из Excel - загрузка из Excel в 1С
Интеграция - Загрузка и выгрузка в Excel
Файлы
ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.
Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний
Оформите подписку на компанию для решения рабочих задач
Оформить подписку и скачать решение со скидкойВы можете заказать платную доработку или адаптацию этой разработки под вашу конфигурацию на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.
1. Преимущества решения
|
Возможность |
Практическое удобство |
|
Пошаговый интерфейс |
Назначение, источник, сопоставление и запись разведены по четырём страницам. Пользователь видит только параметры текущего действия. |
|
Разные форматы |
XLSX читается без установленного Microsoft Excel. Также поддерживаются XLS, ODS, MXL, CSV, TSV, TXT и JSON. |
|
Динамические метаданные |
Документы, справочники, табличные части и их поля определяются в текущей базе. Обработка не содержит жёсткой привязки к объектам УТ. |
|
Проверка без записи |
Преобразование значений и поиск ссылок можно выполнить до изменения данных объекта. |
|
Три режима |
Новые строки можно добавить, полностью заменить или обновить по одному или нескольким ключам. |
|
Диагностика |
Протокол показывает результат по строкам; обработанные исключения записываются в журнал регистрации и сопровождаются сообщением пользователю. |
Автоматическое сопоставление использует имена и синонимы реквизитов. Для каждой колонки видны пример исходного значения и состояние сопоставления. Если автоматический выбор не подходит, поле назначения, способ поиска ссылки и значение по умолчанию можно изменить вручную.
2. В чём польза
Менеджер переносит в заказ подготовленный список товаров или услуг без повторного ввода каждой строки. Бухгалтер или специалист казначейства может загружать табличные расшифровки платежей, если соответствующий документ и его табличная часть доступны в конфигурации. Администратор или внедренец применяет один EPF к разным объектам, не создавая отдельную обработку для каждого документа.
|
Рабочая задача |
Что сокращается |
Как проверить |
|
Первичное заполнение |
Ручной ввод строк и повторный поиск справочных значений |
Предпросмотр, сопоставление, проверка без записи |
|
Полная перезагрузка |
Удаление и повторное создание каждой строки |
Предупреждение о числе удаляемых строк и итоговый протокол |
|
Повторная загрузка |
Ручное сравнение существующих и новых строк |
Режим обновления по отмеченному ключу |
|
Исправление файла |
Поиск ошибки уже после изменения документа |
Строгий режим блокирует запись при любой ошибке |
|
Проверяемая польза Обработка не обещает фиксированную экономию времени: объём выигрыша зависит от числа строк, качества исходного файла и правил конфигурации. Пользователь получает измеримый результат — число успешно обработанных, пропущенных и ошибочных строк. |
3. Пример использования
1. Исходная задача. В файле «Пример загрузки товаров.xlsx» подготовлены пять строк с разной номенклатурой, количеством от 1 до 5, ценой, суммой, складом и ставкой НДС. Строки нужно перенести в табличную часть «Товары» уже записанного заказа клиента в тестовой базе.
2. Выбор данных и настройка. Пользователь выбирает заказ, табличную часть «Товары» и режим «Заменить». Флажок «Не записывать объект при ошибках» остаётся включённым. Затем открывает Excel-файл и проверяет предпросмотр.
3. Выполнение действий. Обработка автоматически связывает колонки файла с реквизитами табличной части. Пользователь проверяет примеры значений и запускает «Проверить без записи».
4. Полученный результат. Протокол подтверждает обработку пяти строк и прямо указывает, что при проверке объект не записан. После отдельной команды записи и подтверждения табличная часть заменяется.
5. Проверка результата и дальнейшая работа. Пользователь открывает заказ и сверяет пять строк, разные позиции номенклатуры и количества 1–5. После фактической записи появляется сообщение «Загрузка успешно завершена. Объект записан.». При ошибке запись не выполняется, а файл или сопоставление можно исправить и проверить повторно.
|
Фактическая проверка примера Тестовая запись перечитала заказ из базы и подтвердила: 5 строк, 5 разных ссылок номенклатуры, значения «Количество» и «КоличествоУпаковок» от 1 до 5. |
4. Функциональные возможности
Назначение и область применения
Обработка загружает строки в табличную часть уже записанного документа или элемента справочника. Она подходит для товаров, услуг, платежей и других строковых данных, когда пользователь может подготовить плоскую таблицу и сопоставить её колонки с реквизитами целевой табличной части.
Список целей формируется по метаданным текущей информационной базы. В проверенной среде скан метаданных нашёл 519 справочников, 294 документа, 467 объектов с табличными частями, 1 182 табличные части и 8 692 реквизита. Этот результат подтверждает работу динамического обхода в одной крупной конфигурации, но не является гарантией записи в любой объект любой конфигурации.
Требования и проверенная среда
|
Параметр |
Требование или результат |
|
Платформа |
1С:Предприятие 8.3; 8.5 |
|
Конфигурация |
Управляемая конфигурация с документами или справочниками, имеющими обычные табличные части |
|
Microsoft Excel |
Не требуется для XLSX; чтение XLS выполняется средствами платформы |
|
Права |
Запуск дополнительной обработки, чтение выбранного объекта и справочников, запись целевого объекта; для подключения нужны административные права подсистемы |
Подключение и запуск
Штатный способ установки — подсистема «Дополнительные отчёты и обработки». Путь в интерфейсе обычно выглядит так: «Администрирование — Печатные формы, отчёты и обработки — Дополнительные отчёты и обработки». Название раздела может отличаться в конкретной конфигурации.
1. Откройте список дополнительных отчётов и обработок с правами администратора.
2. Разрешите использование дополнительных отчётов и обработок, если подсистема отключена.
3. Нажмите «Добавить из файла» и выберите «УниверсальнаяЗагрузкаТабличныхЧастей.epf».
4. Проверьте наименование и доступность команды, запишите элемент и запустите обработку зарегистрированной командой.
Шаг 1 Куда загружать
|
Поле |
Назначение |
|
Объект назначения |
Записанный документ или элемент справочника с табличной частью. После выбора обработка читает метаданные объекта. |
|
Табличная часть |
Список табличных частей выбранного объекта. Сводка показывает количество полей и существующих строк. |
|
Режим загрузки |
Определяет, сохранять, заменять или обновлять существующие строки. |
|
Не записывать объект при ошибках |
Строгий режим. Если найдена хотя бы одна ошибка строки, запись блокируется. |
Для проведённого документа обработка после изменения выполняет запись с проведением, чтобы движения соответствовали новым строкам. Возможность перепроведения зависит от прав пользователя и правил документа.
Шаг 2 Файл и предпросмотр
|
Параметр |
Допустимые значения и действие |
|
Первая строка — заголовки |
Включено — первая строка задаёт названия колонок; выключено — используются имена «Колонка 1», «Колонка 2» и т. д. |
|
Разделитель |
Авто, точка с запятой, запятая или табуляция. Применяется к CSV, TSV и TXT. |
|
Кодировка |
UTF-8 или Windows-1251 для текстовых файлов. |
|
Максимум строк |
От 1 до 200 000; значение по умолчанию 50 000. |
|
Пропускать пустые строки |
Не создаёт строку назначения из полностью пустой строки источника. |
Параметры разделителя и кодировки не влияют на XLSX, XLS, ODS, MXL и JSON. Предпросмотр предназначен для проверки структуры и первых значений; полная проверка выполняется на четвёртом шаге.
Шаг 3 Сопоставление
|
Колонка |
Что настраивает |
|
Загружать |
Включает колонку источника в загрузку. |
|
Источник |
Показывает исходный заголовок колонки. |
|
Пример |
Показывает первое непустое значение без изменения данных. |
|
Поле назначения |
Реквизит строки выбранной табличной части. Значение «не загружать» исключает колонку. |
|
Ключ |
Участвует в поиске существующей строки в режиме «Обновить или добавить». Можно отметить несколько полей. |
|
Поиск ссылки |
Авто, по коду, наименованию, артикулу или уникальному идентификатору. |
|
По умолчанию |
Подставляется, если ячейка источника пуста. |
|
Обязательно |
Пустое значение считается ошибкой строки. |
|
Состояние |
Показывает результат автоматического сопоставления. |
|
Защита от неоднозначности Одно поле назначения нельзя сопоставить нескольким колонкам. Если поиск ссылки возвращает несколько объектов, строка считается ошибочной — случайная ссылка не выбирается. |
Шаг 4 Проверка и загрузка
|
Команда или область |
Результат |
|
Проверить без записи |
Проверяет настройки, преобразует значения и ищет ссылки, но не записывает объект. |
|
Записать в объект |
Показывает подтверждение, выполняет загрузку и записывает объект. В режиме замены сообщает число удаляемых строк. |
|
Готовность |
Кратко объясняет, чего не хватает для выполнения шага. |
|
Протокол |
Показывает источник, объект, табличную часть, результат по строкам и итоговые счётчики. |
После успешной записи выводится сообщение «Загрузка успешно завершена. Объект записан.». При проверке без записи сообщение об успешной записи не выводится.
Настройки и значения разных типов
Отдельных отборов в обработке нет. Состав строк задаётся исходным файлом, а назначение ограничивается одним выбранным объектом и одной табличной частью. Управление загрузкой выполняется сопоставлением колонок, значениями по умолчанию, обязательностью и ключами.
|
Тип |
Пример источника |
Правило |
|
Строка |
Комментарий к строке |
Передаётся как текст с учётом допустимой длины реквизита. |
|
Число |
1 234,50 или 1234.50 |
Пробелы-разделители удаляются; десятичный разделитель распознаётся. |
|
Дата |
03.10.2026 14:25:30 или 2026-10-03 |
Преобразуется в дату платформы. |
|
Булево |
Да, Истина, Yes, 1; Нет, Ложь, No, 0 |
Неизвестное значение считается ошибкой. |
|
Перечисление |
20% |
Ищется по пользовательскому представлению значения перечисления. |
|
Справочник |
Код, наименование, артикул или UUID |
Способ поиска выбирается в сопоставлении; «Авто» проверяет доступные идентификаторы. |
|
Документ |
Номер или UUID |
Ищется ссылка документа требуемого типа. |
Режимы изменения строк
|
Режим |
Поведение |
Когда применять |
|
Добавить |
Сохраняет существующие строки и добавляет новые в конец. |
Первичное дополнение документа или справочника. |
|
Заменить |
Очищает табличную часть перед заполнением; до записи показывает число удаляемых строк. |
Файл содержит полный актуальный состав строк. |
|
Обновить или добавить |
Ищет строку по отмеченным ключам, обновляет найденную или добавляет новую. |
Повторная загрузка, где часть строк уже существует. |
|
Ключ обязателен Для режима «Обновить или добавить» отметьте хотя бы одну колонку как ключ. Составной ключ допустим: строка считается найденной только при совпадении всех отмеченных полей. |
Чтение и проверка результата
Итог протокола содержит количество строк источника, успешных строк, пропущенных пустых строк и ошибок. Во время проверки формулировка прямо указывает, что данные базы не изменяются. После записи объект следует открыть штатной формой и сверить количество строк, ссылки и числовые реквизиты.
- Сверьте итоговое число строк с исходным файлом с учётом пропущенных пустых строк.
- Проверьте, что ссылки относятся к нужным элементам, особенно при поиске по наименованию.
- Проверьте количество, количество упаковок, цену, сумму и ставку НДС, если эти поля загружались.
- Для проведённого документа проверьте статус проведения и движения.
- Сохраните протокол или повторите проверку после исправления исходного файла.
Сообщения и типовые ошибки
|
Сообщение или признак |
Причина |
Действие пользователя |
|
Не найдено значение в справочнике |
Код, наименование или артикул отсутствует либо выбран неверный способ поиска. |
Исправить значение, выбрать другой способ поиска, создать элемент по штатному процессу и повторить проверку. |
|
Найдено несколько значений |
Поиск вернул неоднозначный результат. |
Использовать уникальный код или UUID; устранить дубли в справочнике. |
|
Не заполнено обязательное поле |
Пустая ячейка и включён признак «Обязательно». |
Заполнить ячейку или задать значение по умолчанию. |
|
Режим обновления требует ключ |
Ни одна колонка не отмечена как ключ. |
Отметить устойчивое поле или набор полей. |
|
Объект не записан |
Строгий режим и хотя бы одна ошибка строки. |
Исправить файл или сопоставление, затем повторить проверку. |
|
Ошибка записи объекта |
Права, блокировка, обязательные поля или обработчик «ПередЗаписью» целевой конфигурации. |
Открыть полный текст ошибки и журнал регистрации, проверить права и правила объекта. |
События журнала регистрации имеют префикс «ЗагрузкаТабличныхЧастей». Подробный контекст ограничивается 10 000 символами. Ошибки большого количества строк агрегируются: пользователь получает одно сообщение, а подробности остаются в протоколе и журнале.
Ограничения и меры предосторожности
- Объект назначения должен быть записан. Загрузка в ещё не записанную форму документа не поддерживается.
- За один запуск обрабатывается один объект и одна его табличная часть. Пакетной загрузки нескольких объектов нет.
- Профили сопоставления не сохраняются; при новом файле сопоставление формируется заново.
- Автоматического отката нет. Перед массовой или первой загрузкой нужна резервная копия либо тестовая копия базы.
- Бизнес-правила конфигурации могут требовать реквизиты, характеристики, серии, подразделения или специальные права, которых нет в исходном файле.
- Формат JSON ограничен массивом одноуровневых объектов. Вложенные таблицы и структуры не разворачиваются.
- Максимум строк задаётся пользователем в пределах 1–200 000; крупные файлы требуют оценки времени и памяти на тестовой копии.
Проверено на следующих конфигурациях и релизах:
- 1С:ERP Управление предприятием 2, релизы 2.6.1.70
- 1С:Комплексная автоматизация 2, релизы 2.6.1.70
- Управление торговлей, редакция 11, релизы 11.6.1.70
- Документооборот КОРП, редакция 3.0, релизы 3.0.21.3
- Управление нашей фирмой, редакция 3.0, релизы 3.0.14.159
- Розница, редакция 3.0, релизы 3.0.14.159
- Бухгалтерия предприятия, редакция 3.0, релизы 3.0.207.25
- Зарплата и управление персоналом, редакция 3.1, релизы 3.1.38.92
- 1С:Управление холдингом 3.2 (русский и английский интерфейсы), релизы 3.2.11.20
Вступайте в нашу телеграмм-группу Инфостарт
См. также
5490 руб.
12.08.2021 48395 654 71
6000 руб.
11.12.2019 68000 1163 3
12444 руб.
29.10.2014 237832 777 544
6000 руб.
26.11.2020 51245 865 4
6000 руб.
01.03.2021 13417 88 0
