Когда мы работаем с управляемыми формами в 1С:Предприятии 8.3, одной из частых задач является динамическое создание элементов управления, таких как кнопки, в зависимости от логики нашей системы или пользовательских настроек. Например, это может быть актуально для внешних отчетов Системы Компоновки Данных (СКД), когда нам нужно добавить специфические кнопки, которых нет в стандартном функционале. Для упрощения процесса разработки можно использовать общий модуль для программного создания элементов формы и команд.
Однако при попытке привязать такую динамически созданную кнопку к команде, мы можем столкнуться с ошибкой "Недопустимое значение", как это произошло в описанной ситуации. Эта ошибка возникает в строке, где мы присваиваем имя команды свойству Кнопка.ИмяКоманды.
В данной статье мы подробно разберем, почему возникает эта ошибка, и как правильно организовать программное создание кнопки и ее привязку к команде, чтобы избежать подобных проблем. Мы пошагово рассмотрим весь процесс, начиная от понимания причин ошибки и заканчивая полным примером корректного кода. Также на практике может пригодиться обработка с примером динамического создания и удаления элементов формы.
Давайте вместе выясним, почему система выдает ошибку "Недопустимое значение" в строке кода Кнопка.ИмяКоманды = "ВыбратьМакет_Команда";. Основная причина кроется в порядке выполнения операций и в концепции взаимосвязи между элементами формы и командами формы в платформе 1С:Предприятие.
Важно понимать, что в 1С управляемые формы оперируют двумя ключевыми понятиями, которые часто путают:
КнопкаФормы): Это визуальный элемент, который отображается на форме. Он имеет свой заголовок, вид, положение и может быть привязан к команде.КомандаФормы): Это описание действия, которое может быть выполнено. Команда содержит заголовок, подсказку, картинку и, самое главное, ссылку на процедуру-обработчик (свойство Действие), которая будет выполнена при активации команды.Кнопка на форме является лишь визуальным представлением, своего рода "пультом управления" для команды. Когда мы программно создаем кнопку, используя код, подобный этому:
Кнопка = Элементы.Добавить("ВыбратьМакет", Тип("КнопкаФормы"), Элементы.ОсновнаяКоманднаяПанель);
мы создаем только визуальный элемент. На этом этапе мы еще не определили, какое действие эта кнопка должна выполнять. Для этого кнопке необходимо "указать", какую команду она будет активировать. Это и происходит при присвоении значения свойству ИмяКоманды:
Кнопка.ИмяКоманды = "ВыбратьМакет_Команда";
В этот момент система пытается найти команду с именем "ВыбратьМакет_Команда" в коллекции команд текущей формы (ЭтаФорма.Команды). Если команда с таким именем отсутствует в этой коллекции, платформа не может установить связь между кнопкой и несуществующей командой. Именно это и приводит к ошибке "Недопустимое значение", так как мы пытаемся привязать кнопку к чему-то, что не существует или не является допустимым значением для ссылки на команду.
Таким образом, мы видим, что перед тем как "нарисовать" кнопку и привязать ее к команде, мы должны сначала создать саму команду в коллекции команд формы. Это фундаментальное правило, которое мы будем соблюдать для решения нашей проблемы. Давайте разберем этот процесс по шагам, чтобы гарантировать корректную работу.
Для корректной работы с динамически создаваемыми кнопками и командами мы должны соблюдать строгую последовательность действий. Рассмотрим каждый шаг подробно, чтобы избежать ошибок и построить надежное решение.
Первый и самый важный шаг — это программное создание объекта КомандаФормы и добавление его в коллекцию команд нашей формы. Это достигается с помощью метода ЭтаФорма.Команды.Добавить(), который возвращает новый объект команды. Мы присваиваем команде уникальное имя, которое затем будет использоваться для привязки к кнопке.
Обычно этот этап выполняется в серверной процедуре ПриСозданииНаСервере, так как мы работаем с элементами формы и ее свойствами, которые доступны в серверном контексте. Мы должны убедиться, что команда создается до того, как любая кнопка попытается на нее сослаться.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// ... ваш существующий код, который выполняется до создания кнопки ...
// 1. Создаем объект КомандаФормы
// Мы присваиваем ей уникальное имя "ВыбратьМакет_Команда".
// Это имя является идентификатором команды в коллекции форм и должно быть строго уникальным.
НоваяКоманда = ЭтаФорма.Команды.Добавить("ВыбратьМакет_Команда");
// Задаем заголовок команды. Этот текст будет отображаться на самой кнопке,
// если у нее не задан собственный заголовок, или если вид кнопки подразумевает
// отображение заголовка команды.
НоваяКоманда.Заголовок = "Выбрать макет отчета";
// Указываем имя процедуры-обработчика, которая будет выполняться при активации команды
// (например, при нажатии кнопки, привязанной к этой команде).
// Эта процедура должна быть определена в модуле формы.
НоваяКоманда.Действие = "ВыбратьМакет_ОбработчикКоманды";
// Дополнительно мы можем задать подсказку, которая появится при наведении курсора на кнопку,
// и картинку, если это необходимо. Картинка значительно улучшает визуальное восприятие.
// НоваяКоманда.Подсказка = "Позволяет открыть окно для выбора макета отчета из списка доступных";
// НоваяКоманда.Картинка = БиблиотекаКартинок.ВыбратьМакетОтчета; // Пример использования системной картинки
// ... дальнейший код создания элементов формы ...
КонецПроцедуры
Мы видим, что на этом шаге мы не только создаем команду, но и конфигурируем ее основные свойства: Заголовок, который будет виден пользователю, и Действие, которое указывает на имя процедуры-обработчика команды. Это критически важный этап, который определяет функциональность нашей кнопки.
После того как мы создали команду и указали имя процедуры в ее свойстве Действие, нам необходимо реализовать эту процедуру в модуле формы. Эта процедура будет выполняться каждый раз, когда пользователь активирует команду (например, нажимает соответствующую кнопку на форме). Именно здесь будет находиться вся логика, которая должна срабатывать при нажатии кнопки.
Мы должны тщательно продумать контекст выполнения этой процедуры: клиентский или серверный. Выбор зависит от того, какие действия должен выполнять обработчик:
Сообщить(), ОткрытьФорму()) или выполняет быстрые действия, не требующие обращения к данным базы или сложной бизнес-логике, его следует объявить с директивой &НаКлиенте.&НаСервере. В случае, если часть логики должна быть на клиенте, а часть на сервере, мы используем клиент-серверное взаимодействие, вызывая серверные процедуры из клиентского обработчика.Для нашего примера, где мы, вероятно, будем открывать форму выбора макета или выполнять другую логику, связанную с отчетом СКД, может потребоваться клиент-серверное взаимодействие. Для демонстрации самого обработчика, допустим, что первичное действие выполняется на клиенте:
&НаКлиенте
Процедура ВыбратьМакет_ОбработчикКоманды(Команда)
// Здесь будет находиться код, который должен выполняться при нажатии кнопки "ВыбратьМакет отчета".
// Это точка входа для всей последующей логики выбора и применения макета.
Сообщить("Вы нажали кнопку выбора макета! Запускается процесс выбора.");
// Пример вызова серверной процедуры для дальнейшей обработки.
// Часто бывает, что для выбора макетов необходимо получить дополнительную информацию
// с сервера или применить настройки, что требует серверного контекста.
// ВыбратьМакет_ОбработчикНаСервере();
// В данном контексте мы можем, например, открыть другую форму
// для выбора макета из заранее подготовленного списка.
// Если СписокСхем - это реквизит формы, доступный на клиенте (например, через Объект.СписокСхем),
// мы можем передать его в параметры формы выбора.
// Пример: ОткрытьФорму("ОбщаяФорма.ВыборИзСпискаЗначений", Новый Структура("СписокВыбора", СписокСхем), ЭтаФорма);
// Если у нас уже есть готовая серверная процедура, которая умеет обрабатывать
// выбор макета, мы можем вызвать ее, передав необходимые параметры.
// Например, если мы хотим сразу выбрать первый макет:
// ВыбратьМакетЗавершениеНаСервере(Новый Структура("Значение, Представление", СписокСхем[0].Значение, СписокСхем[0].Представление));
КонецПроцедуры
// Пример серверной процедуры, которая может быть вызвана из клиентского обработчика
// или из других серверных процедур. Она содержит логику, требующую серверного доступа.
&НаСервере
Процедура ВыбратьМакет_ОбработчикНаСервере()
// Здесь может быть логика, требующая серверного контекста,
// например, получение данных из базы, работа с объектом отчета (ОтчетОбъект),
// или выполнение сложных расчетов.
СообщитьНаКлиенте("Логика обработана на сервере после нажатия кнопки!");
// Далее может быть вызов процедуры, которая реально применяет макет
// или открывает серверную форму выбора.
КонецПроцедуры
Важно, чтобы имя процедуры, указанное в свойстве Действие команды (в нашем случае "ВыбратьМакет_ОбработчикКоманды"), точно совпадало с именем реализованной процедуры в модуле формы. Иначе платформа не сможет найти обработчик, и при активации команды возникнет ошибка.
Теперь, когда команда формы с именем "ВыбратьМакет_Команда" существует в коллекции ЭтаФорма.Команды и у нее определен обработчик, мы можем приступить к созданию визуального элемента — кнопки, и корректно привязать ее к нашей команде. Это делается путем присвоения свойству ИмяКоманды кнопки имени ранее созданной команды.
Этот код, как и создание команды, будет находиться в процедуре ПриСозданииНаСервере, но после того, как команда уже добавлена в коллекцию ЭтаФорма.Команды. Соблюдение этого порядка устраняет ошибку "Недопустимое значение".
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// ... Код создания команды (см. шаг 1) обязательно должен идти первым ...
// Мы повторно приводим этот блок, чтобы подчеркнуть правильный порядок.
// В реальном коде он будет один раз в начале процедуры.
НоваяКоманда = ЭтаФорма.Команды.Добавить("ВыбратьМакет_Команда");
НоваяКоманда.Заголовок = "Выбрать макет отчета";
НоваяКоманда.Действие = "ВыбратьМакет_ОбработчикКоманды";
// ... Теперь, когда команда существует в коллекции ЭтаФорма.Команды,
// мы можем безопасно создать кнопку и привязать ее ...
// Нарисуем кнопку
// Добавляем элемент формы типа КнопкаФормы в указанную командную панель.
// "ВыбратьМакет" - это уникальное имя элемента формы.
Кнопка = Элементы.Добавить("ВыбратьМакет", Тип("КнопкаФормы"), Элементы.ОсновнаяКоманднаяПанель);
Кнопка.Вид = ВидКнопкиФормы.КнопкаКоманднойПанели; // Указываем вид кнопки (например, кнопка командной панели)
// Привязываем кнопку к ранее созданной команде.
// На этом этапе команда "ВыбратьМакет_Команда" уже гарантированно существует
// в коллекции ЭтаФорма.Команды, поэтому ошибка "Недопустимое значение" не возникнет.
Кнопка.ИмяКоманды = "ВыбратьМакет_Команда";
// ... остальной код вашей процедуры ПриСозданииНаСервере,
// например, заполнение списка макетов и выбор начального, который был в исходном вопросе ...
КонецПроцедуры
Теперь, когда пользователь нажмет на динамически созданную кнопку, платформа найдет соответствующую команду по ее имени ("ВыбратьМакет_Команда"), а затем вызовет процедуру-обработчик, указанную в свойстве Действие этой команды (ВыбратьМакет_ОбработчикКоманды). Мы создали полностью функциональную динамическую кнопку!
Давайте соберем все шаги вместе, чтобы получить законченный и работоспособный код для процедуры ПриСозданииНаСервере. Мы также интегрируем логику по сбору макетов СКД, которая уже присутствовала в исходном примере автора, чтобы показать, как все части работают вместе в реальном сценарии.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// ************************************************************
// *** 1. Создание команды формы до ее привязки к кнопке ***
// ************************************************************
// Прежде чем пытаться привязать кнопку к команде, мы должны убедиться,
// что сама команда существует в коллекции команд формы.
// В ПриСозданииНаСервере форма создается с нуля, поэтому обычно проверка
// на существование команды не требуется, но для общего понимания ее можно добавить.
Перем НоваяКоманда;
Если ЭтаФорма.Команды.Найти("ВыбратьМакет_Команда") = Неопределено Тогда
НоваяКоманда = ЭтаФорма.Команды.Добавить("ВыбратьМакет_Команда");
НоваяКоманда.Заголовок = "Выбрать макет"; // Текст, который увидит пользователь
НоваяКоманда.Действие = "ВыбратьМакет_ОбработчикКоманды"; // Имя процедуры-обработчика
НоваяКоманда.Пометка = Истина; // Команда активна по умолчанию
// НоваяКоманда.Картинка = БиблиотекаКартинок.ВыбратьМакетОтчета; // Добавляем иконку для красоты
СообщитьНаКлиенте("Команда 'ВыбратьМакет_Команда' успешно создана.");
Иначе
НоваяКоманда = ЭтаФорма.Команды.Найти("ВыбратьМакет_Команда");
СообщитьНаКлиенте("Команда 'ВыбратьМакет_Команда' уже существует.");
КонецЕсли;
// *****************************************************************
// *** 2. Создание элемента формы - кнопки и ее привязка к команде ***
// *****************************************************************
// Теперь, когда мы уверены, что команда существует, мы можем создать кнопку
// и привязать ее к нашей команде без ошибки "Недопустимое значение".
Перем Кнопка;
Если Элементы.Найти("ВыбратьМакет") = Неопределено Тогда
Кнопка = Элементы.Добавить("ВыбратьМакет", Тип("КнопкаФормы"), Элементы.ОсновнаяКоманднаяПанель);
Кнопка.Вид = ВидКнопкиФормы.КнопкаКоманднойПанели;
Кнопка.ИмяКоманды = "ВыбратьМакет_Команда"; // Привязываем к созданной выше команде
// Кнопка.Заголовок = "Выбрать Макет"; // Можно переопределить заголовок кнопки, если нужно
СообщитьНаКлиенте("Кнопка 'ВыбратьМакет' успешно создана и привязана к команде.");
Иначе
Кнопка = Элементы.Найти("ВыбратьМакет");
СообщитьНаКлиенте("Кнопка 'ВыбратьМакет' уже существует.");
КонецЕсли;
// ************************************************************
// *** 3. Дальнейшая логика по сбору макетов отчета СКД ***
// ************************************************************
// Этот блок кода был в исходном вопросе и отвечает за инициализацию макетов отчета.
// Предполагаем, что "Отчет" - это основной реквизит формы, связанный с объектом отчета.
ОтчетОбъект = РеквизитФормыВЗначение("Отчет");
// "СписокСхем" - это, предположительно, реквизит формы типа СписокЗначений,
// который будет использоваться для хранения доступных макетов.
// Если этот реквизит еще не добавлен в форму, добавим его программно.
Если ЭтаФорма.Реквизиты.Найти("СписокСхем") = Неопределено Тогда
ЭтаФорма.ДобавитьРеквизит("СписокСхем", Тип("СписокЗначений"), "Отчет"); // 'Отчет' - это группа или владелец реквизита
СообщитьНаКлиенте("Реквизит 'СписокСхем' успешно добавлен в форму.");
КонецЕсли;
СписокСхем.Очистить(); // Очищаем список перед заполнением
СообщитьНаКлиенте("Начинаем поиск макетов отчета...");
Для Каждого Макет из ОтчетОбъект.Метаданные().Макеты Цикл
Если Макет.ТипМакета = Метаданные.СвойстваОбъектов.ТипМакета.СхемаКомпоновкиДанных Тогда
СписокСхем.Добавить(Макет.Имя, Макет.Синоним);
СообщитьНаКлиенте("Найден макет СКД: " + Макет.Синоним + " (" + Макет.Имя + ")");
КонецЕсли;
КонецЦикла;
Если СписокСхем.Количество() = 0 Тогда
СообщитьНаКлиенте("В отчете не найдено макетов типа 'СхемаКомпоновкиДанных'.", СтатусСообщения.Важное);
// Если макетов нет, кнопка выбора макетов становится бесполезной.
// Мы можем сделать ее недоступной или даже невидимой.
Кнопка.Доступность = Ложь;
Кнопка.Видимость = Ложь; // Скрываем кнопку, если нет макетов для выбора.
// Если отсутствие макетов критично для работы отчета, можно установить Отказ = Истина;
// Отказ = Истина;
Возврат; // Завершаем процедуру
Иначе
СообщитьНаКлиенте("Найдено " + СписокСхем.Количество() + " макетов СКД.");
КонецЕсли;
// Выберем первый из найденных макетов в качестве "начального" или макета по умолчанию.
// "ВыбратьМакетЗавершениеНаСервере" - это предполагаемая процедура, которая устанавливает
// выбранный макет в компоновщик настроек отчета.
ВыбратьМакетЗавершениеНаСервере(Новый Структура("Значение, Представление", СписокСхем[0].Значение, СписокСхем[0].Представление));
СообщитьНаКлиенте("Начальный макет установлен: " + СписокСхем[0].Представление);
КонецПроцедуры
И соответствующий обработчик команды, который будет вызываться при нажатии на динамически созданную кнопку:
&НаКлиенте
Процедура ВыбратьМакет_ОбработчикКоманды(Команда)
// Эта процедура будет отвечать за логику выбора макета отчета.
// Она вызывается, когда пользователь нажимает кнопку "Выбрать макет".
Сообщить("Была нажата кнопка 'Выбрать макет'. Переходим к выбору макета...");
// Здесь мы можем реализовать логику открытия формы для выбора макета.
// Например, можно использовать стандартные механизмы 1С для выбора из списка значений,
// или открыть специализированную форму, которую мы сами разработали.
// Пример: Открытие формы выбора из реквизита СписокСхем.
// Предполагаем, что СписокСхем доступен на клиенте (если это реквизит формы).
// Можно создать новую форму, которая принимает СписокСхем как параметр.
// ПараметрыВыбора = Новый Структура("СписокВыбора", СписокСхем);
// ОткрытьФорму("ОбщаяФорма.ФормаВыбораИзСписка", ПараметрыВыбора, ЭтаФорма);
// В данном упрощенном примере мы просто сообщим о нажатии.
// Реальная логика может включать вызов серверной процедуры для получения актуальных данных,
// открытие диалога для выбора из списка или открытие полноценной формы выбора.
// Например, можно вызвать серверную процедуру для обновления текущего макета:
// ТекущийВыбранныйМакет = ВыбратьМакетИзСпискаНаКлиенте(СписокСхем); // Функция на клиенте для выбора
// Если ТекущийВыбранныйМакет <> Неопределено Тогда
// ВыбратьМакетЗавершениеНаСервере(ТекущийВыбранныйМакет);
// КонецЕсли;
КонецПроцедуры
// Вспомогательная процедура, которая будет устанавливать выбранный макет в компоновщик.
// Она объявлена на сервере, так как работает с ОтчетОбъект и его настройками.
&НаСервере
Процедура ВыбратьМакетЗавершениеНаСервере(ПараметрыМакета)
// Здесь мы выполняем реальные действия по установке выбранного макета
// в компоновщик настроек отчета.
Если ПараметрыМакета = Неопределено Тогда
СообщитьНаКлиенте("Ошибка: Макет для выбора не был передан.", СтатусСообщения.Ошибка);
Возврат;
КонецЕсли;
ОтчетОбъект = РеквизитФормыВЗначение("Отчет");
// Получаем сам макет по имени.
МакетСКД = ОтчетОбъект.ПолучитьМакет(ПараметрыМакета.Значение);
Если МакетСКД = Неопределено Тогда
СообщитьНаКлиенте("Не удалось найти макет с именем: " + ПараметрыМакета.Значение, СтатусСообщения.Ошибка);
Возврат;
КонецЕсли;
// Устанавливаем настройки компоновщика данных из выбранного макета.
// Обычно это делается путем загрузки настроек из макета, который является СхемойКомпоновкиДанных.
ОтчетОбъект.КомпоновщикНастроек.ЗагрузитьНастройки(МакетСКД.ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных"));
// Или, если макет содержит только схему:
// ОтчетОбъект.КомпоновщикНастроек.Инициализировать(МакетСКД);
СообщитьНаКлиенте("Макет отчета успешно изменен на: " + ПараметрыМакета.Представление);
// После изменения макета часто требуется переформировать отчет.
// Например, вызвать процедуру формирования отчета:
// СформироватьОтчет();
КонецПроцедуры
Обратите внимание, что мы добавили проверки на существование команды и элемента перед их добавлением. Хотя в процедуре ПриСозданииНаСервере это обычно не требуется (так как форма создается "с чистого листа"), такие проверки могут быть полезны в других контекстах динамического изменения формы. Также мы убедились, что реквизит СписокСхем добавляется, если его нет, чтобы избежать ошибок инициализации.
Для создания устойчивых и функциональных решений мы должны учитывать несколько важных аспектов, помимо базовой последовательности действий:
&НаКлиенте и &НаСервере. Критически важно помнить, что динамическое создание элементов формы и команд, а также их первоначальная настройка (например, присвоение ИмяКоманды), должно происходить в серверном контексте, чаще всего в процедуре ПриСозданииНаСервере. Обработчики команд могут быть как клиентскими, так и серверными, в зависимости от выполняемой логики. При необходимости клиентский обработчик всегда может вызвать серверную процедуру для доступа к серверным данным или функционалу.
"ВыбратьМакет_Команда") должны быть уникальными в пределах коллекции ЭтаФорма.Команды. Аналогично, имена элементов формы (например, "ВыбратьМакет") должны быть уникальными в пределах коллекции Элементы формы. Повторное добавление команды или элемента с тем же именем вызовет ошибку. Если вы хотите, чтобы элемент или команда были доступны только при определенных условиях, используйте их свойства Видимость и Доступность вместо попыток добавить их повторно.
Если СписокСхем.Количество() = 0). В таких случаях важно предусмотреть альтернативное поведение:
Кнопка.Доступность = Ложь;) или невидимой (Кнопка.Видимость = Ложь;).СообщитьНаКлиенте(...);).Отказ = Истина; в ПриСозданииНаСервере, чтобы предотвратить открытие формы отчета.Отчет ссылается на объект внешнего отчета или на объект встроенного отчета (например, ОтчетОбъект). Именно из этого объекта мы получаем метаданные отчета и доступ к его макетам. Важно, чтобы этот реквизит был корректно инициализирован.
ЭтаФорма.Команды до того, как любая кнопка попытается привязаться к ней через свойство ИмяКоманды. Нарушение этого порядка всегда будет приводить к ошибке "Недопустимое значение".
Картинка, Подсказка, Пометка (флажок активности команды, если применяется), Видимость, Доступность. Эти свойства могут значительно улучшить пользовательский интерфейс и сделать работу с отчетом более интуитивно понятной. Не забывайте использовать системные библиотеки картинок для единообразного и современного внешнего вида.
Следуя этим рекомендациям и соблюдая описанную последовательность действий, вы сможете успешно создавать динамические элементы управления и привязывать их к командам формы без возникновения ошибок "Недопустимое значение". Мы видим, что глубокое понимание механики работы управляемых форм 1С является ключом к разработке стабильных, функциональных и удобных решений.