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

Материал из TaxiMaster
Перейти к: навигация, поиск
(→‎Формат тегов)
(→‎Теги для сотовых телефонов и GSM-шлюзов)
Строка 12: Строка 12:
  
 
=== Теги для сотовых телефонов и GSM-шлюзов ===
 
=== Теги для сотовых телефонов и GSM-шлюзов ===
−
Ниже приведены теги, которые могут быть использованы для устройств, отправляющих СМС-сообщения в сети GSM:
+
Ниже приведены теги, которые могут быть использованы для устройств, отправляющих СМС-сообщения в сети GSM.
 +
Для удобства они поделены на группы.
  
−
# {{code|%PrizePhoneCnt%}} — количество заказов, оставшихся до [[Призовая статистика|призовой поездки]] по телефону.
+
Список полей общего назначения [[КЗ|карточки заказа]]:
−
#* Например, если следующая поездка клиента — призовая, и текст шаблона — {{code|До призового осталось %PrizePhoneCnt% заказ(а,ов)}}, то текст сообщения будет такой: {{code|До призового осталось 1 заказ(а,ов)}}.
+
 
−
# {{code|%PrizeClientCnt%}} — количество [[заказ]]ов до призовой поездки постоянного клиента.
+
# {{code|%ITime%}} — время поступления заказа.  
−
#*Отличие от тега {{code|%PrizePhoneCnt%}} состоит в том, что берется статистика не по номеру телефона, а по [[Постоянные клиенты|номеру постоянного клиента]].
+
# {{code|%PTime%}} — время, когда нужно выполнить заказ. Полезно для оповещения водителей о предварительных заказах.  
−
# {{code|%DateTime%}} — текущие дата и время. Формат даты и времени задается в [[Параметры модуля СМС#Формат тегов|параметрах]].
 
−
# {{code|%Date%}} — текущая дата. Формат даты задается в параметрах.
 
−
# {{code|%Time%}} — текущее время. Формат времени задается в параметрах.
 
 
# {{code|%Phone%}} — номер телефона заказчика.
 
# {{code|%Phone%}} — номер телефона заказчика.
 
#* Например, шаблон {{code|Заказчик (%Phone%)...}}, если номер клиента - {{code|7159561}}, преобразует текст СМС так: {{code|Заказчик (79159561)...}}.
 
#* Например, шаблон {{code|Заказчик (%Phone%)...}}, если номер клиента - {{code|7159561}}, преобразует текст СМС так: {{code|Заказчик (79159561)...}}.
 
# {{code|%CPhone%}} — номер [[Телефон на отзвон|телефона на отзвон]].
 
# {{code|%CPhone%}} — номер [[Телефон на отзвон|телефона на отзвон]].
−
# {{code|%Src%}} — [[адрес подачи]].
 
−
#* Например, если адрес подачи в карточке заказа - «Пушкинская, 289», то шаблон {{code|Адрес подачи: %Src%...}} будет преобразован в текст: {{code|Адрес подачи: Пушкинская, 289}}.
 
−
# {{code|%Dest%}} — [[адрес назначения]].
 
 
# {{code|%Client%}} — имя клиента.
 
# {{code|%Client%}} — имя клиента.
 
# {{code|%AMount%}} — сумма за заказ (поле '''Сумма''' в [[Карточка заказа|карточке заказа]]).
 
# {{code|%AMount%}} — сумма за заказ (поле '''Сумма''' в [[Карточка заказа|карточке заказа]]).
Строка 33: Строка 28:
 
#* Например, шаблон {{code|Скидка: %Disc%}} при скидке 5% преобразуется в сообщение {{code|Скидка: 5%}}.
 
#* Например, шаблон {{code|Скидка: %Disc%}} при скидке 5% преобразуется в сообщение {{code|Скидка: 5%}}.
 
# {{code|%Amnt%}} — сумма за заказ без учета скидки.  
 
# {{code|%Amnt%}} — сумма за заказ без учета скидки.  
−
# {{code|%ITime%}} — время поступления заказа.  
+
# {{code|%CarMark%}} — марка автомобиля.
−
# {{code|%PTime%}} — время, когда нужно выполнить заказ. Полезно для оповещения водителей о предварительных заказах.  
+
# {{code|%CarGosNum%}} — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида {{code|...госномер %CarGosNum%...}}.
 +
#* Например, в шаблоне {{code|Машина подана: номер %CarGosNum%, цвет %CarColor%}} содержится информация о госномере и о цвете автомобиля.
 +
