Как добавить новое действие в 1С: 5 способов с примерами кода

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

Эта статья охватывает все аспекты работы с действиями — от простейших настроек через конфигуратор до сложных программных решений с обработчиками событий. Мы разберём 5 основных способов добавления действий (включая малоизвестные приёмы для управляемых форм), покажем как обойти ограничения стандартных ролей без прав администратора, и предостережём от типичных ошибок, из-за которых действия не отображаются или не срабатывают. Особое внимание уделим актуальным версиям платформы 1С 8.3.20+, где механизм действий претерпел существенные изменения.

1. Что такое "действие" в 1С и где его искать

В терминологии 1С:Предприятие действие — это программный объект, который выполняет определённую команду при вызове пользователем. Это может быть как стандартная операция (например, проведение документа), так и кастомная логика, написанная на встроенном языке. Действия отображаются в интерфейсе в виде кнопок, пунктов меню или команд панелей инструментов.

Где хранятся действия в конфигураторе:

• 📁 Общие действия — в дереве объектов конфигурации раздел Общие → Действия. Здесь создаются глобальные команды, доступные во всех формах.
• 📄 Действия форм — в свойствах конкретной формы (обычной или управляемой) на закладке Действия. Привязываются только к этой форме.
• 🔧 Действия командных панелей — в свойствах командной панели формы на закладке Действия. Используются для группировки кнопок.
• 🖥️ Действия подсистем — в свойствах подсистемы на закладке Действия. Позволяют управлять видимостью команд для групп пользователей.

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

2. Способ 1: Добавление действия через конфигуратор (без программирования)

Самый простой метод — создать действие в визуальном редакторе конфигуратора. Он подходит для стандартных операций, которые не требуют сложной логики. Например, добавить кнопку "Печать акта выполненных работ" в документ РеализацияТоваровУслуг.

Пошаговая инструкция:

1. Откройте конфигуратор в режиме 1С:Предприятие (с правами администратора).
2. В дереве объектов найдите документ, для которого нужно добавить действие (например, Документы → РеализацияТоваровУслуг).
3. Откройте свойства документа, перейдите на закладку Формы и выберите форму ФормаДокумента (или ФормаСписка, если нужно добавить действие в список).
4. На закладке Действия нажмите "Добавить" и заполните свойства:
   • 📌 Имя — уникальный идентификатор (например, ПечатьАктаВыполненныхРабот)
   • 📝 Заголовок — текст, который увидит пользователь (например, "Печать акта")
   • 🖼️ Картинка — иконка для кнопки (можно выбрать из стандартного набора)
   • 🔗 Тип действия — выберите "Выполнить процедуру" и укажите имя экспортной процедуры (если логика уже прописана в модуле формы)

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

• 🔄 Привязать существующую процедуру из модуля формы (например, ПечатьАктаВыполненныхРаботНаСервере())
• 📝 Создать новую процедуру в модуле формы с именем, совпадающим с именем действия (для автоматической привязки)

Проверить права доступа (нужны права администратора)

Сделать резервную копию конфигурации

Определить, к какому объекту привязывается действие (документ, справочник, отчёт)

Подготовить текст заголовка и описание (если нужно)

Выбрать иконку из стандартной библиотеки (опционально)-->

3. Способ 2: Программное создание действия в модуле формы

Когда нужно добавить действие динамически (например, только для определённых пользователей или при выполнении условий), используется программный способ. Это гибкий метод, но требует знания встроенного языка 1С.

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

&Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Добавляем новое действие в командную панель формы
КоманднаяПанель = ЭлементыФормы.КоманднаяПанельФормы;
НовоеДействие = КоманднаяПанель.Действия.Добавить("МоёНовоеДействие");
НовоеДействие.Заголовок = "Экспорт в Excel";
НовоеДействие.Представление = СтандартныйИнтерфейс.Картинка(ТипКартинкиИнтерфейса.Экспорт);
НовоеДействие.Действие = "ЭкспортВExcelНаСервере"; // Имя процедуры-обработчика

