Программное удаление реквизитов формы в 1С: Предприятие 8

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

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

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

Архитектура форм в 1С: Предприятие 8

Чтобы корректно управлять составом элементов, необходимо понимать, как платформа хранит и обрабатывает данные формы. Форма в 1С — это не просто набор полей на экране, а сложный объект метаданных со своим контекстом выполнения.

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

При программном удалении важно различать визуальный элемент (Элемент) и хранилище данных (Реквизит). Удаление одного без другого может привести к ошибкам выполнения или «битым» ссылкам в коде.

Платформа 1С 8.3 предоставляет мощный API для манипуляции этими объектами через объект Форма. Доступ к коллекции реквизитов осуществляется через свойство Реквизиты.

⚠️ Внимание! Удаление реквизита формы программно возможно только на клиенте или в режиме управляемого приложения. В толстом клиенте или старых версиях платформы (до 8.2) механизмы могут отличаться или отсутствовать.

Существует несколько сценариев, когда удаление необходимо. Например, при загрузке динамических списков из внешних источников, когда состав колонок заранее неизвестен.

Также это актуально при создании универсальных обработок, где пользователь сам настраивает вид отчета. В таких случаях жесткая структура формы становится ограничением.

Базовый алгоритм удаления реквизита

Процесс удаления реквизита состоит из нескольких последовательных шагов. Сначала необходимо найти нужный объект в коллекции, а затем вызвать метод удаления.

Основной метод, который используется для этой цели — Удалить() коллекции реквизитов. Он принимает на вход имя удаляемого реквизита в виде строки.

Рассмотрим простейший пример кода, который удаляет реквизит с именем МойРеквизит:

// Получаем доступ к коллекции реквизитов текущей формы
КоллекцияРеквизитов = Форма.Реквизиты;

// Проверяем наличие реквизита перед удалением
Если КоллекцияРеквизитов.Найти("МойРеквизит") <> Неопределено Тогда
КоллекцияРеквизитов.Удалить("МойРеквизит");
КонецЕсли;

Платформа может выдать предупреждение или игнорировать этот элемент при отрисовке.

Поэтому лучшей практикой считается сначала удалять визуальные элементы, привязанные к реквизиту, и только потом сам реквизит.

Для удаления элементов используется коллекция Элементы. Метод аналогичен: Элементы.Удалить("ИмяЭлемента").

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

Всегда проверяйте тип удаляемого объекта. Реквизиты могут быть простыми типами, ссылками или структурами.

Работа с динамическими списками и таблицами

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

Реквизиты такого списка часто создаются автоматически на основе полей запроса. Однако иногда требуется исключить лишние поля программно после формирования списка.

Для работы с колонками таблицы, отображающей список, используется объект Колонки. Удаление колонки из визуальной таблицы не удаляет данные из списка, но скрывает их от пользователя.

Объект	Метод удаления	Возвращаемое значение	Особенности
Форма.Реквизиты	Удалить(Имя)	Нет	Удаляет данные из памяти формы
Форма.Элементы	Удалить(Имя)	Нет	Удаляет визуальный контроль
Список.Колонки	Удалить(Имя)	Нет	Скрывает колонку в таблице
ТабличныйДокумент	УдалитьОбласть()	Нет	Требует координат области

При удалении колонок из ДинамическийСписок важно учитывать, что некоторые поля могут быть обязательными для работы механизмов выбора или редактирования.

Например, удаление поля Ссылка или Представление может нарушить функциональность стандартных кнопок панели списка.

Если вы формируете список вручную через Запрос и заполняете ТаблицуЗначений, то управление колонками осуществляется через объект Колонки таблицы значений.

Нюанс удаления системных полей

Системные поля, такие как "Выбран", "Пометка" или "Уровень", удалять не рекомендуется. Это может привести к непредсказуемому поведению стандартных обработчиков событий дерева или списка.

В некоторых случаях проще не удалять лишние поля, а изначально не включать их в запрос. Оптимизация запроса на уровне выборки полей всегда предпочтительнее программной чистки.

Однако, если состав полей зависит от внешних условий, которые известны только в момент открытия формы, программное удаление остается единственным вариантом.

Удаление реквизитов в расширениях конфигурации

Разработка с использованием расширений накладывает дополнительные ограничения на модификацию форм. Прямое изменение конфигурации в режиме предприятия запрещено.

