Другое · 9 мин
Как добавить колонку в макет 1С
Как добавить колонку в макет 1С: настройка компоновки данных и табличного документа, проверка результата, ограничения и типичные ошибки.
В макетах 1С колонкой может называться как поле набора данных в отчёте на компоновке данных, так и столбец печатной формы или табличного документа. Способ добавления зависит от типа макета и от того, где именно отображается информация: в настройках отчёта, в программе вывода или в конфигурации объекта.
Перед правкой стоит уточнить, редактируется ли типовой макет или собственная доработка. Изменения в типовых объектах могут быть перезаписаны при обновлении конфигурации, поэтому безопаснее работать в расширении или в собственной копии макета.
Ниже описан порядок действий для самых частых случаев, способы проверить результат и признаки, при которых лучше остановиться и обратиться к разработчику.
Что понимать под колонкой в макете 1С
В терминологии 1С «макет» может относиться к макету отчёта, макету печатной формы или макету табличного документа. Колонка в отчёте на компоновке данных обычно соответствует полю набора данных, ресурсу или параметру, который попадает в итоговый результат. В печатной форме колонкой называют вертикальный столбец таблицы, выводимый на лист.
Если речь идёт о типовом отчёте конфигурации, добавление колонки часто сводится к включению уже существующего поля в настройки компоновки данных, а не к созданию нового поля в базе. Когда нужного поля нет, его приходится добавлять в объект конфигурации, в запрос набора данных или в программу формирования макета.
Важно различать внешнее оформление и источник данных. Просто расширить таблицу визуально недостаточно: колонка должна получать значения из какого-либо набора, иначе в ячейках будет пустота или ошибка при выводе.
Когда колонку добавляют через настройку компоновки данных
Для отчётов, построенных на компоновке данных, порядок действий обычно начинается с открытия настройки отчёта в конфигураторе или в интерфейсе пользователя, если права позволяют. В настройке компоновки данных выбирают набор данных, добавляют недостающее поле в список полей или ресурсы, затем размещают его в нужной области макета — строке, колонке или ячейке.
Если поле отсутствует в наборе данных, его нужно добавить в запрос, который лежит в основе набора. В запросе указывают таблицу, поле и псевдоним, после чего поле становится доступным для выбора в настройках компоновки. Без этого шага колонку некуда будет взять даже при правильной настройке макета.
- 1Определите тип макета и источник данных
- 2Добавьте поле в набор данных или запрос при необходимости
- 3Разместите колонку в настройке макета или программно
- 4Проверьте отчёт в режиме предприятия
- 5Убедитесь, что данные отображаются корректно у всех пользователей
После добавления поля в набор и макете отчёт сохраняют и запускают в режиме предприятия. Если колонка появилась с корректными значениями, настройка выполнена верно. Если колонка пустая или отчёт не открывается, причина может быть в отсутствии данных в источнике или в ошибке запроса.
Как добавить колонку в макет табличного документа
Табличный документ в 1С формируется программно или с помощью макета печатной формы. Чтобы добавить колонку в макет табличного документа, открывают макет в конфигураторе, вставляют новую колонку в таблицу и настраивают её ширину, выравнивание и формат значений. Затем в программе, которая заполняет таблицу, указывают, какое значение выводить в эту колонку для каждой строки.
Сравнение вариантов
Подходит для стандартных отчётов, когда нужное поле уже есть в базе. Ограничение — нельзя добавить поле, которого нет в наборе данных.
Позволяет добавить любое поле из базы. Требует знания языка запросов и понимания структуры объектов.
Подходит для сложной логики и нестандартных макетов. Требует поддержки кода при обновлениях.
Если таблица заполняется циклом по выборке, в теле цикла добавляют запись значения в новую колонку текущей строки. Пропуск этого шага приводит к тому, что колонка визуально присутствует, но остаётся пустой. Также нужно проверить, что новая колонка не выходит за границы листа при печати.
При работе с макетом печатной формы колонку можно добавить через конструктор макета, связав ячейку с параметром или ресурсом. После этого в процедуре печати значение параметра передаётся в ячейку, и колонка заполняется при формировании документа.
Через конфигуратор
В конфигураторе откройте нужный макет отчёта или печатной формы. Для компоновки данных перейдите в настройки набора данных, добавьте поле в запрос или выберите существующее из справочника, документа или регистра. Затем в настройке макета разместите это поле в требуемой области и сохраните изменения.
Для табличного документа используйте редактор таблиц: вставьте колонку, задайте её свойства и привяжите к источнику данных. Сохраните конфигурацию и обновите базу, чтобы изменения стали доступны пользователям.
Программно в процедуре вывода
Если макет формируется в коде, новую колонку добавляют в процедуре, которая выводит таблицу. Создают колонку в табличном документе, задают её заголовок и в цикле заполнения записывают значения из выборки. Примерная логика: создать колонку, пройти по строкам, записать значение в ячейку на пересечении строки и новой колонки.
Программный способ подходит, когда логика заполнения зависит от условий, которых нет в стандартных настройках компоновки. Однако такой код сложнее поддерживать при обновлениях, поэтому его лучше выносить в отдельные процедуры и документировать.
Проверка результата после добавления колонки
После любых изменений открывают отчёт или печатную форму в режиме предприятия и проверяют, появилась ли колонка на ожидаемом месте. Проверяют не только наличие заголовка, но и заполнение ячеек данными. Если колонка пустая, проверяют источник данных и права доступа к таблицам, из которых берутся значения.
Также проверяют печатную форму: колонка не должна обрезаться на границе листа, наезжать на соседние столбцы или ломать верстку при выводе на печать. При необходимости подгоняют ширину колонки и настройки переноса текста.
Признак успешного добавления — колонка отображается у всех пользователей с нужными правами, данные соответствуют источникам, а отчёт не выдаёт ошибок при открытии и формировании.
Как проверить результат
Заголовок и значения видны у пользователей с правами
Колонка отсутствует или отчёт не открывается
Данные соответствуют источнику
Ячейки пустые или содержат некорректные значения
Колонка не обрезается и не ломает верстку
Текст наезжает на соседние столбцы или уходит за край листа
Ограничения и риски самостоятельных изменений
Изменения в типовых макетах конфигурации могут быть потеряны при обновлении или поддержке релиза. Поэтому правку рекомендуют выполнять в расширении конфигурации, в собственной копии макета или через механизм доработок, предусмотренный в конфигурации. Прямое редактирование типового объекта без понимания последствий небезопасно.
Некоторые макеты защищены или формируются в закрытых модулях, где добавить колонку без изменения кода разработчика невозможно. В таких случаях самостоятельная правка может привести к блокировке объекта, ошибкам компиляции или некорректной работе отчёта.
Если изменения затрагивают финансовые, налоговые или кадровые отчёты, ошибка в новой колонке может привести к неверным данным в документах. Перед вводом в эксплуатацию такие отчёты обязательно проверяют на тестовой базе и согласовывают с ответственными специалистами.
Типичные ошибки и как их избежать
Одна из частых ошибок — добавить колонку только визуально, не связав её с источником данных. В итоге пользователь видит пустой столбец и думает, что данные не загрузились, хотя проблема в отсутствии привязки к полю или ресурсу.
Другая ошибка — правка макета в рабочей базе без резервной копии. Если в процессе редактирования конфигурация повреждена или объект заблокирован, восстановить работоспособность может быть сложно. Перед изменениями рекомендуют сделать копию базы или поработать в отдельной тестовой среде.
Ещё одна проблема — игнорирование прав доступа. Новая колонка может открываться не у всех пользователей, если к базовой таблице есть ограничения. Тогда колонка будет видна, но данные в ней будут недоступны части сотрудников.
Сравнение способов добавления колонки
Что важно запомнить
Колонку в макете 1С добавляют в зависимости от типа макета: через набор данных, запрос или программу вывода. Результат проверяют в режиме предприятия, а типовой макет править лучше в расширении или копии.
Часто задаваемые вопросы
Можно ли добавить колонку в типовой отчёт без программирования?
Если нужное поле уже есть в наборе данных, колонку часто можно добавить через настройку компоновки данных без кода. Если поля нет, потребуется изменить запрос или объект конфигурации, что уже требует работы разработчика.
Что делать, если после добавления колонка пустая?
Проверьте, включено ли поле в набор данных и заполняется ли оно в запросе. Убедитесь, что в программе вывода значение записывается в ячейку новой колонки. Также проверьте права доступа к исходным таблицам.
Потерятся ли изменения при обновлении 1С?
Изменения в типовых объектах могут быть перезаписаны при обновлении конфигурации. Чтобы сохранить доработку, правку рекомендуют выполнять в расширении или в собственной копии макета.
Нужно ли проверять новую колонку перед использованием?
Да. Проверьте отображение колонки, заполнение ячеек, корректность данных и печатную форму. Для регламентированных отчётов проверку проводят на тестовой базе с участием ответственных специалистов.