# {{code|%CarColor%}} — цвет автомобиля.
 +
# {{code|%CarArrive%}} — фактическое время подачи машины, указанное в часах и минутах. В отличие от {{code|%Min%}}, абсолютное время {{серым|(«Машина будет в 12:45»)}} является более надежным, чем относительное {{серым|(«Машина будет через 5 минут»)}}, поскольку из-за задержки отправки сообщения не теряет актуальность.
 +
 
 +
Список полей для водителей:
 +
 
 +
# {{code|%Src%}} — [[адрес подачи]].
 +
#* Например, если адрес подачи в карточке заказа — «Пушкинская, 289», то шаблон {{code|Адрес подачи: %Src%...}} будет преобразован в текст: {{code|Адрес подачи: Пушкинская, 289}}.
 +
# {{code|%Dest%}} — [[адрес назначения]].
 
# {{code|%Cou%}} — имя контрагента.
 
# {{code|%Cou%}} — имя контрагента.
 
# {{code|%CarType%}} — [[тип автомобиля]].
 
# {{code|%CarType%}} — [[тип автомобиля]].
 
# {{code|%CarCallID%}} — позывной автомобиля.
 
# {{code|%CarCallID%}} — позывной автомобиля.
−
# {{code|%CarGosNum%}} — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида {{code|...госномер %CarGosNum%...}}.
+
# {{code|%DrvAmount%}} — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов при выходе на смену.
−
# {{code|%CarColor%}} — цвет автомобиля.
+
 
−
#* Этот тег также удобен для отправки заказчикам.
+
Список дополнительных данных:
−
#* Например, в шаблоне {{code|Машина подана: номер %CarGosNum%, цвет %CarColor%}} содержится информация о госномере и о цвете автомобиля.  
+
 
−
# {{code|%CarArrive%}} — фактическое время подачи машины, указанное в часах и минутах. В отличие от {{code|%Min%}}, абсолютное время {{серым|(«Машина будет в 12:45»)}} является более надежным, чем относительное {{серым|(«Машина будет через 5 минут»)}}, поскольку из-за задержки отправки сообщения не теряет актуальность.
+
# {{code|%DateTime%}} — текущие дата и время. Формат даты и времени задается в [[Параметры модуля СМС#Формат тегов|параметрах]].
 +
# {{code|%Date%}} — текущая дата. Формат даты задается в параметрах.  
 +
# {{code|%Time%}} — текущее время. Формат времени задается в параметрах.
 +
# {{code|%PrizePhoneCnt%}} — количество заказов, оставшихся до [[Призовая статистика|призовой поездки]] по телефону.
 +
#* Например, если следующая поездка клиента — призовая, и текст шаблона — {{code|До призового осталось %PrizePhoneCnt% заказ(а,ов)}}, то текст сообщения будет такой: {{code|До призового осталось 1 заказ(а,ов)}}.
 +
# {{code|%PrizeClientCnt%}} — количество [[заказ]]ов до призовой поездки постоянного клиента.
 +
#*Отличие от тега {{code|%PrizePhoneCnt%}} состоит в том, что берется статистика не по номеру телефона, а по [[Постоянные клиенты|номеру постоянного клиента]].
 
# {{code|%Min%}} — осталось времени до подачи в указанном формате.
 
# {{code|%Min%}} — осталось времени до подачи в указанном формате.
 
# {{code|%MinM%}} —  осталось минут до подачи (в формате {{code|nn}}).
 
# {{code|%MinM%}} —  осталось минут до подачи (в формате {{code|nn}}).
−
# {{code|%CarMark%}} — марка автомобиля.
 
−
# {{code|%DrvAmount%}} — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов.
 
  
 
=== Теги для mail-гейтов ===
 
=== Теги для mail-гейтов ===

Версия 16:08, 11 декабря 2009

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

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

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

Общие теги

Существует множество общих тегов, то есть тех тегов, которые работают во всех СМС-сообщениях.

Теги для сотовых телефонов и GSM-шлюзов

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

