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

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

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

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

Подготовка среды разработки и создание расширения

Прежде чем приступать к изменению форм, необходимо создать объект расширения в конфигураторе. Для этого откройте базу данных в режиме Конфигуратор и перейдите в дерево метаданных. Найдите ветку «Расширения» и создайте новый элемент, присвоив ему осмысленное имя, например, ExtensionUIButtons.

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

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

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

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

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

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

Для добавления кнопки перетащите элемент Кнопка из палитры инструментов на форму. Разместите её в логически удобном месте, чтобы пользователь мог легко её найти. После размещения сразу задайте уникальное имя объекту, например, КнопкаПечатьАктуальнойФормы, чтобы избежать конфликтов именования в коде.

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

Написание кода обработчика события нажатия

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

Система предложит создать процедуру автоматически при двойном клике на кнопку в режиме конструктора. Имя процедуры будет сформировано на основе имени элемента, например, КнопкаПечатьАктуальнойФормыПриНажатии. Внутри этой процедуры размещается логика, которая должна выполниться.

Рассмотрим пример кода, который выводит простое сообщение пользователю. Это базовый тест работоспособности:

&НаКлиенте
Процедура КнопкаПечатьАктуальнойФормыПриНажатии(Элемент)

Сообщить("Кнопка успешно добавлена через расширение!");

КонецПроцедуры

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

⚠️ Внимание: Если ваш код обращается к данным базы или выполняет сложные вычисления, возможно, потребуется использование директивы &НаСервере и вызов серверной процедуры. Не выполняйте тяжелые операции в клиентском коде, чтобы не «заморозить» интерфейс.

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

Управление видимостью и доступностью кнопки

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

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

Пример кода для управления видимостью

Процедура ПроверкаПравДоступа() Если Не ПользователиИнформационнойБазы.ТекущийПользователь.ВходитВГруппу("Менеджеры") Тогда Элементы.КнопкаПечатьАктуальнойФормы.Видимость = Ложь; КонецЕсли; КонецПроцедуры

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

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

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

Свойство	Тип значения	Описание влияния на интерфейс
Заголовок	Строка	Текст, отображаемый на кнопке
Видимость	Булево	Определяет, отображается ли элемент на экране
Доступность	Булево	Разрешает или запрещает нажатие (элемент становится серым)
Подсказка	Строка	Текст всплывающей подсказки при наведении курсора

Отладка и тестирование функционала

После написания кода необходимо обновить конфигурацию базы данных. В режиме конфигуратора выберите меню Конфигурация -> Обновить конфигурацию базы данных. Система предложите завершить сеанс и обновиться — согласитесь с этим.

Запустите базу в режиме 1С:Предприятие под пользователем, имеющим права на использование расширения. Откройте форму, которую вы модифицировали. Если все сделано правильно, вы увидите новую кнопку в указанном месте.

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

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

Типичные ошибки и способы их решения

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

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

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

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

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

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

Можно ли добавить кнопку в мобильное приложение 1С через расширение?

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

Нужны ли специальные права для создания расширений?

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

Что будет с расширением при обновлении типовой конфигурации?

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

Можно ли распространять расширение как отдельный файл?

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