bdd2

Внешние печатные формы в восьмерке

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

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

Статья является началом цикла статей и разработок:
Внешние печатные формы в восьмерке http://infostart.ru/blogs/157
Обработка для тестирования внешних печатных форм в восьмерке http://infostart.ru/projects/833/
Использование встроенного почтового клиента - http://infostart.ru/blogs/161/
Документ с печатью и подписью - http://infostart.ru/blogs/162/
Внешние печатные формы в восьмерке II - http://infostart.ru/blogs/324/
Заполнение табличных частей документов в восьмерке (внешние обработки) http://infostart.ru/blogs/345/
Обработка для тестирования внешних обработок изменения табличных частей http://infostart.ru/projects/1749/
Использование свойств объектов при доработке типовых конфигураций http://infostart.ru/blogs/692/
Создание новой или изменение старой печатной формы документа является одним из наиболее распространенных требований заказчика при внедрении типовых конфигураций. Внесение изменений непосредственно в типовую конфигурацию существенно увеличивает стоимость ее сопровождения, в частности при переходе на новые релизы. Использование внешних печатных форм помогает решить указанные затруднения.

Внешние печатные формы поддерживаются почти всеми типовыми конфигурациями. Однако в различных конфигурациях реализация рассматриваемой технологии может отличаться. Например, в БП имеется возможность "подменить" внутреннюю форму внешней. В УТ такой возможности нет. Требования типовых конфигураций к внутренней организации внешней обработки, реализующих печатную форму, у всех типовых конфигураций одинаковые.

Итак, печатная форма – это внешняя обработка, у которой должно быть:

1. Реквизит "СсылкаНаОбъект" типа ДокументСсылка неопределенного или определенного вида;

2. В модуле обработки должна быть функция "Печать(); Экспорт;", у которой имеется ключевое слово "Экспорт". Результатом выполнения функции должен быть табличный документ или значение "Неопределено".

3. Необязательно. Макет с идентификатором "Параметры_Авторегистрации" в первом столбце которого в каждой строчке можно указать объекты, для которых предназначена печатная форма. Например, "Документы.ЗаказПокупателя".

Если будет возвращен табличный документ, то с ним будут выполнены штатные действия средствами конфигурации (например, будет показан пользователю для дальнейшей печати). Частный случай, где используется значение "Неопределено", будет описан в другой статье. Кроме подготовки печатных форм описанная технология может применяться для других целей. Мною создавались обработки по изменению табличной части документа (в частности, пересчет НДС для устранения ошибок округления, группировка строк с одинаковой номенклатурой и др.).

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

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

Например:

"ВЫБРАТЬ * |ИЗ
|	Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг
|ГДЕ
|	РеализацияТоваровУслуг.Ссылка = &ТекущийДокумент";


или

"ВЫБРАТЬ * |ИЗ
|	Документ.РеализацияТоваровУслуг.Товары 
|		КАК РеализацияТоваровУслуг
|ГДЕ
|	РеализацияТоваровУслуг.Ссылка = &ТекущийДокумент";


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

Для обхода сложившейся ситуации можно предложить следующее. Точку останова необходимо установить в модуле документа на строке ТабДокумент = Обработка.Печать();, после чего в конфигураторе открыть файл PrnForm.tmp и уже в нем установить точку на требуемое место.

В качестве бонуса предлагаю обработку http://infostart.ru/public/14686/ , с помощью которой можно облегчить процесс тестирования кода. В обработке указываем экземпляр документа для тестирования и имя файла внешней обработки. После чего, тестируем код как обычный модуль.

З.Ы. Недавно столкнулась с такой ситуацией. Опытные специалисты по семерке пытались внести простые изменения в печатные формы, в частности удалить отдельные заполняемые поля. После удаления поля из макета они получали синтаксическую ошибку времени выполнения. Для устранения ошибки достаточно удалить строку кода, в которой происходит назначение параметра макета. Например, если нет необходимости печатать должность руководителя, нужно удалить соответствующую строку ОбластьМакетаПодвал.Параметры.ДолжностьРуководителя = Руководители.РуководительДолжность;. Если назначение параметра происходит с помощью метода Заполнить(), например, ОбластьМакетаШапка.Параметры.Заполнить(Шапка);, то никаких ошибок не возникает и исправлять код не требуется.

См. также

