mail mail
Нужен макрос для Excel?
Сделайте заказ прямо сейчас!
Ищете готовое решение?
Выбирайте и покупайте!
У вас есть интернет-магазин?
Настроим парсер под любой сайт!
Статья является инструкцией по надстройке FillDocuments

Доступные коды полей для подстановки в шаблоны

Коды полей - это специальные метки в шаблонах документов,
на место которых подставляются данные из таблицы Excel при работе с программой заполнения документов.

 

Например, если нам надо в документе (или письме) получить текст «Уважаемый Петров Иван Скотиныч!»,
а в исходной таблице у нас есть столбец с заголовком ФИО,
мы в шаблоне документа пишем: «Уважаемый {ФИО}!»

В этом случае {ФИО} - это код поля, на место которого будут подставлены данные из одноименного столбца исходной книги Excel.

 

Все коды полей заключены в фигурные скобки - {}
(например, {Номер договора}, {print=3}, {%sheet_name%}, {%date%}, {=B4}, и т.д.)

 

Программа поддерживает несколько типов кодов полей, о каждом из которых написано ниже.

 

Коды полей в программе используются для следующих целей:

  1. подстановка в текст документов (шаблонов) данных из таблицы (см. скриншот)
  2. создание писем (тема, текст, получатель письма) (см. скриншот)
  3. формирование имен создаваемых файлов (см. скриншот)

 

Первый, и самый используемый, тип кодов полей - это ссылки на столбцы исходного файла Excel.

Например, в качестве исходных данных у нас выступает таблица Excel из 5 столбцов:

исходная таблица Excel с адресами почты для рассылки писем

Исходная таблица имеет столбцы с названиями ФИО, email, Количество, комп., Дата,
и для подстановки данных из таблицы в документы и письма мы будем использовать такие коды полей:
{ФИО}, {email}, {Количество}, {комп.}, {Дата}

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

 

Второй тип кодов полей - ссылки на фиксированные (именованные) ячейки таблицы.

Например, нам надо подставить во все формируемые документы фиксированные значения из ячеек B2 (дата договора) и F2 (ФИО исполнителя)

подстановка в шаблоны данных из фиксированных ячеек

Для этого, присваиваем этим ячейкам произвольные имена (имя для ячейки вводится слева от строки формул - см. скриншот).
Например, ячейке B2 мы присвоили имя ДатаДоговора, а ячейке F2 - имя Исполнитель.

Теперь в шаблонах документов и писем мы можем использовать следующие коды:

{=B2} или {=ДатаДоговора} - для вставки даты составления договора,
{=F2} или {=Исполнитель} - для вставки ФИО исполнителя

(можно использовать как адреса ячеек, так и имена, которые мы назначили ячейкам)

Внимание: коды полей, ссылающиеся на одиночные ячейки, начинаются со знака = (например, {=D6}, а не {D6})

Кроме того, мы можем вставить в документы номер строки таблицы Excel, имя\номер листа или название исходной книги Excel:

  • {%str%} - номер строки исходной таблицы (например, 2, 3, и т.д.)
  • {%sheet_name%} - имя исходного листа Excel
  • {%sheet_index%} - порядковый номер исходного листа Excel
  • {%workbook_name%} - имя исходного файла Excel (без расширения)

 

Третий тип кодов полей - служебные

В эту категорию попадают все остальные коды полей, которые применяются редко,
но, в то же время, помогают реализовать дополнительные возможности.

 

Коды для вставки текущей даты и времени: (с примерами текста, который будет подставляться вместо кода)

{%date%}   значение: 2012-09-28
{%shortdate%}  значение: 120928
{%longdate%}   значение: 28 сентября 2012
{%time%}   значение: 18-20-33
{%shorttime%}  значение: 182033
{%datetime%}   значение: 2012-09-28 18-20-33
{%shortdatetime%}  значение: 120928-182033
{%longdatetime%}   значение: 28 сентября 2012 18-20-33

 

Код {%index%} используется для автонумерации размножаемых строк в режиме Multirow

 

Для маски имени файла (и только для неё) можно использовать код {print=x}, где x - количество копий при выводе на печать.

Таким образом, можно задать количество печатных копий для каждого шаблона в отдельности
(количество печатных копий по-умолчанию можно задать в настройках программы)

Пример имен файлов шаблонов:

Акт.doc
Доверенность - {ФИО}{print=2}.doc
Договор{print=3}.doc

В этом случае, Акт будет отпечатан в одном экземпляре (по-умолчанию), доверенность - в 2 экземплярах, а договор будет выведен на печать трижды.
В создаваемых файлах поле {print=x} не попадёт в имена создаваемых файлов.

 

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