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

Другое · 9 мин

Команда в 1С: что это, где используется и как настраивается

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

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

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

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

Что представляет собой команда в 1С

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

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

Где встречаются команды и как они выглядят

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

Внешний вид команды настраивается через свойства: заголовок, подсказка, картинка, галочки «Видимо» и «Доступно». Если команда помечена как невидимая, пользователь её не увидит. Если недоступна, команда может быть серая и неактивная. Эти признаки помогают быстро понять, почему ожидаемое действие отсутствует на экране.

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

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

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

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

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

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

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

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

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

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

Нажатие запускает действие
Норма

Открывается форма, документ проводится или отчёт формируется

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

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

Данные после команды корректны
Норма

Значения в документах и регистрах соответствуют ожидаемым

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

Данные изменились неверно или пропали

Создание и настройка команды

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

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

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

Проверка результата и ограничения

После создания команды нужно проверить, что она появляется там, где ожидалось, и реагирует на нажатие. Если команда открывает форму, форма должна отобразиться с правильными данными. Если команда проводит документ, документ должен получить статус «Проведен» без ошибок. Если команда вызывает расчёт, результат должен совпадать с ожидаемым значением.

Ограничения команды связаны с правами доступа, режимом блокировки данных и местом выполнения. Серверные команды требуют подключения к серверу 1С:Предприятие и могут работать медленнее при большом объёме данных. Клиентские команды зависят от рабочей станции пользователя. Некоторые команды недоступны в веб-клиенте или мобильном приложении, что нужно учитывать при проектировании.

Типичные ошибки и риски

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

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

Сравнение вариантов Actions

Команда на форме

Подходит для частых действий пользователя прямо в интерфейсе; требует прав доступа и тестирования

Внешняя обработка

Удобна для разовых задач без изменения основной конфигурации; менее интегрирована в интерфейс

Регламентное задание

Выполняется по расписанию без участия пользователя; не подходит для интерактивных действий

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

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

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

Итог

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

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

Часто задаваемые вопросы

Можно ли удалить встроенную команду 1С?

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

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

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

Где выполняется команда: на клиенте или сервере?

Место выполнения зависит от настройки команды и кода обработчика. Клиентские команды работают на рабочей станции пользователя, серверные — на сервере 1С:Предприятие. Некоторые операции, связанные с доступом к базам и массовыми записями, целесообразнее выполнять на сервере.

Может ли команда повредить данные?

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

Нужно ли программирование для создания команды?

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

Чем команда отличается от отчёта?

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