Добавить вознаграждение
Комментарии
1. Сhe Burashka (CheBurator) 18.03.07 23:12 Сейчас в теме
а это статья для кого?
для начинающих восьмерочников?
2. Андрей Смирнов (Asmir) 118 19.03.07 11:34 Сейчас в теме
3. Poppy (poppy) 3293 21.03.07 01:59 Сейчас в теме
> а это статья для кого?

ИМХО для начинаюх и развивающихся. ;) Эксперты справятся с задачей без нее.

Планирую, что это начало цикла статей про печатные формы.
4. Ананист 20.04.07 11:31 Сейчас в теме
5. Ольга (Sova123) 7 21.11.07 11:22 Сейчас в теме
автор а как внуртренню печатную форму сохранить во внешнюю?
6. Poppy (poppy) 3293 01.12.07 18:33 Сейчас в теме
(5)
В двух словах не объяснишь...
Нужно перенести используемый макет и процедуру из конфигурации во внешнюю обработку. В процедуре заменить ЭтотОбъект.Ссылка на СсылкаНаОбъект.
Далее - затачивать напильником.

Может статейку на эту тему забацать?
7. Archangel (Archangel1) 26.06.08 22:23 Сейчас в теме
>> Может статейку на эту тему забацать?
Не плохо бы? :)...
8. PavelAkaev (pavelakaev) 95 24.03.09 00:47 Сейчас в теме
9. MasterSVS (MasterSVS) 54 09.04.09 16:43 Сейчас в теме
10. Геннадий Долгих (FlyLink) 03.12.09 00:27 Сейчас в теме
11. Павел Жданов (heavymetal) 86 30.07.10 15:20 Сейчас в теме
Было бы не плохо описать еще ДополнительныеПараметры
12. Сергей Ожерельев (Поручик) 3443 30.07.10 19:07 Сейчас в теме
13. isn Игнатьев (isn) 11 09.03.11 14:11 Сейчас в теме
Здравствуйте!
Подскажите никто не реализовывал как внешнюю печатную форму к документу на основе компновщика данных? Стандартный механизм создания не совсем подходит.
P.S. скорее всего я его не так "прикручиваю".
14. Ийон Тихий (cool.vlad4) 41 09.03.11 15:02 Сейчас в теме
15. Александр Медведев (anig99) 2470 09.03.11 16:41 Сейчас в теме
(13) тебе нужен именно отчет вызвать или вывести результат в печатную форма?
результат СКД можно в таблицу значений выгрузить, можно макет нарисовать для СКД, можно вызвать и выполнить отчет программно.
16. Dmitry -- (Zerkon) 95 21.06.11 13:34 Сейчас в теме
Применительно в 8.2 и стандартной УТ дополню: "ТабДокумент = Обработка.Печать()" находится в "ОбщийМодуль.УниверсальныеМеханизмы.НапечататьВнешнююФорму(Ссылка, ИсточникМакета) Экспорт", а временный файл создается, видимо, со случайным именем, так что гораздо проще сделать точку остановки на этой строки и просто по F11 перейти дальше. Система сама найдет и откроет этот файл. Стоит проверить в других конфигурациях, но там наверное такой же механизм...
17. Мижган Андреев (Mihandr) 24 21.06.11 13:43 Сейчас в теме
Извините, что не в тему... не могу сегодня скачать нужную обработку, сегодня еще не скачивал, захожу на закладку файлы - ни чего не происходит, по нажатию на сам файл, открывается пустое окно в браузере, ОПЕРА 11.11, в чем может быт проблема?
18. Наталья Кошеварникова (Roby) 30 17.09.11 14:48 Сейчас в теме
Прочитала все статьи, очень полезно не только для начинающих, но и таких как я, которые пишут от случая к случаю, и поэтому нет хорошего понимания, что и как делать. А также очень пригодилась обработка для тестирования, а то раньше как слепой котенок мучаешься и не знаешь в чем ошибка и как ее выявить, и из-за этого написание внешних п/ф и обработок занимало уйму времени
19. tvv (pmtvv) 09.10.11 14:59 Сейчас в теме
статья понравилась, спасибо
20. Alexey Pak (Alexey55) 27.10.11 14:17 Сейчас в теме
Спасибо!
Статья пригодилась
21. Vladimir (Boroda) 90 19.11.11 16:13 Сейчас в теме
Хотя статья и написана давно, но натолкнулся на неё только недавно. Очень понравилась, и материал пригодился на практике. Спасибо!
22. Тамара Горбачева (GTV) 23.11.11 08:10 Сейчас в теме
Спасибо, для таких как я - начинающих, очень ценно!
23. Эллина (Linery24) 25.11.11 11:34 Сейчас в теме
24. Сергей Бибиков (Serg_17) 23.12.11 04:57 Сейчас в теме
Спасибо, статья просто и понятно объясняет как. практически полезна.
25. Харьков Харьков (xaker1C) 23.12.11 05:09 Сейчас в теме
Спасибо .Очень полезная статья
26. Гость 27.12.11 21:10 Сейчас в теме
Спасибо. Коротко и по делу. И полезно будет не только начинающим, но и тем кто считает, что уже умеет. Потому как порой скачаешь некоторые творения ради экономии времени, так волосы дыбом встают от "оригинальности" решений.
27. Андрей Дегтярев (dagovich) 13.01.12 13:38 Сейчас в теме
КА 1.1.15.1
Внешняя счета-фактуры выдает ошибку:


