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

Другое · 7 мин

Добавление общей команды на форму в 1С 8.3

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

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

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

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

Где создаются общие команды

В конфигураторе общие команды находятся в разделе общих объектов, обычно в ветке «Команды» или «Общие команды». Там описывается имя команды, синоним, обработчик и параметры. Команда не привязана к конкретной форме на этапе создания, что и делает её общей.

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

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

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

Как добавить команду на форму

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

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

Свойства команды на командной панели

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

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

Сравнение вариантов клиентов

Толстый клиент

Полное отображение команд, подходит для разработки и отладки.

Тонкий клиент

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

Веб-клиент

Доступ через браузер, требует проверки совместимости интерфейса.

Различия между толстым, тонким и веб-клиентом

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

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

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

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

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

Кнопка отображается и подписана

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

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

Команда доступна для нажатия
Норма

Выполнение действия начинается

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

Кнопка неактивна или не реагирует

Обработчик отрабатывает
Норма

Ожидаемый результат получен

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

Ошибка выполнения или отсутствие реакции

Проверка результата и частые ошибки

Проверьте, что кнопка появляется на панели, активна в нужных состояниях и вызывает ожидаемое действие. Попробуйте выполнить команду при разных правах пользователя и при заполненных и пустых данных, чтобы выявить скрытые условия недоступности.

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

Типичные ошибки
01
Ссылка на общую команду отсутствует или битая, кнопка не работает
02
Правки внесены в рабочую базу без резервной копии
03
Проверка проведена только в одном клиенте

Ограничения и безопасные работы

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

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

Маршрут решения

Как выбрать действие

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

Альтернативы и когда команда не нужна

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

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

Итог

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

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

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

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

Что делать, если команда не отображается на форме?

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

Можно ли редактировать общую команду в защищенной конфигурации?

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

Нужно ли проверять команду в веб-клиенте?

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