К статье
Практический материал

Другое · 7 мин

Как добавить общую команду на форму в 1С

Как добавить общую команду на форму в 1C: пошаговая настройка команд формы, проверка появления кнопки, ограничения и типичные ошибки.

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

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

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

Что нужно сделать перед добавлением команды

Убедитесь, что общая команда уже существует в дереве конфигурации под разделом общих команд. Если команды ещё нет, создайте её сначала, определите представление и модуль обработки, а только потом подключайте к форме. На форме должна быть открыта вкладка или раздел команд, где формируется состав доступных действий.

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

Общая команда есть в конфигурацииМожно подключить к форме

Проверьте ветку общих команд в конфигураторе

Команды формы открытыДоступно добавление команды

Откройте форму в конфигураторе и раздел команд формы

Конфигурация заблокирована или поддерживаетсяПрямая правка может быть ограничена

Используйте копию конфигурации или расширение, если это предусмотрено

Порядок добавления команды на форму

Откройте нужную форму в конфигураторе и перейдите к разделу команд формы. Выберите действие добавления команды и в свойствах укажите тип «Общая команда», затем выберите нужную команду из списка общих команд конфигурации. Настройте представление, картинку и другие доступные свойства, если они предлагаются интерфейсом.

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

Порядок действий
  1. 1
    Откройте форму в конфигураторе и раздел команд формы
  2. 2
    Добавьте команду и укажите тип «Общая команда»
  3. 3
    Выберите существующую общую команду из списка конфигурации
  4. 4
    Настройте представление и свойства отображения
  5. 5
    Сохраните конфигурацию и обновите базу
  6. 6
    Проверьте появление и работу команды в режиме предприятия

Права, видимость и условия отображения

Команда может быть добавлена на форму, но оставаться невидимой для пользователя из-за ограничений прав доступа или условий видимости. Проверьте, есть ли у роли пользователя право на выполнение команды, и не скрыта ли команда программно в зависимости от состояния объекта. Это частая причина, когда команда числится в конфигурации, но не появляется на форме.

Для управляемых форм важно также состояние командной панели и контекста открытого объекта. Некоторые команды доступны только при выборе строки, только для новых объектов или только в определённом режиме работы. Если команда исчезает в некоторых ситуациях, это может быть нормальным поведением, а не ошибкой добавления.

Частые ошибки при добавлении команд

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

Также часто проверяют команду от имени администратора и делают вывод о доступности для всех пользователей. Права могут отличаться, поэтому проверяйте под учётной записью с реальным набором ролей. Не пренебрегайте тестированием на копии базы: ошибка в обработке команды может привести к некорректным записям в регистрах или документах.

Типичные ошибки
01
Создание команды в модуле формы вместо использования общей команды — теряется переиспользование
02
Забыть сохранить конфигурацию и обновить базу — изменения не появляются в режиме предприятия
03
Проверять только от имени администратора — не отражает реальные права обычных пользователей

Как проверить, что команда работает корректно

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

Если команда отсутствует, вернитесь в конфигуратор и проверьте состав команд формы, тип команды, права пользователя и условия видимости. После внесения изменений снова сохраните конфигурацию, обновите базу и повторите проверку. Повторный цикл «сохранение — обновление — проверка» помогает отделить ошибку настройки от кэширования или прав доступа.

Контрольные точки

Как проверить результат

Команда видна на форме
Норма

Кнопка или пункт меню отображается в ожидаемом месте

Тревожный признак

Команда отсутствует или серая без причины

Выполнение команды
Норма

Действие выполняется без ошибок и даёт ожидаемый результат

Тревожный признак

Ошибка при выполнении или ничего не происходит

Доступ для обычного пользователя
Норма

Команда доступна под тестовым пользователем с нужными ролями

Тревожный признак

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

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

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

Итог

Что важно запомнить

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

Нужно ли создавать команду заново для каждой формы?

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

Почему команда добавлена, но не отображается на форме?

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

Можно ли редактировать общую команду напрямую в рабочей базе?

Не рекомендуется без резервной копии и проверки на отдельной базе. Прямые правки в поддерживаемой конфигурации могут привести к потере изменений при обновлении или к ошибкам в данных.

Чем команда формы отличается от общей команды?

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