Разработка и Конфигурация · 12 мин
Как вывести поле «Комментарий» в списке документов в 1С
Как вывести колонку «Комментарий» в списке документов 1С: настройка списка в режиме предприятия, изменение формы в конфигураторе, динамический список и типичные ошибки.
Колонка «Комментарий» в списке документов помогает быстро находить нужные проводки, не открывая каждый документ: пользователи часто пишут туда номера счетов контрагентов, причины корректировки или пояснения для бухгалтерии. По умолчанию во многих типовых конфигурациях эта колонка в форме списка отсутствует, и её приходится добавлять вручную.
Есть два принципиально разных способа решить задачу. Первый — настройка формы списка в режиме «Предприятие» через меню «Ещё → Изменить форму», который доступен рядовому пользователю без прав администратора и не требует изменения конфигурации. Второй — доработка формы списка в конфигураторе, когда колонка должна появиться у всех пользователей сразу или требуется вывод через запрос динамического списка.
Выбор способа зависит от того, нужна ли колонка только вам или всем сотрудникам, есть ли у вас доступ к конфигуратору и стоит ли конфигурация на поддержке. Ниже разобраны оба сценария с проверкой результата и типичными ошибками.
Определите, какой у вас список и кому нужна колонка
Перед изменениями важно понять, с какой формой списка вы работаете. В управляемых формах (интерфейс «Такси») список документов почти всегда представляет собой динамический список с автоматически сформированным запросом. В таком случае реквизит «Комментарий» доступен для вывода без доработок, потому что он входит в основную таблицу документа.
Если разработчик конфигурации переопределил запрос динамического списка вручную (произвольный запрос), поле «Комментарий» может отсутствовать в выборке, и тогда простой настройкой формы его не вывести — понадобится правка текста запроса. Признак произвольного запроса: в конфигураторе у динамического списка установлен флаг «Произвольный запрос».
Также решите, кому нужна колонка. Настройка через «Изменить форму» сохраняется персонально для текущего пользователя (или для всех — если у вас есть право сохранения настроек для всех пользователей). Доработка в конфигураторе делает колонку видимой для всех без исключения, но требует обновления конфигурации базы данных.
Как выбрать действие
Способ 1: вывести колонку через «Изменить форму» без конфигуратора
Откройте список документов нужного вида, например «Покупки → Поступления (акты, накладные, УПД)» или журнал «Реализация (акты, накладные, УПД)». В правом верхнем углу формы нажмите кнопку «Ещё» и выберите пункт «Изменить форму». Откроется окно настройки с деревом элементов формы.
В дереве элементов найдите таблицу списка — обычно она называется «Список». Раскройте её и пролистайте перечень полей: найдите строку «Комментарий». Установите напротив неё флажок видимости и нажмите «ОК» или «Применить». Колонка появится в конце таблицы списка.
Если колонка оказалась в неудобном месте, перетащите её заголовок мышью в нужную позицию прямо в списке или измените порядок элементов в том же окне настройки формы. Ширину колонки можно отрегулировать обычным перетаскиванием границы заголовка.
- 1Откройте список документов нужного вида
- 2Нажмите «Ещё» → «Изменить форму»
- 3В дереве элементов раскройте таблицу «Список»
- 4Найдите поле «Комментарий» и включите флажок видимости
- 5Нажмите «ОК» и проверьте, что колонка появилась
- 6Перетащите колонку в удобное место и настройте ширину
Обратите внимание: если у вас есть право «Сохранение настроек для всех пользователей» (обычно у администратора), в окне настройки формы будет доступен вариант сохранения настройки для всех. Тогда колонка появится у коллег без доработки конфигурации — это самый безболезненный способ массового включения.
Способ 2: добавить колонку в конфигураторе
Откройте конфигуратор, найдите нужный вид документа в дереве конфигурации (ветка «Документы»), раскройте его и перейдите в подчинённый объект «Формы». Обычно форма списка называется «ФормаСписка». Если её нет, платформа генерирует форму автоматически — тогда создайте новую форму списка через кнопку добавления, указав тип «ФормаСписка».
В редакторе формы раскройте дерево элементов, найдите таблицу «Список» и добавьте в неё новый элемент: правый клик по «Список» → «Добавить» → «Поле формы». В свойствах нового элемента укажите путь к данным — «Список.Комментарий». Платформа автоматически создаст колонку с заголовком «Комментарий».
Перетащите элемент в нужную позицию среди других колонок. После сохранения выполните обновление конфигурации базы данных (клавиша F7 или меню «Конфигурация → Обновить конфигурацию базы данных»). После перезапуска сеансов пользователи увидят новую колонку.
Если список построен на произвольном запросе
Когда у динамического списка включён флаг «Произвольный запрос», набор доступных полей определяется текстом запроса, а не структурой таблицы документа. В этом случае реквизит «Комментарий» нужно явно добавить в выборку запроса, иначе его не будет ни в настройке формы, ни в конфигураторе среди доступных полей.
Откройте в конфигураторе форму списка, выделите реквизит «Список» и в палитре свойств нажмите кнопку открытия настройки динамического списка. В тексте запроса добавьте поле из таблицы документа. Типовой фрагмент выглядит так:
ВЫБРАТЬ
РеализацияТоваровУслуг.Ссылка,
РеализацияТоваровУслуг.Дата,
РеализацияТоваровУслуг.Номер,
РеализацияТоваровУслуг.Контрагент,
РеализацияТоваровУслуг.Комментарий
ИЗ
Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг
После добавления поля в запрос оно станет доступно и для вывода колонкой, и для отбора, и для сортировки. Учтите ограничение: в динамических списках с произвольным запросом поле, по которому выполняется основная сортировка и которое задано как ключевое, должно присутствовать обязательно, иначе список будет работать некорректно.
Если документы выводятся в журнале документов нескольких видов (например, общий журнал «Складские документы»), убедитесь, что реквизит «Комментарий» включён в состав граф журнала — иначе для части видов документов колонка будет пустой.
Проверка результата и производительность
После добавления колонки проверьте три вещи. Во-первых, откройте список и убедитесь, что для документов с заполненным комментарием текст отображается. Во-вторых, попробуйте отсортировать список по новой колонке и выполнить поиск по ней — сортировка и поиск должны работать без ошибок. В-третьих, проверьте отображение у другого пользователя, если настройка делалась для всех.
Длинные комментарии могут визуально «раздвигать» таблицу. Ограничьте ширину колонки в свойствах элемента формы или просто сузьте её в списке — текст обрежется, но полное значение будет видно во всплывающей подсказке или при открытии документа.
На производительность списка одно дополнительное строковое поле из основной таблицы документа влияет незначительно. Замедление возможно только если комментарий выводится через соединение с другой таблицей в произвольном запросе — такой запрос стоит проверить на больших объёмах данных.
Как проверить результат
Колонка «Комментарий» видна, текст документов с заполненным комментарием показывается
Колонка есть, но пустая у всех документов — проверьте запрос или графы журнала
Список сортируется по колонке, поиск по комментарию находит документы
Ошибка при сортировке — поле не входит в выборку динамического списка
Колонка видна всем, кому предназначалась
Видна только вам — настройка сохранена персонально, нужен конфигуратор или сохранение для всех
Типичные ошибки и ограничения
Самая частая ситуация: пользователь ищет «Комментарий» в окне «Изменить форму» и не находит. Причина почти всегда в произвольном запросе динамического списка, где поле не выбрано, либо в том, что реквизит ищется не в той ветке дерева — поле может находиться внутри группы колонок или быть скрытым элементом с отключенной видимостью.
Вторая ошибка — ожидание, что настройка распространится на всех автоматически. Персональные настройки формы хранятся в разрезе пользователя, и коллеги колонку не увидят. Также персональные настройки сбрасываются при изменении формы разработчиком: после обновления конфигурации колонка может снова пропасть, и её придётся включать заново.
Наконец, помните об ограничении журналов документов: если документ входит в журнал, а реквизит «Комментарий» не добавлен в графы журнала, в списке журнала колонка будет пустой. Состав граф настраивается в конфигураторе в свойствах журнала, вкладка «Графы».
Альтернативы: расширение конфигурации и настройка списка
Если колонка нужна всем пользователям, но трогать типовую конфигурацию нельзя, используйте расширение конфигурации. В конфигураторе создайте расширение (меню «Конфигурация → Расширения конфигурации»), добавьте в него заимствованную форму списка нужного документа и добавьте колонку «Комментарий» уже в расширении. Такой подход не снимает конфигурацию с поддержки и переживает обновления в большинстве случаев.
Ещё одна альтернатива без доработок — использовать настройку списка («Ещё → Настроить список») с отбором по комментарию: колонка не появится, но можно быстро отфильтровать документы по фрагменту текста. Это удобно, когда комментарий нужен не для обзора, а для поиска конкретных документов.
Сравнение вариантов
Быстро и безопасно, но настройка персональная и сбрасывается при изменении формы разработчиком
Колонка у всех пользователей, но объект снимается с полной поддержки типовой конфигурации
Колонка у всех, поддержка сохраняется; требует навыков работы с расширениями и проверки после обновлений
Без изменения формы вообще, но подходит только для поиска, а не для постоянного отображения
Часто задаваемые вопросы
Почему в окне «Изменить форму» нет поля «Комментарий»?
Скорее всего, список построен на произвольном запросе динамического списка, и поле Комментарий в него не включено. Проверить это может специалист с доступом к конфигуратору: у реквизита «Список» в свойствах будет установлен флаг «Произвольный запрос». Решение — добавить поле в текст запроса.
Как сделать колонку «Комментарий» видимой для всех пользователей без конфигуратора?
Если у вашей учётной записи есть соответствующее право, при сохранении настройки формы предлагается вариант «для всех пользователей». В типовых конфигурациях это право обычно есть у администратора. Настройка сохранится централизованно, но может быть перезаписана при обновлении формы разработчиком.
Колонка появилась, но пустая, хотя комментарии в документах заполнены. В чём причина?
Чаще всего документ выводится через журнал документов, в графы которого реквизит «Комментарий» не включён. Откройте свойства журнала в конфигураторе и добавьте реквизит на вкладке «Графы». Вторая возможная причина — в произвольном запросе выбрано поле с другим именем или из другой таблицы.
Пропадёт ли настройка колонки после обновления конфигурации?
Персональная настройка формы может сброситься, если при обновлении изменилась структура формы списка. Доработка в расширении обычно сохраняется, но после обновления стоит проверить форму: если поставщик сильно изменил заимствованную форму, расширение может потребовать корректировки.
Можно ли вывести комментарий в список, если документов много и список тормозит?
Да, само поле из основной таблицы документа практически не влияет на скорость. Если список уже работает медленно, причина обычно в другом: сложные отборы, соединения в произвольном запросе или большой объём данных. Добавление колонки «Комментарий» ситуацию не ухудшит.
Можно ли по комментарию искать документы, не выводя колонку?
Да. Используйте «Ещё → Настроить список» и добавьте отбор по полю «Комментарий» с видом сравнения «Содержит». Также во многих списках работает строка поиска, которая ищет по видимым и служебным полям — состав полей поиска можно расширить в настройках динамического списка.
Что важно запомнить
Для личного использования достаточно включить видимость поля «Комментарий» через «Ещё → Изменить форму». Для всех пользователей безопаснее всего расширение конфигурации, а при произвольном запросе динамического списка поле сначала добавляют в текст запроса. Перед любыми изменениями в конфигураторе сделайте резервную копию базы.