Документация для разработчиков
Темная тема
Недоступно в редакциях: Малый бизнес, Стандарт, Старт

Создание и редактирование правила

Форма редактирования параметров правила предназначена для создания новых правил обработки почтовых сообщений и редактирования уже созданных. Для создания нового правила вам следует заполнить поля формы и нажать кнопку Сохранить.


Контекстная панель

Кнопка Описание
Список правил Переход на страницу со списком правил.
Добавить новое правило Переход к форме создания нового правила.

Кнопка отображается при редактировании существующего правила.
Удалить данное правило Удаление данного ящика.

Кнопка отображается при редактировании существующего правила.


Закладка Параметры

Поле Описание
Код Код правила, под которым оно было сохранено.

Отображается при редактировании существующего правила.
Последнее изменение Дата и время последнего изменения правила.

Отображается при редактировании существующего правила.
Почтовый ящик Почтовый ящик, к которому должно применяться это правило. Для создания нового почтового ящика, вы можете кликнуть ссылку Создать.
Активность Если этот флаг установлен, правило активно и может быть применено к сообщениям.
Если флаг не установлен, правило не применяется к сообщениям.

См. тж. поле Применять при событиях.
* Название Любое осмысленное название данного правила.
Описание Произвольное описание правила.
Сортировка Вес сортировки правила; применяется при отображении правила в списке.
Применять при событиях Типы событий, при которых следует применять это правило:
  • При получении почты - если флаг установлен, правило будет применяться к каждому сообщению при получении почты с почтового ящика, для которого создано это правило. Если флаг сброшен, правило не будет автоматически применяться при получении почты;
  • При принудительном вызове правила - если флаг установлен, правило можно будет применить в ручном режиме.

* - поля, обязательные для заполнения.



Закладка Условия

Поле Описание
Группы полей для задания условий Задание условий предварительной фильтрации сообщений перед тем как к ним будет применено данное правило.

Для получения подробной информации по полям группы см. примечания ниже.
Вероятность, что сообщение спам Правило будет применяться только к сообщениям, параметр СПАМ коэф. которых удовлетворяет этому условию; т.е. больше или меньше уровня, задаваемого в процентах.

Например, если выставить данное условие в "больше 90%", то правило будет применяться только к тем сообщениям, вероятность спама которых превышает 90%.
Размер сообщения Правило будет применяться только к сообщениям, размер которых удовлетворяет этому условию.
Условие на PHP скрипте Опциональный PHP скрипт, который исполняется во время определения возможности применения правила к сообщению. PHP скрипт должен определить допустимость применения правила к сообщению и вернуть значение true или false.

Для получения подробной информации об этом поле см. примечания ниже.
Настройки добавления сообщения в техподдержку
Эта группа настроек отображается только при создании правила с шаблоном "Добавление сообщения в техподдержку"
Определять по E-Mail ранее зарегистрированного пользователя Если это условие установлено в да..., то при получении нового сообщения правило будет предпринимать попытки найти зарегистрированного пользователя с таким адресом в базе данных и привязать сообщение к нему.
В противном случае, при получении писем с любых адресов сообщения в модуле техподдержки будут создаваться как анонимные.
Добавлять новое сообщение в уже открытое обращение Условие определяет, сообщения с какого адреса могут быть добавлены в открытое обращение в техподдержку.

При установке флага как скрытое... сообщение будет доступно только сотрудникам техподдержки.
Шаблоны темы для определения ответа на обращение Регулярные выражения, применяемые для сортировки входящих сообщений. Поле предназначено для разработчиков; не рекомендуется изменять его значение без надобности.
Привязывать новое обращение к сайту Указание на сайт, к которому будет привязано вновь создаваемое обращение.
Привязывать новое обращение к категории Указание категории обращения, к которой будет привязано вновь создаваемое обращение.
Назначить новому обращению критичность Позволяет указать критичность вновь создаваемого обращения.


Закладка Действия

Поле Описание
Установить статус прочтенности Позволяет отметить все сообщения, к которым будет применяться это правило, как прочитанные.
Установить пометку спам Позволяет отметить все сообщения, к которым будет применяться это правило, как сообщения массовой рассылки.
Действие на PHP скрипте Опциональный PHP скрипт, который исполняется во время применения правила к сообщению.
Удалить сообщение Удаляет сообщения, к которым применяется правило.
Не обрабатывать другими правилами Указывает, что после применения этого правила к конкретному сообщению, остальные правила не будут применены к нему, даже если сообщение удовлетворяет условиям правила.


Группы полей для задания условий

Первый выпадающий список группы содержит перечень текстовых свойств сообщения, которые являются источником информации для фильтра (операнд).

Второй выпадающий список содержит перечень компаративных операторов (операторов сравнения), определяющих тип операции сравнения, применяемой к тексту свойства, выбранного в первом списке при фильтрации. В качестве функционального оператора может быть выбран пункт Регулярное выражение. Синтаксис используемых регулярных выражений соответствует спецификации PCRE. Описание синтаксиса можно найти здесь: http://ru2.php.net/manual/en/reference.pcre.pattern.syntax.php.

Поле ввода текста предназначено для ввода образца текста, с которым производится сравнение текста свойства первого списка.


Пример

Для того чтобы правило применялось ко всем входящим сообщениям, в поле Тема которых присутствует слово "Заказ", установите следующие значения полей:

  • Операнд - Тема;
  • Оператор - Содержит;
  • Образец - Заказ.


Пример условия на PHP скрипте

Поставляемые возможности в большинстве случаев достаточны для задания условий отбора сообщений. Однако, если стандартные механизмы не позволяют реализовать требуемые условия отбора сообщений, предусмотрена возможность создания пользовательских программных условий отбора. Скрипт для отбора сообщений должен быть написан на языке PHP. Во время выполнения условного скрипта гарантируется валидность массива полей сообщения $arMessageFields.

Условный PHP-скрипт должен вернуть true, если условие выполняется и к сообщению может быть применено правило, или false в противном случае.


Пример

if ($arMessageFields["FIELD_PRIORITY"] > 3 || strpos($arMessageFields["FIELD_FROM"], "@bitrix") > 0)
return true;
return false;


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх