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

Материал из TaxiMaster
Перейти к: навигация, поиск
(→‎Формат тегов)
Строка 1: Строка 1:
 
'''Тег''' — особая текстовая конструкция внутри большого выражения, которая автоматически заменяется на переменное значение (взятое, например, из базы данных Такси-Мастер, из [[Карточка заказа|карточки заказа]] и т. д.).
 
'''Тег''' — особая текстовая конструкция внутри большого выражения, которая автоматически заменяется на переменное значение (взятое, например, из базы данных Такси-Мастер, из [[Карточка заказа|карточки заказа]] и т. д.).
 
Теги предназначены для того, чтобы в тексте сообщения заменять себя на значение, которое в большинстве случаев берется из программы [[Такси-Мастер]].
 
Теги предназначены для того, чтобы в тексте сообщения заменять себя на значение, которое в большинстве случаев берется из программы [[Такси-Мастер]].
−
Теги вставляются в [[шаблоны СМС-сообщений]].
+
Теги вставляются в [[шаблоны СМС-сообщений]] и шаблоны E-mail.
 +
 
 +
Открыть справочник тегов можно практически из любого окна, где можно использовать теги, например, из окна нового шаблона E-mail, из окна нового шаблона СМС, из окна новой группы экипажей на вкладке уведомлений. Доступные теги зависят от окна, из которого открыт справочник тегов.
  
 
Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам:
 
Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам:
Строка 8: Строка 10:
 
# Тег является регистрозависимым, то есть {{code|%Тег%}} и {{code|%тег%}} — это разные теги.
 
# Тег является регистрозависимым, то есть {{code|%Тег%}} и {{code|%тег%}} — это разные теги.
  
−
== Общие теги ==
+
== Теги для СМС и E-mail ==
−
Существует множество общих тегов, то есть тех тегов, которые работают во всех СМС-сообщениях.
+
=== Теги заказа ===
−
Ниже приведены теги, которые могут быть использованы для устройств, отправляющих СМС-сообщения в сети GSM.
+
{{code|%Order.Id%}} - уникальный индитификатор заказа.
−
Для удобства они поделены на группы.
+
{{code|%Order.Phone%}} - номер телефона заказчика.
 +
{{code|%Order.PhoneToDial%}} - номер телефона на отзвон.
 +
{{code|%Order.SourceAddress%}} - адрес подачи.
 +
{{code|%Order.DestinationAddress%}} - адрес назначения.
 +
{{code|%Order.SourceZone%}} - район подачи.
 +
{{code|%Order.DestinationZone%}} - район назначения.
 +
{{code|%Order.StopAddresses%}} - адреса остановок.
 +
{{code|%Order.InputTime%}} - время поступления заказа.
 +
{{code|%Order.MinBeforeArrive%}} - время до подачи в минутах.
 +
{{code|%Order.SourceTime%}} - время подачи. Автоматически будет добавляться дата в том случае, если дата подачи в заказе не совпадает с текущей датой.
 +
{{code|%Order.FinishTime%}} - время завершения.
 +
{{code|%Order.TaximeterDistance%}} - расстояние по таксометру, км.
 +
{{code|%Order.TaximeterDuration%}} - общее время пути.
 +
{{code|%Order.TotalCost%}} - итоговая сумма за заказ.
 +
{{code|%Order.Cost%}} - сумма за заказ без скидки.
 +
{{code|%Order.CashSum%}} - сумма наличными.
 +
{{code|%Order.CashlessSum%}} - сумма безнал.
 +
{{code|%Order.BonusSum%}} - сумма бонусы.
 +
{{code|%Order.BankCardSum%}} - сумма банк. карта.
 +
{{code|%Order.DiscountSum%}} - сумма скидки.
 +
{{code|%Order.PayType%}} - тип расчета: наличный и безналичный.
 +
{{code|%Order.Customer%}} - заказчик из карточки заказа.
 +
{{code|%Order.PrizePhoneCnt%}} - количество заказов до призового. Текст тега задается в {{путь|Файл - Настройки - Заказы - Призовые заказы}}.
 +
{{code|%Order.Comment%}} - примечание к заказу.
 +
{{code|%Order.CreatorTaxiName%}} - название службы-создателя.
 +
{{code|%Order.CreatorTaxiPhone%}} - телефон службы-создателя.
 +
{{code|%Order.PerformerTaxiName%}} - название службы-исполнителя.
 +
{{code|%Order.PerformerTaxiPhone%}} - телефон службы-исполнителя.
 +
{{code|%Order.Tariff%}} - название тарифа.
 +
 
 +
