Внешняя печатная форма 1с с макетом документа Word
-

Внешняя печатная форма 1с с макетом документа Word

16
18600
12.02.2021 Игорь Торба

Содержание:

1.       Чек-лист разработки для создания внешней печатной формы

2.       Пример разработки в 1С 8.3 Зарплата и управление персоналом


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


Весь принцип реализации строиться на использовании расширения. Причем, добавлять в расширение объекты основной конфигурации практически не нужно. Это очень удобно для дальнейших обновлений конфигураций с расширениями. Возникает вопрос: «А при чем здесь внешняя печатная форма, ведь это расширение?». Дело в том, что расширение легко устанавливается в программу в пользовательском режиме. А если еще ее объекты обособленны от объектов основной конфигурации, то, я думаю, можно называть ее внешней.


Пожалуй, единственным ограничением является наличие в конфигурации Библиотеки стандартных подсистем (далее – БСП). Данный метод «активно» использует механизмы этой библиотеки, поэтому БСП должно быть интегрировано в конфигурацию информационной базы (далее – ИБ). Но здесь особо беспокоиться не нужно, т.к. БСП сейчас присутствует практически во всех типовых конфигурациях.


Перед тем как продемонстрировать пример разработки, предлагаю ознакомиться с чек-листом и представить общую последовательность действий.  


1. Чек-лист разработки для создания внешней печатной формы


1.Создать расширение в конфигурации ИБ

2.В расширении добавить новую обработку (далее Обработка)

3.Обработку включить в подсистему ПодключаемыеОтчетыИОбработки

4.Создать шаблон (документ в формате MS Word) с необходимым содержанием и установить параметры

5.В обработку добавить макет и загрузить в него файл шаблона, созданного в пункте 4

6.В обработку добавить форму и в модуле формы создать функцию:

·         ВыполнитьКомандуПечати – экспортная, пользовательская

7.В модуле менеджера обработки создать 3 процедуры и 4 функции:

·         ПриОпределенииНастроек - экспортная, предопределенная БСП

·         ДобавитьКомандыПечати - экспортная, предопределенная БСП

·         Печать - экспортная, предопределенная БСП

·         ПолучитьДанныеПечати - экспортная, предопределенная БСП

·         ПолучитьДанныеОбъекта – пользовательская

·         ОбластиМакетаОфисногоДокумента – пользовательская

·         НапечататьДокумент– пользовательская  


2. Пример разработки в 1С 8.3 Зарплата и управление персоналом


Давайте рассмотрим этот процесс на примере создания печатной формы дополнительного соглашения к трудовому договору в формате файла MS Word. В качестве информационной базы я буду использовать конфигурацию 1C 8.3 Зарплата и управление персоналом версии 3.1.14.183, установленную на платформе 1С:Предприятие 8.3 (8.3.17.1496). В данной конфигурации используется БСП версии 3.1.2.469.


1.Создаем расширение в конфигурации ИБ.


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


Расширение конфигурации в 1С 8.3 ЗУП

Рис. 1 Расширение конфигурации в 1С 8.3 Зарплата и управление персоналом


2.Добавляем в расширение новую обработку.


Делаем двойной клик по строке списка с нашим расширением и открываем конфигурацию расширения. В дереве конфигурации находим «Обработки» … выделяем … правая клавиша мышки … Добавить. Я назвал обработку «Расш1_ПечатьWord».


3. Включаем обработку в подсистему ПодключаемыеОтчетыИОбработки.


Для этого необходимо добавить в расширение подсистему ПодключаемыеОтчетыИОбработки из основной конфигурации. Переходим в окно основной конфигурации, находим подсистему ПодключаемыеОтчетыИОбработки в дереве, выделяем и через контекстное меню жмем команду «Добавить в расширение» (см. Рис.2)


Добавление в расширение в 1С 8.3 Зарплата и управление персоналом

Рис. 2 Добавление в расширение в 1С 8.3 Зарплата и управление персоналом


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


4.Создаем шаблон-документ Word с необходимым содержанием и параметрами.


