Тег — различия между версиями

Материал из TaxiMaster
Перейти к: навигация, поиск
(Специфические теги)
(Формат тегов)
Строка 55: Строка 55:
 
# {{code|%Date%}} — текущая дата. Формат даты задается в параметрах.  
 
# {{code|%Date%}} — текущая дата. Формат даты задается в параметрах.  
 
# {{code|%Time%}} — текущее время. Формат времени задается в параметрах.
 
# {{code|%Time%}} — текущее время. Формат времени задается в параметрах.
 
== Формат тегов ==
 
Теги могут быть выведены в соответствии с особым форматом, который задается в [[Параметры модуля СМС|параметрах модуля СМС]].
 
Он задает маску, по которой затем формируется значение.
 
Маска может содержать следующие заменяемые значения:
 
 
# {{code|dd}} — день (число), например, {{code|22}}.
 
# {{code|mm}} — номер месяца, например, {{code|03}}.
 
# {{code|yyyy}} — год, обозначенный четырьмя цифрами, например, {{code|2000}}.
 
# {{code|hh}} — часы, например, {{code|22}}.
 
# {{code|nn}} — минуты (задействована буква “n”, поскольку “m” уже обозначает месяц), например, {{code|58}}.
 
# {{code|ss}} — секунды, например, {{code|00}}.
 
 
Переменные могут быть разделены пробелами, знаками {{code|.}} или {{code|-}}, а также другими знаками, однако использование других знаков не рекомендуется.
 
  
 
== Ссылки ==
 
== Ссылки ==

Версия 16:09, 11 мая 2021

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

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

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

Общие теги

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

Список полей из карточки заказа:

  1. «%Phone%» — номер телефона заказчика.
    Например, шаблон «Заказчик (%Phone%)...», если номер клиента - «7159561», преобразует текст СМС так: «Заказчик (7159561)...».
  2. «%CPhone%» — номер телефона на отзвон.
  3. «%Src%»адрес подачи.
  4. «%Dest%»адрес назначения.
  5. «%Amount%» — сумма за заказ (поле «Сумма» в карточке заказа).
    Например, шаблон «%Src% - %Dest%, %Amount%» позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой.
  6. «%Disc%» — результирующая скидка в рублях.
    Например, шаблон «Скидка: %Disc% р» при скидке 5% и стоимости заказа 100 рублей преобразуется в сообщение «Скидка: 5 р».
  7. «%ITime%» — время поступления заказа.
  8. «%PTime%» — время подачи, то есть время, в которое нужно начать выполнение заказа. Полезно для оповещения водителей о предварительных заказах.
  9. «%Cou%»
  10. «%CarType%» — тип автомобиля (наименование).
  11. «%CarCallID%» — позывной автомобиля.
  12. «%CarGosNum%» — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида «...госномер %CarGosNum%...».
    Например, в шаблоне «Машина подана: номер %CarGosNum%, цвет %CarColor%» содержится информация о госномере и о цвете автомобиля.
  13. «%CarColor%» — цвет автомобиля.
  14. «%CarMark%» — марка автомобиля.
  15. «%Min%» — время до подачи, которое водитель указал в TMDriver, когда принимал заказ.
  16. «%Client%» — имя клиента (берется из карточки заказа).
  17. «%ClientCaption%» — имя заказчика из карточки физического или юридического лицасм. список изменений.
  18. «%CarArrive%» — фактическое время подачи машины, указанное в часах и минутах. В отличие от «%Min%», абсолютное время («Машина будет в 12:45») является более надежным, чем относительное («Машина будет через 5 минут»), поскольку из-за задержки отправки сообщения не теряет актуальность.
  19. «%Description%» — примечание к заказу. Будьте осторожны: объемы данных в этом поле могут быть велики с точки зрения номинального объема СМС.
  20. «%orderid%» — уникальный идентификатор заказа (его номер)см. список изменений.
  21. «%PrizePhoneCnt%» — количество заказов до призового (текст задается в параметрах).
  22. «%TaximeterDistance%» — расстояние по таксометру в километрах.
  23. «%TaximeterDuration%» — общее время в пути.

Список полей из карточки водителя:

  1. «%DrvAmount%» — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов при выходе на смену.
  2. «%DriverCellPhone%» — сотовый телефон водителя.
  3. «%DriverHomePhone%» — домашний телефон водителя.
  4. «%DriverName%» — полное имя водителя (ФИО).

Список дополнительных данных:

  1. «%DateTime%» — текущие дата и время. Формат даты и времени задается в параметрах.
  2. «%Date%» — текущая дата. Формат даты задается в параметрах.
  3. «%Time%» — текущее время. Формат времени задается в параметрах.

Ссылки