=== Теги автомобиля ===
 +
{{code|%Car.Number%}} - гос.номер автомобиля.
 +
{{code|%Car.Color%}} - цвет автомобиля.
 +
{{code|%Car.Mark%}} - марка автомобиля.
 +
{{code|%Car.Model%}} - модель автомобиля.
 +
{{code|%Car.ShortName%}} - короткое название автомобиля.
 +
 
 +
=== Теги экипажа ===
 +
{{code|%Crew.Group%}} - название группы экипажа водителя.
 +
{{code|%Crew.Code%}} - позывной экипажа.
 +
 
 +
=== Теги водителя ===
 +
{{code|%Driver.Name%}} - ФИО водителя.
 +
{{code|%Driver.Phone%}} - основной телефон водителя.
 +
{{code|%Driver.Balance%}} - текущий баланс счета водителя.
 +
 
 +
=== Теги клиента ===
 +
{{code|%Client.Id%}} - ИД клиента.
 +
{{code|%Client.Name%}} - имя клиента.
 +
{{code|%Client.Number%}} - номер договора клиента.
 +
{{code|%Client.Balance%}} - баланс клиента.
 +
{{code|%Client.BonusBalance%}} - бонусный баланс клиента.
 +
{{code|%Client.TermAccount%}} - терминальный аккаунт клиента.
 +
{{code|%Client.APILogin%}} - логин API клиента.
 +
{{code|%Client.APIPassword%}} - пароль API клиента.
 +
{{code|%Client.ReferralCode%}} - реферальный код клиента.
 +
 
 +
=== Общие теги ===
 +
{{code|%DateTime%}} - текущая дата и время.
 +
{{code|%Date%}} - текущая дата.
 +
{{code|%Time%}} - текущее время.
 +
{{code|%Advertisement%}} - рекламный текст. Рекламные тексты задаются в {{путь|Файл - Настройки - СМС}}.
  
 +
== Устаревшие СМС теги ==
 +
В справочнике тегов можно включить отображение устаревших тегов, включив опцию "Отображать старые теги".
 
Список полей из [[КЗ|карточки заказа]]:
 
Список полей из [[КЗ|карточки заказа]]:
  

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

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

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

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

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

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

Теги заказа

«%Order.Id%» - уникальный индитификатор заказа. «%Order.Phone%» - номер телефона заказчика. «%Order.PhoneToDial%» - номер телефона на отзвон. «%Order.SourceAddress%» - адрес подачи. «%Order.DestinationAddress%» - адрес назначения. «%Order.SourceZone%» - район подачи. «%Order.DestinationZone%» - район назначения. «%Order.StopAddresses%» - адреса остановок. «%Order.InputTime%» - время поступления заказа. «%Order.MinBeforeArrive%» - время до подачи в минутах. «%Order.SourceTime%» - время подачи. Автоматически будет добавляться дата в том случае, если дата подачи в заказе не совпадает с текущей датой. «%Order.FinishTime%» - время завершения. «%Order.TaximeterDistance%» - расстояние по таксометру, км. «%Order.TaximeterDuration%» - общее время пути. «%Order.TotalCost%» - итоговая сумма за заказ. «%Order.Cost%» - сумма за заказ без скидки. «%Order.CashSum%» - сумма наличными. «%Order.CashlessSum%» - сумма безнал. «%Order.BonusSum%» - сумма бонусы. «%Order.BankCardSum%» - сумма банк. карта. «%Order.DiscountSum%» - сумма скидки. «%Order.PayType%» - тип расчета: наличный и безналичный. «%Order.Customer%» - заказчик из карточки заказа. «%Order.PrizePhoneCnt%» - количество заказов до призового. Текст тега задается в «Файл - Настройки - Заказы - Призовые заказы». «%Order.Comment%» - примечание к заказу. «%Order.CreatorTaxiName%» - название службы-создателя. «%Order.CreatorTaxiPhone%» - телефон службы-создателя. «%Order.PerformerTaxiName%» - название службы-исполнителя. «%Order.PerformerTaxiPhone%» - телефон службы-исполнителя. «%Order.Tariff%» - название тарифа.

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

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

Теги экипажа

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

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

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

Теги клиента

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

Общие теги

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

Ссылки

Источник — «http://help.taximaster.ru/index.php?title=Тег&oldid=18139»