Добавление кнопки в 1С через расширение: от создания до подключения

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

• Имя: КнопкаПечатьЭтикеток
• Синоним: Печать этикеток
• Действие: выберите созданную ранее команду ПечатьЭтикеток.
• Картинка: можно выбрать стандартную иконку (например, Печать) или загрузить свою.
• Перетащите кнопку на нужную панель в визуальном редакторе формы (обычно это Панель действий или Командная панель).

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

Имя команды совпадает в командном интерфейсе и форме|Кнопка привязана к команде|Форма сохранена и подключена к расширению|Расширение активировано в базе-->

5. Написание кода для обработки нажатия кнопки

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

В дереве объектов расширения найдите раздел Общие модули и создайте новый модуль:

1. Кликните правой кнопкой по Общие модули и выберите Добавить.
2. Укажите параметры:
   • Имя: ОбщийМодульКомандЗаказа
   • Синоним: Обработчики команд для заказа
   • Тип: Общий модуль
   • Клиент (управляемое приложение): установите галочку.
   • Сервер: установите галочку, если логика будет выполняться на сервере.
• Откройте модуль и добавьте следующий код:

&Процедура ПечатьЭтикетокНаСервере(Команда)

// Получаем текущий документ из формы
ТекущийДокумент = Команда.Параметры.Объект;

// Формируем текст сообщения
ТекстСообщения = СтрШаблон("Заказ №%1 от %2\nКлиент: %3\nСумма: %4",
ТекущийДокумент.Номер,
Формат(ТекущийДокумент.Дата,"ДФ=dd.MM.yyyy"),
ТекущийДокумент.Контрагент.Наименование,
Формат(ТекущийДокумент.СуммаДокумента,"ЧДЦ=2; ЧНГ=0"));

// Показываем сообщение пользователю
ПоказатьОповещениеПользователя(ТекстСообщения,,,"Информация по заказу");

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

&Процедура ПечатьЭтикеток(Команда) Экспорт

// Вызываем серверную процедуру
ПечатьЭтикетокНаСервере(Команда);

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

Теперь нужно привязать этот обработчик к команде. Вернитесь к командному интерфейсу (КомандныйИнтерфейсЗаказаКлиента) и:

1. Выберите команду ПечатьЭтикеток.
2. На вкладке Свойства найдите поле Действие и укажите имя процедуры: ОбщийМодульКомандЗаказа.ПечатьЭтикеток.
3. Сохраните изменения.

Если всё сделано правильно, при нажатии на кнопку в форме заказа пользователь увидит оповещение с данными документа.

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

6. Тестирование и отладка

После добавления кнопки и написания кода необходимо протестировать расширение в пользовательском режиме. Вот как это сделать правильно:

1. Запустите 1С в режиме 1С:Предприятие (не конфигуратор!).
2. Откройте документ Заказ клиента (или тот объект, куда вы добавили кнопку).
3. Убедитесь, что кнопка отображается на панели действий. Если её нет:
   • Проверьте, подключено ли расширение (Справка → О программе → Расширения).
   • Убедитесь, что форма, которую вы модифицировали, действительно открывается (иногда в конфигурации есть несколько форм для одного объекта).
   • Проверьте, что имя формы в расширении совпадает с реальным именем формы в конфигурации.
4. Нажмите на кнопку и проверьте, появляется ли сообщение с данными заказа.

Если кнопка не работает или возникают ошибки, используйте отладчик:

• 🐞 Запустите 1С в режиме отладки (Сервис → Параметры → Отладка).
• 📍 Поставьте точку останова в коде обработчика (кликните левой кнопкой мыши на сером поле слева от номера строки).
• 🔍 Повторите действия, приводящие к ошибке, и проанализируйте значения переменных в отладчике.

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

• 🚫 Кнопка не отображается:
  • Проверьте, что расширение подключено и активно.
  • Убедитесь, что имя формы в расширении совпадает с именем формы в конфигурации (включая регистр!).
  • Проверьте, что кнопка добавлена на правильную панель (например, Панель действий, а не Панель навигации).
