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

Другое · 8 мин

Как создать команду в 1С

Как создать команду в 1С: где добавить команду, написать обработчик, вызвать серверный код, разместить на панели и проверить результат без ошибок.

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

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

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

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

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

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

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

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

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

Команда формыПривязана к форме

Проверяется наличие формы и контекста объекта

Общая командаДоступна в нескольких разделах

Проверяется размещение и права доступа

Обработчик отсутствуетКоманда создана, но не действует

Нужно написать процедуру выполнения

Написание обработчика команды

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

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

Вызов серверного кода и работа с данными

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

После выполнения команды верните пользователю понятный результат: сообщение об успехе, открытие созданной формы или отказ с объяснением причины. Молчаливая обработка без обратной связи затрудняет поиск ошибок и вызывает недоверие к системе.

Размещение команды в интерфейсе

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

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

Проверка результата и отладка

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

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

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

Типичные ошибки и ограничения

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

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

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

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

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

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

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

Видимость команды
Норма

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

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

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

Права доступа
Норма

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

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

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

Выполнение действия
Норма

Данные изменены, результат показан

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

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

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

Итог по созданию команды

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

Итог

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

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

Можно ли создать команду без написания кода?

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

Когда использовать клиентский, а когда серверный обработчик?

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

Почему команда не видна пользователю?

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

Как передать параметры в команду?

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

Какие ограничения есть при изменении конфигурации?

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