Разработка и Конфигурация · 11 мин
Что используется в качестве визуального средства для табличных документов в 1С
Какое визуальное средство используется для создания и изменения табличных документов в 1С: табличный редактор, его возможности, макеты и практика работы.
В качестве визуального средства для создания и изменения табличных документов в 1С используется табличный редактор — встроенный инструмент платформы, внешне напоминающий электронные таблицы. Он доступен и в конфигураторе (при разработке макетов печатных форм), и в пользовательском режиме (при просмотре и редактировании сформированных отчётов и печатных документов).
Табличный документ в 1С — это объект с ячеечной структурой: строки, колонки, объединённые области, рамки, шрифты, заливка. Через табличный редактор разработчик визуально собирает макет будущей печатной формы, а пользователь видит итоговый документ, может его отредактировать, сохранить в файл или распечатать.
Важно понимать двойственность инструмента: один и тот же табличный документ существует как макет в конфигурации (шаблон с именованными областями и параметрами) и как результат — заполненный данными документ, который выводится на экран. Табличный редактор обслуживает обе роли.
Что такое табличный документ и табличный редактор в 1С
Табличный документ — один из базовых типов данных платформы 1С:Предприятие. Он представляет собой прямоугольную сетку ячеек, каждая из которых может содержать текст, число, дату, картинку, а также оформление: шрифт, цвет, границы, выравнивание. Ячейки можно объединять, задавать фиксированную ширину колонок и высоту строк, защищать от редактирования.
Табличный редактор — это визуальная оболочка для работы с таким документом. Он открывается автоматически, когда вы открываете макет типа «Табличный документ» в конфигураторе или когда программа формирует печатную форму в пользовательском режиме. Отдельной установки не требуется — редактор входит в состав платформы.
Где открывается табличный редактор
В конфигураторе табличный редактор вызывается при создании или открытии макета. Путь: дерево конфигурации → нужный объект (документ, справочник, отчёт) → ветка «Макеты» → добавить макет типа «Табличный документ». Также макеты общего назначения хранятся в ветке «Общие» → «Общие макеты».
В режиме «1С:Предприятие» редактор появляется при формировании печатной формы (кнопка «Печать» в документе) или табличного отчёта. Здесь пользователь может править содержимое, если документ не защищён, а также сохранить результат через «Файл → Сохранить копию» в форматах MXL, Excel, PDF, HTML и других.
Кроме того, табличный документ можно открыть как самостоятельный файл: платформа работает с файлами формата MXL (родной формат 1С) через «Файл → Открыть» в толстом или тонком клиенте.
Основные возможности табличного редактора
Редактор позволяет выполнять полный цикл визуальной работы с макетом или готовым документом:
- ввод и редактирование текста, чисел и формул в ячейках;
- объединение и разделение ячеек, вставка и удаление строк и колонок;
- настройка оформления: шрифт, цвет текста и фона, толщина и стиль границ, выравнивание;
- создание именованных областей — горизонтальных и вертикальных блоков, которые программно выводятся при формировании печатной формы;
- задание параметров ячеек: если свойство «Заполнение» установлено в «Параметр», значение подставляется из данных при выводе;
- вставка картинок, диаграмм, элементов управления (в толстом клиенте);
- группировка строк и колонок, расстановка разрывов страниц, настройка колонтитулов и параметров печати.
Текст выводится как есть, без подстановки данных
Вместо имени параметра выводится значение, переданное из кода
Текст с вставками параметров в квадратных скобках, например: Покупатель: [Контрагент]
Как создать макет печатной формы в табличном редакторе
Типовой сценарий разработки печатной формы выглядит так. Сначала в конфигураторе у объекта создаётся макет типа «Табличный документ». Платформа предложит конструктор печати, который автоматически построит макет с областями «Шапка», «Строка» и «Подвал» и сгенерирует процедуру вывода. Конструктор удобен как стартовая точка, но макет почти всегда дорабатывается вручную.
Дальше работа идёт в табличном редакторе: выделяются нужные строки, через «Таблица → Имена → Назначить имя» создаётся именованная область, в ячейках прописываются параметры. Затем в модуле менеджера объекта или в общем модуле пишется код, который получает макет, выводит области и заполняет параметры.
Пример программного вывода макета
Визуальный макет оживает через встроенный язык. Минимальный фрагмент вывода печатной формы выглядит следующим образом:
ТабДок = Новый ТабличныйДокумент;
Макет = Документы.РеализацияТоваровУслуг.ПолучитьМакет("Печать");
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьШапка.Параметры.НомерДокумента = Номер;
ОбластьШапка.Параметры.Контрагент = Контрагент;
ТабДок.Вывести(ОбластьШапка);
Для Каждого СтрокаТовара Из Товары Цикл
ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
ОбластьСтрока.Параметры.Заполнить(СтрокаТовара);
ТабДок.Вывести(ОбластьСтрока);
КонецЦикла;
Здесь табличный редактор отвечает за внешний вид, а код — за наполнение. Если в макете параметр назван иначе, чем в коде, значение просто не подставится, и в ячейке останется пусто или выведется имя параметра — это самый частый признак опечатки.
ТабДок.Показать("Печатная форма"); // вывод на экран в табличном редактореЧем табличный редактор отличается от других средств вывода
Табличный документ — не единственный способ представить данные в 1С, и выбор инструмента зависит от задачи. Сравнение основных вариантов:
| Средство | Назначение | Когда выбирать |
|---|---|---|
| Табличный документ (табличный редактор) | Печатные формы, документы с точной вёрсткой | Нужен строгий вид при печати: счета, акты, накладные |
| СКД (система компоновки данных) | Отчёты с гибкими настройками | Пользователь сам меняет группировки, отборы, поля |
| Табличное поле / динамический список | Отображение данных в формах | Интерактивная работа с данными на экране |
| HTML-документ | Произвольная веб-разметка | Нестандартная визуализация, письма, предпросмотр |
Если требуется печатная форма с фиксированной структурой и точным расположением элементов — выбор однозначно за табличным документом и его редактором. Если нужен аналитический отчёт, который пользователь будет перенастраивать, рациональнее СКД, которая впрочем тоже выводит результат в табличный документ.
Макет вручную или конструктор печати
Быстро создаёт макет и готовый код. Подходит для простых форм; сложную вёрстку всё равно придётся править вручную
Полный контроль над областями, параметрами и оформлением. Требует понимания структуры табличного документа
Быстрый старт на базе готовой формы из типовой конфигурации; риск унаследовать лишние области и параметры
Типичные ошибки и ограничения
При работе с табличным редактором разработчики чаще всего сталкиваются с несколькими повторяющимися проблемами. Несовпадение имён параметров в макете и в коде приводит к пустым ячейкам. Попытка получить область по несуществующему имени вызывает ошибку выполнения. Изменение макета в работающей базе без обновления конфигурации даёт ситуацию, когда пользователь видит старую форму.
Из ограничений стоит помнить: табличный документ не предназначен для обработки больших массивов данных как Excel — при выводе десятков тысяч строк формирование замедляется и расходует много памяти. Для тяжёлых выгрузок лучше формировать файл напрямую или разбивать вывод. Также в веб-клиенте часть возможностей редактирования ограничена по сравнению с толстым клиентом.
Как проверить, что макет работает правильно
После разработки печатную форму проверяют на реальных данных разной длины: короткие и длинные наименования контрагентов, пустые необязательные поля, многострочная табличная часть с переносом на следующую страницу. Особое внимание — разрывам страниц и повторению шапки таблицы на каждом листе (свойство «Повторять при печати» у строк макета).
Как проверить результат
Все поля заполнены данными документа, нет имён параметров в квадратных скобках
Видны [Параметр] или пустые ячейки там, где данные есть
Выведены все строки документа, итоги сходятся
Одна строка или пропущенные позиции
Форма помещается на лист, шапка повторяется на каждой странице
Обрезанные колонки, таблица без заголовков со второй страницы
Полезно также проверить сохранение в PDF и Excel: если в Excel объединённые ячейки мешают дальнейшей обработке, имеет смысл предусмотреть отдельный упрощённый макет для выгрузки.
FAQ
Чем табличный документ отличается от макета табличного документа?
Макет — это шаблон, хранящийся в конфигурации: области, параметры, оформление. Табличный документ — результат: объект, который программа заполняет данными по этому шаблону и показывает пользователю. Оба открываются одним и тем же табличным редактором.
Можно ли редактировать сформированную печатную форму перед печатью?
Да, если документ не защищён. В пользовательском режиме содержимое ячеек можно править прямо в табличном редакторе, но эти изменения не сохраняются в базе и не влияют на макет — при следующем формировании форма будет построена заново.
В какие форматы сохраняется табличный документ?
Через «Файл → Сохранить копию» доступны MXL (родной формат 1С), Excel (XLS/XLSX), PDF, HTML, ODS, TXT и некоторые другие. Программно используется метод Записать() с указанием типа файла.
Что делать, если параметр в макете не заполняется?
Сверьте имя параметра в свойствах ячейки макета и в коде — они должны совпадать с точностью до символа. Проверьте, что у ячейки свойство «Заполнение» установлено в «Параметр» или «Шаблон», а не «Текст».
Подходит ли табличный документ для аналитических отчётов?
Технически да, но неудобно: каждую настройку придётся программировать вручную. Для отчётов с пользовательскими отборами и группировками предназначена СКД, которая выводит результат в тот же табличный документ автоматически.
Как изменить печатную форму, не снимая конфигурацию с поддержки?
Используйте расширение конфигурации с добавлением собственного макета и обработчика печати или подключите внешнюю печатную форму через стандартный механизм «Дополнительные отчеты и обработки», если он есть в вашей конфигурации.
Что важно запомнить
Визуальное средство работы с табличными документами в 1С — встроенный табличный редактор платформы. В конфигураторе он служит для разработки макетов с именованными областями и параметрами, в пользовательском режиме — для просмотра, правки, сохранения и печати готовых форм. Данные в макет подставляются программно через параметры, поэтому имена в макете и коде должны совпадать.