|
<< Кликните, чтобы показать Содержание >> Действие TAG |
Добавляет к метаданным сообщения тег (числовую метку).
Описание
Это действие устанавливает в метаданных сообщения тег (числовую метку). Тегов может быть несколько. В этом случае они перечисляются через запятую ',' или точку с запятой ';'. Если один и тот же тег устанавливать для объекта несколько раз, то у тега повышается "уровень" (его числовое значение). Иначе говоря, у каждого тега есть внутренний счётчик, показывающий, сколько раз он был установлен для этого объекта.
Установлен тег или нет, а также значение его счётчика (сколько раз он был установлен для текущего объекта) можно впоследствии проверять в условиях фильтров для принятия решений.
По умолчанию значение счётчика при установке тега увеличивается на 1. Если счётчик тега необходимо увеличить более чем на 1, то можно задавать значение, на которое необходимо увеличить счётчик после имени тега в круглых скобках: "TAG(...)". Например, SPAM(3) – увеличивает значение счётчика для тега SPAM на 3, а SPAM(1) равносильно просто SPAM. Это может быть необходимо в случаях, когда условия, устанавливающие один и тот же тег, имеют разную значимость, важность или приоритет.
Значение для изменения счётчика может быть отрицательным. SPAM(-3) – уменьшает значение счётчика для тега SPAM на 3.
Формат
<action name="tag" value="<tag list>" /> |
|---|
или
<action name="tag" > tag list </action> |
|---|
Атрибут "name":
В атрибуте "name" укажите имя действия: name="tag".
Атрибут "value":
В атрибуте value="..." перечисляются имена тегов.
Имена тегов также можно перечислять в самом теге "action".
Пример:
<action name="tag" value="SPAM" /> |
|---|
Устанавливает тег с именем "SPAM".
<action name="tag" value="SPAM(3)" /> |
|---|
Устанавливает тег с именем "SPAM" и увеличивает его счётчик на 3.
<action name="tag" value="SPAM, shopping" /> |
|---|
Устанавливает теги с именами "SPAM" и "shopping".
<action name="tag" value="SPAM(3), shopping(2)" /> |
|---|
Устанавливает теги с именами "SPAM" и "shopping" и увеличивает их счётчики на 3 и 2 соответственно.
<action name="tag" value="SPAM, shopping">VIP-OFFICE</action> |
|---|
Также устанавливает теги с именами "SPAM" и "shopping".
<action name="tag" value="SPAM, shopping">VIP-OFFICE</action> |
|---|
Устанавливает теги с именами "SPAM", "shopping", "VIP-OFFICE".
Пример:
Пометить запросы на популярные российские почтовые сервисы тегом RUS_MAIL.
<?xml version="1.0" encoding="utf-8"?> <filter name="TEST" version="1.0"> <comment>This is the comment for the filter.</comment> <table name="main">
<rule enabled="true"> <comment> Mark requests to popular Russian mail services with the RUS_MAIL tag. </comment> <match> <c name="req-header" headername="Host" op="eq" value="win.mail.ru" /> <c name="req-header" headername="Host" op="eq" value="mail.yandex.ru" /> <c name="req-header" headername="Host" op="eq" value="mail.rambler.ru" /> </match> <action name="tag" value="RUS_MAIL"/> </rule>
<rule enabled="true"> <match><c name="all"/></match> <action name="accept" /> </rule>
</table> </filter> |
|---|