На этом этапе берем шаблон доп. соглашения – документ в формате MS Word c расширением .docx, устанавливаем разделители областей вывода, а в местах, где необходимо подставить значения из базы 1С устанавливаем маркеры параметров.


Разделитель области предназначен для того, чтобы «именовать» части документа-шаблона для дальнейшего вывода средствами встроенного языка 1С. Разделители представляют собой пару - открывающий тэг {v8 Область.<Имя области>} в самом начале области документа и закрывающий тэг {/v8 Область.<Имя области>} в самом конце области документа.


В этом примере я не буду рассматривать ситуацию с выводом нескольких областей. В большинстве случаев это и не требуется. Например, для вывода не сложной формы дополнительного соглашения к трудовому договору достаточно весь документ поместить в одну область. Так ее и назовем «ВесьДокумент».


Маркеры параметров выполняют такую же роль, как и параметры стандартных печатных макетов, и имеют следующий формат {v8 <Имя параметра>}


Документ в формате MS Word

Рис. 3 Документ в формате MS Word


5. Добавляем в обработку макет и загружаем в него файл шаблона.


Добавляем в обработку макет. Тип макета – двоичные данные. Название должно начинаться с префикса ПФ_DOC_ Для этого примера я назвал его «ПФ_DOC_ДопСоглашение».


Далее кликаем по макету печатной формы и открывается форма с кнопкой «Загрузить из файла». Загружаем наш шаблон .docx, созданный ранее(пункт 4).


6. В обработку добавляем форму.


Теперь в нашей обработке «Расш1_ПечатьWord» создаем форму. Форма должна быть основной, поэтому при создании формы важно, чтобы флажок «Назначить форму основной» был установлен.


В модуль формы копируем функцию с Рис.4


 Команда печати в 1С 8.3 Зарплата и управление персоналом

Рис. 4 Функция модуля формы в 1С 8.3 Зарплата и управление персоналом

 

7. В модуле менеджера обработки создадим необходимые процедуры и функции.


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


7.1 ПриОпределенииНастроек


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


 Команда печати в 1С 8.3 Зарплата и управление персоналом

Рис. 5 Команда печати в 1С 8.3 Зарплата и управление персоналом


7.2 ДобавитьКомандыПечати


Данная процедура является предопределенной БСП поэтому название нужно сохранить. Здесь мы описывает команду, которая будет запускать печать нашей формы. Свойство МенеджерПечати определяет нахождение модуля менеджера где располагается процедура Печать. Свойство Обработчик определяет нахождение и название клиентского обработчика команды. В нашем случае он располагается на форме обработки.


печать в 1С 8.3 Зарплата и управление персоналом

Рис. 6 Добавление команды печати в 1С 8.3 Зарплата и управление персоналом


7.3 Печать


Данная процедура является предопределенной БСП поэтому название нужно сохранить. В переменную ИдентификаторКоманды и ИмяМенеджераПечати устанавливаем имя идентификатора и менеджера печати из процедуры ДобавитьКомандуПечати (пункт 7.2).


Процедура печати в 1С 8.3 Зарплата и управление персоналом

Рис. 7 Процедура печати в 1С 8.3 Зарплата и управление персоналом


7.4 ПолучитьДанныеПечати


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


В параметр функции УправлениеПечатью.МакетПечатнойФормы устанавливаем полный путь к макету печатной формы, созданному в пункте 5 нашей статьи.


Получение данных объекта в 1С 8.3

Рис. 8 Получение данных печати в 1С 8.3 Зарплата и управление персоналом

 

7.5 ПолучитьДанныеОбъекта


В этой функции необходимо создать структуру с данными, которыми будет заполняться печатная форма. Ключ структуры – имя параметра шаблона Word {v8 <Имя параметра>}, а значение – значение из базы 1С. Параметр функции СсылкаНаОбъект – ссылка на объект печати. В нашем случае это ссылка на сотрудника.


Получение данных объекта в 1С 8.3 Зарплата и управление персоналом

