Как добавить командную панель в 1С: пошаговый разбор для разработчиков и администраторов

Командная панель в 1С:Предприятие 8.3 — это ключевой элемент интерфейса, который позволяет пользователям быстро выполнять основные действия без поиска по меню. Её отсутствие или некорректная настройка может значительно снизить удобство работы с программой. В этой статье мы разберём все способы добавления командной панели: от стандартных инструментов конфигуратора до ручного программирования для управляемых и обычных форм.

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

Что такое командная панель в 1С и зачем она нужна

Командная панель (или панель действий) — это горизонтальная или вертикальная область в форме 1С, содержащая кнопки для выполнения команд. Она может располагаться:

• 📍 Вверху формы (стандартное расположение для управляемых форм)
• 📍 Снизу формы (типично для обычных форм в "толстом" клиенте)
• 📍 Слева/справа (вертикальная панель, часто используется в мобильных версиях)

Основные функции командной панели:

• ⚡ Быстрый доступ к часто используемым действиям (создание, редактирование, печать документов)
• 🔄 Группировка команд по логическим блокам (например, "Документы", "Отчёты", "Сервис")
• 🎨 Адаптация интерфейса под роли пользователей (скрытие ненужных кнопок для определённых групп)
• 🖥️ Поддержка разных режимов работы (Толстый клиент, Тонкий клиент, Веб-клиент)

Без командной панели пользователям приходится искать нужные функции в меню Все функции или Ещё, что замедляет работу. Например, в типовой конфигурации 1С:Бухгалтерия 3.0 панель действий документа "Поступление товаров" содержит кнопки для проведения, печати и создания на основе — их отсутствие заставит бухгалтера тратить лишние 3-5 кликов на каждое действие.

Способы добавления командной панели в 1С 8.3

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

Рассмотрим каждый метод подробно, начиная с самого простого.

Метод 1: Добавление командной панели через Конфигуратор (для управляемых форм)

Это самый быстрый способ, который не требует написания кода. Подходит для управляемых форм в конфигурациях на базе 1С:Предприятие 8.3.10+.

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

1. Откройте конфигуратор в режиме 1С:Предприятие (с правами администратора).
2. Перейдите в раздел Объекты → [Ваш объект] → Формы (например, Документы → ПоступлениеТоваровУслуг → Формы).
3. Выберите нужную форму (обычно ФормаОбъекта или ФормаСписка) и откройте её в редакторе форм.
4. В панели элементов (Палитра) найдите компонент КоманднаяПанель и перетащите его в верхнюю часть формы.
5. В свойствах командной панели (Свойства) укажите:
   • 🔹 Имя — например, ОсновныеДействия
   • 🔹 Тип командной панели — Горизонтальная или Вертикальная
   • 🔹 Источник команд — выберите из списка (например, Объект.Форма.Команды)

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

Добавлена командная панель в нужное место формы|

Указан корректный источник команд|

Панель не перекрывает другие элементы интерфейса|

Форма сохранена и обновлена в базе данных-->

Метод 2: Ручное программирование командной панели (для обычных и управляемых форм)

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

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

&Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Создаём командную панель
КоманднаяПанель = ЭлементыФормы.Добавить("КоманднаяПанель1", Тип("КоманднаяПанель"));
КоманднаяПанель.Верх = 0;
КоманднаяПанель.Высота = 30;
КоманднаяПанель.ГоризонтальноеПоложение = ГоризонтальноеПоложение.Растянуть;
КоманднаяПанель.ИсточникКоманд = Новый ИсточникКомандФормы(ЭтаФорма);

// Добавляем команды (пример для документа)
КомандаПровести = КоманднаяПанель.Команды.Добавить("Провести");
КомандаПровести.Действие = "ПровестиДокумент";
КомандаПровести.Заголовок = "Провести";
КомандаПровести.Изображение = БиблиотекаКартинок.Провести;

КомандаПечать = КоманднаяПанель.Команды.Добавить("Печать");
КомандаПечать.Действие = "ПечатьДокумента";
КомандаПечать.Заголовок = "Печать";
КомандаПечать.Изображение = БиблиотекаКартинок.Печать;
КонецПроцедуры

Для обычных форм (толстый клиент) код будет отличаться:

