Как добавить колонку в форму списка документа 1С

Форма списка документа — это таблица, в которой пользователь видит реестр документов: номер, дату, контрагента, сумму. Когда нужной колонки не хватает, её можно добавить тремя способами: через настройки самой формы в режиме «Предприятие», через расширение конфигурации или через изменение формы в конфигураторе. Выбор зависит от того, есть ли у вас права разработчика, снята ли конфигурация с поддержки и нужен ли результат всем пользователям или только вам.

Прежде чем менять конфигурацию, убедитесь, что задача не решается штатными средствами. В типовых конфигурациях на управляемых формах многие реквизиты уже добавлены в динамический список, но скрыты настройками — тогда достаточно включить их видимость через «Ещё → Изменить форму». Это быстрее и безопаснее, чем доработка кода.

Если нужная колонка — это реквизит самого документа (например, «Комментарий» или «Ответственный»), её добавление обычно не вызывает сложностей. Сложнее с колонками из связанных объектов: склад из табличной части, договор контрагента, остаток по документу. Такие данные требуют изменения запроса динамического списка и могут замедлить форму.

Способ 1. Добавить колонку через настройки формы без программирования

Этот способ подходит, если конфигурация типовая и дорабатывать её нельзя или нежелательно. Откройте список документов в режиме «Предприятие», нажмите «Ещё» и выберите пункт «Изменить форму». Откроется окно настройки, где в дереве элементов можно отметить галочками скрытые поля — многие реквизиты документа уже присутствуют в составе формы, но не показаны пользователю.

Дополнительно проверьте настройки самого списка: «Ещё → Настроить список». Там задаются отбор, сортировка и условное оформление. Если колонка отображается, но пустая, возможно, дело не в форме, а в отборе или в том, что реквизит не заполнен в документах.

Ограничение способа очевидно: можно показать только то, что уже есть в составе формы и в запросе динамического списка. Новый реквизит, который разработчик не включил в запрос, таким путём не вывести. Также настройки формы сохраняются для конкретного пользователя (или копируются администратором), а не для всей базы автоматически.

1. 1
   Откройте форму списка документа в режиме «Предприятие»
2. 2
   Нажмите «Ещё → Изменить форму»
3. 3
   В дереве элементов найдите нужный реквизит и отметьте его галочкой
4. 4
   Нажмите «ОК» и проверьте, что колонка появилась в таблице
5. 5
   При необходимости перетащите колонку мышью в нужное место

Способ 2. Добавить колонку в конфигураторе

Если нужен реквизит, которого нет в форме, откройте конфигуратор, найдите документ в дереве конфигурации и перейдите в его формы. Обычно форма списка называется «ФормаСписка». Если формы нет (используется автоматически генерируемая), создайте её: правой кнопкой по документу → «Формы» → добавить форму списка.

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

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

ВЫБРАТЬ
	Док.Ссылка,
	Док.Номер,
	Док.Дата,
	Док.Контрагент,
	Док.СуммаДокумента,
	Док.Ответственный
ИЗ
	Документ.РеализацияТоваровУслуг КАК Док

Способ 3. Добавить колонку через расширение конфигурации

Для типовых конфигураций на поддержке правильный путь — расширение. В конфигураторе откройте «Конфигурация → Расширения конфигурации», создайте новое расширение, затем в основной конфигурации найдите форму списка документа и через контекстное меню добавьте её в расширение. Дальше форму редактируют так же, как обычную, но изменения лягут в расширение и не нарушат поддержку.

Плюс расширения — обновления типовой конфигурации будут устанавливаться без снятия с поддержки. Минус — при обновлении типовой формы расширение может «сломаться»: если разработчик типовой решения переименовал элементы или изменил запрос списка, расширение придётся адаптировать. Поэтому после каждого обновления проверяйте формы, доработанные расширениями.

Как вывести колонку с данными из связанных объектов

Частая задача — показать в списке не реквизит шапки, а данные из связанного объекта: договор контрагента, склад из табличной части, статус оплаты. Такие колонки добавляются изменением запроса динамического списка: через точку («Док.Контрагент.ИНН») или через соединение с другой таблицей.

Будьте осторожны с соединениями к табличным частям: если в документе несколько строк товаров, соединение размножит строки списка — один документ появится несколько раз. Это типичная ошибка. Чтобы её избежать, используют вложенный запрос с группировкой или выводят только первое значение через агрегатные функции.

Также учитывайте производительность: сложный запрос с соединениями и виртуальными таблицами (например, остатки по каждому документу) может заметно замедлить открытие и прокрутку списка. Для тяжёлых данных разумнее вывести колонку с расчётом по требованию или использовать дополнительный отчёт вместо списка.

Проверка результата и права пользователей

После доработки обновите конфигурацию базы данных (F7), перезапустите сеанс и откройте форму списка. Проверьте: колонка видна, данные заполнены корректно, сортировка по колонке работает, форма открывается с приемлемой скоростью. Проверяйте на учётных данных, близких к реальным, — на пустой тестовой базе проблемы производительности не видны.

Отдельный момент — права. Если у пользователя нет права просмотра реквизита или связанного объекта (например, нет доступа к справочнику «Договоры»), колонка у него будет пустой или форма выдаст ошибку доступа. Проверьте отображение под профилем обычного пользователя, а не только под администратором.

Частые вопросы