gifts2017

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

Опубликовал 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) 19.03.07 11:34
3. Poppy (poppy) 21.03.07 01:59
> а это статья для кого?

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

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

Может статейку на эту тему забацать?
7. Archangel (Archangel1) 26.06.08 22:23
>> Может статейку на эту тему забацать?
Не плохо бы? :)...
8. PavelAkaev (pavelakaev) 24.03.09 00:47
9. MasterSVS (MasterSVS) 09.04.09 16:43
10. Геннадий Долгих (FlyLink) 03.12.09 00:27
11. Павел Жданов (heavymetal) 30.07.10 15:20
Было бы не плохо описать еще ДополнительныеПараметры
12. Сергей Ожерельев (Поручик) 30.07.10 19:07
13. isn Игнатьев (isn) 09.03.11 14:11
Здравствуйте!
Подскажите никто не реализовывал как внешнюю печатную форму к документу на основе компновщика данных? Стандартный механизм создания не совсем подходит.
P.S. скорее всего я его не так "прикручиваю".
15. Александр Медведев (anig99) 09.03.11 16:41
(13) тебе нужен именно отчет вызвать или вывести результат в печатную форма?
результат СКД можно в таблицу значений выгрузить, можно макет нарисовать для СКД, можно вызвать и выполнить отчет программно.
16. Dmitry -- (Zerkon) 21.06.11 13:34
Применительно в 8.2 и стандартной УТ дополню: "ТабДокумент = Обработка.Печать()" находится в "ОбщийМодуль.УниверсальныеМеханизмы.НапечататьВнешнююФорму(Ссылка, ИсточникМакета) Экспорт", а временный файл создается, видимо, со случайным именем, так что гораздо проще сделать точку остановки на этой строки и просто по F11 перейти дальше. Система сама найдет и откроет этот файл. Стоит проверить в других конфигурациях, но там наверное такой же механизм...
17. Мижган Андреев (Mihandr) 21.06.11 13:43
Извините, что не в тему... не могу сегодня скачать нужную обработку, сегодня еще не скачивал, захожу на закладку файлы - ни чего не происходит, по нажатию на сам файл, открывается пустое окно в браузере, ОПЕРА 11.11, в чем может быт проблема?
18. Наталья Кошеварникова (Roby) 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) 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) 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) 17.08.12 14:57
35. Константин Балаев (Mamakan) 11.11.12 10:55
Хотя статья и написана давно, но только сейчас понадобился описанный функционал. Все понравилась, и материал пригодился на практике. Спасибо!
36. Андрей Штоколов (Alfer) 12.11.12 10:03
37. Юрий Погосов (kid_infostart) 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) 14.05.14 09:50
(40) Fr1eNd_Tver, По рисованию ВПФ у меня можете статью посмотреть)
43. Александр Шкут (alex_shkut) 20.08.15 08:57
В самом начале текста в строчке
2. В модуле обработки должна быть функция "Печать(); Экспорт;",
уберите точку с запятой перед Экспорт - это синтаксическая ошибка.