Тег

Материал из TaxiMaster
Версия от 11:06, 11 августа 2009; RishatMuhametshin (обсуждение | вклад) (Теги для сотовых телефонов и GSM-шлюзов: by rain — В текущей версии нет такого тэга.)

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

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

Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам:

  1. Тег заключается в знаки %: «%ПримерТега%».
  2. Тег является регистрозависимым, то есть «%Тег%» и «%тег%» — это разные теги.

Общие теги

Существует множество общих тегов, то есть тех тегов, которые работают во всех СМС-сообщениях.

Теги для сотовых телефонов и GSM-шлюзов

Ниже приведены теги, которые могут быть использованы для устройств, отправляющих СМС-сообщения в сети GSM:

  1. «%PrizePhoneCnt%» — количество заказов, оставшихся до призовой поездки по телефону.
    • Например, если следующая поездка клиента — призовая, и текст шаблона — «До призового осталось %PrizePhoneCnt% заказ(а,ов)», то текст сообщения будет такой: «До призового осталось 1 заказ(а,ов)».
  2. «%PrizeClientCnt%» — количество заказов до призовой поездки постоянного клиента.
  3. «%DateTime%» — текущие дата и время. Формат даты и времени задается в параметрах.
  4. «%Date%» — текущая дата. Формат даты задается в параметрах.
  5. «%Time%» — текущее время. Формат времени задается в параметрах.
  6. «%Phone%» — номер телефона заказчика.
    • Например, шаблон «Заказчик (%Phone%)...», если номер клиента - «7159561», преобразует текст СМС так: «Заказчик (79159561)...».
  7. «%CPhone%» — номер телефона на отзвон.
  8. «%Src%»адрес подачи.
    • Например, если адрес подачи в карточке заказа - «Пушкинская, 289», то шаблон «Адрес подачи: %Src%...» будет преобразован в текст: «Адрес подачи: Пушкинская, 289».
  9. «%Dest%»адрес назначения.
  10. «%Client%» — имя клиента.
  11. «%AMount%» — сумма за заказ (поле Сумма в карточке заказа).
    • Например, шаблон «%Src% - %Dest%, %AMount%» позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой.
  12. «%Disc%» — скидка в процентах.
    • Например, шаблон «Скидка: %Disc%» при скидке 5% преобразуется в сообщение «Скидка: 5%».
  13. «%Amnt%» — сумма за заказ без учета скидки.
  14. «%ITime%» — время поступления заказа.
  15. «%PTime%» — время, когда нужно выполнить заказ. Полезно для оповещения водителей о предварительных заказах.
  16. «%Cou%» — имя контрагента.
  17. «%CarType%»тип автомобиля.
  18. «%CarCallID%» — позывной автомобиля.
  19. «%CarGosNum%» — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида «...госномер %CarGosNum%...».
  20. «%CarColor%» — цвет автомобиля.
    • Этот тег также удобен для отправки заказчикам.
    • Например, в шаблоне «Машина подана: номер %CarGosNum%, цвет %CarColor%» содержится информация о госномере и о цвете автомобиля.
  21. «%Min%» — осталось времени до подачи в указанном формате.
  22. «%MinM%» — осталось минут до подачи (в формате «nn»).
  23. «%CarMark%» — марка автомобиля.
  24. «%DrvAmount%» — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов.

Теги для mail-гейтов

Ниже приведены теги, которые могут быть использованы для mail-гейтов:

  1. ProviderLogin — имя пользователя для авторизации у провайдера (см. TMComDevs.ini).
  2. Password — пароль для авторизации у провайдера.
  3. SourceAddress — адрес отправителя сообщения.
  4. Phone — номер телефона получателя (берется из карточки заказа).
  5. MessageBody — непосредственно текст сообщения, которое нужно отправить.

Очевидно, что текст отправляемого сообщения берется либо из формы отправки СМС-сообщения на любой номер, либо из справочника «Водители», либо из каких-либо других справочников Такси-Мастер, в которых задается текст СМС-сообщения, отправляемого по умолчанию.

Специфические теги

Есть также специфические теги, предназначенные для массовой рассылки. Массовая рассылка — это отдельная возможность модуля, и для нее представлены следующие теги:

  1. %SpamStart% — начало выбранного периода, статистика за который будет рассылаться. Дата выводится в формате dd.mm.yyyy.
  2. %SpamStop% — конец выбранного периода статистики. Дата выводится в формате dd.mm.yyyy.
  3. %OrdersCnt% — количество заказов, выполненных за выбранный период статистики.

Формат тегов

Теги могут быть выведены в соответствии с особым форматом, который задается в параметрах модуля СМС. Он задает маску, по которой затем формируется значение. Маска может содержать следующие заменяемые значения:

  1. dd — день (число), например, 22.
  2. mm — номер месяца, например, 03.
  3. yyyy — год, обозначенный четырьмя цифрами, например, 2000.
  4. hh — часы, например, 22.
  5. nn — минуты (задействована буква “n”, поскольку “m” уже обозначает месяц), например, 58.
  6. ss — секунды, например, 00.

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