Формирование документа MS Word с использованием БСП и программное добавление закладок

15.08.23

Разработка - Инструментарий разработчика

Пример формирования документа MS Word с использованием библиотеки стандартных подсистем и добавление закладок в сформированный документ путем редактирования XML кода файла MS Word. (Тестирование проводилось на платформе 8.3.18.1959 с использованием библиотеки стандартных подсистем версии 3.1.7.294)

Файлы

ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.

Наименование Скачано Купить файл
Формирование документа MS Word с использованием БСП и программное добавление закладок
.epf 26,83Kb
17 2 500 руб. Купить

Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний

Оформите подписку на компанию для решения рабочих задач

Оформить подписку и скачать решение со скидкой

Вы можете заказать платную доработку или адаптацию этой разработки под вашу конфигурацию на «Бирже заказов».

  • 0% комиссии — оплата напрямую исполнителю;
  • Исполнители любого масштаба — от отдельных специалистов до команд под проект;
  • Прямой обмен контактами между заказчиком и исполнителем;
  • Безопасная сделка — при необходимости;
  • Рейтинги, кейсы и прозрачная система откликов.

Появилась необходимость в формировании документа MS Word из макета, однако попытка использования COM-объекта на сервере не увенчалась успехом. Решено было обратиться к БСП.

Основная идея данной статьи - показать способ подстановки закладок в документ MS Word, но так как была использована и библиотека стандартных подсистем, решил сформировать документ ".docx" с её помощью и заодно составить шпаргалку для подобных задач.

Статья получилась достаточно громоздкая, поэтому cпрятал формирование документа с помощью БСП под спойлер.

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

 
 Формирование документа MS Word с помощью БСП

 

Для формирования закладок исходил из того, что файл, формируемый MS Word с расширением .docx, по сути, является архивом, содержащим xml файлы с данными и настройками основного файла. Если разархивировать его как обычный архив, он будет выглядеть следующим образом:

 

 

Сами же данные (в т.ч. и закладки) находятся в xml файле "document.xml", который, в свою очередь, находится в папке "word".

Таким образом, ныряем в код:

&НаСервере
Процедура СформироватьИПрисоединитьФайлыMSWord(ИмяМакета, КаталогСохранения, КаталогВременныхФайлов)
	
	ПутиДляРаботыСФайлами = СформироватьПутиДляРаботыСФайлами(ИмяМакета, КаталогСохранения, КаталогВременныхФайлов);
	
	//	Формирование документа MS Word с использованием процедур БСП
	СформироватьШаблонВMSWord(ПутиДляРаботыСФайлами.ПутьКФайлуШаблон, ИмяМакета);
	
	//	Заполнение закладок в созданном документе
	ЗаполнитьЗакладкиКакZIP(ИмяМакета,
							ПутиДляРаботыСФайлами.ПутьКФайлуШаблон,
							ПутиДляРаботыСФайлами.ПутьКВыгрузкеДляАрхива,
							ПутиДляРаботыСФайлами.ПутьКРедактируемомуФайлу,
							ПутиДляРаботыСФайлами.ПутьКФайлуСЗакладками);
	
	УдалитьФайлы(КаталогВременныхФайлов);
	
КонецПроцедуры

Первые две строчки процедуры были разобраны под спойлером, там же можно увидеть и изюминку формирования путей, для работы с xml файлами, а сейчас разберем процедуру "ЗаполнитьЗакладкиКакZIP".

Первым делом необходимо разархивировать полученный документ с расширением ".docx":

