Вызвать команду печати документа 1с
Форма "ПечатьДокументов" предоставляет некоторые дополнительные функции при работе с печатными формами, такие как:
- кнопка печати на принтер, непосредственно в форме;
- указание количества копий, печатной формы;
- редактирование сформированной печатной формы;
- возможность сохранения печатной формы в различные форматы данных(Excel, Word, PDF и др.);
- отправка печатной формы по электронной почте;
- удобная работа с комплектом документов.
Эта форма сейчас используется фирмой 1С во всех типовых конфигурациях для вывода печатных форм документов и элементов справочников. И конечно же нам, при разработке своих печатных форм, чтобы не выходить за рамки принятой практики, следует так же выводить свои печатные формы используя предоставляемые инструменты.
При использовании стандартных методов добавления печатных форм подсистема "Печать" все сделает за нас и выведет печатную форму, как надо. Например:
- При добавлении команды печати в документ с использованием подсистемы "Печать", нам необходимо в процедуре ДобавитьКомандыПечати описать команду печати с указанием менеджера печати, в котором реализована прцоедура Печать;
- При создании Дополнительной обработки, нам необходимо, в модуле объекта обработки в функции СведенияОВнешнейОбработке, описать команду с типом использования Вызов серверного метода и тут же реализовать процедуру Печать, которая определенным образом реализует вызов формирования печатной формы.
- Когда печатная форма создается с изменение конфигурации;
- Когда печатная форма создается без изменения конфигурации, т.е. используетя подсистема "Дополнительные отчеты и обработки".
Создаем печатную форму добавляя её через конфигуратор.
Первый вариат. Через создание обработки с командой.
Этот вариант предусматривает, добавление обработки непосредственно в Объекты метаданных:
Рассмотрим вариант, когда нам необходимо реализовать печатную форму определенного объекта, например, элемента справочника. Для этого нам необходимо поработать в четырех местах обработки:
- Создать команду, которая будет вызывать форму нашей печатной формы;
- Создать саму форму;
- Создать макет печатной формы;
- Внести изменения в модуль менеджера обработки.
- Группу где хотим, чтобы команда отображалась в форме;
- Тип параметра, это как раз тот справочник или документ, печатную форму которого мы делаем;
- Режим использования параметра - Множественный. Чтобы можно было выводить печатных формы, сразу по нескольким выбранным в списке элементам.
- Менеджер печати - имя объекта в модуле менеджера, которого определена функция Печать, формирующая нашу печатную форму;
- Идентификатор - идентификатор печатной формы, которую необходимо напечатать. По этому идентификатору, мы будем в функции Печать модуля менеджера выбирать, какую печатную форму необходимо напечатать;
- Объекты печати - это непосредтвенно те объекты для которых формируются печатные формы;
- Владелец формы;
- Параметры печати - сюда мы формируем и передаем структуру с параметрами печати, тут же мы передаем наши дополнительные параметры, которые мы запросили у пользователя в форме обработки.
Второй вариант. Через реализацию команды печати.
Этот вариант, очень похож на первый по реализации печати. Отличие его в способе создания команды, которая будет выводиться в интерфейс и запускать нашу печать.
В этом случае при определении команды печати мы так же задействуем подсистему "Печать" из БСП. Вместо того, чтобы определять команду для открытия обработки в самой обработке, нам необходимо перейти в модуль менеджера, того объекта, в который мы хотим добавить печатную форму, и задать описание команды печати в процедуре ДобавитьКомандыПечати(КомандыПечати):
Здесь мы добавляем на все формы справочника(напоминаю, что мы работаем со справочником контрагенты), команду печати с названием "Печать печатной формы". И вот здесь главный момент, который надо учесть. На форму можно добавить два вида команд:
1. Вызов процедуры Печать из модуля менеджера;
2. Вызов клиентского метода.
Вот именно вызов клиентского метода нам и нужен. Клиентский метод позволит нам вызвать форму обработки, в которой мы перед печатью запросим у пользователя необходимые нам данные.
Чтобы реализовать такой вызов, необходимо при определении команды, задать для неё Обработчик(см. код выше). В Обработчик команды передается строка, содержащая путь к клиентской функции, т.е. путь к Экспортной функции общего модуля на клиенте. Именно эта функция будет вызвана, при нажатии на команду печати, которую мы добавляем на формы.
Как вы понимаете, чтобы это все заработало, необходимо создать этот самый ОбщийМодуль и определить Экспортную функцию. Поэтому пишем в нашем общем модуле следующий код:
Здесь мы делаем тоже самое, что и при первой реализации, открываем форму печатной формы, только теперь наши ДанныеДляПечати, будут содержаться в параметре переданном функции ПараметрыПечати, а точнее в его поле ОбъектыПечати.
После того, как мы открыли форму обработки, все действия аналогичны первому варианту.
Реализацию подобного варианта можно найти в типовых конфигурациях, в механизмах связанных с печатью согласия на обработку персональных данных.
Создаем дополнительную обработку.
В этом случае нам необходимо воспользоватья подсистемой "Дополнительные отчеты и обработки" из БСП.
При таком варианте решения, нам необходимо писать код, только в двух местах и все они находятся в нашей будущей дополнительной обработке:
1. Модуль объекта обработки;
2. Модуль формы обработки.
В модуле объекта пишем следующий код:
Здесь две функции и одна процедура.
Стандартная функция для Дополнительной обработки СведенияОВнешнейОбработке(), без неё система не поймет, что это дополнительная обработка. Здесь важным моментом является, указание того, что команда реализуемая в данной обработке имеет тип Открытие формы. Т.е. мы будем открывать форму, как нам и нужно. Дальше следует определение процедуры Печать и функции, которая непосредственно формирует наш табличный документ.
Тут нужно обратить внимание на то, что команда печать в этом случае должна содержать только 4 параметра, а не 5 как это при привычном определение команды печати в модуле менеджера. В данном случае отсутвует параметр для передачи Параметров печати. Поэтому нам придетя проявить изобретательность, чтобы передать помимо самих объектов, для которых формируется печатная форма, но так же и параметры которые мы запрашиваем у пользователя в форме.
И так мы определили дополнительную обработку, команда из которой будет открывать форму обработк. Поэтому следующим шагом создаем форму обработки.
В этой форме нам необходимо создать три реквизита для сохранения значений, которые нам понадобятся в дальнейшем. Назовем эти реквизиты следующим образом:
ДополнительнаяОбработкаСсылка - тип СправочникСсылка.ДополнительныеОтчетыИОбработки
ИдентификаторКоманды - тип Строка
ОбъектыНазначения - тип СписокЗначений
В модуле этой формы пишем следующий код:
В процедуре ПриСозданииНаСервере, заполняем наши три реквизита, которые мы создали для хранения параметров передаваемых в форму обработки.
Дальше определяем обработчик кнопки печать на форме. В этом обработчике нам необходимо самим открыть форму "Печать документов", для этого необходимо подготовить ПараметрыОткрытия определенной структуры. В этой структуре, как минимум должны быть определены два поля:
ИсточникДанных - ссылка на нашу дополнительную обработку в справочнике Дополнительных обработок и отчетов. Этот параметр мы сохранили из параметров формы, при создании на сервере;
ПараметрыИсточника, которые включают в себя ИдентификаторКоманды и ОбъектыНазначения:
ИдентификаторКоманды - так же сохранили при создании на сервере, это идентификатор, той команды, которая вызвала форму нашей обработки. Поэтому идентификатору, мы будем определять, что нам необходимо печатать в процедуре Печать в модуле объекта.
ОбъектыНазначения - именно в этом поле нам необходимо передать массив объектов, для которых формируется печатная форма, а так же параметры, запрашиваемые у пользователя в форме.
Как я определяю объекты назначения, можно увидеть в функции ПолучитьОбъектыНазначенияИПараметрыПечати. Здесь я копирую наши объекты назначения из реквизита формы, на место элемента массива с индексом 0, я вставляю наши параметры печати.
В дальнейшем массив определенный таким образом будет передан из формы "Печать документов", в качестве первого параметра процедуры Печать модуля объекта, которую мы определили ранее.
Если вернуться к определению модуля объекта обработки и посмотреть на функцию НапечататьМакет, в первых трех строках функции можно увидеть, как я вытаскиваю из переданных данных в процедуру Печать наши параметры и объекты и дальше с ними работаю.
Такие манипуляции с параметром ОбъектыНазначения, обусловленны спецификой вызова процедуры Печать модуля объекта. Вы можете сами отследить, как передаются параметры и выполняются вызовы функций, открыв модуль формы ПечатьДокументов.
Результат.
В итоге таких манипуляций, мы получим три команды на форме, из которой мы хотим выводить печатную форму:
Нумерация команд, соответствует порядку вариантов реализации.
Все эти команды будут выполнять одинаковые действия:
Показывать форму запроса дополнительных параметров
Выводить в форму "Печать документов" сформированные печатные форм . Как раз то, чего мы и добивались:
(0) Модуль менеджера относится "ко всем объектам данного вида".
Модуль объекта к "конкретному объекту".
УТ 11 написана на БСП и для печати комплекта документов (печатных форм) надо вызывать экспортную процедуру общего модуля (УправлениеПечатьюУТКлиент.ПечатьКомплектаДокументовСНастройкой(ОписаниеКоманды)), а при записи 1С ругается, говорит, что "Переменная не определена (УправлениеПечатьюУТКлиент) (Проверка: Сервер)". Хотя после точки (УправлениеПечатьюУТКлиент.) сама подсказывает нужные процедуры и функции общего модуля. Странно.
"Переменная не определена (УправлениеПечатьюУТКлиент) (Проверка: Сервер)"
Просто никогда с БСП до этого не работал, но надо же когда-то начинать.
Дело в том, что в УТ 11 есть такой документ - "Задание на перевозку". В нем есть ТЧ Распоряжения - как правило, там либо заказы клиентов, либо реализации (те, которые без заказов). Так вот, нам надо добавить в меню Печать пунктик "Комплект документов с настройкой. ", но на печать надо выводить печатные формы из реализаций. То есть получается так, что сначала я получаю список реализаций (по заказам, или без заказов - по заказам я их, естественно, получаю запросом), а потом по каждой реализации запускаю стандартную процедуру печати документов с настройкой. Вроде все просто.
В модуле менеджера документа "Задание на перевозка" есть стандартная процедура ДобавитьКомандыПечати. В ней можно дописать такой код:
(p.s. Кстати, странно, почему это в типовой заложено и работает, ведь менеджер объекта работает на сервере, а общий модуль УправлениеПечатьюУТКлиент - клиентский. Но работает).
Естественно, мне пишут, что "печать комплекта документов для Задания на перевозку не поддерживается". Но мне и не нужно печатать комплект для этого документа, мне нужно печатать его для связанных с ним реализаций.
Делаю вот что. Создаю новый модуль ДополнительныйМодульКлиент (клиентский), подменяю в процедуре ДобавитьКомандыПечати стандартный обработчик на новый (из нового модуля, ДополнительныйМодульКлиент.ПечатьКомплектаДокументовСМНастройкой), а в нем собираюсь получить список реализаций и вызвать стандартную функцию (УправлениеПечатьюУТКлиент.ПечатьКомплектаДокументовСМНастройкой).
Но тут нужен запрос, а модуль-то клиентский!
Делаю еще один общий модуль - ДополнительныйМодульСервер (серверный), чтобы вызвать его из модуля ДополнительныйМодульКлиент (кдиентский) и вернуть результат обратно. Но клиентский общий модуль не видит модуля серверного.
Совсем запутался и прошу помощи ). Может быть, подскажете, что я деляю не так? Или кто-то уже с этим сталкивался?
Немного добавлю для пояснения.
В процедуре УправлениеПечатьюУТКлиент.ПечатьКомплектаДокументовСМНастройкой стоят такие строки:
Пробую установить на общем модуле обе галки - клиент и сервер - и разместить все в одном модуле.
Но процедура, которая &НаКлиенте не видит функцию, которая &НаСервере.
В предыдущей статье мы научились выводить табличный документ на печать, применяя при этом команду формы, что, согласитесь, может быть неудобно: мы не можем распечатать документ из списка, мы не можем распечатать несколько документов из того же списка документов, если это нужно. Поэтому, в этой статье я покажу, как реализовать более универсальную возможность печати табличного документа, используя команду объекта. Для этого мы создадим подчиненную нужному объекту команду, при выполнении которой будет показываться один или несколько табличных документов.
С тем, как был создан макет табличного документа (его мы и будем использовать), можете ознакомиться в этой статье:
А как было реализовано заполнение табличного документа, и осуществлен простой способ его вывода можете ознакомиться в этой статье:
И так, создадим подчиненную нашему документу команду печати.
После выполнения команды Добавить контекстного меню, будет создана подчиненная документу команда, открыт модуль этой команды, и справа откроется окно палитры свойств вновь созданной команды.
Назовем новую команду ПечатьНакладной.
Следующим шагом, нам нужно выбрать группу, в которой эта команда будет отображаться. Поскольку команду должна быть доступна на управляемой форме (или в форме документа, или в форме списка), то и группу нужно выбрать, связанную с формой. Поэтому выберем группу «Командная панель формы. Важное», если мы так сделаем, то кнопка команды печати будет отображаться в командной панели управляемой формы.
Теперь, необходимо выбрать тип параметра, который будет передан в команду при её выполнении. Мы выберем ссылку на документ, которому эта команда подчинена.
На этом мы закончим настройку свойств команды и перейдем к основной разработке: получению данных документов и заполнение табличного документа этими данными.
Делать всю эту работу мы будет в модуле менеджера документа. В принципе, всю эту работу можно было сделать и в модуле команды, но мы сделаем в модуле менеджера, чтобы потенциально этот код можно было применять и в других случаях. В модуле команды мы будем просто выводить табличный документ на просмотр. Поэтому откроем модуль менеджера документа.
В этом модуле напишем экспортную функцию, в которую в качестве параметров будет передан массив документов (как мы его будем получать, разберем ниже).
В этой функции первым делом создадим программно табличный документ 1С и получим макет, который был создан ранее в статье.
О том как этот макет сделан, читайте здесь: Создание макета табличного документа в 1С 8.3
Теперь я сделаю иерархический запрос, в котором в верхнем уровне иерархии будут документы, на детальном уровне данные из табличной части.
Если всё нормально, то мы выводим шапку документа и таблицы, как мы это делали в предыдущей статье.
Нам осталось получить выборку табличной части документа, обойти её и заполнить соответствующую область.
Получим и выведем подвал, а также выведем горизонтальный разделитель таблиц, чтобы каждый документ печатался на отдельном листе.
Закончим работать с циклом и вернем табличный документ, если он заполнился (для проверки этого факта, я создал переменную, которой присваиваю истина, если табличный документ заполняется данными).
На этом мы закончим работать с функцией в менеджере модуля. Она в целом будет иметь следующий вид.
Откроем модуль команды, которую мы создали ранее.
В этом модуле уже будет существовать обработка команды в клиентском контексте, которая была образована при создании команды.
Обратите внимание на параметр ПараметрКоманды, в этом параметре и содержится массив документов. Это именно массив, потому что при создании команды мы в свойстве команды «Режим использования данных» указали Множественный. Именно этот массив мы и передадим в функцию, которую создали в модуле менеджера объекта.
Создадим в модуле команды функцию в серверном контексте, которая будет обращаться к ранее созданной функции из модуля менеджера документа и возвращать табличный документ. А если документ заполнен, то выведем его на просмотр.
Теперь мы можем распечатать сразу несколько документов из формы списка документов.
Для распечатывания нескольких документов, необходимо выделить мышкой нужные документы и выполнить команду печати.
Если Вы всё еще «плаваете» в конструкциях языка запросов, и у Вас вызывают трудности даже самые простые запросы, то рекомендую вам мой курс «Запросы в 1С от новичка до профи». Где эти и многие другие вопросы рассматриваются более подробно.
В чем особенность этого курса:
• Курс рассчитан на тех, кто не знаком с языком запросов в 1С;
• Учебный материал грамотно скомпонован и прост в освоении;
• Несколько десятков уроков;
• Полезные практические примеры;
• Все уроки изложены понятным и простым языком
Для моих читателей, купон на скидку 25%: hrW0rl9Nnx
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
- Очень доступный и понятный язык изложения
- Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
- Поймете идеологию управляемого приложения 1С
- Узнаете, как разрабатывать управляемое приложение;
- Научитесь разрабатывать управляемые формы 1С;
- Сможете работать с основными и нужными элементами управляемых форм
- Программирование под управляемым приложением станет понятным
Вступайте в мои группы:
One thought on “ Вывод на печать табличного документа в 1С 8.3. Используем команды объектов ”
Спасибо большое, очень помогло в разработке печати своего документа в УНФ.
И так, сам макет документа мы уже создали, как это сделано, вы можете узнать в соответствующей статье.
Сейчас мы получим ранее созданный макет, заполним табличный документ 1С по этому макету, и нам останется вывести табличный документе 1С на просмотр для последующей печати.
Мы сделаем упрощенный (учебный) вариант: формирование всего нашего табличного документа будет осуществляться на модуле управляемой формы. Для этого мы на форме документа создадим команду «ПечатьДокумента», которую разместим в командной панели формы.
Для команды ПечатьДокумента создадим два обработчика в клиентском и серверном контексте.
Серверный обработчик переименуем в функцию, в нем мы создадим программно табличный документ 1С, который она и будет возвращать.
Теперь нужно получить макет, созданный в предыдущей статье, для этого мы будем использовать метод менеджера документа ПолучитьМакет.
Имейте в виду, что метод ПолучитьМакет напрямую доступен только или в модуле документа, или в модуле менеджера документа. Еще этот метод можно применить, используя менеджер конкретного объекта, как я сделал выше. Непосредственно на форме его использовать нельзя!
Алгоритм заполнения табличного документа будет следующим: мы будем получать нужную область макета, если необходимо заполнять эту область какими-нибудь данными, а потом выводить полученную область в табличный документ.
Напомню, что макет у нас имеет четыре области: Шапка, ШапкаТаблицы, СтрокаТаблицы, Подвал. Области Шапка, ШапкаТаблицы и Подвал будут выведены в табличный документ всего один раз, а область СтрокаТаблицы будет выведена столько раз, сколько строк в табличной части обрабатываемого документа.
Весь код ниже я выполняю между кодом получения макета и возвратом табличного документа.
Получим самую первую область макета, при помощи метода ПолучитьОбласть, где в качестве параметра следует указать название получаемой области.
В этой области мы используем шаблон, в котором имеются два параметра: НомерДок и ДатаДок передадим номер документа и дату документа в соответствующие параметры области, используя свойство Параметры нужной нам области. Данное свойство содержит коллекцию параметров табличного документа, и мы можем обращаться к нужному параметру через оператор «.».
Мы закончили с областью Шапка, и нам нужно вывести её в табличный документ, делается это при помощи метода Вывести табличного документа, где в качестве параметра указывается выводимая область.
Точно также получим область, которая соответствует шапке таблицы, заполнять его не нужно, а мы просто выведем его сразу же в табличный документ.
Следующим шагом выведем область СтрокаТаблицы, причем эта область должна быть выведена столько раз, сколько строк в табличной части документа. Поэтому мы сначала получим эту область, а потом циклом будем обходить табличную часть, заполнять параметры области и выводить область в табличный документ.
В коде выше, мы обошли табличную часть документа, обратившись к ней через основной реквизит Объект управляемой формы (основной формы документа).
Обратите внимание, я использовал метод Заполнить, потому что названия параметров макета совпадают с названиями реквизитов табличной части документа.
Нам осталось получить область Подвал и вывести её в табличный документ.
На этом мы закончим работать с функцией на сервере, весь ее код будет выглядеть следующим образом.
Нам осталось доделать клиентскую процедуру ПечатьДокумента: мы будем выводить на просмотр полученный табличный документ при помощи метода табличного документа Показать().
В качестве первого параметра метода Показать, я указал название, которое выйдет на форме табличного документа.
Проверим, как работает наш код.
Напомню, что я рассмотрел самый простой (учебный) пример вывода печатной формы, следующие примеры будут более приближенные к реальным.
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
Читайте также: