Использование полей ворда в шаблонах
Использование метаданных в полях ворда позволяет:
- настраивать формат отображения даты и времени;
- задавать формат чисел, в том числе записывать их значение прописью;
- выполнять несложные вычисления;
- производить вставку различного текста в зависимости от значения метаданных;
- производить вставку объектов, текста документов и рисунков, при необходимости с поддержкой связывания (изменение связанных файлов будет отображаться в документе);
- формировать гиперссылки и пр.
Описание полей, их ключи и формат записи подробно описан в справочной системе Word’а и на сайте Microsoft >>
После замены метаданных их значениями, программа выполняет дополнительные действия с полями в следующем порядке:
- Если в настройках шаблона (вкладка «Заполнение» / «Опции») отмечено «Корректировать значения полей связывания и внедрения объектов», то для всех полей Link, IncludePicture, IncludeText и HyperLink программа будет корректировать коды этих полей, а именно:
- заменяет недопустимые символы поддерживаемыми, кавычки “”«» заменяет на ", апострофы ’‘ на ‘
- при отсутствии пути и наименования файла подставляет полный путь к книге, из которой вызвано заполнение этого шаблона
- если указанно наименование книги с расширением, поддерживаемым приложением Excel без пути и такой файл открыт, то подставляет путь к нему
- для полей Link в случае отсутствия класса объекта, добавляет его для файлов эксель и ворд
- если в полях Link и HyperLink присутствует ссылка на диапазон книги эксель, то она при необходимости приводится к требуемому формату записи в стиле RC, после чего происходит приведение формы записи ссылки или закладки в документе ворда к требуемому формату записи этих полей
Это позволяет использовать ссылки из эксель без необходимости их приведения к формату записи в полях, опускать пути, динамически вставлять объекты, рисунки и текст.
- Для получения актуальных данных значения всех полей обновляются.
- Если в настройках шаблона (вкладка «Заполнение» / «Опции») отмечено «Заменять поля их значениями», то поля заменяются значениями (поля удаляются с заменой их значениями), в противном случае значения полей фиксируются (блокируются без возможности их повторного вычисления вручную или автоматически).
Исключением являются поля:- номеров страниц
- общего количества страниц в документе и главах
- количества слов и символов
- наименования документа
- размера файла
- оглавления и списка литературы
- гиперссылок
- link, includetext, includepicture не фиксируются, но заменяются. Для их фиксации/обновления используйте соответствующие ключи
Это позволяет сохранить значения большинства полей вычисленных на этапе заполнения документа, но оставив возможность корректировки документа в последующем с сохранением актуальных данных (номера страниц, оглавление и т.п.)
Обратите внимание, что для некоторых полей (текущей даты/времени или задания формата отображения значений даты/времени из метаданных, вывод числовых значений прописью и пр.) их значения зависят от установленного языка для области текста, содержащего их.
Например, если текущая дата 1.03.19 г., то в зависимости от заданного языка для поля { TIME \@ "d MMMM yyyy” } оно будет иметь значение:
10 мая 2019 – установлен русский язык
10 May 2019 – установлен английский язык