&НаСервере
Процедура ЗаполнитьЗакладкиКакZIP(ИмяМакета, ПутьКФайлуШаблон, ПутьКВыгрузкеДляАрхива, ПутьКРедактируемомуФайлу, ПутьКФайлуСЗакладками)
	
	АрхивZip = Новый ЧтениеZipФайла(ПутьКФайлуШаблон);
	
	АрхивZip.ИзвлечьВсе(ПутьКВыгрузкеДляАрхива, РежимВосстановленияПутейФайловZIP.Восстанавливать);
	
	АрхивZip.Закрыть();
	
	ОтредактироватьФайлTXT(ИмяМакета, ПутьКРедактируемомуФайлу);
	
	НовыйАрхивZip = Новый ЗаписьZipФайла(ПутьКФайлуСЗакладками,,,МетодСжатияZIP.Копирование,УровеньСжатияZIP.Оптимальный,МетодШифрованияZIP.Zip20);
	НовыйАрхивZip.Добавить(ПутьКВыгрузкеДляАрхива + "_rels\",РежимСохраненияПутейZIP.СохранятьОтносительныеПути,РежимОбработкиПодкаталоговZIP.ОбрабатыватьРекурсивно);
	НовыйАрхивZip.Добавить(ПутьКВыгрузкеДляАрхива + "customXml\",РежимСохраненияПутейZIP.СохранятьОтносительныеПути,РежимОбработкиПодкаталоговZIP.ОбрабатыватьРекурсивно);
	НовыйАрхивZip.Добавить(ПутьКВыгрузкеДляАрхива + "docProps\",РежимСохраненияПутейZIP.СохранятьОтносительныеПути,РежимОбработкиПодкаталоговZIP.ОбрабатыватьРекурсивно);
	НовыйАрхивZip.Добавить(ПутьКВыгрузкеДляАрхива + "word\",РежимСохраненияПутейZIP.СохранятьОтносительныеПути,РежимОбработкиПодкаталоговZIP.ОбрабатыватьРекурсивно);
	НовыйАрхивZip.Добавить(ПутьКВыгрузкеДляАрхива + "*.xml",РежимСохраненияПутейZIP.НеСохранятьПути,РежимОбработкиПодкаталоговZIP.НеОбрабатывать);
	
	НовыйАрхивZip.Записать();
		
КонецПроцедуры

В теле данной процедуры мы сначала разархивируем файл, затем вызываем процедуру, редактирующую файл "document.xml", и, после, собираем его обратно в файл с расширением ".docx". 

Переходим к процедурам, добавляющим закладки:

&НаСервере
Процедура ОтредактироватьФайлTXT(ИмяМакета, ПутьКРедактируемомуФайлу)
	
	Текст = Новый ТекстовыйДокумент;
	Текст.Прочитать(ПутьКРедактируемомуФайлу);
	
	СтрокаXML = Текст.ПолучитьТекст();
	
	//**********************************************************************************
	
	//	Вторым параметром передаем строку поиска, от которой будем отталкиваться
	//	w:name="ИмяЗакладки"
	//	для каждой последующей закладки увеличиваем id на 1
	
	ВставитьЗакладку(СтрокаXML, "ДАТАРЕГ", "<w:bookmarkStart w:id=""1"" w:name=""ДатаРегистрации""/>", "<w:bookmarkEnd w:id=""1""/>");
	ВставитьЗакладку(СтрокаXML, "РЕГНОМЕР", "<w:bookmarkStart w:id=""2"" w:name=""РегистрационныйНомер""/>", "<w:bookmarkEnd w:id=""2""/>");
	
	//**********************************************************************************
		
	Текст.УстановитьТекст(СтрокаXML);
	Текст.Записать(ПутьКРедактируемомуФайлу);
	
КонецПроцедуры

&НаСервере
Процедура ВставитьЗакладку(СтрокаXML, СтрокаПоиска, ЗакладкаНачало, ЗакладкаКонец)
	
	//**********************************************************************************
	
	//	Открытие закладки
	
	ПозицияНайденнойСтроки = СтрНайти(СтрокаXML, СтрокаПоиска);
	
	ПозицияВставкиНачалаЗакладки = СтрНайти(СтрокаXML, "<w:r", НаправлениеПоиска.СКонца, ПозицияНайденнойСтроки) - 1;
	
	ЧислоСимволовСлева = ПозицияВставкиНачалаЗакладки;
	ДлинаСтроки = СтрДлина(СтрокаXML);
	ЧислоСимволовСправа = ДлинаСтроки - ПозицияВставкиНачалаЗакладки;
	
	ТекстСлева = Лев(СтрокаXML, ЧислоСимволовСлева);
	ТекстСправа = Прав(СтрокаXML, ЧислоСимволовСправа);
	ТекстВставки = ЗакладкаНачало;
		
	СтрокаXML = ТекстСлева + ТекстВставки + ТекстСправа;
	
	//**********************************************************************************
	
	// Закрытие закладки
	
	ПозицияНайденнойСтроки = СтрНайти(СтрокаXML, СтрокаПоиска);
	
	ПозицияВставкиКонцаЗакладки = СтрНайти(СтрокаXML, "</w:r>", НаправлениеПоиска.СНачала, ПозицияНайденнойСтроки) + СтрДлина("</w:r>") - 1;
	
	ЧислоСимволовСлева = ПозицияВставкиКонцаЗакладки;
	ДлинаСтроки = СтрДлина(СтрокаXML);
	ЧислоСимволовСправа = ДлинаСтроки - ПозицияВставкиКонцаЗакладки;
	
	ТекстСлева = Лев(СтрокаXML, ЧислоСимволовСлева);
	ТекстСправа = Прав(СтрокаXML, ЧислоСимволовСправа);
	ТекстВставки = ЗакладкаКонец;
		
	СтрокаXML = ТекстСлева + ТекстВставки + ТекстСправа;
	
	//**********************************************************************************
	
КонецПроцедуры

По-хорошему, стоит работать с xml файлами как, собственно, с xml файлами, открывая один на чтение, другой на запись, но до меня, к сожалению, не дошло как это можно сделать, поэтому решил работать с xml как с текстовой строкой.

В общем случае, сначала в строке ищем точку вхождения текста, куда нужно вставить закладку. В нашем случае это "ДАТАРЕГ" и "РЕГНОМЕР". Их мы передаем вторым параметром в процедуру "ВставитьЗакладку". Третий и четвертый параметры - это, соответственно, конструкции, которыми Word обозначает закладки, которые, мы, собственно, и вставляем в нужные места. В этих же конструкциях мы задаем id закладки (важно увеличивать для каждой последующей закладки id на 1) и имя закладки (ДатаРегистрации и РегистрационныйНомер в нашем случае).

В процедуре "ВставитьЗакладку" после того, как была найдена строка вхождения, в нужные места по тегам вставляются переданные конструкции открытия и закрытия закладки. Такие дела.

ХОЧУ ОБРАТИТЬ ВНИМАНИЕ, что не стоит называть текст вхождения по типу "&!ВхождениеТекста123!&". Дело в том, что Word по-своему записывает некоторые слова. Таким образом, множество знаков (&#$!,. и прч.) он, вероятно, сохранит в виде кодировки символа, а не непосредственно сам символ. Также длинные слова он может разделить на несколько. Визуально, в документе, это будет единое слово, но в xml файле оно будет разделено на несколько, что не позволит отыскать его. Так что для подобных изощрений имеет смысл поэкспериментировать и найти короткое слово.

 
 Пример ошибки

Так это выглядит в MS Word:
Так это выглядит в xml: <w:t xml:space="preserve">РЕГНОМЕР</w:t>

Так это выглядит в MS Word:
Так это выглядит в xml: <w:t xml:space="preserve">егистрацонныйНомер</w:t>

Как можно видеть, знак амперсанда и букву "Р" Word где-то съел, закодировав по-своему.

 

На этом у меня всё, спасибо за внимание!

Вступайте в нашу телеграмм-группу Инфостарт

обработка закладки word БСП

См. также

Инструментарий разработчика Роли и права Запросы СКД Программист Руководитель проекта 1С:Предприятие 8 Платные (руб)

Инструменты для разработчиков 1С 8.3: Infostart Toolkit. Автоматизация и ускорение разработки на управляемых формах. Легкость работы с 1С.

10000 руб.

02.09.2020    269043    1497    422    

1180

Инструментарий разработчика Чистка данных Свертка базы Инструменты администратора БД Системный администратор Программист Руководитель проекта 1С:Предприятие 8 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Россия Платные (руб)

Инструмент представляет собой обработку для проведения свёртки или обрезки баз данных. Работает на ЛЮБЫХ конфигурациях (УТ, БП, ERP, УНФ, КА и т.д.). Поддерживаются серверные и файловые базы, управляемые и обычные формы, интерфейс 8.5. Может выполнять свертку одновременно в несколько потоков, а также без непосредственного участия пользователя. Решение в Реестре отечественного ПО.

24900 руб.

20.08.2024    75473    381    170    

326

Пакетная печать Печатные формы Инструментарий разработчика Программист 1С:Предприятие 8 Платные (руб)

Расширение для создания и редактирования печатных форм в системе 1С:Предприятие 8.3. Благодаря конструктору можно значительно снизить затраты времени на разработку печатных форм, повысить качество и прозрачность разработки, а также навести порядок в многообразии корпоративных печатных форм. Обновление версии от 21.04.26

22570 руб.

06.10.2023    40320    115    54    

127

Инструментарий разработчика Нейросети Платные (руб)

Первые попытки разработки на 1С с использованием больших языковых моделей (LLM) могут разочаровать. LLMки сильно галлюцинируют, потому что не знают устройства конфигураций 1С, не знают нюансов синтаксиса. Но если дать им подсказки с помощью MCP, то результат получается кардинально лучше. Далее в публикации: MCP для поиска по метаданным 1С, справке синтакс-помощника и проверки синтаксиса.

15250 руб.

25.08.2025    64226    130    36    

139

Инструментарий разработчика Разработка Администрирование веб-серверов Системный администратор Программист Бизнес-аналитик Руководитель проекта 1С 8.3 Платные (руб)

Analyzer 1C сводит выгрузку 1С — основную конфигурацию и все расширения — в единый граф знаний. Любой запрос по связям за доли секунды, с пометками «Доб.» / «Заимств.» / «Переопределено». Новое в 2.0 — обновление поставки: сравнение и объединение версий деревом «как в Конфигураторе» с выгрузкой плана решений; поиск конфликтов из-за перехватов расширений и висячих ссылок; загрузка из бинарных .cf/.cfe; циклические зависимости. Плюс анализ влияния, запросы BSL, роли и RLS, граф вызовов. Минута на развёртывание через Docker без необходимости подключения к Интернет. Любая 1С:Предприятие 8.3+.

14000 руб.

17.04.2026    9118    39    50    

54

Инструменты администратора БД Инструментарий разработчика Роли и права Программист 1С:Предприятие 8 1C:Бухгалтерия Россия Платные (руб)

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

17000 руб.

10.11.2023    26519    98    46    

104

Информационная безопасность Инструменты администратора БД Инструментарий разработчика Учет документов Системный администратор Программист Бизнес-аналитик Бухгалтер Пользователь Руководитель проекта 1С 8.3 1С 8.5 Розничная и сетевая торговля (FMCG) Платные (руб)

Контроль ввода данных в 1С: проверка заполнения реквизитов, обязательные поля, контроль перед записью и проведением, запрет проведения документа. Позволяет настраивать любые проверки данных в 1С 8.3/8.5 от обязательных полей до сложных условий – без открытия конфигуратора и написания кода. Готовое расширение, которое подключается и работает сразу.

6000 руб.

15.04.2026    2704    6    0    

21

Инструментарий разработчика Программист 1С:Предприятие 8 Платные (руб)

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

9500 руб.

17.05.2024    54900    188    63    

220
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. angabanga5 11.11.24 15:01 Сейчас в теме
вопрос по табличной части, а у меня строки таблицы по отдельности прыгают через перенос строки, как это объеденить-то в таблицу ?
2. angabanga5 11.11.24 15:20 Сейчас в теме
(1) а все понял там другая процедура с коллекцией, спасибо
Для отправки сообщения требуется регистрация/авторизация