Как в 1С программно заполнить Excel-файл с сохранением исходного форматирования и размеров колонок

← На главную

При автоматизации документооборота часто возникает задача: взять готовый шаблон в формате Excel, который уже идеально настроен (задана ширина колонок, шрифты, границы и логотипы), и заполнить его данными из 1С. Основная сложность заключается в том, чтобы после записи данных «не поехало» оформление. В этой статье мы подробно разберем все доступные методы — от стандартных средств платформы до низкоуровневой работы со структурой файла.

Метод 1: Использование объекта ТабличныйДокумент (Метод Прочитать)

Начнем с самого современного и рекомендуемого способа для платформы 1С:Предприятие 8.3. Этот метод позволяет работать с файлом без использования установленного Microsoft Office на сервере, что критически важно для производительности и кроссплатформенности (например, если сервер 1С работает на Linux).

Рассмотрим алгоритм действий:

Создаем новый объект ТабличныйДокумент.
Загружаем в него существующий файл Excel с помощью метода Прочитать().
Находим нужные ячейки по координатам или именам.
Вставляем данные.
Сохраняем результат методом Записать() с указанием типа файла ТипФайлаТабличногоДокумента.XLSX.

Проанализируем пример кода:


ТабДок = Новый ТабличныйДокумент;
ПутьКФайлу = "C:\Templates\Report.xlsx";
// Читаем файл, 1С постарается максимально точно передать ширину колонок
ТабДок.Прочитать(ПутьКФайлу, СпособЧтенияЗначенийТабличногоДокумента.Значение);

// Заполняем ячейку (например, 2-я строка, 3-я колонка)
Область = ТабДок.Область(2, 3);
Область.Текст = "Новое значение из 1С";

// Сохраняем результат
ТабДок.Записать("C:\Output\ReadyReport.xlsx", ТипФайлаТабличногоДокумента.XLSX);

Важный нюанс: Метод Прочитать() импортирует ширину колонок в единицы измерения 1С. Хотя точность достаточно высокая, при очень сложном форматировании (миллиметровые отступы) могут быть незначительные отклонения. Однако для 90% бизнес-задач это решение является оптимальным.

Метод 2: Работа через COM-объект (Microsoft Excel)

Если на компьютере, где выполняется код, установлен Microsoft Excel, мы можем использовать COM-соединение. Это самый «верный» способ сохранить форматирование на 100%, так как редактирование происходит непосредственно движком Excel.

Разберем, как реализовать этот процесс программно:


Попытка
    Excel = Новый COMОбъект("Excel.Application");
Исключение
    Сообщить("Excel не установлен!");
    Возврат;
КонецПопытки;

Excel.Visible = Ложь;
Excel.DisplayAlerts = Ложь;

Книга = Excel.Workbooks.Open("C:\Templates\Template.xlsx");
Лист = Книга.Worksheets(1); // Обращаемся к первому листу

// Заполнение данных
Лист.Cells(5, 2).Value = "Контрагент ООО 'Ромашка'";
Лист.Cells(6, 2).Value = ТекущаяДата();

// При заполнении через COM ширина колонок гарантированно остается прежней,
// так как мы меняем только свойство Value ячейки
Книга.SaveAs("C:\Output\Result.xlsx");
Книга.Close();
Excel.Quit();

Главный минус этого метода — низкая скорость работы и требовательность к ресурсам. Не рекомендуется использовать его в циклах при массовой генерации файлов на стороне сервера.

Метод 3: Работа с XLSX как с ZIP-архивом (Низкоуровневый подход)

Как справедливо было замечено в обсуждении, современный файл .xlsx — это обычный ZIP-архив, внутри которого находятся XML-файлы. Если нам нужно изменить только данные, не трогая стили и размеры колонок, мы можем программно отредактировать XML.

Выясним структуру архива:

xl/worksheets/sheet1.xml — здесь хранятся данные ячеек.
xl/styles.xml — здесь описаны шрифты и границы.
В файле листа за ширину колонок отвечает тег <cols>.

Посмотрим на алгоритм реализации через 1С:

Используем ЧтениеZipФайла для распаковки шаблона во временную папку.
Используем ЧтениеXML и ЗаписьXML для поиска нужных узлов и замены значений в файле sheet1.xml.
Запаковываем файлы обратно через ЗаписьZipФайла, сохраняя расширение .xlsx.

Этот метод невероятно быстр, но требует глубоких знаний структуры OpenXML. Преимущество: вы гарантированно не измените ни один байт в описании стилей или ширины колонок, так как правите только текст внутри тегов значений.

Метод 4: Использование именованных областей (Named Ranges)

Для повышения надежности любого из вышеперечисленных методов (особенно COM), рекомендуем использовать именованные области в Excel. Вместо того чтобы обращаться к ячейке Cells(5, 2), которая может сдвинуться при редактировании шаблона пользователем, вы задаете ячейке имя в самом Excel (например, "ДатаДоговора").

Проанализируем ситуацию: пользователь зашел в шаблон, расширил колонки или вставил пустую строку сверху. Если ваш код завязан на координаты (5, 2), данные попадут не туда. Если же вы используете имя:


// Пример для COM
Лист.Range("ДатаДоговора").Value = ТекущаяДата();

В этом случае Excel сам найдет нужную ячейку, где бы она ни находилась, и сохранит все ее настройки оформления.

Метод 5: Вставка объекта в макет 1С (OLE)

Рассмотрим еще один вариант: хранение шаблона прямо внутри конфигурации. В макете 1С можно выбрать тип «Двоичные данные» (для хранения файла) или «Active документ». Однако, если вы хотите визуально редактировать его в конфигураторе, можно вставить объект Лист Microsoft Excel.

Как это сделать:

В окне редактирования макета выберите пункт меню «Таблица» -> «Рисунки» -> «Вставить объект».
Выберите «Создать из файла» и укажите ваш Excel-шаблон.

Теперь шаблон хранится в 1С. При программном выводе вы можете активировать этот объект и заполнить его. Но помните, что этот метод привязывает вас к среде Windows и разрядности установленного Office (32/64 бита), что часто вызывает ошибки "OLE-объект не зарегистрирован".