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

Другое · 6 мин

Параметризуемые команды в 1С 8.3: добавление, параметры и выполнение

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

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

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

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

Где параметризуемая команда применима

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

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

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

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

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

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

Передача параметра при выполнении команды

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

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

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

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

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

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

Частые ошибки и безопасные действия

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

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

Итог

Итог

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

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

Нужно ли программировать добавление параметризуемой команды?

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

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

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

Что делать, если команда не видит переданный параметр?

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

Сохраняется ли значение параметра после закрытия формы?

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

Можно ли использовать параметризуемую команду в отчёте?

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