&Процедура ПриОткрытии()
// Создаём панель инструментов
ПанельИнструментов = ЭлементыФормы.Добавить(
"ПанельИнструментов1",
Тип("ПанельИнструментов"),
ЭтотОбъект,
Истина
);
ПанельИнструментов.Положение = ПоложениеПанели.Верх;
ПанельИнструментов.Высота = 24;

// Добавляем кнопку "Провести"
КнопкаПровести = ПанельИнструментов.Элементы.Добавить(
"Провести",
Тип("КнопкаПанелиИнструментов")
);
КнопкаПровести.Картинка = БиблиотекаКартинок.Провести;
КнопкаПровести.Подсказка = "Провести документ (F9)";
КнопкаПровести.Действие = "ПровестиДокумент";
КонецПроцедуры

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

Метод 3: Наследование и расширение типовой конфигурации

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

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

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

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

• 🔄 Сохранение изменений при обновлении типовой конфигурации
• 🛡️ Минимизация рисков конфликтов
• 🔧 Возможность отключить расширение без потери данных

Пример кода для добавления команды через расширение:

&Процедура ДобавитьКомандуВПанель(КоманднаяПанель, ИмяКоманды, Заголовок, Действие, Картинка)
Команда = КоманднаяПанель.Команды.Добавить(ИмяКоманды);
Команда.Заголовок = Заголовок;
Команда.Действие = Действие;
Команда.Изображение = Картинка;
Команда.Видимость = Истина;
КонецПроцедуры

// Вызов в процедуре ПриСозданииНаСервере
ДобавитьКомандуВПанель(
ЭлементыФормы.ОсновнаяКоманднаяПанель,
"ЭкспортВExcel",
"Экспорт в Excel",
"ЭкспортироватьДанныеВExcel",
БиблиотекаКартинок.ЭкспортВExcel
);

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

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

Одна из самых распространённых ошибок — несоответствие имени команды и обработчика. Например, если вы добавили команду с именем "Печать", но в модуле формы описали процедуру ПечатьДокумента(), кнопка не будет работать. Имена должны совпадать:

Команда.Действие = "Печать"; // Имя команды
&НаСервере
Процедура Печать()
// Код печати документа
КонецПроцедуры

Динамическое управление командной панелью

Иногда требуется скрывать или показывать кнопки в зависимости от условий (например, права пользователя, статус документа). Для этого используйте события формы ПриАктивизацииСтроки или ПриИзменении.

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

&Процедура ПриАктивизацииСтрокиНаСервере(ТекущаяСтрока)
// Скрываем кнопку "Удалить" для проведённых документов
Если Объект.Проведен Тогда
ЭлементыФормы.ОсновнаяКоманднаяПанель.Команды.Удалить.Видимость = Ложь;
Иначе
ЭлементыФормы.ОсновнаяКоманднаяПанель.Команды.Удалить.Видимость = Истина;
КонецЕсли;

// Показываем кнопку "Отменить проведение" только проводникам
Если Пользователь.Роли.Найти("ПроводникДокументов") <> Неопределено Тогда
ЭлементыФормы.ОсновнаяКоманднаяПанель.Команды.ОтменитьПроведение.Видимость = Истина;
Иначе
ЭлементыФормы.ОсновнаяКоманднаяПанель.Команды.ОтменитьПроведение.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

Для группировки команд по категориям (например, "Документ", "Печать", "Сервис") используйте свойство Родитель:

// Создаём категорию
КатегорияПечать = КоманднаяПанель.Команды.Добавить("КатегорияПечать");
КатегорияПечать.Заголовок = "Печать";
КатегорияПечать.Тип = ТипКомандыФормы.Категория;

// Добавляем команды в категорию
КомандаПечать = КоманднаяПанель.Команды.Добавить("ПечатьДокумента");
КомандаПечать.Родитель = КатегорияПечать;
КомандаПечать.Заголовок = "Печать документа";

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

Оптимизация командной панели для пользователей

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

• 🎯 Размещайте часто используемые команды слева — пользователи привыкли, что основные действия (создание, редактирование, проведение) находятся в начале панели.
• 🖼️ Используйте иконки — визуальные подсказки ускоряют поиск нужной кнопки. Стандартные картинки можно взять из БиблиотекаКартинок.
• 📌 Группируйте команды по логике — например, все действия с документом в одной категории, отчёты — в другой.
• 🔍 Добавляйте подсказки — свойство Подсказка помогает новичкам разобраться в назначении кнопок.
• 🔄 Тестируйте в разных клиентах — командная панель может по-разному отображаться в толстом, тонком и веб-клиенте.

