При разработке внешних обработок для систем на базе 1С:Предприятие 8.3, использующих Библиотеку стандартных подсистем (БСП), программисты часто сталкиваются с досадной ситуацией. После регистрации обработки в справочнике Дополнительные отчеты и обработки, вместо ожидаемого красивого названия кнопки в интерфейсе документа (например, "Загрузка данных") появляется странная техническая строка вида ПодменюЗаполнитьСмТакже_7С4F4.... Это сбивает с толку пользователей и заставляет разработчика искать ошибку в стандартном коде формирования сведений об обработке.
В этой статье мы подробно проанализируем, почему механизм БСП подставляет дефолтные значения вместо заданных представлений, разберем типичные ошибки в функции СведенияОВнешнейОбработке и выясним, как «чистота» программного кода влияет на конечный интерфейс.
Для начала рассмотрим ситуацию, в которой оказывается система. Когда мы подключаем внешнюю обработку, платформа вызывает экспортную функцию СведенияОВнешнейОбработке в её модуле объекта. Результат этой функции — структура, которая содержит описание команд. Эти данные записываются в базу. В момент открытия формы документа (например, РаботаВВыходныеИПраздничныеДни) подсистема БСП динамически сканирует доступные команды и пытается отрисовать кнопки на форме.
Если в процессе чтения структуры команд система сталкивается с ошибкой, отсутствием данных или некорректным форматом строки представления, она не может оставить элемент формы без имени. В этом случае генерируется уникальный внутренний идентификатор, состоящий из префикса подменю и ГУИДа обработки. Это гарантирует, что кнопка физически будет создана и на нее можно будет нажать, даже если разработчик допустил ошибку в описании.
Как показывает практика и обсуждение на форумах, самой частой и незаметной причиной является копирование кода из веб-браузеров (с сайтов ИТС, форумов или из мессенджеров). При копировании в текст модуля часто попадают неразрывные пробелы (символ с кодом 160 вместо стандартного пробела с кодом 32) или невидимые управляющие символы.
Визуально код выглядит абсолютно правильным:
НоваяКоманда.Представление = "Загрузка работы в праздники и выходные";
Однако для парсера БСП наличие спецсимвола внутри строки может сделать её «нечитаемой» в контексте формирования интерфейса. Проанализируем ситуацию: автор темы исправил проблему простым перенабором текста вручную. Это подтверждает, что в исходном коде присутствовал «мусор», который блокировал корректную передачу синонима кнопки в метаданные подсистемы.
Другой важный момент — использование функции НСтр для локализации строк. Рассмотрим стандартный вызов:
НоваяКоманда.Представление = НСтр("Загрузка работы в праздники и выходные");
Выясним причину, почему это может не работать. Согласно стандартам разработки 1С, функция НСтр ожидает строку в формате КодЯзыка = 'Значение'. Если передать просто текст без указания кода языка (например, ru), в некоторых режимах совместимости или при определенных настройках основного языка конфигурации функция может вернуть пустую строку. А если поле Представление в структуре команд окажется пустым, БСП автоматически заменит его техническим идентификатором.
Правильный вариант написания:
НоваяКоманда.Представление = НСтр("ru = 'Загрузка работы в праздники и выходные'");
Иногда автоматическое создание структуры через ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке() может работать некорректно, если версия БСП в конфигурации значительно отличается от той, под которую писался код. Рассмотрим альтернативный, «ручной» способ инициализации таблицы команд, который гарантирует жесткое соответствие типов данных.
Разберем по шагам, как это реализовать:
// 1. Создаем таблицу значений с жесткой типизацией колонок
ТаблицаКоманд = Новый ТаблицаЗначений;
ТаблицаКоманд.Колонки.Добавить("Представление", Новый ОписаниеТипов("Строка"));
ТаблицаКоманд.Колонки.Добавить("Идентификатор", Новый ОписаниеТипов("Строка"));
ТаблицаКоманд.Колонки.Добавить("Использование", Новый ОписаниеТипов("Строка"));
ТаблицаКоманд.Колонки.Добавить("ПоказыватьОповещение", Новый ОписаниеТипов("Булево"));
ТаблицаКоманд.Колонки.Добавить("Модификатор", Новый ОписаниеТипов("Строка"));
// 2. Добавляем строку команды
НоваяКоманда = ТаблицаКоманд.Добавить();
НоваяКоманда.Представление = "Загрузка работы в праздники и выходные";
НоваяКоманда.Идентификатор = "ЗагрузкаРаботыВПраздникиИВыходные";
НоваяКоманда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыОткрытиеФормы();
НоваяКоманда.ПоказыватьОповещение = Ложь;
// 3. Вставляем таблицу в параметры регистрации
ПараметрыРегистрации.Вставить("Команды", ТаблицаКоманд);
Такой подход исключает ошибки интерпретации структуры данных на стороне сервера при регистрации обработки.
Даже если вы исправили код внутри обработки, при повторной загрузке файла в справочник «Дополнительные отчеты и обработки» изменения могут не отобразиться сразу. Это связано с кэшированием программных интерфейсов БСП. Чтобы принудительно обновить данные, рекомендуем придерживаться следующего алгоритма:
ПараметрыРегистрации всегда инкрементируйте поле Версия (например, с "1.0" на "1.0.1"). Система видит изменение версии и обновляет записи в своих внутренних регистрах./ClearCache, чтобы обновить кэшированные формы документов.Появление ГУИДа вместо названия кнопки — это не баг платформы, а защитный механизм БСП, сигнализирующий о том, что данные команды не были прочитаны корректно. Основными «виновниками» обычно выступают скрытые символы при копировании кода или неполный синтаксис функции НСтр. Внимательно проверяйте текст модуля, используйте явное определение колонок таблицы команд и всегда повышайте номер версии при внесении изменений в интерфейсную часть обработки.