Другое · 7 мин
Как обратиться к общей команде в 1С
Практическая статья о вызове общих команд в 1С: где искать команду, как добавить на форму, права доступа, проверка результата и типичные ошибки.
Общие команды в 1С создаются в ветке конфигурации и предназначены для вызова из разных частей информационной базы. Они не привязаны к одному документу или справочнику, поэтому могут быть доступны из нескольких форм, отчётов или обработок. Чтобы обратиться к такой команде, нужно сначала убедиться, что она существует в текущей конфигурации и имеет уникальное имя.
Вызов возможен как из пользовательского интерфейса, так и программно из модулей форм или общих модулей. При этом важно различать клиентское и серверное выполнение: некоторые команды работают только на клиенте, другие требуют серверного контекста. Неправильный выбор контекста чаще всего приводит к ошибке «Метод не найден» или к отсутствию команды в списке доступных.
Перед изменением конфигурации рекомендуется сделать резервную копию и проверить изменения на отдельной базе или копии рабочей информации. Неправильно настроенная общая команда может стать недоступной для пользователей или вызвать ошибки при открытии форм, поэтому исправления вносят осторожно и только после тестирования.
Где искать общие команды в конфигурации
В конфидаторе общие команды размещаются в отдельной ветке, обычно с названием «Общие команды». Там хранятся имена команд, синонимы, картинки и параметры, которые отображаются в интерфейсе. Если нужная команда не отображается, проверьте, что конфигурация открыта в режиме правки и объект не загружен только для чтения.
Имя команды используется для программного обращения, поэтому оно должно быть лаконичным и не содержать пробелов. Синоним предназначен для пользователей и может быть изменён без влияния на вызовы из кода. Если команда создаётся повторно с тем же именем, старая версия может быть заменена, что приведёт к потере связей с формами.
Как добавить команду на форму или панель
Чтобы пользователь мог запустить общую команду с экрана, её добавляют в командную панель формы, в меню действий или на панель команд списка. Для этого открывают форму в конфидаторе, переходят к свойствам командной панели и включают нужную команду из общего списка. После этого команда становится видимой в интерфейсе при открытии формы.
Если команда не появляется на панели, проверьте, не скрыта ли она условием видимости или ограничением прав доступа. Также убедитесь, что форма пересохранена и конфигурация обновлена. В клиентском приложении может потребоваться перезапуск сеанса, чтобы изменения вступили в силу.
Проверьте имя и синоним в конфидаторе
Откройте форму в режиме пользователя и проверьте панель действий
Проверьте профиль доступа и права на объект
Вызов команды из модуля
Обращение к общей команде из программного кода выполняется по её имени, но точный способ зависит от контекста: клиентский модуль формы, серверный модуль или общий модуль. В клиентском коде команда обычно доступна через интерфейс формы, в серверном — через соответствующий контекст выполнения. Если модуль не видит команду, проверьте, находится ли вызов в подходящей части приложения.
При программном вызове важно обработать возможные исключения: команда может быть недоступна из-за прав, закрытой формы или отсутствия текущего объекта. Рекомендуется проверять результат выполнения и записывать сообщение об ошибке в журнал регистрации, если команда используется в важных бизнес-процессах.
Права доступа и роли
Даже правильно созданная команда может быть недоступна пользователю, если у его роли нет прав на выполнение действия или на связанные объекты. Проверьте настройки профилей доступа, роли пользователя и ограничения по данным. Если команда открывает документ или справочник, пользователь должен иметь право на просмотр этого объекта.
При отсутствии прав команда может либо не отображаться в интерфейсе, либо выдавать сообщение о запрете при нажатии. В этом случае не стоит дублировать команду для каждого пользователя: достаточно скорректировать роли или права доступа, а затем проверить вход от тестового пользователя с нужным профилем.
- 1Откройте конфигурацию и найдите ветку «Общие команды»
- 2Проверьте имя команды, синоним и контекст выполнения
- 3Добавьте команду на командную панель нужной формы
- 4Настройте права доступа и роли пользователей
- 5Сохраните конфигурацию и обновите базу
- 6Проверьте вызов от имени тестового пользователя
Типичные ошибки при работе с общими командами
Одна из частых ошибок — попытка вызвать клиентскую команду из серверного модуля или наоборот. Это приводит к ошибкам выполнения, потому что контексты имеют разные возможности и наборы объектов. Перед вызовом уточните, где должна выполняться команда, и разместите код в соответствующем модуле.
Другая ошибка — использование неточного имени команды или опечатка в синониме. Программное обращение чувствительно к регистру и точному совпадению имени, а пользовательский интерфейс показывает синоним. Если команда не находится, сравните имя в коде с именем в конфигурации посимвольно.
Также часто забывают обновить конфигурацию после изменений. Новая команда может быть видна в конфидаторе, но отсутствовать в запущенной базе, пока не будет выполнено обновление и не перезапущен сеанс пользователей.
Как проверить результат
После настройки команды откройте соответствующую форму от имени пользователя с нужными правами и нажмите на команду. Ожидаемый результат — открытие формы, выполнение отчёта или запуск обработки без сообщений об ошибке. Если команда не реагирует, посмотрите журнал регистрации и сообщения системы о причинах отказа.
Также проверьте, что команда доступна только тем ролям, для которых она предназначена. Попробуйте войти от пользователя без прав и убедитесь, что команда либо скрыта, либо корректно сообщает об ограничении. Это поможет избежать ситуаций, когда ограниченный пользователь видит недоступное действие.
Что важно запомнить
Общая команда ищется в специальной ветке конфигурации, добавляется на форму, проверяется по правам и контексту, а все изменения тестируются на копии базы.
Можно ли вызывать общую команду из любого модуля?
Не из любого. Нужно учитывать, клиентская команда или серверная, и размещать код в соответствующем модуле формы или общего модуля. В противном случае возникнет ошибка выполнения или команда не будет видна.
Что делать, если команда не отображается на форме?
Проверьте, добавлена ли команда на командную панель формы, сохранена ли конфигурация и обновлена ли база. Также убедитесь, что у пользователя есть права на команду и на связанные с ней объекты.
Нужно ли перезапускать 1С после изменений?
Часто требуется обновить конфигурацию и перезапустить сеанс пользователя, чтобы изменения в командных панелях и правах вступили в силу. Без этого новая команда может остаться невидимой в запущенном приложении.
Безопасно ли редактировать общие команды в рабочей базе?
Не рекомендуется без резервной копии и предварительного тестирования на копии базы. Ошибка в общей команде может затронуть несколько форм и пользователей одновременно.
Как отличить имя команды от синонима?
Имя используется в коде и должно быть точным, без пробелов. Синоним отображается пользователю в интерфейсе и может быть изменён без влияния на программные вызовы.