К статье
Практический материал

Другое · 7 мин

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

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

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

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

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

Что считать реквизитом формы, а что элементом формы

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

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

Когда удаление возможно, а когда требуется конфигуратор

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

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

Порядок действий
  1. 1
    Определите имя реквизита и связанного элемента формы
  2. 2
    Проверьте ссылки на реквизит в модулях, выражениях и командах
  3. 3
    Удалите элемент формы или скройте его, очистите значение при необходимости
  4. 4
    Обновите конфигурацию и проверьте форму в пользовательском режиме

Порядок действий при скрытии или удалении элемента формы

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

Для управляемой формы типичная последовательность выглядит так: открыть форму в конструкторе или модуле, найти элемент в коллекции Элементы, при необходимости сохранить значение реквизита, удалить элемент или установить ему свойство Видимость в значение Ложь. Если нужно очистить данные, присвойте реквизиту значение Неопределено или пустое значение в зависимости от типа.

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

Проверка результата и границы безопасной работы

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

Типичные ошибки
01
Удаление реквизита без проверки ссылок в модулях и отчётах
02
Путаница между удалением элемента формы и удалением реквизита

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

Типичные ошибки и альтернативы удалению

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

Контрольные точки

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

Открытие формы
Норма

Форма открывается без ошибок

Тревожный признак

Сообщение о несуществующем реквизите

Работа документов
Норма

Проведение и сохранение проходят

Тревожный признак

Ошибки при проведении или сохранении

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

Как проверить, что форма работает после изменений

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

Сравнение вариантов

Скрыть элемент формы

Подходит для временного исключения из интерфейса, реквизит остаётся в данных

Очистить значение

Подходит для сброса данных, структура формы не меняется

Удалить в конфигураторе

Подходит при полном отказе от реквизита, требует обновления базы

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

Сравнение вариантов Actions

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

Итог

Что важно запомнить

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

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

Можно ли удалить реквизит формы из модуля формы во время работы базы?

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

В чём разница между реквизитом формы и элементом формы?

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

Что делать, если реквизит используется в СКД или командах формы?

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

Как понять, что удаление не повредило базу?

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