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

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

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

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

Как устроен механизм ввода на основании

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

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

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

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

1. 1
   Откройте конфигуратор и найдите документ, который должен создаваться (например, «СчетНаОплату») в ветке «Документы»
2. 2
   Откройте его свойства и на закладке «Вводится на основании» отметьте документ-основание (например, «ЗаказКлиента»)
3. 3
   Откройте модуль объекта документа и добавьте процедуру «ОбработкаЗаполнения» с переносом нужных реквизитов из параметра «ДанныеЗаполнения»
4. 4
   Обновите конфигурацию базы данных (F7) и проверьте, что команда появилась в форме документа-основания
5. 5
   Создайте тестовый документ на основании и проверьте заполнение реквизитов

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

Процедура ОбработкаЗаполнения(ДанныеЗаполнения, СтандартнаяОбработка)
	Если ТипЗнч(ДанныеЗаполнения) = Тип("ДокументСсылка.ЗаказКлиента") Тогда
		Контрагент = ДанныеЗаполнения.Контрагент;
		Организация = ДанныеЗаполнения.Организация;
		ДокументОснование = ДанныеЗаполнения;
	КонецЕсли;
КонецПроцедуры

Добавление через расширение конфигурации

Для типовых конфигураций (1С:ERP, «Управление торговлей», «Комплексная автоматизация») правильный путь — расширение. Оно не нарушает поддержку и не слетает при обновлении. Порядок такой: создайте расширение, добавьте в него собственный документ или заимствуйте существующий, настройте связь ввода на основании и дополните обработчик заполнения через аннотацию «&После» или «&Вместо».

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

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

Настройка заполнения реквизитов и табличных частей

Качество команды «Создать на основании» определяется тем, насколько полно заполняется новый документ. Минимум — шапка: организация, контрагент, договор, склад, валюта. Для торговых документов обычно требуется перенос табличной части «Товары» с количеством, ценами и ставками НДС.

Табличную часть заполняйте запросом к основанию: выберите нужные поля из табличной части документа-источника и загрузите результат в табличную часть нового документа методом «Загрузить». Если документов-оснований может быть несколько (например, одна реализация по нескольким заказам), логику усложняют: в типовых конфигурациях для этого используются специальные обработчики в общих модулях ввода на основании.

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

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

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

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

Самая частая проблема — команда появилась, но документ создаётся пустым. Причина почти всегда в том, что в «ОбработкаЗаполнения» не прописана ветка для нужного типа основания, либо процедура вообще не добавлена. Вторая по частоте ошибка — проверка типа «ДанныеЗаполнения» не совпадает с реальным типом: из формы списка может передаваться массив или структура, а не ссылка.

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

Альтернативы: когда ввод на основании не нужен

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

Частые вопросы