Как вывести связь документов в отчёт «Структура подчинённости» в УТ 11.3
Отчёт «Связанные документы» показывает цепочку документов, но новые объекты и новые связи в нём сами не появляются. В статье на примере заказа клиента и реализации показано, что нужно добавить в формы, модули менеджеров и критерий отбора, чтобы связь отображалась.
Настройка структуры подчинённости по шагам
Задача состоит в том, чтобы отобразить связь документов по какому-либо полю в стандартном отчете по структуре подчиненности, который вызывается по кнопке "Связанные документы" из командной панели самого документа:
А структура подчиненности выглядит таким образом:
Например, есть связь между документом ЗаказКлиента и документом РеализацияТоваровУслуг по соответствующему полю "ЗаказКлиента", и соответственно документ РеализацияТоваровУслуг создается на основании документа ЗаказКлиента. Покажем на их примере решение нашей задачи. Само собой, эти приведенные для примера документы являются типовыми для УТ 11.3, и в них уже есть все стандартные механизмы, поэтому я буду показывать решение задачи, будто мы их создали с нуля.
Необходимо проделать следующие действия:
1) На формах этих двух документов в их командных панелях создаем группу "ПодменюОтчеты" с видом "Подменю", а в этой группе добавляем еще три группы с видом "Группа кнопок" и называем их "ПодменюОтчетыВажное", "ПодменюОтчетыПерейти" и "ПодменюОтчетыСмТакже":
2) В модулях форм этих документов прописываем следующие куски кода:
В процедуре ПриСозданииНаСервере добавляем:
МенюОтчеты.ПриСозданииНаСервере(ЭтаФорма,Элементы.ПодменюОтчеты);После этого добавляем следующую процедуру:&НаКлиенте
Процедура Подключаемый_ВыполнитьКомандуОтчет(Команда)
МенюОтчетыКлиент.ВыполнитьПодключаемуюКомандуОтчет(Команда, ЭтаФорма, Объект);
КонецПроцедуры3) В модулях менеджера этих документов добавляем следующую процедуру:Процедура ДобавитьКомандыОтчетов(КомандыОтчетов) Экспорт
ВариантыОтчетовУТПереопределяемый.ДобавитьКомандуСтруктураПодчиненности(КомандыОтчетов);
КонецПроцедуры4) В дереве объектов конфигурации находим критерий отбора "СвязанныеДокументы". На вкладке "Данные" указываем наши документы. На вкладке "Состав" ищем документ РеализацияТоваровУслуг и отмечаем его поле для связи "ЗаказКлиента":
Актуальность для новых версий
Ключевая часть решения — состав критерия отбора СвязанныеДокументы — работает и в современных версиях: именно по нему отчёт находит связанные документы. Изменился способ вывода команды на форму: начиная с УТ 11.4 и в ERP 2.5 команды отчётов подключаются через подсистему БСП «Подключаемые команды» (ПодключаемыеКоманды.ПриСозданииНаСервере), а не через модули МенюОтчеты и МенюОтчетыКлиент.
Частые вопросы
Почему новый документ не попадает в структуру подчинённости?
Чаще всего документ не добавлен в критерий отбора «СвязанныеДокументы»: его нужно указать на вкладке «Данные», а на вкладке «Состав» отметить реквизит, по которому идёт связь.
Можно ли связать документы по реквизиту табличной части?
Да, в состав критерия отбора можно включить и реквизиты табличных частей документа, если их тип совпадает с типом критерия.
Обязательно ли создавать три группы в подменю отчётов?
Для механизма МенюОтчеты в УТ 11.3 — да: команды раскладываются по группам «Важное», «Перейти» и «См. также», и без них команда может не вывестись.