|
<< Кликните, чтобы показать Содержание >> Действие TAG |
Добавляет к метаданным объекта тег (числовую метку).
Описание
Это действие устанавливает в метаданных объекта тег (числовую метку). Тегов может быть несколько. В этом случае они перечисляются через запятую ',' или точку с запятой ';'. Если один и тот же тег устанавливать для объекта несколько раз, то у тега повышается "уровень" (его числовое значение). У каждого тега есть внутренний счётчик, показывающий, сколько раз он был установлен для этого объекта.
Существование тега, а также значение его счётчика (сколько раз он был установлен для текущего объекта) можно впоследствии проверять в условиях фильтров для принятия решений.
По умолчанию значение счётчика при установке тега увеличивается на 1. Если счётчик тега необходимо увеличить более чем на 1, то можно задавать значение, на которое необходимо увеличить счётчик, после имени тега в круглых скобках: "TAG(...)". Например, SPAM(3) – увеличивает значение счётчика для тега SPAM на 3, а SPAM(1) равносильно просто SPAM. Это может быть необходимо в случаях, когда условия, устанавливающие один и тот же тег, имеют разную значимость / важность / приоритет.
Значение для изменения счётчика может быть отрицательным. SPAM(-3) – уменьшает значение счётчика для тега SPAM на 3.
Установленные в этом действии теги в дальнейшем будут доступны в условиях фильтра сообщений , если из данного HTTP-объекта будет извлечено сообщение. |
|---|
Формат
<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">SPAM, shopping</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>Filter comment.</comment> <table name="main">
<rule enabled="true"> <comment> Mark requests to popular Russian mail services with 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> |
|---|