Рис. 9 Получение данных объекта в 1С 8.3 Зарплата и управление персоналом


7.6 ОбластиМакетаОфисногоДокумента


Здесь описываем области и устанавливаем типы.

Возможные типы областей:

·         Общая – используется однократно.

·         СтрокаТаблицы – используется для вывода множества строк;

·         Список – используется для вывода множества строк;

·         ВерхнийКолонтитул;

·         НижнийКолонтитул;


документ в 1С 8.3 Зарплата и управление персоналом

Рис. 10 Области макета в 1С 8.3 Зарплата и управление персоналом


7.7 НапечататьДокумент


Эта функция отвечает за вывод и заполнение областей. В блоке, отмеченном красной линией, нужно описать последовательный вывод областей. Здесь меняем/устанавливаем только название области. В нашем случае «ВесьДокумент»


Функция напечатать документ в 1С 8.3 Зарплата и управление персоналом

Рис. 11 Функция напечатать документ в 1С 8.3 Зарплата и управление персоналом


На этом все. Запускаем печать и получаем ожидаемый результат.


Печать макета документа Word

Рис. 12 Печать макета документа Word


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


В интернете можно найти множество авторских методик создания внешней печатной формы в формате документа MS Word, однако, методы на основе БСП являются наиболее надежными.


Специалист компании «Кодерлайн»

Игорь Торба

 

Задать вопрос автору статьи
Тема вопроса*
Ваше имя*
E-mail или телефон*
Ваш вопрос*
 

0
Zhiger
Приветствую!
Сделал все согласно Вашему описанию. При нажатии кнопки печать Пусто. ЗУП 3,1 УФ
Имя Цитировать 0
0
Администратор
Добрый день!
Проверьте макет Word. Возможны скрытые символы или комментарии. Лучше макет создать новый, а не использовать какой-то рабочий файл.
Имя Цитировать 0
0
Алексей
Спасибо за статью!
На сегодняшний момент очень мало примеров использования серверных методов для работы с офисными документами. Перерыл много статей, везде описывают, как с использованием методов модуля УправлениеПечатьюКлиент собрать doc, но с определенной версии БСП весь этот функционал был перенесен на сервер в модуль УправлениеПечатью, а в КоллекцииПечатныхФорм добавилось поле соответствие ОфисныеДокументы. Старый функционал пока работает, но клиентские функции уже помечены как устаревшие.
Поэтому еще раз спасибо за полезную и свежую статью.
Из пожеланий, было бы здорово увидеть такой же труд на тему подключения внешней печатной формы офисного документа. То есть не через расширение конфигурации, а именно через регистрацию внешней печатной формы.Там же есть свои нюансы.
Имя Цитировать 0
0
Екатерина
Спасибо за статью. Жаль что пример работает только под полными правами.
Имя Цитировать 0
0
Администратор
Здравствуйте! Спасибо за Ваш комментарий!
Имя Цитировать 0
0
Guest
Хорошая статья. Спасибо. Хотелось бы листинг еще не на картинках.
Имя Цитировать 0
0
Guest
Добрый день!
Спасибо вам за статью!
У меня ругается на Выборку в Функции ПолучитьДанныеОбъекта, подскажите, пожалуйста, где искать ошибку?
Имя Цитировать 0
0
Guest
К комментарию выше: Расширение1 Обработка.Расш1_ПечатьWord.МодульМенеджера(104,40)}: Переменная не определена (Выборка)
ДанныеОбъекта.Вставить("Организация", <<?>>Выборка.Организация); (Проверка: Сервер)
Также:
ДанныеОбъекта.Вставить("НДог", <<?>>Выборка.НомерДоговора); (Проверка: Сервер)
ДанныеОбъекта.Вставить("ДДог", Формат(<<?>>Выборка.ДатаДоговора, "ДЛФ=D" ) ); (Проверка: Сервер)
ДанныеОбъекта.Вставить("ГенДир", <<?>>Выборка.ГенДир); (Проверка: Сервер)
Имя Цитировать 0
0
Администратор
Цитата
Guest пишет:
К комментарию выше: Расширение1 Обработка.Расш1_ПечатьWord.МодульМенеджера(104,40)}: Переменная не определена (Выборка)
ДанныеОбъекта.Вставить("Организация", <<?>>Выборка.Организация); (Проверка: Сервер)
Также:
ДанныеОбъекта.Вставить("НДог", <<?>>Выборка.НомерДоговора); (Проверка: Сервер)
ДанныеОбъекта.Вставить("ДДог", Формат(<<?>>Выборка.ДатаДоговора, "ДЛФ=D" ) ); (Проверка: Сервер)
ДанныеОбъекта.Вставить("ГенДир", <<?>>Выборка.ГенДир); (Проверка: Сервер)
Здравствуйте!
Обратитесь по телефонам, указанным в верхней части сайта. Наши специалисты вам помогут.
Имя Цитировать 0
0
Guest
Отличная статья, огромное спасибо! Следуя рекомендациям, удалось настроить вывод в Word.
Имя Цитировать 0
Добавить комментарий
Текст сообщения*
Защита от автоматических сообщений
 