{ВнешняяОбработка.SchetFakture.МодульОбъекта(668)}: Ошибка при вызове метода контекста (ПредставлениеСерий)
Строчка.ТоварНаименование = СокрЛП(ВыборкаСтрокТовары.ТоварНаименование) + ФормированиеПечатныхФормСервер.ПредставлениеСерий(ВыборкаСтрокТовары);
по причине:
Попытка передачи с клиента на сервер мутабельного значения 1-го параметра метода ПредставлениеСерий ().
29. Денис Зубарев (MeaTDeN) 8 19.01.12 17:11 Сейчас в теме
Побольше бы таких статей для начинающих программистов, а то сложно по научным книжкам изучать программирование на 1С.
30. Олег Иванов (oleg_ss) 22.01.12 13:03 Сейчас в теме
Еще раз Спасибо!
Для начинающих все доходчиво и понятно.
31. Илья Кабышев (BAPPKAH) 01.02.12 23:09 Сейчас в теме
Спасибо!
Статья пригодилась
32. Olga Gabuza (OLga_gab) 02.02.12 02:24 Сейчас в теме
Прочитала статью, очень полезно для начинающих, таких как я, которые пишут от случая к случаю, и поэтому нет хорошего понимания, что и как делать. А также очень пригодилась обработка для тестирования, а то раньше как слепой котенок мучаешься и не знаешь в чем ошибка и как ее выявить, и из-за этого написание внешних п/ф и обработок занимало уйму времени.
33. элла иванова (2011b11) 20.04.12 09:04 Сейчас в теме
Cпасибо Вам за обработку.
Для начинающих все доходчиво и понятно.
34. Наталья Ожигина (Nathaly) 41 17.08.12 14:57 Сейчас в теме
35. Константин Балаев (Mamakan) 9 11.11.12 10:55 Сейчас в теме
Хотя статья и написана давно, но только сейчас понадобился описанный функционал. Все понравилась, и материал пригодился на практике. Спасибо!
36. Андрей Штоколов (Alfer) 12.11.12 10:03 Сейчас в теме
37. Юрий Погосов (kid_infostart) 1 12.11.12 12:00 Сейчас в теме
38. Андрей - (Motor24) 07.11.13 14:57 Сейчас в теме
Откопал буквально только что. Огромное спасибо за столь лаконичное и ёмкое изложение!
39. Aleck Zgonnik (0614) 29.03.14 14:53 Сейчас в теме
40. Anton Chikov (Fr1eNd_Tver) 31.03.14 11:18 Сейчас в теме
а для 8.2 и 8.3 есть описание, хотелось бы освежить в памяти.
41. Cветлана Яковлева (svetlana-a-s) 14.05.14 06:40 Сейчас в теме
42. Елена Пименова (Bukaska) 118 14.05.14 09:50 Сейчас в теме
(40) Fr1eNd_Tver, По рисованию ВПФ у меня можете статью посмотреть)
43. Александр Шкут (alex_shkut) 36 20.08.15 08:57 Сейчас в теме
В самом начале текста в строчке
2. В модуле обработки должна быть функция "Печать(); Экспорт;",
уберите точку с запятой перед Экспорт - это синтаксическая ошибка.