gifts2017

Алгоритм построения печатных форм в 1С: Бухгалтерия предприятия КОРП

Опубликовал Марат Еникеев (maraton1185) в раздел Программирование - Практика программирования

В этой статье будет рассмотрен алгоритм построения печатных форм документов в типовой конфигурации 1С: Бухгалтерия предприятия КОРП. Целью является наглядно показать применяемый в типовой алгоритм, чтобы помочь начинающим программистам в добавлении новых печатных форм документов или изменении существующих.

Для того, что бы разобраться в коде типовых конфигураций, я, последнее время, стал часто использовать ментальные карты. Мне это помогает, надеюсь и Вам будет полезно) В качестве софта для построения ментальной карты, применяю достаточно распространённый xMind (www.xmind.net). Недавно наткнулся в сети на вот такой плагин к xMind - www.codeanalyzer.ru, который и подтолкнул к написанию этой статьи. 

Итак, сначала сформулируем задачу. Использовать будем типовую конфигурацию последнего, на день написания статьи, релиза 2.0.45.6. Откроем демонстрационную конфигурацию под бухгалтером. Откроем форму документа "Реализация товаров и услуг". Нам необходимо разобраться, как формируется меню "Печать", какие процедуры отвечают за непосредственную печать, как запоминается печатная форма по умолчанию и какие требования предъявляются к внешней печатной форме.

Постановка задачи

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

 

Посмотрим, что вызывается из ПередОткрытием().

 

Посмотрим на вызовы УстановитьКнопкиПечати(...)

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

Теперь объединим всё используемое в одно дерево:

Добавим процедуры, вызываемые из процедур-обработчиков действий:

Таким образом, что мы имеем? Перед открытием, после записи и при установке печати по умолчанию вызывается УстановитьКнопкиПечати(), которая вызывает ПолучитьДеревоМакетовПечати() и получает из неё что-то, что затем передает в УстановитьПодменюПечати(), УстановитьПечатьПоУмолчанию() и СформироватьПодменю(). Последние три процедуры отвечают за формирование меню на форме документа. Для кнопки печати по умолчанию используется действие на основании процедуры формы документа ОсновныеДействияФормыПечатьПоУмолчанию(). Посмотрим на ПолучитьДеревоМакетовПечати().

Видим, что её вызов происходит из практически всех документов конфигурации при вызове УстановитьКнопкиПечати(). А делает она следующее: 

ИнициализироватьДеревоДополнительныхКнопок() возвращает дерево значений, с колонками как на рисунке.

Далее начинается заполнение этого дерева. Сначала формами, переданными с помощью параметра-структуры, возвращаемого функцией модуля документа ПолучитьСтруктуруПечатныхФорм() (это ДобавитьВДеревоМакетовВстроенныеФормы(...)), затем внешними (с помощью ДобавитьВДеревоМакетовДополнительныеФормы(...)). Причём, в качестве действия для встроенных и внешних форм устанавливается действие из параметра, созданное на основании процедуры формы ОсновныеДействияФормыПечать(), а для установки печати по умолчанию - действие из параметра ДействиеУстановитьПечатьПоУмолчанию().  Далее происходит отметка строки печати по умолчанию и добавление в конец меню разделителся с кнопкой "По умолчанию...".  Анализ текста ДобавитьВДеревоМакетовДополнительныеФормы() говорит о том, что внешние печатные формы регистрируются в табличной части справочника ВнешниеОбработки - Принадлежность.

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

Теперь посмотрим на вызов печатной формы из ПечатьПоДополнительнойКнопке(). В конце процедуры видим, что ответ на вопрос "внешняя ли это печатная форма?" дается через проверку заполненности колонки "Расшифровка". И если внешняя, то вызываем НапечататьВнешнююФорму(), если же форма встроенная, то вызывается процедура модуля объекта "Печать()".

Посмотрим на НапечататьВнешнююФорму(...). Ответим на вопрос: какие поля содержит структура "Расшифровка"? Исходя из нашей схемы заполнение этой структуры должно происходить в вызове ДобавитьВДеревоМакетовДополнительныеФормы(...) (из ПолучитьДеревоМакетовПечати(...)). Действительно, в коде этой процедуры видим:

СтруктураРасшифровки = Новый Структура("СсылкаНаВнешнююОбработку, НомерСтроки, ДополнительныеПараметрыОбработки", ВыборкаСсылок.Ссылка, Выборка.НомерСтроки, Выборка.ДополнительныеПараметрыОбработки.Получить());

