Тег — различия между версиями
(→Специфические теги) |
|||
Строка 55: | Строка 55: | ||
# {{code|%Date%}} — текущая дата. Формат даты задается в параметрах. | # {{code|%Date%}} — текущая дата. Формат даты задается в параметрах. | ||
# {{code|%Time%}} — текущее время. Формат времени задается в параметрах. | # {{code|%Time%}} — текущее время. Формат времени задается в параметрах. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Формат тегов == | == Формат тегов == |
Версия 16:09, 11 мая 2021
Тег — особая текстовая конструкция внутри большого выражения, которая автоматически заменяется на переменное значение (взятое, например, из базы данных Такси-Мастер, из карточки заказа и т. д.). Теги предназначены для того, чтобы в тексте сообщения заменять себя на значение, которое в большинстве случаев берется из программы Такси-Мастер. Теги вставляются в шаблоны СМС-сообщений.
Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам:
- Тег заключается в знаки %: %ПримерТега% .
- Тег является регистрозависимым, то есть %Тег% и %тег% — это разные теги.
Общие теги
Существует множество общих тегов, то есть тех тегов, которые работают во всех СМС-сообщениях. Ниже приведены теги, которые могут быть использованы для устройств, отправляющих СМС-сообщения в сети GSM. Для удобства они поделены на группы.
Список полей из карточки заказа:
-
- Например, шаблон Заказчик (%Phone%)... , если номер клиента - 7159561 , преобразует текст СМС так: Заказчик (7159561)... .
%Phone% — номер телефона заказчика.
- телефона на отзвон. %CPhone% — номер
- адрес подачи. %Src% —
- адрес назначения. %Dest% —
- Сумма в карточке заказа).
- Например, шаблон %Src% - %Dest%, %Amount% позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой.
%Amount% — сумма за заказ (поле -
- Например, шаблон Скидка: %Disc% р при скидке 5% и стоимости заказа 100 рублей преобразуется в сообщение Скидка: 5 р .
%Disc% — результирующая скидка в рублях.
- %ITime% — время поступления заказа.
- %PTime% — время подачи, то есть время, в которое нужно начать выполнение заказа. Полезно для оповещения водителей о предварительных заказах.
- %Cou% —
- %CarType% — тип автомобиля (наименование).
- %CarCallID% — позывной автомобиля.
-
- Например, в шаблоне Машина подана: номер %CarGosNum%, цвет %CarColor% содержится информация о госномере и о цвете автомобиля.
%CarGosNum% — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида ...госномер %CarGosNum%... .
- %CarColor% — цвет автомобиля.
- %CarMark% — марка автомобиля.
- TMDriver, когда принимал заказ. %Min% — время до подачи, которое водитель указал в
- %Client% — имя клиента (берется из карточки заказа).
- физического или юридического лицасм. список изменений. %ClientCaption% — имя заказчика из карточки
- («Машина будет в 12:45») является более надежным, чем относительное («Машина будет через 5 минут»), поскольку из-за задержки отправки сообщения не теряет актуальность. %CarArrive% — фактическое время подачи машины, указанное в часах и минутах. В отличие от %Min% , абсолютное время
- %Description% — примечание к заказу. Будьте осторожны: объемы данных в этом поле могут быть велики с точки зрения номинального объема СМС.
- см. список изменений. %orderid% — уникальный идентификатор заказа (его номер)
- параметрах). %PrizePhoneCnt% — количество заказов до призового (текст задается в
- %TaximeterDistance% — расстояние по таксометру в километрах.
- %TaximeterDuration% — общее время в пути.
Список полей из карточки водителя:
- %DrvAmount% — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов при выходе на смену.
- %DriverCellPhone% — сотовый телефон водителя.
- %DriverHomePhone% — домашний телефон водителя.
- %DriverName% — полное имя водителя (ФИО).
Список дополнительных данных:
- параметрах. %DateTime% — текущие дата и время. Формат даты и времени задается в
- %Date% — текущая дата. Формат даты задается в параметрах.
- %Time% — текущее время. Формат времени задается в параметрах.
Формат тегов
Теги могут быть выведены в соответствии с особым форматом, который задается в параметрах модуля СМС. Он задает маску, по которой затем формируется значение. Маска может содержать следующие заменяемые значения:
- dd — день (число), например, 22 .
- mm — номер месяца, например, 03 .
- yyyy — год, обозначенный четырьмя цифрами, например, 2000 .
- hh — часы, например, 22 .
- nn — минуты (задействована буква “n”, поскольку “m” уже обозначает месяц), например, 58 .
- ss — секунды, например, 00 .
Переменные могут быть разделены пробелами, знаками
. или - , а также другими знаками, однако использование других знаков не рекомендуется.