Теги
# абота Риелторского Агентства #Работа Риелторского Агентства #1С: CRM #1С: ERP #1С: ERP Управление строительной организацией #1С: ERP. Управление буровой компанией #1С: WMS Управление складом #1С: Аренда и управление недвижимостью #1С: БУХ #1С: Договорчики #1С: Документооборот #1С: ЗУП #1С: Интеграция #1С: КА #1С: Колледж #1С: Конвертация данных #1С: Модули #1С: Платформа #1С: Розница #1С: Сценарное тестирование #1С: ТОИР #1С: УАТ #1С: УКФ #1С: Университет #1С: УНФ #1С: УПП #1С: Управление строительной организацией #1С: УТ #1С: УХ #1С:ERP #1С:БГУ #1С:БП #1С:Риелтор #1С.6-НДФЛ #ADO #APACHE #API #canonical #com-объекты #Excel #Excel в 1С #GoogleDrive #Googleаккаунт #HTTP #ITIL #Koderline: Управление медиа-холдингом #Koderline: Управление проектами строительства скважин #LINUX #MS SQL Server #WEB #WEB-сервисы 1С #Word #XML #Администрирование 1С #акты в 1С #Безопасность сервера #Бесшовная интеграция #БИТ.Финанc #Битрикс24 #Блокировки в 1С #БСП #БУ #Бурение скважин #Бухгалтерская отчётность в МСФО #Бюджетирование #Внедрение #Внедрение ERP #Задача для 1С #Закрытие месяца #Запросы 1С #Интеграция 1С #КАК ОТРАЖАЮТСЯ ТОВАРЫ В ПУТИ 1С #Как сделать в 1С #Конвертация данных #Корпоративное сопровождение #Лизинг #Лицензии 1С #Механизм Анализа Данных в 1С #Моделирование #Модуль Диадок #МСФО #Налоги #Обмен между базами #Обновления #Операции в 1С #Оптимизация #Отпуск #Отчетность #Отчеты в 1С #Оценка задач #Перенос данных #Планирование #Полезные обработки #Правила обмена #предопределенные элементы справочников #Принцип работы 1С #Проводки 1С #Программирование в 1С #Программные права #Продажа ТМЦ #Продажи #Производство #Работа с объектами в 1С #Расширение конфигурации #РСБУ #С # #СКД #Соединение COM в 1С платформе #Соединение СОМ в 1С платформе #Сравнение конфигураций #Тестирование 1С #Техническое задание #Типы данных ссылки #Торговое оборудование #Транспортная логистика #Управление проектами #Финансовый учет #Хранилище настроек #Ценообразование #Экзамен 1С #Яндекс-диск или Google-диск #Яндекс.Касса 1С под Linux 1С:УНФ Email или телефон Работа с объектами в 1С Функциональные опции в 1С
Услуги программиста 1С
Получите специалиста  
для решения всех задач
в области 1С
Программы 1С
Цены и подробное описание программ 1С:Предприятие 8.