Как в 1С добавить кнопку редактирования

Кнопка «Редактировать» в 1С — это элемент формы, связанный с командой, которая открывает объект на изменение или переводит форму в режим редактирования. В зависимости от задачи кнопку добавляют либо средствами конфигуратора без программирования, либо с созданием собственной команды и обработчика на встроенном языке. Правильный способ зависит от того, работаете вы с управляемой формой (такси-интерфейс большинства современных конфигураций) или с обычной формой старых решений.

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

Определите, какая именно кнопка редактирования нужна

Под «кнопкой редактирования» пользователи и разработчики обычно понимают три разные задачи. Первая — вернуть или вывести стандартную кнопку «Изменить» в форме списка, чтобы открывать элемент на редактирование мышью, а не клавишей F2. Вторая — добавить в форму документа или справочника собственную кнопку, которая переводит заблокированную форму в режим изменения. Третья — создать кнопку, открывающую связанный объект (например, редактирование контрагента прямо из документа).

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

Вывод стандартной кнопки «Изменить» в форму списка

Откройте конфигуратор, найдите нужный объект (справочник, документ) в дереве конфигурации и раскройте ветку «Формы». Двойным щелчком откройте форму списка. В редакторе управляемой формы слева находится дерево элементов, справа вверху — вкладки «Элементы» и «Команды».

Перейдите на вкладку «Команды» и раскройте группу «Стандартные команды» нужной таблицы (например, «Список»). Найдите команду «Изменить» и перетащите её мышью в дерево элементов — внутрь командной панели формы списка. После этого в командной панели появится кнопка с соответствующей пиктограммой. Сохраните конфигурацию (F7) и обновите конфигурацию базы данных, если изменения затрагивают структуру.

Проверьте результат в режиме «1С:Предприятие»: откройте список, выделите строку и нажмите новую кнопку — элемент должен открыться в режиме редактирования. Если кнопка видна, но неактивна, проверьте права пользователя на изменение объекта.

1. 1
   Откройте конфигуратор и форму списка нужного объекта
2. 2
   Перейдите на вкладку «Команды» и найдите стандартную команду «Изменить»
3. 3
   Перетащите команду в командную панель дерева элементов
4. 4
   Сохраните форму и обновите конфигурацию базы данных
5. 5
   Проверьте работу кнопки в режиме «1С:Предприятие»

Создание собственной кнопки редактирования в управляемой форме

Если стандартной команды недостаточно, создайте свою. В редакторе формы откройте вкладку «Команды» и нажмите «Добавить». Задайте имя команды, например «РедактироватьКарточку», и заголовок «Редактировать» — именно он отобразится на кнопке. В свойствах команды укажите «Действие»: система предложит создать обработчик в модуле формы.

Пример обработчика, открывающего текущий объект списка на редактирование:

&НаКлиенте
Процедура РедактироватьКарточку(Команда)
ТекущиеДанные = Элементы.Список.ТекущиеДанные;
Если ТекущиеДанные = Неопределено Тогда
ПоказатьПредупреждение(, "Выберите строку для редактирования");
Возврат;
КонецЕсли;
ПоказатьЗначение(, ТекущиеДанные.Ссылка);
КонецПроцедуры

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

&НаКлиенте
Процедура РедактироватьКарточку(Команда)
    ТекущиеДанные = Элементы.Список.ТекущиеДанные;
    Если ТекущиеДанные = Неопределено Тогда
        Возврат;
    КонецЕсли;
    ПоказатьЗначение(, ТекущиеДанные.Ссылка);
КонецПроцедуры

Кнопка редактирования в обычной форме

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

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

Кнопка «Редактировать» для формы, открытой только на просмотр

Частая задача — форма документа открывается в режиме «только просмотр» (например, после проведения или по настройке прав), а пользователю нужна кнопка для перехода в режим изменения. Здесь логика обратная: создаётся команда, в обработчике которой снимается признак просмотра.

Пример такого обработчика:

&НаКлиенте
Процедура ВключитьРедактирование(Команда)
ЭтаФорма.ТолькоПросмотр = Ложь;
Элементы.ФормаВключитьРедактирование.Доступность = Ложь;
КонецПроцедуры

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

Типовые ошибки и проверка результата

Самая частая проблема — кнопка создана, но при нажатии ничего не происходит. Обычно причина в том, что команде не назначен обработчик (свойство «Действие» пустое) или кнопка в дереве элементов не связана с командой: в свойствах кнопки поле «ИмяКоманды» должно ссылаться на созданную команду. Вторая типичная ошибка — обращение к элементу формы по неверному имени, из-за чего возникает ошибка «Поле объекта не обнаружено».

Ещё одна категория ошибок связана с контекстом: обработчик, помеченный директивой «&НаСервере», не может напрямую вызывать клиентские методы вроде открытия формы. Открытие объекта пользователю всегда выполняйте в клиентском контексте («&НаКлиенте»), а серверные процедуры используйте только для получения данных.

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

Изменение типовых форм без снятия с поддержки

Если вы дорабатываете типовую конфигурацию, прямое изменение формы объекта приведёт к частичному снятию её с поддержки и усложнит будущие обновления. Безопасная альтернатива — механизм расширений конфигурации: создайте расширение (меню «Конфигурация — Расширения конфигурации»), добавьте в него заимствованную форму и разместите кнопку там. Расширение подключается поверх типовой конфигурации и не мешает обновлениям.

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

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