Мастер-Агент:Конструктор закладок

Материал из Megatec
Перейти к: навигация, поиск

Содержание

[править] Введение

С релиза 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) необходимо сформировать таблицу – шапку и первую пустую строку. Закладку нужно вставлять за пределами таблицы, сразу после шапки:
    334.PNG
    Закладка для этого случая будет выглядеть так:

    • THt_Nm_Ad_Ct_RT_MN

    Также закладку можно вставить в первой колонке таблицы:
    335.PNG

    Закладка для этого случая будет выглядеть так:

    • THtNm_Ad_Ct_RT_MN_

    [править] Пример 3

    Более сложная табличная закладка, которая должна отображать:

  • Порядковый номер записи
  • Название отеля
  • Адрес, через знак слеш - телефон отеля
  • Звездность отеля
  • Начало и окончание проживания, через пробел
  • Продолжительность услуги
  • Тип номера
  • Питание
    Название закладки будет следующим: THt_Or_Nm_AdSlPhGp_Ct_DbDhDE_Ds_Rt_MN
  • Личные инструменты
    Пространства имён

    Варианты
    Просмотры
    Действия
    Навигация
    Инструменты