// Устанавливаем видимость в зависимости от роли пользователя
Если НЕ Пользователь.Роли.Найти("Администратор") Тогда
НовоеДействие.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

&Процедура ЭкспортВExcelНаСервере()
// Логика экспорта данных в Excel
ТаблицаДокумента = Объект.Выгрузить();
Экспорт.ЭкспортироватьВExcel(ТаблицаДокумента);
КонецПроцедуры

Ключевые моменты:

• 🔹 Действие добавляется в процедуре ПриСозданииНаСервере, чтобы оно появилось при открытии формы.
• 🔹 Для управляемых форм используйте свойство ЭлементыФормы.КоманднаяПанельФормы.
• 🔹 Имя действия ("МоёНовоеДействие") должно быть уникальным в пределах формы.
• 🔹 Обработчик (ЭкспортВExcelНаСервере) должен быть описан в том же модуле формы.

1) Правильно ли указано имя командной панели (иногда она называется иначе, например, КоманднаяПанель)

2) Нет ли ошибок в коде процедуры ПриСозданииНаСервере

3) Достаточно ли прав у текущего пользователя для отображения командной панели-->

4. Способ 3: Использование общих действий для нескольких форм

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

Как создать общее действие:

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

   &Процедура ОтправитьНаПочтуНаСервере(ОбъектФормы) Экспорт
   // Получаем текущий объект формы (документ, справочник и т.д.)
   ТекущийОбъект = ОбъектФормы.Объект;
   
   // Логика отправки на почту
   ПочтовоеСообщение = Новый ПочтовоеСообщение;
   ПочтовоеСообщение.Текст = ТекущийОбъект.Представление();
   ПочтовоеСообщение.Отправить();
   КонецПроцедуры

4. Сохраните действие и привяжите его к нужным формам через свойство Действия в конфигураторе.

Преимущества общих действий:

• ✅ Централизованное управление — изменяете логику в одном месте, она обновляется во всех формах.
• ✅ Экономия ресурсов — не нужно дублировать одинаковый код в разных модулях.
• ✅ Гибкость — можно ограничивать видимость действия через роли прямо в свойствах общего действия.

&Процедура МоёДействиеНаСервере(ОбъектФормы, Параметры) Экспорт
Сообщить("Передан параметр: " + Параметры.МойПараметр);
КонецПроцедуры

Действия.МоёДействие.Выполнить(,, Новый Структура("МойПараметр", "Значение"));

5. Способ 4: Добавление действия через расширение конфигурации

Если у вас нет прав на изменение основной конфигурации (например, в облачной версии 1С:Фреш), или вы хотите сохранить возможность обновлений без потери кастомизации, используйте расширения конфигурации. Этот метод позволяет добавлять действия без модификации исходного кода.

Пошаговая инструкция:

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

   &Процедура МоёДействиеИзРасширения(Команда)
   Сообщить("Действие выполнено из расширения!");
   КонецПроцедуры

7. Сохраните расширение и подключите его к основной конфигурации через Конфигурация → Расширения → Подключить.

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

6. Способ 5: Динамическое создание действий через код (продвинутый уровень)

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

Пример динамического добавления действий в управляемую форму:

&Процедура ПриОткрытии(Отказ)
// Получаем командную панель
КоманднаяПанель = ЭлементыФормы.КоманднаяПанельФормы;

// Очищаем старые динамические действия (если нужно)
Для Каждого Действие Из КоманднаяПанель.Действия Цикл
Если НачалоСтроки(Действие.Имя, "Динамическое_") Тогда
КоманднаяПанель.Действия.Удалить(Действие);
КонецЕсли;
КонецЦикла;

// Добавляем новые действия на основе условий
Если Объект.ЭтоГруппа Тогда
НовоеДействие = КоманднаяПанель.Действия.Добавить("Динамическое_ЭкспортГруппы");
НовоеДействие.Заголовок = "Экспорт группы в XML";
НовоеДействие.Действие = "ЭкспортГруппыВXML";
Иначе
НовоеДействие = КоманднаяПанель.Действия.Добавить("Динамическое_ОтправитьНаПроверку");
НовоеДействие.Заголовок = "Отправить на проверку";
НовоеДействие.Картинка = СтандартныйИнтерфейс.Картинка(ТипКартинкиИнтерфейса.Отправить);
НовоеДействие.Действие = "ОтправитьНаПроверкуДокумент";
КонецЕсли;
КонецПроцедуры

