Skip to end of metadata
Go to start of metadata

Архива поддерживает гибкое определение полей заголовков почтового сообщения. Под полями почтового сообщения подразумеваются такие заголовки как От кого, Кому, Тема и другие (англ. To, From, Subject). При редактировании файла с определениями полей можно изменить, какие из заголовков будут индексироваться, какие будут видны, экспортированы и проч. После того как вы изменили определение поля заголовка, необходимо перезагрузить сервер Архива. Система пока ещё не в состоянии загружать изменения в процессе изменения.

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

Для нахождения точного месторасположения [main application и настройки] обратитесь в Разделы файловой системы

В директорию [настройки]. Для Linux это будет /etc/opt/mailarchiva/ROOT

Отредактируйте скопированный файл config_category_email.xml с использованием текстового редактора Notepad или VI. 

Спецификации поля

Внутри файла XML указаны все связанные с почтовым сообщением поля. К примеру, вот как выглядит опеределение поля в файле: 

Определние в XML требует объяснения:

ЭлементПримерОписание
nametoимя поля
typeemailaddressтип поля
resourcefield_label_toимя ресурса в файле application.properties
use для чего используется это поле
usageretentionразрешено указывать в правилах сохранения

Применение

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

ПрименениеОписание
exportПозволяет экспортировать поле
basicheaderviewОтображает поле в стандартном просмотре заголовка
advancedheaderviewОтображает поле в развернутом просмотре заголовка
archiveruleПозволяет использовать поле в правилах архивирования
searchquery

Позволяет использовать поле в поисковых запросах

retentionПозволяет использовать поле в определении правил сохранения
searchresultsОтображает поле в результатах поиска
index_tokenizedПомечает и индексирует поле в индексе поиска
index_storedХранит и индексирует поле в индексе поиска
index_tokenized_and_storedПомечает, хранит и индексирует поле в индексе поиска
ldapВозвращает из ldap [в данный момент не поддерживается]
downloadПозволяет скачивать поле
viewsourceПозволяет демонстрацию поля при просмотре источника
printПоказывает поле в просмотре для печати
viewОтображает поле в основном просмотре
stubruleПозволяет показывать поле в правиле стаббинга

Типы

Данные типы данных определяют, как данные в поле заголовка хранятся в индексе и как эти данные демонстрируются пользователю. 

Тип данныхОписание
stringтекстовая строка
integerцелое число
longдлинное целое число
floatчисло с плавающей точкой
double

число двойной точности

booleantrue/false
dateдата
emailaddressпочтовый адрес
sizeразмер в kb/mb/gb/tb

Составные поля

Составные поля - это те, что содержат в себе несколько других полей. Примером составного поля является anyaddress. Он определяется, как показано ниже: 

Пользовательские заголовки

Используя динамические поля, можно настроить Архива на поддержку любого пользовательского почтового заголовка. К примеру, рассылка вашей компании устанавливает заголовок MIME, называющийся X-Originating-IP. Когда динамическое поле X-Originating-IP будет добавлено в файл настройки полей пользователя (в файле шаблона config_category_email.xml расположенный в разделе файловой системы с назначением настройки), Архива EE возвратит содержимое заголовка и применит его по назначению.  Для применения для применения пользовательских заголовков система должны быть перезагружена. 

К примеру, нам необходимо добавить новое поле X-Originating-IP

Для этого необходимо:

  • скачать шаблон определения пользовательских полей
  • поместить данный файл в раздел файловой системы с назначением настройки
  • отредактировать данный файл и добавить нужные поля
  • перезапустить Архива EE

К примеру, это динамическое поле определено следующим образом:  

Имя поля должно совпадать с именем заголовка MIME. 

 

config_category_email.xml



Более того, строка: 

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

После этого необходимо перезагрузить Архива. В примере выше поле X-Originating-IP должно быть проиндексировано и сохранено. Поле должно появиться в выпадающем списке доступных полей для поиска. 

Метка сноски поля определяет поле, на которое указывает поле-контейнер anyaddress. Поэтому, когда кто-то будет искать письма с помощью anyaddress, по полям, содержащимся в поле-контейнере, тоже будет произведен поиск.    

  • No labels