Тег — различия между версиями
Материал из TaxiMaster
(→Общие теги) |
(→Теги для сотовых телефонов и GSM-шлюзов) |
||
| Строка 14: | Строка 14: | ||
Ниже приведены теги, которые могут быть использованы для устройств, отправляющих СМС-сообщения в сети GSM: | Ниже приведены теги, которые могут быть использованы для устройств, отправляющих СМС-сообщения в сети GSM: | ||
| − | # | + | # {{code|%PrizePhoneCnt%}} — количество заказов, оставшихся до [[Призовая статистика|призовой поездки]] по телефону. |
#* Например, если следующая поездка клиента — призовая, и текст шаблона — {{code|До призового осталось %PrizePhoneCnt% заказ(а,ов)}}, то текст сообщения будет такой: {{code|До призового осталось 1 заказ(а,ов)}}. | #* Например, если следующая поездка клиента — призовая, и текст шаблона — {{code|До призового осталось %PrizePhoneCnt% заказ(а,ов)}}, то текст сообщения будет такой: {{code|До призового осталось 1 заказ(а,ов)}}. | ||
| − | # | + | # {{code|%PrizeClientCnt%}} — количество [[заказ]]ов до призовой поездки постоянного клиента. |
| − | #*Отличие от тега | + | #*Отличие от тега {{code|%PrizePhoneCnt%}} состоит в том, что берется статистика не по номеру телефона, а по [[Постоянные клиенты|номеру постоянного клиента]]. |
| − | # | + | # {{code|%DateTime%}} — текущие дата и время. Формат даты и времени задается в [[Параметры модуля СМС#Формат тегов|параметрах]]. |
| − | # | + | # {{code|%Date%}} — текущая дата. Формат даты задается в параметрах. |
| − | # | + | # {{code|%Time%}} — текущее время. Формат времени задается в параметрах. |
| − | # | + | # {{code|%Phone%}} — номер телефона заказчика. |
| − | #* Например, шаблон {{code|Заказчик (%Phone%)...}}, если номер клиента - | + | #* Например, шаблон {{code|Заказчик (%Phone%)...}}, если номер клиента - {{code|7159561}}, преобразует текст СМС так: {{code|Заказчик (79159561)...}}. |
| − | # | + | # {{code|%CPhone%}} — номер [[Телефон на отзвон|телефона на отзвон]]. |
| − | # | + | # {{code|%Src%}} — [[адрес подачи]]. |
#* Например, если адрес подачи в карточке заказа - «Пушкинская, 289», то шаблон {{code|Адрес подачи: %Src%...}} будет преобразован в текст: {{code|Адрес подачи: Пушкинская, 289}}. | #* Например, если адрес подачи в карточке заказа - «Пушкинская, 289», то шаблон {{code|Адрес подачи: %Src%...}} будет преобразован в текст: {{code|Адрес подачи: Пушкинская, 289}}. | ||
| − | # | + | # {{code|%Dest%}} — [[адрес назначения]]. |
| − | # | + | # {{code|%Client%}} — имя клиента. |
| − | # | + | # {{code|%AMount%}} — сумма за заказ (поле '''Сумма''' в [[Карточка заказа|карточке заказа]]). |
#* Например, шаблон {{code|%Src% - %Dest%, %AMount%}} позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой. | #* Например, шаблон {{code|%Src% - %Dest%, %AMount%}} позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой. | ||
| − | # | + | # {{code|%Disc%}} — скидка в процентах. |
#* Например, шаблон {{code|Скидка: %Disc%}} при скидке 5% преобразуется в сообщение {{code|Скидка: 5%}}. | #* Например, шаблон {{code|Скидка: %Disc%}} при скидке 5% преобразуется в сообщение {{code|Скидка: 5%}}. | ||
| − | # | + | # {{code|%Amnt%}} — сумма за заказ без учета скидки. |
| − | # | + | # {{code|%ITime%}} — время поступления заказа. |
| − | # | + | # {{code|%PTime%}} — время, когда нужно выполнить заказ. Полезно для оповещения водителей о предварительных заказах. |
| − | # | + | # {{code|%Cou%}} — имя контрагента. |
| − | # | + | # {{code|%CarType%}} — [[тип автомобиля]]. |
| − | # | + | # {{code|%CarCallID%}} — позывной автомобиля. |
| − | # | + | # {{code|%CarGosNum%}} — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида {{code|...госномер %CarGosNum%...}}. |
| − | # | + | # {{code|%CarColor%}} — цвет автомобиля. |
#* Этот тег также удобен для отправки заказчикам. | #* Этот тег также удобен для отправки заказчикам. | ||
#* Например, в шаблоне {{code|Машина подана: номер %CarGosNum%, цвет %CarColor%}} содержится информация о госномере и о цвете автомобиля. | #* Например, в шаблоне {{code|Машина подана: номер %CarGosNum%, цвет %CarColor%}} содержится информация о госномере и о цвете автомобиля. | ||
| − | # | + | # {{code|%Min%}} — осталось времени до подачи в указанном формате. |
| − | # | + | # {{code|%MinM%}} — осталось минут до подачи (в формате {{code|nn}}). |
| − | # | + | # {{code|%CarMark%}} — марка автомобиля. |
| − | # | + | # {{code|%DrvAmount%}} — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов. |
| + | # {{code|%PrizeRem%}} — количество поездок, оставшееся до [[Призовая статистика|призовой]]. | ||
=== Теги для mail-гейтов === | === Теги для mail-гейтов === | ||
Версия 11:02, 11 августа 2009
Тег — особая текстовая конструкция внутри большого выражения, которая автоматически заменяется на переменное значение (взятое, например, из базы данных Такси-Мастер, из карточки заказа и т. д.). Теги предназначены для того, чтобы в тексте сообщения заменять себя на значение, которое в большинстве случаев берется из программы Такси-Мастер. Теги вставляются в шаблоны СМС-сообщений.
Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам:
- Тег заключается в знаки %: %ПримерТега%.
- Тег является регистрозависимым, то есть %Тег% и %тег% — это разные теги.
Содержание
Общие теги
Существует множество общих тегов, то есть тех тегов, которые работают во всех СМС-сообщениях.
Теги для сотовых телефонов и GSM-шлюзов
Ниже приведены теги, которые могут быть использованы для устройств, отправляющих СМС-сообщения в сети GSM:
- %PrizePhoneCnt% — количество заказов, оставшихся до призовой поездки по телефону.
- Например, если следующая поездка клиента — призовая, и текст шаблона — До призового осталось %PrizePhoneCnt% заказ(а,ов), то текст сообщения будет такой: До призового осталось 1 заказ(а,ов).
- %PrizeClientCnt% — количество заказов до призовой поездки постоянного клиента.
- Отличие от тега %PrizePhoneCnt% состоит в том, что берется статистика не по номеру телефона, а по номеру постоянного клиента.
- %DateTime% — текущие дата и время. Формат даты и времени задается в параметрах.
- %Date% — текущая дата. Формат даты задается в параметрах.
- %Time% — текущее время. Формат времени задается в параметрах.
- %Phone% — номер телефона заказчика.
- Например, шаблон Заказчик (%Phone%)..., если номер клиента - 7159561, преобразует текст СМС так: Заказчик (79159561)....
- %CPhone% — номер телефона на отзвон.
- %Src% — адрес подачи.
- Например, если адрес подачи в карточке заказа - «Пушкинская, 289», то шаблон Адрес подачи: %Src%... будет преобразован в текст: Адрес подачи: Пушкинская, 289.
- %Dest% — адрес назначения.
- %Client% — имя клиента.
- %AMount% — сумма за заказ (поле Сумма в карточке заказа).
- Например, шаблон %Src% - %Dest%, %AMount% позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой.
- %Disc% — скидка в процентах.
- Например, шаблон Скидка: %Disc% при скидке 5% преобразуется в сообщение Скидка: 5%.
- %Amnt% — сумма за заказ без учета скидки.
- %ITime% — время поступления заказа.
- %PTime% — время, когда нужно выполнить заказ. Полезно для оповещения водителей о предварительных заказах.
- %Cou% — имя контрагента.
- %CarType% — тип автомобиля.
- %CarCallID% — позывной автомобиля.
- %CarGosNum% — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида ...госномер %CarGosNum%....
- %CarColor% — цвет автомобиля.
- Этот тег также удобен для отправки заказчикам.
- Например, в шаблоне Машина подана: номер %CarGosNum%, цвет %CarColor% содержится информация о госномере и о цвете автомобиля.
- %Min% — осталось времени до подачи в указанном формате.
- %MinM% — осталось минут до подачи (в формате nn).
- %CarMark% — марка автомобиля.
- %DrvAmount% — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов.
- %PrizeRem% — количество поездок, оставшееся до призовой.
Теги для mail-гейтов
Ниже приведены теги, которые могут быть использованы для mail-гейтов:
- ProviderLogin — имя пользователя для авторизации у провайдера (см. TMComDevs.ini).
- Password — пароль для авторизации у провайдера.
- SourceAddress — адрес отправителя сообщения.
- Phone — номер телефона получателя (берется из карточки заказа).
- MessageBody — непосредственно текст сообщения, которое нужно отправить.
Очевидно, что текст отправляемого сообщения берется либо из формы отправки СМС-сообщения на любой номер, либо из справочника «Водители», либо из каких-либо других справочников Такси-Мастер, в которых задается текст СМС-сообщения, отправляемого по умолчанию.
Специфические теги
Есть также специфические теги, предназначенные для массовой рассылки. Массовая рассылка — это отдельная возможность модуля, и для нее представлены следующие теги:
- %SpamStart% — начало выбранного периода, статистика за который будет рассылаться. Дата выводится в формате dd.mm.yyyy.
- %SpamStop% — конец выбранного периода статистики. Дата выводится в формате dd.mm.yyyy.
- %OrdersCnt% — количество заказов, выполненных за выбранный период статистики.
Формат тегов
Теги могут быть выведены в соответствии с особым форматом, который задается в параметрах модуля СМС. Он задает маску, по которой затем формируется значение. Маска может содержать следующие заменяемые значения:
- dd — день (число), например, 22.
- mm — номер месяца, например, 03.
- yyyy — год, обозначенный четырьмя цифрами, например, 2000.
- hh — часы, например, 22.
- nn — минуты (задействована буква “n”, поскольку “m” уже обозначает месяц), например, 58.
- ss — секунды, например, 00.
Переменные могут быть разделены пробелами, знаками . или -, а также другими знаками, однако использование других знаков не рекомендуется.
