Изменение формы справочника в 1С: 5 способов + примеры кода

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

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

Материал будет полезен как начинающим программистам 1С, так и опытным специалистам, которые хотят систематизировать свои знания. Все примеры кода протестированы на актуальных релизах платформы (по состоянию на 2026 год) и адаптированы под современные стандарты разработки.

1. Подготовка к изменению формы: что нужно знать до начала работы

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

Во-первых, обязательно создайте резервную копию информационной базы. Это можно сделать через конфигуратор (Администрирование → Выгрузить информационную базу) или с помощью внешних инструментов вроде 1C:Enterprise Development Tools. Особенно актуально это для облачных версий, где откат изменений затруднён.

Во-вторых, определите тип формы, с которой будете работать:

• 📋 Управляемая форма — современный подход (рекомендуется для новых разработок)
• 🖥️ Обычная форма — устаревающая технология, но ещё встречается в legacy-системах
• 🔄 Форма списка/выбора — требует отдельного подхода при модификации

Тип формы можно узнать в дереве метаданных конфигуратора (правая кнопка на справочнике → Формы).

В-третьих, проверьте права доступа. Для изменения форм требуются права Конфигуратор или Администратор. В корпоративных системах эти права часто ограничены — уточните их у ИТ-отдела.

⚠️ Внимание: Если вы работаете с типовыми конфигурациями (1С:Бухгалтерия, 1С:ЗУП, 1С:ERP), модификация форм может привести к конфликтам при автоматических обновлениях. В таких случаях лучше использовать расширения конфигурации или внешние обработки.

2. Способ 1: Редактирование формы в режиме конфигуратора (без программирования)

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

Алгоритм действий:

1. Откройте конфигуратор и найдите нужный справочник в дереве метаданных.
2. Раскройте ветку Формы и выберите форму для редактирования (обычно это ФормаЭлемента или ФормаСписка).
3. Дважды кликните на форму — откроется визуальный редактор.
4. Используйте панель инструментов для добавления новых элементов (Поле ввода, Кнопка, Табличное поле и др.).
5. Настройте свойства элементов в правой панели (например, Имя, Заголовок, Данные).
6. Сохраните изменения (Файл → Сохранить) и обновите конфигурацию базы данных.

Пример добавления нового поля:

• 🔹 Перетащите элемент Поле ввода на форму.
• 🔹 В свойствах укажите Имя (например, НовоеПоле) и Данные (связь с реквизитом справочника).
• 🔹 Настройте Заголовок (отображаемое имя) и Тип значения (строка, число, дата и т.д.).

Создана резервная копия базы|

Проверены права доступа|

Определён тип формы (управляемая/обычная)|

Выбран правильный справочник в дереве метаданных-->

Этот метод имеет ограничения:

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

Для сложных модификаций потребуется программирование.

3. Способ 2: Программное изменение формы через модуль объекта

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

Рассмотрим типичные задачи, решаемые через код:

• 🔧 Динамическое заполнение полей (например, подстановка значения из другого справочника).
• 🔧 Условное отображение элементов (скрытие/показ полей в зависимости от условий).
• 🔧 Валидация данных перед сохранением.
• 🔧 Интеграция с внешними системами (выгрузка/загрузка данных).

Пример кода для динамического изменения заголовка формы в зависимости от статуса элемента:

Процедура ПриОткрытии(Отказ)
Если Объект.Статус = Перечисление.СтатусыСправочника.Активен Тогда
ЭлементыФормы.ЗаголовокФормы.Заголовок = "Активный элемент: " + Объект.Наименование;
Иначе
ЭлементыФормы.ЗаголовокФормы.Заголовок = "Неактивный элемент: " + Объект.Наименование;
КонецЕсли;
КонецПроцедуры

Ещё один полезный пример — скрытие поля при определенном условии:

Процедура ПриИзмененииСтатуса(Элемент)
ЭлементыФормы.ДополнительнаяИнформация.Видимость =
(Объект.Статус = Перечисление.СтатусыСправочника.Архивный);
КонецПроцедуры

