Команды модуля AB.

Команды описанные в этом разделе предназначены для работы с адресной книгой реализуемой модулем AB и доступны если в возможности сервера COMMAND-SET указан набор команд AB.

Любым аутентифицированным пользователям доступен поиск по адресной книге (команда AB). Администраторы и операторы домена могут управлять доступностью для поиска данных отдельных пользователей (команда ABSET). Администраторы могут управлять доступностью для поиска данных пользователей целых доменов.

Команда ABLIST.

ABLIST { DOMAINS | USERS:domain } [{ START | END | CONTAIN }"text"] [start [number]]

Команда ABLIST позволяет получить списки доменов и пользователей информация о которых хранится в адресной книге. Эта команда доступна только администраторам и, с некоторыми ограничениями, операторам домена.

Первый аргумент команды указывает какой список необходимо получить: DOMAINS - список доменов, USERS:domain - список пользователей домена domain. Операторы домена могут запрашивать только список пользователей и только своего домена.

Примечание

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

Следующий аргумент является необязательным и указывает фильтр имён получаемых объектов. Аргумент определяет в какой части имени объекта будет производиться регистронезависимый поиск подстроки указанной в параметре: START - имя должно начинаться с указанной подстроки, END - имя должно заканчиваться на указанную подстроку, CONTAIN - имя должно содержать указанную подстроку. В результат включаются только те элементы списка, в именах которых найдена указанная подстрока.

Aргумент start позволяет запросить часть списка результата и задаёт индекс первого объекта с которого должен начинаться список. Первый объект имеет индекс 0. Необязательный аргумент number задаёт ограничение количества объектов результата.

Результатом успешного выполнения команды являются ноль или более *-строк каждая из которых содержит два аргумента: имя домена или пользователя в кавычках и флаг H (скрыт для поиска) или V (доступен для поиска). Вывод завершается ответом OK.

Команда ABSET.

ABSET { "user@domain" | "domain" } { HIDDEN | H | VISIBLE | V }

Команда ABSET управляет доступностью для поиска отдельных пользователей или целых доменов и доступна только администраторам и, с некоторыми ограничениями, операторам домена.

Операторы домена могут управлять доступностью для поиска только данных отдельных пользователей и только в своём домене.

Первый аргумент указывает имя объекта - пользователя или домена . Если во втором аргументе указан один из синонимов: HIDDEN или H, то объект будет скрыт для поиска, значение VISIBLE или V делает объект доступным для поиска.

Примечание

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

При успешном выполнении сервер посылает ответ OK.

Команда AB.

AB {{ START | END | CONTAIN }"text"} [number]

Команда AB предназначена для поиска данных пользователей в адресной книге и доступна любому аутентифицированному пользователю.

Ключевые слова START, END и CONTAIN указывают как в данных пользователя будет осуществляться поиск строки "text": соответственно, в начале строк, в конце строк или в любом месте строки. Последний аргумент необязателен и задаёт ограничение количества записей результата. По-умолчанию, максимальное количество записей в результате - 1000.

Поиск подстроки "text" осуществляется в следующих данных пользователей записанных в адресной книге: адрес электронной почты, имя пользователя, полное имя/название, фамилия, имя.

При успешном выполнении сервер посылает ноль или более *-строк. Каждая такая строка содержит аргументы в виде строк в кавычках: имя пользователя с доменной частью (т.е. адрес электронной почты), дополнительные почтовые ящики, полное имя/название, организация, подразделение. Если информации о каких-то из перечисленных данных нет, то на соответствующем месте указываются пустые строки "". Вывод завершается ответом OK.