← На главную

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

Давайте вместе, шаг за шагом, разберем все возможные причины и найдем решение. Мы проанализируем основные настройки команды, проверим интерфейс формы и рассмотрим более редкие случаи, которые могут влиять на видимость.

Шаг 1. Проверка основных свойств команды в конфигураторе

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

1. Свойство «Действие». Это одна из самых частых ошибок. Недостаточно просто создать в модуле объекта экспортную процедуру с именем, совпадающим с именем команды. Нужно явно указать платформе, какой код должен выполняться при нажатии на кнопку. В свойстве Действие должно быть указано имя процедуры-обработчика из модуля менеджера объекта. Если это поле пустое, платформа не знает, что делать с командой, и не будет ее отображать.
2. Свойство «Тип параметра команды». Этот параметр определяет, какие данные будут переданы в процедуру-обработчик при вызове команды. Если команда предназначена для работы с конкретным документом, то в качестве типа параметра должен быть указан тип ссылки на этот документ, например, ДокументСсылка.РеализацияТоваровУслуг. Неправильно указанный тип или его отсутствие может привести к тому, что команда не будет отображаться в формах, где контекст не соответствует этому типу.
3. Настройка прав (Роли). Проверьте, есть ли у пользователя, под которым вы тестируете, права на просмотр этой команды. Перейдите на вкладку «Права» в свойствах объекта конфигурации и убедитесь, что для нужных ролей установлен флажок напротив вашей команды, ведь грамотная настройка системы ролей — ключ к корректной работе интерфейса — быстро проверить настройки поможет анализ прав доступа по ролям и профилям пользователей.
4. Группа. Вы указали группу Командная панель формы.Важное. Это правильное действие, чтобы команда появилась на видном месте. Однако стоит убедиться, что в самой форме эта группа не скрыта и не переопределена.

Шаг 2. Настройка видимости в командном интерфейсе формы

Даже если команда в конфигурации настроена идеально, ее видимость на конкретной форме управляется отдельно. Для этого существует специальный редактор командного интерфейса, который мы сейчас и рассмотрим.

Разберем по шагам, как это проверить:

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

Важный момент: часто платформа при автоматическом построении формы может снимать этот флажок. Поэтому, если вы добавили новую команду к уже существующему документу, обязательно проверьте эту настройку. Установка этого флажка в большинстве случаев решает проблему.

Шаг 3. Анализ свойств самой формы и ее элементов

Помимо глобального командного интерфейса, существуют настройки, которые могут влиять на видимость команд уже на уровне элементов формы.

• Свойство формы «Состав команд». В палитре свойств самой формы (не элемента, а корневого узла «Форма») есть свойство Состав команд. Нажмите на кнопку с многоточием, чтобы открыть окно со списком всех доступных стандартных команд. Убедитесь, что флажок напротив вашей команды не снят.
• Свойство кнопки «ТолькоВоВсехДействиях». Если вы вручную вынесли команду на форму в виде кнопки, у этой кнопки есть свойство ТолькоВоВсехДействиях. Если для него установлено значение «Да», кнопка не будет видна на командной панели, а будет доступна только через подменю «Еще». Для отображения на панели установите значение «Нет» или «Авто».

Шаг 4. Дополнительные и неочевидные причины

Если предыдущие шаги не помогли, причина может быть более специфической. Рассмотрим несколько таких случаев.

• Пользовательские настройки. Пользователь мог самостоятельно скрыть команду через меню «Еще» → «Изменить форму» в режиме Предприятия. В этом случае в конфигураторе все будет выглядеть правильно. Чтобы это проверить, можно сбросить настройки формы для данного пользователя.
• Функциональные опции. Видимость команды может быть привязана к функциональной опции — быстро найти причину поможет детальный анализ прав, ролей и функциональных опций. Проверьте свойство Функциональные опции у самой команды в дереве конфигурации. Подробнее про использование функциональных опций для адаптации интерфейса можно прочитать в отдельном материале. Если там указана опция, убедитесь, что ее значение включено для текущего сеанса.
• Программное управление видимостью. Возможно, видимость команды управляется кодом. Программная работа с элементами формы — мощный инструмент, но он требует внимательности. Изучите модуль формы, особенно процедуры-обработчики событий ПриСозданииНаСервере и ПриЧтенииНаСервере — для поиска ошибок в коде подойдёт инструмент пошаговой отладки в режиме 1С:Предприятие. Поищите в коде строки, которые могут скрывать вашу команду.

  Посмотрим на пример, как это может выглядеть:

  Скопировать код

  
  Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
  
      Если НЕ КакоеТоУсловие Тогда
          // Скрываем команду, если условие не выполнено
          Элементы.ИмяВашейКоманды.Видимость = Ложь;
      КонецЕсли;
  
  КонецПроцедуры
  

  Убедитесь, что подобный код не мешает отображению вашей команды.

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

Пройдясь по всем этим пунктам, вы систематически проверите все возможные причины проблемы. В большинстве случаев ошибка кроется в пропущенном свойстве Действие или снятом флажке видимости в командном интерфейсе формы.