⚠️ Внимание: При программной модификации форм в типовых конфигурациях используйте подписки на события вместо прямого изменения модуля. Это позволит сохранить изменения при обновлениях. Подробнее о подписках читайте в документации к Библиотеке стандартных подсистем (БСП).

Для отладки кода формы используйте:

• 🐞 Пошаговое выполнение (F11 в конфигураторе).
• 🐞 Вывод в отладочное окно (Сообщить()).
• 🐞 Журнал регистрации для отслеживания ошибок.

4. Способ 3: Создание новой формы с нуля (альтернатива модификации)

Иногда проще создать новую форму для справочника, чем модифицировать существующую. Это актуально когда:

• 📌 Стандартная форма сильно перегружена ненужными элементами.
• 📌 Требуется кардинально иной интерфейс (например, мастер ввода в несколько шагов).
• 📌 Нужно избежать конфликтов при обновлении типовых конфигураций.

Пошаговая инструкция по созданию новой формы:

1. В дереве метаданных выберите справочник → Формы → Добавить.
2. Укажите Имя (например, НоваяФормаЭлемента) и Тип (управляемая/обычная).
3. В конструкторе формы добавьте необходимые элементы управления.
4. В модуле формы пропишите логику работы (обработчики событий).
5. Свяжите форму с объектом через свойство ОсновнаяФорма или программно при открытии.

Пример кода для программного открытия новой формы:

Процедура ОткрытьНовуюФорму(СсылкаНаОбъект)
Форма = ПолучитьФорму("Справочник.Номенклатура.НоваяФормаЭлемента");
Форма.ЭлементУправления.Объект = СсылкаНаОбъект;
Форма.Открыть();
КонецПроцедуры

Преимущества этого подхода:

• ✅ Полный контроль над структурой и логикой формы.
• ✅ Нет риска повредить стандартную форму.
• ✅ Легче поддерживать и обновлять.

Недостаток — дополнительные затраты времени на разработку с нуля.

5. Способ 4: Использование расширений конфигурации (для типовых решений)

Расширения конфигурации — это рекомендуемый способ модификации типовых решений (1С:Бухгалтерия, 1С:ЗУП, 1С:ERP и др.). Они позволяют вносить изменения, не затрагивая оригинальную конфигурацию, что упрощает обновления.

Как добавить форму справочника через расширение:

1. Создайте новое расширение (Файл → Новое → Расширение конфигурации).
2. В дереве расширения найдите нужный справочник и добавьте новую форму.
3. Настройте форму так же, как в обычной конфигурации.
4. Укажите Порядок формы (чем выше число, тем выше приоритет).
5. Сохраните расширение и подключите его к основной базе.

Пример структуры расширения для формы справочника Номенклатура:

РасширениеКонфигурации.МоеРасширение
├── Справочники
│   └── Номенклатура
│       └── Формы
│           └── НоваяФормаЭлемента (УправляемаяФорма)

Особенности работы с расширениями:

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

⚠️ Внимание: В некоторых версиях платформы (до 8.3.18) расширения имели ограничения по работе с формами. Перед использованием проверьте совместимость в документации к вашей версии 1С.

6. Способ 5: Динамическое изменение формы в режиме 1С:Предприятие

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

Для этого используются методы ПолучитьФорму() и ИзменитьФорму(). Пример скрытия элемента для пользователей без прав администратора:

Процедура ПриОткрытии(Отказ)
Если НЕ ГлобальныйКонтекст.Пользователь.Роли.Содержит(Роли.Администратор) Тогда
ЭлементыФормы.КонфиденциальноеПоле.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

Более сложный пример — добавление новой кнопки на форму программно:

Процедура ДобавитьКнопкуЭкспорта(Форма)
Кнопка = Форма.ЭлементыФормы.Добавить("ЭкспортВExcel", Тип("Кнопка"));
Кнопка.Заголовок = "Экспортировать в Excel";
Кнопка.Действие = "ЭкспортироватьДанные";
Кнопка.Видимость = Истина;
КонецПроцедуры

