Инструкция по настройке создания документов на основании

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

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

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

Анализ объекта-источника и целевого документа

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

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

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

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

Регистрация действия в системе действий 1С

Техническая реализация начинается с регистрации нового действия в системе. В платформе 1С за механизм «Создать на основании» отвечает объект метаданных «Действие» (Action). Именно здесь прописывается логика перехода от одного документа к другому. Откройте конфигуратор и найдите ветку «Действия» в дереве метаданных.

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

• 📂 Укажите объект-источник: выберите документ, из которого будет производиться создание (например, «ЗаказКлиента»).
• 📄 Укажите объект-результат: выберите документ, который будет создаваться (например, «РеализацияТоваровУслуг»).
• ⚙️ Определите модуль объекта или общий модуль, где будет размещен код обработки.

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

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

Программная реализация процедуры создания

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

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

Процедура СозданиеНаОсновании(ОбъектИсточник, ОбъектРезультат, Параметры)

// Перенос шапки документа
ОбъектРезультат.Контрагент = ОбъектИсточник.Контрагент;
ОбъектРезультат.Организация = ОбъектИсточник.Организация;
ОбъектРезультат.Дата = Параметры.ДатаНовогоДокумента;

// Очистка табличной части перед заполнением
ОбъектРезультат.Товары.Очистить();

// Перенос товаров
Для каждого СтрокаИсточника из ОбъектИсточник.Товары Цикл
НоваяСтрока = ОбъектРезультат.Товары.Добавить();
НоваяСтрока.Номенклатура = СтрокаИсточника.Номенклатура;
НоваяСтрока.Количество = СтрокаИсточника.Количество;
НоваяСтрока.Цена = СтрокаИсточника.Цена;
КонецЦикла;

КонецПроцедуры

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

Как обработать ошибки в процессе создания?

Если в процессе выполнения процедуры возникнет ошибка (например, деление на ноль или неверный тип), документ не создастся, и пользователь увидит сообщение об ошибке. Рекомендуется оборачивать критические участки кода в конструкцию «Попытка...Исключение», чтобы перехватывать ошибки и выводить понятные сообщения пользователю, предлагая исправить данные в источнике.

Настройка форматов и печатных форм

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

Вы можете указать, какая именно печатная форма должна открываться по умолчанию. Например, при создании «Счета на оплату» на основании «Заказа» логично сразу показать макет счета. Для этого используется свойство действия, отвечающее за вывод печатной формы, или вызов метода Печать() в конце процедуры создания.

Тип документа	Рекомендуемая печатная форма	Дополнительное действие
Заказ клиента	Счет на оплату	Отправка по Email
Поступление товаров	Торг-12 / УПД	Проведение документа
Производственный заказ	Требование-накладная	Резервирование товаров
Акт выполненных работ	Акт КС-2	Создание счета-фактуры

Также стоит предусмотреть возможность выбора пользователем варианта печати, если их несколько. Стандартный интерфейс 1С позволяет выводить список доступных макетов. Убедитесь, что все необходимые макеты созданы и доступны в системе. Печатные формы должны соответствовать актуальным требованиям законодательства и внутренним стандартам компании.

⚠️ Внимание: Интерфейс и доступные настройки печати могут различаться в разных версиях платформы 1С и в разных конфигурациях (Бухгалтерия, Управление Торговлей, ЗУП). Всегда проверяйте доступность макетов в той базе, где производится настройка.

Обработка табличных частей и фильтрация данных

Часто возникает ситуация, когда в документ-источник введено больше товаров, чем нужно перенести в новый документ. Например, в заказе клиент указал 10 позиций, но отгрузить нужно только 5. Механизм создания на основании должен позволять пользователю выбрать нужные строки для переноса.

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

• ✅ Реализуйте возможность изменения количества: пользователь может захотеть отгрузить не все 100 штук, а только 50.
• 🔄 Предусмотрите замену номенклатуры: если товара нет в наличии, менеджер может заменить его на аналог прямо в процессе создания.
• 🚫 Исключайте пустые строки: код должен игнорировать строки с нулевым количеством, чтобы не засорять новый документ.

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

Тестирование и отладка сценариев использования

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

Обратите внимание на проведение документов. Если целевой документ должен проводиться автоматически при создании, убедитесь, что все необходимые для проведения данные заполнены корректно. Ошибки проведения часто возникают из-за отсутствия цен, ставок НДС или некорректных счетов учета.

⚠️ Внимание: Никогда не тестируйте новые механизмы создания документов напрямую в рабочей базе в рабочее время. Ошибки в коде могут привести к порче данных или блокировке работы пользователей. Используйте изолированную тестовую среду.

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

Частые ошибки и способы их устранения

В процессе настройки разработчики часто сталкиваются с типовыми проблемами. Одна из самых распространенных — ошибка типов данных. Если в источнике реквизит имеет тип СправочникСсылка.Номенклатура, а в приемнике ожидается СправочникСсылка.Товары (даже если это один и тот же справочник, но с разными именами в метаданных), присваивание вызовет ошибку.

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

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

Что делать, если кнопка «Создать на основании» неактивна?

Проверьте права доступа пользователя к действию и к целевому документу. Убедитесь, что документ-источник проведен (если это требуется по логике) и не помечен на удаление. Также проверьте, зарегистрировано ли действие в системе и привязано ли оно к форме.

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

Да, это возможно. Для этого нужно либо запускать процедуру создания несколько раз с разными параметрами отбора, либо реализовать специальный механизм «Распределения», который разбивает строки источника на несколько новых документов по заданному правилу (например, по складам).

Как обновить механизм в типовой конфигурации?

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

Влияет ли создание на основании на движение регистров?

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

Где хранится история связей между документами?

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