Тем не менее, расширения позволяют добавлять новые реквизиты и элементы, а также управлять их видимостью. Удаление реквизитов, добавленных самим расширением, проходит штатно.

Сложнее обстоят дела с реквизитами основной конфигурации. Вы не можете удалить «родной» реквизит формы, созданный в базовой конфигурации.

Вместо удаления в таких случаях применяется метод сокрытия. Свойство Видимость элемента управления устанавливается в Ложь.

// Пример сокрытия элемента в расширении
ЭлементФормы = Форма.Элементы.Найти("РеквизитИзБазы");
Если ЭлементФормы <> Неопределено Тогда
ЭлементФормы.Видимость = Ложь;
КонецЕсли;

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

Если же речь идет о реквизитах, добавленных расширением, которые больше не нужны, их можно удалить через Форма.Реквизиты.Удалить().

⚠️ Внимание! При обновлении основной конфигурации структура форм может измениться. Код расширения, удаляющий реквизиты по жестким именам, может перестать работать, если разработчик базы изменит имя поля.

Используйте обработку исключений при попытке удаления, чтобы ваше расширение не «падало» с ошибкой при изменении структуры основной формы.

Всегда оборачивайте критические участки кода в конструкцию Попытка.. Исключение.

Очистка временных данных и оптимизация памяти

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

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

После удаления ненужных полей рекомендуется вызвать метод Очистить() для значений, если они хранят тяжелые объекты.

Однако, сам факт удаления реквизита из коллекции Реквизиты разрывает связь между именем и значением.

Значение, хранившееся в удаленном реквизите, становится недоступным для кода формы. Ссылка на объект теряется, и в следующий цикл сборки мусора память будет освобождена.

Не стоит злоупотреблять созданием и удалением реквизитов в циклах. Это дорогостоящая операция для платформы.

Лучше создать структуру один раз, наполнить её, а затем отфильтровать ненужное, чем генерировать и удалять поля динамически при каждом действии пользователя.

Обработка ошибок и отладка

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

Если код формы пытается прочитать значение Объект.МойРеквизит после того, как реквизит был удален, система выдаст ошибку «Свойство объекта не найдено».

Для отладки таких ситуаций удобно использовать панель «Отладка» в режиме предприятия. Она позволяет просматривать текущий состав реквизитов формы в реальном времени.

Также полезно выводить состав доступных реквизитов в журнал регистрации или консоль отладки перед удалением.

// Вывод списка реквизитов для отладки
Для каждого Реквизит Из Форма.Реквизиты Цикл
Сообщить(Реквизит.Имя);
КонецЦикла;

Такой лог поможет понять, какие поля реально существуют в момент выполнения кода, а какие уже были удалены или не были созданы.

Помните, что имена реквизитов чувствительны к регистру в некоторых контекстах, хотя платформа 1С обычно нормализует их. Лучше использовать точное совпадение имен.

⚠️ Внимание! Интерфейс и возможности API могут незначительно отличаться в разных версиях платформы 1С. Всегда проверяйте синтаксис-помощник (F1) для вашей конкретной версии платформы.

Если вы используете внешние обработки или отчеты, убедитесь, что версия платформы на компьютере пользователя соответствует версии, на которой разрабатывался код.

Несовместимость версий может привести к тому, что новые методы удаления будут недоступны в старых релизах.

Секрет быстрой отладки

Используйте комбинацию Ctrl+Shift+F9 для сброса кэша форм. Это поможет избежать ситуаций, когда форма сохраняется в кэше со старой структурой реквизитов.

Часто задаваемые вопросы (FAQ)

Можно ли удалить реквизит формы, созданный в конфигураторе?

Нет, реквизиты, созданные на уровне метаданных в конфигураторе, являются неизменяемой частью структуры формы. Их можно только скрыть (свойство Видимость), но не удалить программно из коллекции Реквизиты. Удалению подлежат только динамически созданные реквизиты.

Что будет, если удалить реквизит, к которому привязано поле ввода?

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

Как удалить все реквизиты формы, кроме одного?

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

Влияет ли удаление реквизитов на производительность формы?

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

Можно ли восстановить удаленный реквизит?

Нет, после вызова метода Удалить() данные и структура реквизита уничтожаются. Для восстановления потребуется заново создать реквизит через метод Добавить() и присвоить ему значение.