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

Другое · 7 мин

Изменение формы в расширении конфигурации 1С

Как правильно изменить форму в расширении 1С: порядок подготовки объекта, правка реквизитов и элементов, публикация, проверка результата и ограничения самостоятельной правки.

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

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

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

Когда правка формы через расширение оправдана

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

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

Подготовка объекта расширения и правила именования

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

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

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

Изменение реквизитов и элементов формы

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

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

Команды, действия и оформление макета

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

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

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

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

Открытие формы пользователем
Норма

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

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

Ошибка при открытии или форма не отображается

Новые реквизиты и элементы
Норма

Отображаются и сохраняют значения

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

Поля пустые или не сохраняются

Команды и обработчики
Норма

Выполняются без прерывания

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

Ошибка выполнения или команда недоступна

Отладка, публикация и проверка результата

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

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

Ограничения, риски и альтернативы

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

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

Типичные ошибки
01
Правка формы в базовой конфигурации вместо расширения — изменения пропадут при обновлении
02
Изменение типа реквизита без проверки элементов формы — ошибка при открытии или записи
03
Публикация расширения без обновления информационной базы — пользователи не увидят правки

Частые ошибки и что делать, если форма не обновилась

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

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

Итог

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

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

Можно ли изменить любую типовую форму через расширение?

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

Нужно ли добавлять форму в состав расширения явно?

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

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

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

Будут ли изменения сохранены после обновления конфигурации?

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