Конструктор закладок
Введение
С релиза 9.2.5 Мастер-Агент появилась первая версия гибкого механизма создания закладок для отчетов в MS Word. Механизм позволяет создавать закладки, используя своеобразный алфавит, благодаря чему возможно большое многообразие форматов выводимой информации.
TCl – начало закладки «Информация о клиентах», признак принадлежности закладки к «Информация о клиентах». С него должны начинаться названия всех закладок «Информация о клиентах»
TPC – начало закладки «Платежи клиента». С него должны начинаться названия всех закладок по Платежам клиента по путевке
TAg – начало закладки «Путевка». С него должны начинаться названия всех закладок по Путевке
TTr – начало закладки «Трансфер», признак принадлежности закладки к услуге «Трансфер». С него должны начинаться названия всех закладок по услуге «Трансфер»
THt – начало закладки «Отель», признак принадлежности закладки к услуге «Отель». С него должны начинаться названия всех закладок по услуге «Отель»
TFl – начало закладки «Перелет», признак принадлежности закладки к услуге «Перелет». С него должны начинаться названия всех закладок по услуге «Перелет»
TIn – начало закладки «Страховка», признак принадлежности закладки к услуге «Страховка». С него должны начинаться названия всех закладок по услуге «Страховка»
TEx – начало закладки «Экскурсия», признак принадлежности закладки к услуге «Экскурсия». С него должны начинаться названия всех закладок по услуге «Экскурсия»
TAS – начало закладки «Услуги», признак принадлежности закладки ко всем услугам по заявке в путевке.
TDS – начало закладки «Дополнительные услуги», признак принадлежности закладки к дополнительным услугам по заявке в путевке (используются те же закладки, что и в разделе TAS).
Вспомогательные символы
- _ - Переход к следующей колонке
- AT** - Работа с доп. описаниями. Для использования необходимо, чтобы код доп. описания был заведен как AT**, где ** - это два символа (буквы либо цифры). В закладку пишем весь код доп. описания. Например "TCl_AT01"
- а) в случае, когда необходимо вывести информацию дополнительного описания о пользователе, создавшего путевку - то закладку нужно формировать как TAgAT** (AT - заглавные). Для вывода информации по текущему пользователю - использовать TAgAt** (t - не заглавная);
- b) в случае, когда необходимо вывести в отчет две одинаковые закладки (все символы в последовательности совпадают вне зависимости от регистра букв), то к каждой такой закладке в конце нужно добавлять уникальный префикс (символ) в виде цифры или буквы;
-
- частный случай: если необходимо вывести в одном отчете информацию о пользователе, создавшем путевку, и о текущем пользователе - то нужно во второй закладке к имени добавить одну цифру или букву латинского алфавита (это ограничение раздела "Закладки" в MS Word - при добавлении закладок программа не обрабатывает регистр в названии закладки). Будет выглядеть следующим образом:
- TAgAT01
- TAgAt01А
- Em - Пустое значение ""
- BL - Символ Левая скобка "("
- BR - Символ Правая скобка ")"
- CL - Символ Двоеточие ":"
- CM - Символ Запятая ',' без проставления самой последней в цикле
- Dh - Символ тире "-"
- Dt - Символ точка "."
- En - Символ переноса каретки без проставления самого последнего
- Gp - Символ пробела " "
- Or - Порядок - просто нумерация записей начиная с 1
- Sl - Символ прямого слеша "/"
- Sm - Симовл точка с запятой "; " без проставления самого последнего
- WN - Текст "Количество ночей"
- Wd - Текст "дней"
- Wn - Текст "ночей"
Команды
- XF - Команда для вывода следом идущего значения параметра только в первый раз
- XL - Команда для вывода следом идущего значения параметра только в последний раз
- Xl - Команда для вывода следом идущего параметра все время, кроме последнего раза в цикле (в списке услуг или клиентов или платежей...)
- XW - Команда для вывода следом идущего параметра все время, кроме первого и последнего раза в цикле (в списке услуг или клиентов или платежей...)
- OR - Команда 'Логическое ИЛИ'. Выводит следом идущее значение параметра, если предыдущее пустое и наоборот
- XA - Команда 'И'. Позволяет вывести следом идущее значение параметра, если предыдущее не пустое
Информация о путевке
- Ap - Название покупателя - юр. лицо (Краткое)
- AP - Название покупателя - юр. лицо (Полное)
- AN - Страна по путевке
- AR - Регион по путевке
- AY - Город по путевке
- Cr - Код валюты путевки
- CN - Курс по путевке при переводе в национальную валюту
- MF - Имя пользователя (менеджера), создавшего путевку (9.2.7)
- MM - Отчество пользователя (менеджера), создавшего путевку (9.2.7)
- MS - Фамилия пользователя (менеджера), создавшего путевку (9.2.7)
- AD - Продолжительность тура в днях (9.2.7)
- An - Продолжительно тура в ночах (9.2.7)
- IQ - ICQ фирмы-владельца (9.2.7)
- Iq - ICQ контактного лица по фирме-владельцу (9.2.7)
- Rp - Стоимость заявки (у оператора) в валюте путевки (9.2.7)
- ww - (URL) - сайт покупателя-партнера путевки (юр. лица) (9.2.7)
- DP - Срок оплаты по путевке (в формате dd.MM.yyyy) (9.2.7)
- Pj - Должность покупателя (юр. лица) из Контакты/Контактное лицо (9.2.7)
- Ej - Адрес эл. почты покупателя (юр. лица) из Контакты/Координаты для связи (9.2.7)
- Dc - Долг клиента по путевке в валюте путевки (9.2.7)
- CS - Сумма всех платежей клиента по путевке в валюте путевки (9.2.7)
- RR - Cебестоимость заявки в валюте заявки (2011.1)
- RA - Cебестоимость заявки в валюте путевки (2011.1)
- CW - Сумма предоплаты прописью в валюте путевки (2011.1)
- CP - Сумма предоплаты прописью в валюте платежа (2011.1)
- Fd – Дата Договора фин. обеспечения (2011.2.3)
- Fa – Адрес местонахождения организации, предоставляющей фин. обеспечение (2011.2.3)
- Fp – Почтовый адрес организации, предоставляющей фин. обеспечение (2011.2.3)
- Og - ОГРН Покупатель - юридическое лицо (2011.2.3)
- Rw - Стоимость заявки в валюте путевки прописью (2011.2.3)
- Jo - ОГРН туроператора по путевке (2011.2.4)
- DN - разница между Стоимостью у оператора и Ценой для клиента в национальной валюте (2011.2.4)
- DR - разница между Стоимостью у оператора и Ценой для клиента в валюте заявки (2011.2.4)
Свойства, общие для всех услуг
- Ct - Страна по услуге
- ct - Город по услуге
- cf - Город из (откуда) (по услуге)
- DB - Дата начала услуги в формате dd.MM.yy
- DE - Дата окончания услуги в формате dd.MM.yy
- Ds - Продолжительность (количество дней) по услуге
- Ns - Продолжительность (количество ночей) по услуге
- AS - Название услуги
- AM - Количество человек по услуге
- Sc - Cписок туристов по услуге (вывод полного ФИО каждого туриста через запятую) (9.2.7)
Услуга Отель
THt – начало закладки, признак принадлежности закладки к услуге «Отель». С него должны начинаться названия всех закладок по услуге «Отель»
- Nm - Название отеля
- Ad - Адрес отеля
- Ph - Телефон отеля
- CT – Категория отеля (звездность)
- RT - Тип комнат (Название)
- Rt - Тип номера (комнат) (Код)
- HC - Категория номера (размещения) (Название)
- HA - Тип размещения (Название)
- MN - Тип питания в отеле (название)
- MC - Тип питания в отеле (Код)
- AC - Количество взрослых (Adult) по услуге отель (пример: 2)
- CC - Количество детей (Child) по услуге отель(пример: +2)
- IC - Количество инфантов (Infant) по услуге отель (пример: +2)
- Cc - Общее количество человек (туристов) на услуге отель
- Cn - Страна по отелю
- Rg - Регион по отелю
- Ci - Город по отелю
Услуга Перелет
TFl – начало закладки, признак принадлежности закладки к услуге «Перелет». С него должны начинаться названия всех закладок по услуге «Перелет»
- FC - Номер (код) рейса авиаперелета
- FF - Город вылета
- FT - Город прилета
- TR - Название тарифа по-русски по услуге перелет
- TE - Название тарифа по услуге перелет (лат.)
- TF - Время вылета
- TT - Время прилета
- AN - Название авиалинии по услуге перелет
- FN - Код авиалинии по услуге перелет
- PF - Аэропорт вылета (2011.1)
- PT - Аэропорт прилета (2011.1)
Услуга Трансфер
TTr – начало закладки, признак принадлежности закладки к услуге «Трансфер». С него должны начинаться названия всех закладок по услуге «Трансфер»
- TN - Название трансфера
- Tt - Транспорт по услуге трансфер (русское название) (9.2.7)
- tt - Транспорт по услуге трансфер (лат.) (9.2.7)
Услуга Экскурсия
TEx – начало закладки, признак принадлежности закладки к услуге «Экскурсия». С него должны начинаться названия всех закладок по услуге «Экскурсия»
- Ex - Название экскурсии
- ET - Название типа транспорта по экскурсии
Информация о клиентах (туристах) по путевке
TCl – начало закладки, признак принадлежности закладки к услуге «Информация о клиентах». С него должны начинаться названия всех закладок «Информация о клиентах»
- Sn - Фамилия туриста
- sN - Фамилия туриста (лат.)
- Na - Имя туриста
- nA - Имя туриста (лат.)
- Mn - Отчество туриста
- mN - Отчество туриста (лат.)
- Ni - Инициалы туриста (Иванов И. И.)
- nI - Иинциалы туриста (лат. - Ivanov I. I.)
- Bd - День рождения туриста
- PN - Серия и номер паспорта (если введены данные по загран - то выводится загран-паспорт, иначе российский)
- Pn - Серия и номер российского паспорта
- pn - Серия и номер загран-паспорта
- dE - Дата окончания загран-паспорта
- dB - Дата выдачи загран-паспорта
- pw - Кем выдан загран-паспорт
- Pw - Кем выдан российский паспорт
- CA - Адрес (почтовый) клиента
- CP - Телефон клиента
- Sx - Пол клиента (туриста) (М/Ж)
- sx - Пол клиента (туриста) (лат.) (M/F)
- IV - Наличие услуги виза у клиента (вывод да/нет)
- IT - Наличие услуги трансфер у клиента (вывод да/нет) (2011.1)
- II - Наличие услуги страховка у клиента (вывод да/нет) (2011.1)
Информация по платежам
TPC – начало закладки «Платежи клиента. С него должны начинаться названия всех закладок по Платежам клиента по путевке
- PD - Дата создания платежа
- PT - Вид платежа
- PG - Сумма платежа в валюте платежа
- Pg - Сумма платежа в валюте путевки
- PS - Сумма платежа в национальной валюте
- PO - ISO-код валюты платежа
- PC - Код валюты платежа
- Pc - Курс валюты платежа на дату платежа по отношению к национальной валюте
- pc - Курс обмена из валюты путевки в национальную валюту на дату платежа
Примеры
Элементы алфавита чувствительны к регистру, т.е. имеет значение, заглавная буква, или строчная. MS Word накладывает ограничение на длину названия закладки – 40 символов.
Пример 1
Требуется выводить информацию об отелях – название, звездность, даты проживания. Для этого нужно создать закладку, название которой будет состоять из элементов алфавита, отвечающих за соответствующие параметры. В данном случае название нашей закладки будет:
- THtNmGpCtGpDBGpDE
- В качестве разделителя использован пробел.
Пример 2
Нужно отображать информацию об отелях в табличной форме. Для этого в шаблоне отчета (документе MS Word) необходимо сформировать таблицу – шапку и первую пустую строку. Закладку нужно вставлять за пределами таблицы, сразу после шапки:
Закладка для этого случая будет выглядеть так:
Также закладку можно вставить в первой колонке таблицы:
Закладка для этого случая будет выглядеть так:
Пример 3
Более сложная табличная закладка, которая должна отображать:
- Порядковый номер записи
- Название отеля
- Адрес, через знак слеш - телефон отеля
- Звездность отеля
- Начало и окончание проживания, через пробел
- Продолжительность услуги
- Тип номера
- Питание
Название закладки будет следующим: THt_Or_Nm_AdSlPhGp_Ct_DbDhDE_Ds_Rt_MN