Динамические изменения удобны для:

• 🎯 Адаптивных интерфейсов (изменение формы под размер экрана).
• 🎯 Ролевого доступа (разные формы для разных пользователей).
• 🎯 Контекстных действий (кнопки появляются при определенных условиях).

Однако у этого метода есть минусы:

• ⚠️ Сложность отладки — ошибки проявляются только в режиме 1С:Предприятие.
• ⚠️ Риск конфликтов при одновременной модификации формы несколькими расширениями.

7. Типичные ошибки и как их избежать

При изменении форм справочников разработчики часто сталкиваются с одними и теми же проблемами. Рассмотрим самые распространённые ошибки и способы их решения.

Ещё несколько полезных советов:

• 🔍 Всегда тестируйте формы на копии базы перед внедрением в рабочую систему.
• 🔍 Документируйте изменения — особенно важно для командной разработки.
• 🔍 Используйте версии (Git, 1C:EDT) для отката неудачных изменений.

8. Продвинутые техники: интеграция с внешними системами

Иногда формы справочников нужно связать с внешними системами: загружать данные из Excel, отправлять запросы в API или отображать информацию из веб-сервисов. Рассмотрим ключевые сценарии.

1. Загрузка данных из Excel:

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

Процедура ЗагрузитьИзExcel(ПутьКФайлу)
Excel = Новый COMОбъект("Excel.Application");
Книга = Excel.Workbooks.Open(ПутьКФайлу);
Лист = Книга.Worksheets(1);

// Чтение данных из ячеек
Данные = Лист.Range("A1:B10").Value;

// Обработка данных и заполнение справочника
Для Каждого Строка Из Данные Цикл
НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = Строка[1];
НовыйЭлемент.Артикул = Строка[2];
НовыйЭлемент.Записать();
КонецЦикла;

Excel.Quit();
КонецПроцедуры

2. Отправка данных в API:

Для взаимодействия с REST API используйте HTTPСоединение или HTTPЗапрос. Пример отправки данных при сохранении элемента:

Процедура ПриЗаписи(Отказ)
Если НЕ ЗначениеЗаполнено(Объект.ВнешнийИдентификатор) Тогда
Запрос = Новый HTTPЗапрос("https://api.example.com/items");
Запрос.Заголовки.Вставить("Authorization", "Bearer " + ПолучитьТокен());
Запрос.УстановитьТекст(СериализоватьВJSON(Объект));

Ответ = Новый HTTPСоединение().Получить(Запрос);
Если Ответ.КодСостояния = 200 Тогда
ДанныеОтвета = ДесериализоватьJSON(Ответ.ПолучитьТекст());
Объект.ВнешнийИдентификатор = ДанныеОтвета.Идентификатор;
Иначе
Сообщить("Ошибка отправки данных: " + Ответ.КодСостояния);
Отказ = Истина;
КонецЕсли;
КонецЕсли;
КонецПроцедуры

3. Отображение веб-контента:

Для встраивания веб-страниц или дашбордов прямо в форму используйте элемент ПолеHTMLДокумента. Пример:

ЭлементыФормы.ВебПанель.АдресСтраницы =
"https://analytics.example.com/dashboard?id=" + Объект.УникальныйИдентификатор;

При интеграции с внешними системами учитывайте:

• 🌐 Безопасность: не храните пароли и токены в открытом виде (используйте ХранилищеПараметров).
• 🌐 Производительность: тяжелые операции выполняйте в фоновом режиме.
• 🌐 Обработку ошибок: всегда проверяйте ответы от внешних систем.

FAQ: Ответы на частые вопросы

Процедура ПриИзмененииРазмера(Элемент)
Если ЭтаФорма.Размер.Ширина < 800 Тогда
ЭлементыФормы.ДополнительнаяПанель.Видимость = Ложь;
Иначе
ЭлементыФормы.ДополнительнаяПанель.Видимость = Истина;
КонецЕсли;
КонецПроцедуры