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

Другое · 7 мин

Как добавить команду «Создать на основании» в 1С

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

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

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

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

Подготовка и выбор объекта конфигурации

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

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

Где добавляется команда: форма списка или форма документа

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

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

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

Открывают нужную форму, переходят к командам формы и добавляют новую команду. Указывают имя, например «СоздатьНаОсновании», представление для пользователя и место размещения: командная панель, контекстное меню или обе области. Важно задать параметр команды, если форма должна получить ссылку на исходный документ.

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

Свойство «Доступность» определяет, видна ли команда в текущем контексте. Можно оставить команду всегда доступной или ограничить её появлением только при выделенной строке в списке. Неверное условие доступности — частая причина того, что кнопка не отображается.

Обработчик команды и заполнение нового объекта

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

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

Проверка прав, доступности и безопасные изменения

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

Типичные ошибки
01
Команда добавлена на форму документа вместо формы списка, поэтому не видна в контексте выбора исходного объекта.
02
Обработчик не получает ссылку на выделенную строку, поэтому новый объект создаётся пустым.
03
Автоматическое проведение нового документа без проверки пользователем может привести к некорректным движениям.

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

Частые ошибки и признаки рабочей команды

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

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

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

Команда видна в списке
Норма

Кнопка отображается при выделенной строке

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

Кнопка скрыта или неактивна

Новый объект открывается
Норма

Форма создаваемого документа открывается

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

При нажатии нет реакции или ошибка

Реквизиты перенесены
Норма

Контрагент, дата, суммы и строки заполнены

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

Новый объект пустой или заполнен неверно

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

Итог перед проверкой

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

Итог

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

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

Нужно ли создавать команду отдельно для каждого документа?

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

Работает ли команда в веб-клиенте?

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

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

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

Что делать, если команда исчезает после обновления конфигурации?

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

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

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