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

Материал из TaxiMaster
Перейти к: навигация, поиск
(Устаревшие СМС теги)
(Устаревшие СМС теги)
Строка 117: Строка 117:
 
Список дополнительных данных:
 
Список дополнительных данных:
  
# {{code|%DateTime%}} — текущие дата и время. Формат даты и времени задается в [[Параметры модуля СМС#Формат тегов|параметрах]].
+
# {{code|%DateTime%}} — текущие дата и время.  
 
# {{code|%Date%}} — текущая дата. Формат даты задается в параметрах.  
 
# {{code|%Date%}} — текущая дата. Формат даты задается в параметрах.  
 
# {{code|%Time%}} — текущее время. Формат времени задается в параметрах.
 
# {{code|%Time%}} — текущее время. Формат времени задается в параметрах.

Версия 13:40, 27 августа 2021

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

Открыть справочник тегов можно практически из любого окна, где можно использовать теги, например, из окна нового шаблона E-mail, из окна нового шаблона СМС, из окна новой группы экипажей на вкладке уведомлений. Доступные теги зависят от окна, из которого открыт справочник тегов.

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

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

Теги для СМС и E-mail

Теги заказа

  1. «%Order.Id%» - уникальный индитификатор заказа.
  2. «%Order.Phone%» - номер телефона заказчика.
  3. «%Order.PhoneToDial%» - номер телефона на отзвон.
  4. «%Order.SourceAddress%» - адрес подачи.
  5. «%Order.DestinationAddress%» - адрес назначения.
  6. «%Order.SourceZone%» - район подачи.
  7. «%Order.DestinationZone%» - район назначения.
  8. «%Order.StopAddresses%» - адреса остановок.
  9. «%Order.InputTime%» - время поступления заказа.
  10. «%Order.MinBeforeArrive%» - время до подачи в минутах.
  11. «%Order.SourceTime%» - время подачи. Автоматически будет добавляться дата в том случае, если дата подачи в заказе не совпадает с текущей датой.
  12. «%Order.FinishTime%» - время завершения.
  13. «%Order.TaximeterDistance%» - расстояние по таксометру, км.
  14. «%Order.TaximeterDuration%» - общее время пути.
  15. «%Order.TotalCost%» - итоговая сумма за заказ.
  16. «%Order.Cost%» - сумма за заказ без скидки.
  17. «%Order.CashSum%» - сумма наличными.
  18. «%Order.CashlessSum%» - сумма безнал.
  19. «%Order.BonusSum%» - сумма бонусы.
  20. «%Order.BankCardSum%» - сумма банк. карта.
  21. «%Order.DiscountSum%» - сумма скидки.
  22. «%Order.PayType%» - тип расчета: наличный и безналичный.
  23. «%Order.Customer%» - заказчик из карточки заказа.
  24. «%Order.PrizePhoneCnt%» - количество заказов до призового. Текст тега задается в «Файл - Настройки - Заказы - Призовые заказы».
  25. «%Order.Comment%» - примечание к заказу.
  26. «%Order.CreatorTaxiName%» - название службы-создателя.
  27. «%Order.CreatorTaxiPhone%» - телефон службы-создателя.
  28. «%Order.PerformerTaxiName%» - название службы-исполнителя.
  29. «%Order.PerformerTaxiPhone%» - телефон службы-исполнителя.
  30. «%Order.Tariff%» - название тарифа.

Теги автомобиля

  1. «%Car.Number%» - гос.номер автомобиля.
  2. «%Car.Color%» - цвет автомобиля.
  3. «%Car.Mark%» - марка автомобиля.
  4. «%Car.Model%» - модель автомобиля.
  5. «%Car.ShortName%» - короткое название автомобиля.

Теги экипажа

  1. «%Crew.Group%» - название группы экипажа водителя.
  2. «%Crew.Code%» - позывной экипажа.

Теги водителя

  1. «%Driver.Name%» - ФИО водителя.
  2. «%Driver.Phone%» - основной телефон водителя.
  3. «%Driver.Balance%» - текущий баланс счета водителя.

Теги клиента

  1. «%Client.Id%» - ИД клиента.
  2. «%Client.Name%» - имя клиента.
  3. «%Client.Number%» - номер договора клиента.
  4. «%Client.Balance%» - баланс клиента.
  5. «%Client.BonusBalance%» - бонусный баланс клиента.
  6. «%Client.TermAccount%» - терминальный аккаунт клиента.
  7. «%Client.APILogin%» - логин API клиента.
  8. «%Client.APIPassword%» - пароль API клиента.
  9. «%Client.ReferralCode%» - реферальный код клиента.

Общие теги

  1. «%DateTime%» - текущая дата и время.
  2. «%Date%» - текущая дата.
  3. «%Time%» - текущее время.
  4. «%Advertisement%» - рекламный текст. Рекламные тексты задаются в «Файл - Настройки - СМС».

Устаревшие СМС теги

В справочнике тегов можно включить отображение устаревших тегов, включив опцию "Отображать старые теги". Список полей из карточки заказа:

  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%» — текущее время. Формат времени задается в параметрах.

Ссылки