А в НапечататьВнешнююФорму() по номеру строки получаются двоичные данные внешней обработки, далее они записываются во временный файл и выполняется вызов метода обработки "Печать()".

Теперь обратим внимание на процедуру модуля документа "Печать()". Она по переданному имени макета вызывает процедуру, формирующую табличный документ, например "ПечатьДокумента()".

Таким образом, общая схема объектов может выглядеть вот так:

Из неё видно, что чтобы добавить новую встроенную печатную форму в документ, нужно: 

  1. В модуль документа добавить процедуру, возвращающую табличный документ;
  2. В процедуру модуля документа ПолучитьСтруктуруПечатныхФорм() добавить элемент структуры-результата. Ключом быдет идентификатор печатной формы, значеним - представление в списке печатных форм.
  3. В процедуру Печать() добавить условие, обрабатывающее идентификтор новой печатной формы.

Чтобы добавить внешнюю печатную форму, необходимо:

  1. Зарегистрировать внешнюю обработку в справочнике "ВнешниеОбработки", указав в табличной части "Принадлежность" объекты, к которым она будет относиться;
  2. Обеспечить наличие в добавляемой внешней обработке метода модуля обработки "Печать()".
На этом заканчиваю) Легкого кода Вам!)

См. также

Подписаться Добавить вознаграждение
Комментарии
1. _smile_ 25.03.13 17:09
Полезная статья. Все понятно и доступно написано.
Если бы еще такую же для например УТ11 или БП3.0, то было бы здорово.
2. Александр Шаров (Ta_Da) 26.03.13 10:37
Эм. Я может что-то в этой жизни упустил - а вот Ваши схемки в XMind с деревом процедур и функций, они ведь не вручную сделаны? Или есть какой-то более-менее штатный вариант загрузки/выгрузки?
3. maratenikeev (maraton1185) 26.03.13 10:59
Нет, не вручную, всё это автоматом формирует вот эта штука: http://www.codeanalyzer.ru/ + просмотр кода, иерархия вызовов, поиск. Я туда загрузил типовую и по ней писал эту статью. Есть некоторые не стыковки, но в целом плагин впечатлил.
4. Алексей Т. (CratosX) 26.03.13 14:08
(3) maratenikeev, free-версией, или pro? Нашел описание только скидки 30%, но сумму не увидел.

По существу - а чего на примере БП Корп, в обычной БП Проф аналогично же
5. maratenikeev (maraton1185) 26.03.13 14:38
(4) CratosX, суммы я то же не увидел, но делал с pro, так как при регистрации дается доступ на месяц.
Как я понял, они ещё не начали продажи pro, только скидки дают "к открытию".
А в КОРП, т.к. на работе такая стоит) Потом, у них на сайте такой же пример, только для старого релиза. Я решил убить сразу нескольких зайцев: опробывать плагин на пригодность, проверить его работу на последнем релизе конфы и сделать этот пример немного по-понятней для себя.
6. Эдуард Зелинский (VasMart) 27.03.13 17:43
(3) maratenikeev, зуп выгрузился нормально, а вот сегодняшние бухия и КОРП в том числе - вылетают на ОбщийМодуль.УправлениеОтчетами.Модуль.txt

Какой релиз корпа удалось загрузить или работали с "прошедшей" выгрузкой?
Прикрепленные файлы:
7. maratenikeev (maraton1185) 27.03.13 19:48
(6) VasMart, работал с 2.0.45.6, таких ошибок не было
8. Эдуард Зелинский (VasMart) 27.03.13 20:04
(7) maratenikeev, разработчики отвели чуть быстрее ) ошибку устранили.
9. Алексей Новиков (Новиков) 31.03.13 22:53
Статья опоздала на пару лет. А так да - хорошо описано.
10. Юрий Гуреев (Gureev) 18.07.13 09:35
В статье наиболее впечатлил инструментарий и подход к анализу.

Спасибо, взял на вооружение)
11. Сергей Кондратьев (serg0776) 14.11.13 09:44
ПолучитьСтруктуруПечатныхФорм() это в толстом клиенте (старые конфигурации), а как в тонком теперь, к примеру на УНФ?
12. Евгений Шабалин (xzorkiix) 21.05.14 10:57
Ни кто не знает, а Для 3.0 этого просто нет?