&Процедура ЭкспортГруппыВXML()
// Логика экспорта
КонецПроцедуры

&Процедура ОтправитьНаПроверкуДокумент()
// Логика отправки
КонецПроцедуры

Когда использовать динамические действия:

• 🔄 Когда список действий зависит от данных (например, статуса документа).
• 🔒 Когда нужно ограничить видимость действий по сложным правилам (не только ролями).
• 📊 Когда действия генерируются на основе внешних источников (например, списка доступных отчётов из веб-сервиса).

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

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

1. Действие не отображается в интерфейсе

• ❌ Причина: Не указан заголовок или картинка.
• ✅ Решение: Проверьте свойства Заголовок и Представление в конфигураторе.

• ❌ Причина: Действие добавлено в нету командную панель (например, в КоманднаяПанельСписка вместо КоманднаяПанельФормы).
• ✅ Решение: Уточните имя командной панели через ЭлементыФормы.

2. Действие не выполняется при нажатии

• ❌ Причина: Не указан обработчик или ошибка в имени процедуры.
• ✅ Решение: Проверьте, что имя процедуры в свойстве Действие совпадает с именем в модуле.

• ❌ Причина: Обработчик не помечен как Экспорт (для общих действий).
• ✅ Решение: Добавьте ключевое слово Экспорт в объявление процедуры.

3. Ошибка "Недостаточно прав" при выполнении действия

• ❌ Причина: Действие требует прав администратора, а пользователь их не имеет.
• ✅ Решение: Настройте права в ролях или используйте ПроверкаПравДоступа() в коде.

⚠️ Внимание: В версиях 1С:Предприятие 8.3.20+ изменился механизм обработки действий в управляемых формах. Если вы обновляли платформу, проверьте совместимость кода с новой версией через Справка → О программе → Версия платформы. Некоторые старые обработчики могут требовать адаптации.

8. Права доступа и безопасность

Добавление новых действий всегда связано с вопросами безопасности. Неконтролируемое создание команд может привести к утечкам данных или нарушению бизнес-процессов. Вот ключевые правила:

1. Настройка прав на уровне ролей

Каждое действие можно привязать к определённым ролям:

• 🔐 В конфигураторе откройте свойства действия и перейдите на закладку Права.
• 📋 Отметьте роли, которым разрешено видеть и выполнять это действие.
• 🔄 Для динамических действий используйте проверку в коде:

  Если НЕ Пользователь.Роли.Найти("Менеджер") Тогда
  НовоеДействие.Видимость = Ложь;
  КонецЕсли;

2. Безопасность в расширениях

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

• 🛡️ Всегда проверяйте права в обработчиках, даже если действие скрыто в интерфейсе (пользователь может вызвать его программно).
• 🔍 Используйте ПроверкаПравДоступа("ИнтерактивноеУдаление") для критичных операций.

3. Логирование действий

Для аудита полезно вести журнал выполнения кастомных действий:

&Процедура МоёДействиеНаСервере()
// Логируем вызов действия
Регистратор = РегистраторыСобытий.Создать();
Регистратор.ЗарегистрироватьСобытие(
"Выполнено действие 'МоёДействие'",
УровеньЖурналирования.Информация,
,
"Пользователь: " + Пользователь.Имя
);

// Основная логика
...
КонецПроцедуры

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

FAQ: Частые вопросы по работе с действиями в 1С

&Процедура ПриОткрытии(Отказ)
Если Объект.СуммаДокумента > 100000 Тогда
КоманднаяПанель.Действия.Добавить("БольшаяСделка").Заголовок = "Одобрить крупную сделку";
КонецЕсли;
КонецПроцедуры