Как скрыть строки в табличной части 1С

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

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

Ниже разобраны рабочие способы для управляемых форм (1С 8.3, тонкий и веб-клиент) и обычных форм (8.2 и ранние конфигурации), а также вариант для динамических списков и типичные ошибки, из-за которых отбор «не срабатывает».

Какой способ выбрать: отбор, оформление или отдельная таблица

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

Частая ошибка — пытаться скрыть строки через видимость колонок или через свойства элемента формы. Видимость управляет колонками целиком, а не отдельными строками, и для фильтрации данных не предназначена.

Скрытие строк через ОтборСтрок в управляемой форме

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

Пример: в документе «Реализация товаров и услуг» нужно показать только строки с конкретным складом. Код размещается в модуле формы, например в обработчике команды или при изменении реквизита-фильтра.

&НаКлиенте
Процедура ПоказатьТолькоСклад(Команда)
    Отбор = Новый ФиксированноеСоответствие(
        Новый Соответствие);
    Соответствие = Новый Соответствие;
    Соответствие.Вставить("Склад", ВыбранныйСклад);
    Элементы.Товары.ОтборСтрок = Новый ФиксированноеСоответствие(Соответствие);
КонецПроцедуры

Чтобы снять отбор и показать все строки, достаточно присвоить свойству Неопределено:

Элементы.Товары.ОтборСтрок = Неопределено;

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

Отбор по нескольким условиям и его ограничения

Фиксированное соответствие поддерживает несколько ключей — условия объединяются по «И». Например, показать строки с конкретным складом и конкретным видом номенклатуры:

Соответствие = Новый Соответствие;
Соответствие.Вставить("Склад", ВыбранныйСклад);
Соответствие.Вставить("ВидНоменклатуры", ВидТовара);
Элементы.Товары.ОтборСтрок = Новый ФиксированноеСоответствие(Соответствие);

Главное ограничение: фиксированный отбор умеет сравнивать только на равенство. Условия «не равно», «больше», «в списке», «содержит подстроку» таким способом задать нельзя. Для них есть обходные пути:

• добавить в табличную часть служебный реквизит-флаг (например, «Скрытая»), вычислять его при изменении строк и фильтровать по нему;
• вывести данные в отдельную таблицу значений на форме и заполнять её программно по любому условию;
• если таблица построена на динамическом списке — использовать полноценный отбор динамического списка с произвольными видами сравнения.

Скрытие строк в обычных формах (обычное приложение)

В обычных формах механика похожая, но отбор задаётся у данных табличной части или у табличного поля. У табличной части объекта есть свойство ОтборСтрок, доступное на сервере и на клиенте в толстом клиенте:

// Обычная форма, модуль формы
ЭлементыФормы.Товары.ОтборСтрок.Склад.Установить(ВыбранныйСклад);
// Снятие отбора:
ЭлементыФормы.Товары.ОтборСтрок.Сбросить();

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

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

Альтернатива: отдельная таблица значений на форме

Когда условие фильтрации сложное или строки нужно показывать из нескольких источников, удобнее не трогать табличную часть объекта, а создать реквизит формы типа «ТаблицаЗначений» и вывести его на форму. В эту таблицу программно копируются только нужные строки.

1. 1
   Добавьте реквизит формы типа «ТаблицаЗначений» с колонками, повторяющими нужные поля табличной части
2. 2
   Перетащите реквизит в дерево элементов формы — появится таблица
3. 3
   В серверной процедуре переберите табличную часть объекта и скопируйте в новую таблицу только строки, удовлетворяющие условию
4. 4
   При необходимости редактирования реализуйте обратную синхронизацию: перенос изменённых строк обратно в табличную часть объекта
5. 5
   Протестируйте запись и проведение документа, убедившись, что скрытые строки не потеряны

Этот способ требует больше кода, особенно если строки должны редактироваться: придётся синхронизировать изменения в обе стороны и не потерять скрытые строки при записи. Зато он даёт полный контроль над составом отображаемых данных и позволяет строить произвольные условия, включая запросы к базе.

Упрощённый вариант без редактирования — заполнение таблицы запросом:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ Товары.Номенклатура, Товары.Количество
|ИЗ Документ.РеализацияТоваровУслуг.Товары КАК Товары
|ГДЕ Товары.Ссылка = &Ссылка И Товары.Количество > 0";
Запрос.УстановитьПараметр("Ссылка", Объект.Ссылка);
ТаблицаОтбора.Загрузить(Запрос.Выполнить().Выгрузить());

Условное оформление и динамические списки

Если цель — не скрыть строки, а сделать часть из них невзрачными (отменённые, архивные, с нулевым количеством), используйте условное оформление формы. Оно настраивается в конфигураторе на закладке «Условное оформление» формы или программно через УсловноеОформление.Элементы. Можно менять цвет текста, шрифт (например, зачёркнутый), доступность и видимость отдельных полей строки.

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

Если таблица на форме построена на динамическом списке (основной реквизит — «ДинамическийСписок»), фильтрация делается через его отбор: Список.Отбор.Элементы либо параметры произвольного запроса. Динамический список поддерживает все виды сравнения, группы условий «И/ИЛИ» и отбор по периоду — это самый гибкий вариант, но он применим только к спискам, а не к табличным частям объекта напрямую.

Проверка результата и типичные ошибки

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

Ещё одна тонкость: имена в соответствии для отбора должны точно совпадать с именами колонок данных таблицы формы, а не с заголовками на форме. Если колонка переименована в конфигураторе, старый код отбора молча перестанет работать.

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