• 🚫 Ошибка при нажатии на кнопку:
  • Проверьте, что процедура-обработчик существует и экспортирована (ключевое слово Экспорт).
  • Убедитесь, что модуль, где находится обработчик, имеет правильные флаги (Клиент и/или Сервер).
  • Проверьте права доступа пользователя — возможно, у него нет прав на выполнение серверных процедур.
• 🚫 Кнопка появляется, но ничего не происходит:
  • Проверьте, что команда привязана к обработчику в свойствах командного интерфейса.
  • Убедитесь, что в коде нет"тихих" ошибок (например, обращения к несуществующим реквизитам).

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

7. Распространённые ошибки и как их избежать

Даже опытные разработчики сталкиваются с проблемами при работе с расширениями в 1С. Вот наиболее частые ошибки и способы их предотвращения:

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

• 🔄 Регулярно проверяйте обновления конфигурации и тестируйте расширение после каждого апдейта.
• 📌 Используйте гибкие привязки — вместо жёсткого указания имён форм используйте поиск по синонимам или типам.
• 📂 Ведите журнал изменений в расширении, чтобы быстро адаптировать его под новые версии конфигурации.

⚠️ Внимание: Если вы распределяете расширение между несколькими базами, учитывайте, что пути к формам и объектам могут отличаться в разных конфигурациях. Например, в УТ 11 и КА 2.4 форма заказа клиента имеет разную структуру. Всегда тестируйте расширение на целевой базе перед внедрением.

8. Экспорт и импорт расширений

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

Чтобы экспортировать расширение:

1. В конфигураторе кликните правой кнопкой по вашему расширению и выберите Сохранить в файл....
2. Укажите путь для сохранения (например, C:\1C_Extensions\ПечатьЭтикеток.cfe).
3. Нажмите Сохранить.

Файл расширения имеет формат .cfe (1C Extension File) и может быть импортирован в другую базу. Для этого:

1. Откройте целевую базу в конфигураторе.
2. Перейдите в раздел Расширения, кликните правой кнопкой и выберите Загрузить из файла....
3. Выберите сохранённый ранее файл .cfe.
4. Подключите расширение (аналогично тому, как это делалось при создании).

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

• 🔧 Если в целевой базе уже есть расширение с таким же именем, произойдёт конфликт. Переименуйте файлы перед импортом.
• 🔍 Проверьте совместимость версий платформы. Расширение, созданное в 1С:Предприятие 8.3.20, может не работать в 8.3.15.
• 📋 Если расширение использует внешние обработки или библиотеки, их также нужно перенести в целевую базу.

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

💡

Экспортируйте расширения в формате.cfe — это универсальный способ переноса изменений между базами без риска повредить основную конфигурацию.

FAQ: Частые вопросы по добавлению кнопок через расширения

Можно ли добавить кнопку в форму, которая не существует в основной конфигурации?

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

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

Вы можете управлять видимостью кнопки через роли или условное оформление. Например, в обработчике команды добавьте проверку:

Если НЕ ЗначениеЗаполнено(Пользователи.НайтиПоНаименованию("Иванов И.И.")) Тогда
Возврат;
КонецЕсли;

Или используйте функцию РолиДоступа.Проверка для проверки прав.

Можно ли добавить кнопку в форму справочника, а не документа?

Да, процесс аналогичный. В расширении выберите форму справочника (например, Справочник.Номенклатура.ФормаЭлемента) и добавьте кнопку на нужную панель. Логика обработки будет зависеть от того, какие данные вам нужны из справочника.

Как обновить расширение, если в основной конфигурации изменилась форма?

Если форма в основной конфигурации была изменена (например, после обновления релиза), вам нужно:

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

Если форма была кардинально переработана, возможно, придётся пересоздавать расширение.

Можно ли через расширение добавить кнопку, которая будет вызывать внешнюю обработку?

Да, это один из самых распространённых сценариев. В обработчике команды добавьте код для открытия внешней обработки:

&НаКлиенте
Процедура ОткрытьВнешнююОбработку(Команда)
ПутьКФайлу ="C:\Обработки\ПечатьЭтикеток.epf";
Если НЕ ЗначениеЗаполнено(ПутьКФайлу) Тогда
Сообщить("Файл обработки не найден!");
Возврат;
КонецЕсли;
ОткрытьФорму("Обработка.ПечатьЭтикеток