Список полей общего назначения карточки заказа:

  1. «%ITime%» — время поступления заказа.
  2. «%PTime%» — время, когда нужно выполнить заказ. Полезно для оповещения водителей о предварительных заказах.
  3. «%Phone%» — номер телефона заказчика.
    • Например, шаблон «Заказчик (%Phone%)...», если номер клиента - «7159561», преобразует текст СМС так: «Заказчик (79159561)...».
  4. «%CPhone%» — номер телефона на отзвон.
  5. «%Client%» — имя клиента.
  6. «%AMount%» — сумма за заказ (поле Сумма в карточке заказа).
    • Например, шаблон «%Src% - %Dest%, %AMount%» позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой.
  7. «%Disc%» — скидка в процентах.
    • Например, шаблон «Скидка: %Disc%» при скидке 5% преобразуется в сообщение «Скидка: 5%».
  8. «%Amnt%» — сумма за заказ без учета скидки.
  9. «%CarMark%» — марка автомобиля.
  10. «%CarGosNum%» — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида «...госномер %CarGosNum%...».
    • Например, в шаблоне «Машина подана: номер %CarGosNum%, цвет %CarColor%» содержится информация о госномере и о цвете автомобиля.
  11. «%CarColor%» — цвет автомобиля.
  12. «%CarArrive%» — фактическое время подачи машины, указанное в часах и минутах. В отличие от «%Min%», абсолютное время («Машина будет в 12:45») является более надежным, чем относительное («Машина будет через 5 минут»), поскольку из-за задержки отправки сообщения не теряет актуальность.

Список полей для водителей:

  1. «%Src%» — адрес подачи.
    • Например, если адрес подачи в карточке заказа — «Пушкинская, 289», то шаблон «Адрес подачи: %Src%...» будет преобразован в текст: «Адрес подачи: Пушкинская, 289».
  2. «%Dest%» — адрес назначения.
  3. «%Cou%» — имя контрагента.
  4. «%CarType%» — тип автомобиля.
  5. «%CarCallID%» — позывной автомобиля.
  6. «%DrvAmount%» — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов при выходе на смену.

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

  1. «%DateTime%» — текущие дата и время. Формат даты и времени задается в параметрах.
  2. «%Date%» — текущая дата. Формат даты задается в параметрах.
  3. «%Time%» — текущее время. Формат времени задается в параметрах.
  4. «%PrizePhoneCnt%» — количество заказов, оставшихся до призовой поездки по телефону.
    • Например, если следующая поездка клиента — призовая, и текст шаблона — «До призового осталось %PrizePhoneCnt% заказ(а,ов)», то текст сообщения будет такой: «До призового осталось 1 заказ(а,ов)».
  5. «%PrizeClientCnt%» — количество заказов до призовой поездки постоянного клиента.
  6. «%Min%» — осталось времени до подачи в указанном формате.
  7. «%MinM%» — осталось минут до подачи (в формате «nn»).

Теги для mail-гейтов

Ниже приведены теги, которые могут быть использованы для mail-гейтов:

  1. «ProviderLogin» — имя пользователя для авторизации у провайдера (см. «TMComDevs.ini»).
  2. «Password» — пароль для авторизации у провайдера.
  3. «SourceAddress» — адрес отправителя сообщения.
  4. «Phone» — номер телефона получателя (берется из карточки заказа).
  5. «MessageBody» — непосредственно текст сообщения, которое нужно отправить.

Очевидно, что текст отправляемого сообщения берется либо из формы отправки СМС-сообщения, либо из справочника «Водители», либо из каких-либо других справочников Такси-Мастер, в которых задается текст СМС-сообщения, отправляемого по умолчанию.

Специфические теги

Есть также специфические теги, предназначенные для массовой рассылки. Массовая рассылка — это отдельная возможность модуля, и для нее представлены следующие теги:

  1. «%SpamStart%» — начало выбранного периода, статистика за который будет рассылаться. Дата выводится в формате «dd.mm.yyyy».
  2. «%SpamStop%» — конец выбранного периода статистики. Дата выводится в формате «dd.mm.yyyy».
  3. «%OrdersCnt%» — количество заказов, выполненных за выбранный период статистики.

Формат тегов

Теги могут быть выведены в соответствии с особым форматом, который задается в параметрах модуля СМС. Он задает маску, по которой затем формируется значение. Маска может содержать следующие заменяемые значения:

  1. «dd» — день (число), например, «22».
  2. «mm» — номер месяца, например, «03».
  3. «yyyy» — год, обозначенный четырьмя цифрами, например, «2000».
  4. «hh» — часы, например, «22».
  5. «nn» — минуты (задействована буква “n”, поскольку “m” уже обозначает месяц), например, «58».
  6. «ss» — секунды, например, «00».

Переменные могут быть разделены пробелами, знаками «.» или «-», а также другими знаками, однако использование других знаков не рекомендуется.

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