Пример оптимизированной командной панели для документа "Заказ покупателя":

// Категория "Документ"
КатегорияДокумент = КоманднаяПанель.Команды.Добавить("КатегорияДокумент", ТипКомандыФормы.Категория);
КатегорияДокумент.Заголовок = "Документ";

// Команды категории
ДобавитьКоманду(КоманднаяПанель, "Провести", "Провести (F9)", "ПровестиДокумент", БиблиотекаКартинок.Провести, КатегорияДокумент);
ДобавитьКоманду(КоманднаяПанель, "ОтменитьПроведение", "Отменить проведение", "ОтменитьПроведениеДокумента", БиблиотекаКартинок.ОтменаПроведения, КатегорияДокумент);
ДобавитьКоманду(КоманднаяПанель, "СоздатьНаОсновании", "Создать на основании", "ОткрытьСписокНаОсновании", БиблиотекаКартинок.СоздатьНаОсновании, КатегорияДокумент);

// Категория "Печать"
КатегорияПечать = КоманднаяПанель.Команды.Добавить("КатегорияПечать", ТипКомандыФормы.Категория);
КатегорияПечать.Заголовок = "Печать";

ДобавитьКоманду(КоманднаяПанель, "ПечатьЗаказа", "Печать заказа", "ПечатьДокумента", БиблиотекаКартинок.Печать, КатегорияПечать);
ДобавитьКоманду(КоманднаяПанель, "ПечатьСчётФактура", "Печать счёт-фактуры", "ПечатьСчётФактуры", БиблиотекаКартинок.Печать, КатегорияПечать);

Для мобильных устройств рекомендуется использовать вертикальную командную панель с крупными кнопками (высота не менее 48 px). Это связано с особенностями сенсорного управления.

💡

Не перегружайте командную панель! Оптимальное количество кнопок — 5-7 в одной категории. Если команд больше, разбейте их на вкладки или используйте выпадающее меню.

FAQ: Частые вопросы по командным панелям в 1С

Как добавить командную панель в форму списка?

Для формы списка алгоритм такой же, как и для формы объекта. Откройте форму списка в конфигураторе (Объекты → [Ваш объект] → Формы → ФормаСписка), добавьте командную панель и настройте команды. Типичные команды для списка: "Создать", "Изменить", "Удалить", "Обновить".

Пример кода для добавления команды "Экспорт в Excel":

КомандаЭкспорт = КоманднаяПанель.Команды.Добавить("ЭкспортВExcel");
КомандаЭкспорт.Заголовок = "Экспорт в Excel";
КомандаЭкспорт.Действие = "ЭкспортироватьСписокВExcel";
КомандаЭкспорт.Изображение = БиблиотекаКартинок.ЭкспортВExcel;

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

Для диагностики откройте Отладку → Журнал регистрации в веб-клиенте и проверьте ошибки.

// Создаём подменю
ПодменюЭкспорт = КоманднаяПанель.Команды.Добавить("ПодменюЭкспорт", ТипКомандыФормы.Подменю);
ПодменюЭкспорт.Заголовок = "Экспорт";

// Добавляем команды в подменю
КомандаЭкспортExcel = КоманднаяПанель.Команды.Добавить("ЭкспортExcel");
КомандаЭкспортExcel.Родитель = ПодменюЭкспорт;
КомандаЭкспортExcel.Заголовок = "В Excel";
КомандаЭкспортExcel.Действие = "ЭкспортироватьВExcel";

КомандаЭкспортPDF = КоманднаяПанель.Команды.Добавить("ЭкспортPDF");
КомандаЭкспортPDF.Родитель = ПодменюЭкспорт;
КомандаЭкспортPDF.Заголовок = "В PDF";
КомандаЭкспортPDF.Действие = "ЭкспортироватьВPDF";

Команда1 = КоманднаяПанель.Команды.Добавить("Команда1", , 0); // Первая позиция
Команда2 = КоманднаяПанель.Команды.Добавить("Команда2", , 1); // Вторая позиция

КоманднаяПанель.Команды.Переместить("Команда2", 0); // Перемещаем на первое место