XIMSS Протокол

При установлении соединения, Сервер берёт IP Адрес, с которым соединился клиент и выбирает Домен, которому назначен этот IP адрес.

В этом разделе в операциях может явно задаваться альтернативный целевой Домен: если он найден, то он считается целевым доменом и используется в следующих операциях.

listFeatures

Эта операция указывает серверу вернуть сообщение features, содержащее текущие доступные опции аутентификации и коммуникации.

Атрибуты:

domain

опциональное имя целевого Домена.

readStrings

Эта операция читает новый словарь (слова, тэги, имена кнопок и т.п.), хранящийся на Сервере. Сервер отправляет сообщение с данными strings, содержащее данные словаря (смотрите ниже).

Атрибуты:

language

язык словаря. Если атрибут отсутствует, то используется строка из настройки Пользователя Язык.

starttls

Эта операция указывает серверу установить SSL/TLS безопасное соединение.

Атрибуты:

domain

опциональное имя целевого Домена.

Если сервер возвращает положительный ответ, то клиент немедленно должен начать процесс установки параметров SSL/TLS.

recoverPassword

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

Атрибуты:

domain

опциональное имя целевого Домена.

userName

имя Пользователя.

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

signup

Эта операция предписывает Серверу создать нового Пользователя.

Атрибуты:

domain

опциональное имя целевого Домена.

userName

новое Имя Пользователя.

password

новый пароль Пользователя.

realName

Настоящее Имя нового Пользователя (опционально).

recoverPassword

адрес электронной почты, который используется для отправки забытого пароля (опционально).

Если сервер возвращает положительный ответ, то Пользователь был создан.
Обратите внимание: эта операция не производит вход на сервер от имени нового пользователя.
Обратите внимание: эта операция имеет некоторую задержку при отправке ответа.

login

Атрибуты:

domain

опциональное имя целевого Домена.

method

этот атрибут задаёт использование SASL метода. Если этот атрибут отсутствует, то используется незашифрованный метод (пароль передаётся в открытом виде).

authData

Если используется незашифрованный метод, то этот атрибут содержит имя пользователя.
Для всех остальных методов, это строка с данными протокола в кодировке base64.

password

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

Пример:

C:<login id="A001" authData="user1@example.dom" password="123rtu" />
S:<session id="A001" urlID="12-skejlkieuoiuoi-dnciru" userName="user1@example.dom" realName="User J. Smith"/>
S:<response id="A001"/>

Сервер отправляет следующие сообщения данных:

features

Это синхронное сообщение данных отправляется, когда Сервер обрабатывает операцию listFeatures.

Тело:

набор XML элементов:

domain

имя целевого Домена.

sasl

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

starttls

если этот элемент представлен, то клиент может выполнять операцию starttls.

language

в текстовом теле этого элемента содержится язык по умолчанию, выбранный для целевого Домена. Если этот элемент отсутствует, то выбирается значение языка по умолчанию (English).

signup

если этот элемент представлен, то клиент может выполнять операцию signup.

session

В этом сообщении содержится информация о вновь созданной сессии. Оно посылается перед отправкой положительного ответа на операцию login.

Атрибуты:

urlID

строка с идентификатором сессии. Эта строка с идентификатором может использоваться для доступа к данным сессии через HTTP.

userName

полное имя аутентифицированного Пользователя (accountName@domainName).

realName

Настоящее Имя аутентифицированного Пользователя (этот атрибут отсутствует, если Настоящее Имя не указано в Установках Пользователя).

Примеры:

C:<login id="A001" authData="user1@example2.dom" password="rrr123" />
S:<response id="A001" errorCode="account has been moved to a remote system" errorNum="518" />

Когда указанный SASL метод должен отправить клиенту challenge, он отправляет сообщение данных challenge с атрибутом value, в котором содержатся данные challenge в кодировке base64 для SASL протокола.
Клиент должен отвечать отправкой запроса auth с тем же самым атрибутом id, что использовался при запросе login и с атрибутом value, в котором содержатся данные ответа SASL протокола в кодировке base64.

Пример (смотрите RFC2195):

C:<login id="A001" method="CRAM-MD5" />
S:<challenge value="PDE4OTYuNjk3MTcwOTUyQHBvc3RvZmZpY2UucmVzdG9uLm1jaS5uZXQ+" />
C:<auth id="A001" value="dGltIGI5MTNhNjAyYzdlZGE3YTQ5NWI0ZTZlNzMzNGQzODkw" />
S:<session id="A001" urlID="12-skejlkieuoiuoi-dnciru" userName="user1@example.dom" realName="User J. Smith"/>
S:<response id="A001"/>

noop

Эта операция не делает ничего и всегда заканчивается успешно.

bye

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

passwordModify

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

Атрибуты:

oldPassword

текущий пароль Пользователя. Операция проверяет этот пароль до того, как пытается изменить его.

newPassword

в этом опциональном атрибуте задаётся новый пароль. Для этого Пользователя должна быть разрешена операция Изменение Пароля.

recoveryEMail

этот опциональный атрибут указывает новый адрес электронной почты для восстановления пароля.

SMIMEUnlock

Эта операция разблокирует Закрытый Ключ Пользователя, хранящийся на Сервере.
Когда Закрытый Ключ разблокирован, Сервер расшифровывает части сообщений с использованием операции folderRead.
Сервер также может зашифровывать и/или подписывать цифровой подписью передаваемые сообщения.
Обратите внимание: эта операция передаёт разблокирующую строку ("пароль хранения") открытым текстом. Клиентское приложение должно использовать эту команду только через безопасное (TLS) соединение.
Обратите внимание: разблокированный Закрытый Ключ добавляется только к данным текущей сессии и нигде не сохраняется. Если для одного и того же Пользователя открывается другая сессия, то ему необходимо самостоятельно разблокировать в ней Закрытый Ключ.

Атрибуты:

password

разблокирующая строка (пароль).

duration

опциональный атрибут - время (в секундах), в течение которого Закрытый Ключ будет находиться разблокированным; по истечении этого времени Закрытый Ключ блокируется автоматически.

SMIMEModifyPassword

Эта операция изменяет парольную строку, защищающую Закрытый Ключ Пользователя на Сервере. Закрытый Ключ Пользователя должен быть разблокирован.
Обратите внимание: эта операция передаёт разблокирующую строку ("пароль хранения") открытым текстом. Клиентское приложение должно использовать эту команду только через безопасное (TLS) соединение.

Атрибуты:

password

новая разблокирующая строка (пароль).

SMIMELock

Эта операция блокирует Закрытый Ключ Пользователя, хранящийся на Сервере (она удаляет разблокированный Закрытый Ключ из данных текущей сессии).
Эту операцию рекомендуется использовать после определённого времени бездействия пользователя.

clearUploaded

Эта операция удаляет один или все файлы из "набора загруженных файлов".

Атрибуты:

uploadID

если этот опциональный параметр указан, то из "набора загруженных файлов" удаляется файл только с таким fileID.
Если этот параметр не указан, то из "набора загруженных файлов" удаляются все файлы.

readStrings

Эта операция читает новый словарь (слова, тэги, имена кнопок и т.п.), хранящийся на Сервере. Сервер отправляет сообщение с данными strings, содержащее данные словаря (смотрите ниже).

Атрибуты:

language

язык словаря. Если атрибут отсутствует, то используется строка из настройки Пользователя Язык.

readTime

Эта операция читает текущее время Сервера. Сервер отправляет сообщение currentTime.

readStatus

Эта операция читает текущий статус Пользователя. Сервер отправляет сообщение currentStatus.

listKnownValues

Эта операция приводит к отправке сервером сообщения knownValues. Это сообщение содержит наборы "известных значений": известные названия Часовых Поясов, имена кодировок и т.д.

cliExecute

Эта операция выполняет команду CLI.

Тело:

текст команды CLI

Если команда CLI имеет результат, то сервер отправляет сообщение cliResult.

retrieveXML

Эта операция читает XML документ на удалённом сервере.

Атрибуты:

url

URL на XML документ (http: или https:).

Если документ получен успешно, то Сервер отправляет сообщение retrievedXML с содержимым полученного документа.

spellerList

Эта операция приводит к тому, что сервер отправляет сообщения speller, в которых содержатся имена установленных программ для проверки орфографии.

spellerCheck

Эта операция проверяет корректность написания произвольного текста. Для каждой обнаруженной ошибки, Сервер отправляет сообщение spellerReport.

Атрибуты:

speller

имя программы для проверки орфографии.

Тело:

проверяемый текст.

Сервер может отправлять следующие служебные сообщения данных в любое время:

alert

Аутентифицированный Пользователь получает Предупреждение. Как только сервер отправляет Клиенту сообщение данных с Предупреждением, сообщение Предупреждения помечается как "подтверждённое".

Тело:

текст Предупреждения (в кодировке UTF-8).

Сервер может отправлять следующие сообщения данных:

strings

Это синхронное сообщение данных отправляется, когда Сервер обрабатывает запрос readStrings.

Атрибуты:

language

выбранный язык.

Тело:

набор из XML элементов string и strings. Каждый элемент имеет атрибут name - имя (или "ключ") элемента словаря.
Элементы словаря типа строка представляются с использованием элементов string. Телом элемента string является значение элемента словаря.
Элементы словаря типа словарь представляются с использованием элементов strings. Телом элемента strings является набор XML элементов string.

Пример:
Клиент читает словарь по умолчанию (английский).

C:<readStrings id="A001">
S:<strings id="A001" language="" >
    <string name="AppendButton">Append</string>
    <strings name="AppendModes">
      <string name="simple">Simple Mode</string>
      <string name="advanced">Advanced Mode</string>
    </strings>
  </strings>
S:<response id="A001"/>

currentTime

Эти сообщения отправляются, когда Сервер обрабатывает запрос readTime.

Атрибуты:

gmtTime

текущее Время Сервера (GMT).

localTime

текущее Время Сервера (в выбранном часовом поясе).

currentStatus

Эти сообщения отправляются, когда Сервер обрабатывает запрос readStatus.

Тело:

набор XML элементов:

messageStore

Информация о Хранилище Почты Пользователя.

Атрибуты:

used

текущий объём использованного хранилища (в байтах).

limit

размер Квоты Хранилища. Этот атрибут отсутствует, если ограничение для квоты не установлено.

PrevLogin

Информация о предыдущем успешном входе на сервер.

Атрибуты:

gmtTime

время входа (GMT).

localTime

время входа (в выбранном часовом поясе).

ip

сетевой адрес, с которого вошёл пользователь.

LastFailedLogin

Информация о последнем неуспешном входе на сервер.

Атрибуты:

gmtTime

время последнего неуспешного входа на сервер (GMT).

localTime

время последнего неуспешного входа на сервер (в выбранном часовом поясе).

ip

сетевой адрес, с которого была предпринята попытка неуспешного входа на сервер.

RulesAllowed, SignalRulesAllowed, RPOPAllowed, PWDAllowed

Фактически действующие Установки Пользователя. Эти элементы не имеют атрибутов и текст их тела является значением установки.

option

ноль, один или несколько XML элементов. Телом элемента является строка, указывающая опцию, включённую для текущего Пользователя:

S/MIME

Услуги Безопасной Почты (S/MIME Защиты) включены.

SMIMEActive

Услуги Безопасной Почты (S/MIME Защиты) разблокированы.

SMIMEInactive

Услуги Безопасной Почты (S/MIME Защиты) заблокированы (но Пользователь имеет Защитный Ключ PKI).

WebCAL

Услуги календаря включены.

WebSite

Веб Доступ к Хранилищу Файлов по HTTP включён.

knownValues

Эти сообщения отправляются, когда Сервер обрабатывает запрос listKnownValues.

Тело:

набор XML элементов:

tzid

атрибут name элемента указывает наименование известного Часового Пояса;

charset

атрибут name элемента указывает наименование известной кодировки;

mailRuleAllowed

атрибут name элемента задаёт поддерживаемые режимы Разрешённых Почтовых Правил. Каждый режим определяет, какие действия Почтовых Правил пользователю разрешается изменять; Элементы сортируются так, что бы вначале были перечислены "наиболее ограничивающие" режимы.

mailRuleCondition

атрибут name элемента указывает поддерживаемое условие Почтовых Правил.

mailRuleAction

атрибут name элемента указывает поддерживаемое действие Почтовых Правил; атрибут allowedSet элемента указывает задействование имени Разрешённого Почтового Правила. Пользователь может изменять Правило, содержащую эту операцию, только если в значении Установки Разрешённые Правила для Почты Пользователя установлен менее ограничивающий режим для Разрешённых Правил для Почты.

signalRuleAllowed, signalRuleCondition, signalRuleAction

аналогично элементам mailRuleAllowed, mailRuleCondition, mailRuleAction, но для Правил Сигналов.

cliResult

Эти сообщения отправляются, когда Сервер обрабатывает запрос cliExecute.

Тело:

текстовое представление результата работы команды CLI.

retrievedXML

Эти сообщения отправляются, когда Сервер обрабатывает запрос retrieveXML.

Атрибуты:

url

URL документа.

Тело:

один XML документ, в котором содержится полученный документ.

speller

Эти сообщения отправляются, когда Сервер обрабатывает запрос spellerList.

Атрибуты:

speller

имя программы для проверки орфографии, обычно - название языка или название диалекта (такое, как English-US или French-CA).

spellerReport

Эти сообщения отправляются, когда Сервер обрабатывает запрос spellerCheck и обнаруживает ошибку орфографии.

Атрибуты:

position

позиция неверно написанного слова в отправленном тексте.

size

размер неверно написанного слова в отправленном тексте (в байтах).

Тело:

ноль, один или несколько XML элементов guess. Текст тела каждого элемента является предлагаемой заменой для неверно написанного слова.

Обратите внимание: отправляемый текст сначала декодируется из XML и в атрибутах указывает позиция слова и размер в результирующем декодированном тексте (который должен быть в кодировке UTF-8).

mailboxCreate

Эта операция создаёт новую Папку.

Атрибуты:

mailbox

в этом атрибуте задаётся имя новой Папки.

mailboxClass

этот опциональный атрибут указывает класс Папки.

mailboxRename

Эта операция переименовывает Папку.

Атрибуты:

mailbox

в этом атрибуте задаётся имя существующей Папки.

newName

в этом атрибуте задаётся имя новой Папки.

children

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

mailboxRemove

Эта операция удаляет Папку.

Атрибуты:

mailbox

имя существующей Папки.

children

если этот опциональный атрибут присутствует, то удаляются также и все "дети" Папки (вложенные Папки).

mailboxList

Эта операция заставляет Сервер отправить сообщение данных mailbox (смотрите ниже) для каждой видимой Папки (Папки, к которой аутентифицированный Пользователь имеет Права Доступа Видеть).

Атрибуты:

filter

в этом опциональном атрибуте задаётся строка с фильтром в формате протокола IMAP.

mailboxClass

если этот опциональный атрибут указан, то перечисляются только Папки указанного класса. Укажите значение пустая строка для перечисления только Папок с классом "mail".

mailboxSubList

Эта операция заставляет Сервер отправить сообщение данных mailboxSubscription (смотрите ниже) для каждого элемента из набора подписанных папок Пользователя. Заметьте, что Папок в этом наборе может и не быть.

Атрибуты:

filter

в этом опциональном атрибуте задаётся строка с фильтром в формате протокола IMAP.

mailboxSubUpdate

Эта операция изменяет набор подписанных папок Пользователя.

Тело:

набор элементов mailboxSubscription.

Атрибуты:

mailbox

имя папки в кодировке UTF-8.

mode

если значением этого атрибута является add, то имя mailboxдобавляется в набор подписанных папок (если в наборе отсутствует папка с таким именем).
в противном случае, имя mailbox удаляется из набора подписанных папок.

mailboxRightsGet

Эта операция заставляет Сервер отправить сообщение данных mailboxRight (смотрите ниже) с правами доступа к указанной Папке.

Атрибуты:

mailbox

имя существующей Папки.

mailboxACLList

Эта операция заставляет Сервер отправить сообщение данных mailboxACL с данными из Списка Прав Доступа к Папке.

Атрибуты:

mailbox

имя существующей Папки.

mailboxACLUpdate

Эта операция изменяет Список Прав Права Доступа к Папке для указанной Папки.

Атрибуты:

mailbox

имя существующей Папки.

Тело:

Набор XML элементов aclElem:

Атрибуты:

pattern

"имя" элемента ACL. Оно может быть именем Пользователя, именем с префиксом "+" или "-" и т.д. Дополнительную информацию смотрите в разделе Список Прав Доступа к Папке.

mode

если этот опциональный атрибут имеет значение add, то указанные права добавляются к набору прав, уже заданных для этого элемента ACL. Если элемент ACL не существует, то он будет создан.
если этот опциональный атрибут имеет значение sub, то указанные права убираются из набора прав, заданных для этого элемента ACL.
если этот опциональный атрибут имеет значение clear, то этот элемент ACL удаляется.
если этот опциональный атрибут имеет любое другое значение или этот атрибут отсутствует, то указанные права замещают набор прав, уже заданный для этого элемента ACL. Если элемент ACL не существует, то он будет создан.

Тело:

строка; каждый символ определяет Права Доступа к Папке.

Сервер отправляет следующие сообщения данных:

mailbox

Эти синхронные сообщения данных отправляются, когда Сервер обрабатывает запрос mailboxList.

Атрибуты:

mailbox

имя папки в кодировке UTF-8.

UIDVALIDITY, MESSAGES, UIDNEXT, UNSEEN, INTERNALSIZE, OLDEST, CLASS, MEDIA, UNSEENMEDIA

стандартные и расширенные атрибуты IMAP.

pureFolder

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

mailboxSubscription

Эти сообщения отправляются, когда Сервер обрабатывает запрос mailboxSubList.

Атрибуты:

mailbox

имя папки в кодировке UTF-8.

mailboxRights

Это сообщение отправляется, когда Сервер обрабатывает запрос mailboxRightsGet.

Атрибуты:

mailbox

имя Папки.

Тело:

строка; каждый символ определяет фактически действующие Права Доступа к Папке, предоставленные текущему пользователю.

mailboxACL

Это сообщение отправляется, когда Сервер обрабатывает запрос mailboxACLList.

Атрибуты:

mailbox

имя Папки.

Тело:

Набор XML элементов aclElem, один элемент для каждого элемента из Списка Прав Доступа к Папке:

Атрибуты:

pattern

"имя" элемента ACL. Оно может быть именем Пользователя, именем с префиксом "+" или "-" и т.д. Дополнительную информацию смотрите в разделе Список Прав Доступа к Папке.

Тело:

строка; каждый символ определяет Права Доступа к Папке, предоставленные или забранные от "имени".

• A001: Клиент просит Сервер создать Папку типа Блокнот MyNotes.
• A002: Клиент просит Сервер переименовать папку MyNotes в SharedNotes.
• A003: Клиент просит Сервер предоставить права Видеть (Lookup) и Входить (Select) к Папке SharedNotes пользователям user1 и user2.
• A004: Клиент просит Сервер добавить права Удалить (Delete) и Добавить (Inser) для Папки SharedNotes пользователям user1 и забрать право Входить у пользователя user2.
• A005: Клиент просит Сервер получать ACL данные для Папки SharedNotes.

folderOpen

Эта операция открывает указанную Папку как "Представление Папки" ("Folder").
Представление Папки представляет собой Папку Сервера, в которой сообщения были отсортированы и, опционально, отфильтрованы.
Каждое представление папки имеет имя; в одной сессии не может быть двух представлений с одинаковыми именами. С другой стороны, в одной сессии могут быть открыто два различных преставления (с разными именами) для одной и той же Папки. Например, приложение может использовать одно представление для показа содержимого Папки, отсортированным по полю Дата, а в другом окне будет оно будет показывать ту же Папку, но отсортированную по полю От Кого и только с теми сообщениями, в поле Keywords которых имеется тэг Business.
Когда в Папку добавляются сообщения (а также, когда сообщения изменяются или удаляются), Сервер уведомляет об этих изменениях всех клиентов, открывших какое-либо Представление этой Папки.
Для каждого представления уведомление об изменениях отправляется независимо, так что клиенту нет необходимости знать, что два представления папки фактически показывают разные виды одной и той же Папки Сервера.

Атрибуты:

folder

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

mailbox

имя Папки. Если этот атрибут не указан, то используется имя представления папки.

mailboxClass

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

sortField

имя поля заголовка сообщения, используемое для сортировки Папки.

sortOrder

если этот опциональный атрибут задан и имеет значение desc, то применяется обратный порядок сортировки.

filter

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

filterField

если этот опциональный атрибут указан, то его значение задаёт поле заголовка сообщения для сравнения с атрибутом filter. В представление папки включаются только те сообщения, у которых указанное поле существует и значение которого соответствует значению атрибута filter.
Если значением атрибута является FLAGS, то значение атрибута filter должно быть разделённым через запятую списком имён флагов сообщения и/или обратных имён флагов сообщения (negative names). В представление папки включаются только те сообщения, которые содержат указанный набор флагов и набор обратных флагов. Например, атрибут filter="Media,Unseen" укажет Серверу построить представление папки с использованием только тех сообщений, у которых установлен флаг Media и не установлен флаг Seen.
Если значением этого атрибута является body, то в представление папки включаются только те сообщения, которые содержат в какой-либо части тела сообщения значение атрибута filter.
Если этот атрибут отсутствует, то в представление папки включаются те сообщения, которые содержат значение атрибута filter в какой-либо части тела сообщения или в любом поле заголовка сообщения.

Тело:

тело запроса должно содержать один или более элементов <field>.
Каждое тело элемента должно содержать имя поля заголовка, получаемого для каждого сообщения.
Эти поля известны как поля просмотра.

Могут быть указаны следующие поля просмотра и sortField:

• From, To, Cc, Bcc, Reply-To, Sender, Return-Path или другое имя Email-field. Если заголовок сообщения содержит указанное Email-field, то оно разбирается. Если поле содержит "комментарий" (то есть "настоящее имя"), то оно используется. В противном случае разобранный адрес электронной почты не используется.
• Date, Resent-Date. Значение даты поля конвертируется в GMT. Если элементы с такими значениями поля отправляются в сообщении folderReport, то они содержат атрибут localTime, указывающий значение поля в Часовом Поясе, выбранном для текущего пользователя.
• любое другое имя поля заголовка (Subject, X-Mailer и т.п.). Используется MIME-декодированное значение этого поля.
• E-From, E-To, или другое имя E-Email-field. Если заголовок сообщения содержит указанное Email-field, то оно разбирается и разобранный адрес электронной почты используется.
• Pty. Значение поля X-Priority конвертируется в строки High, Low или в пустую строку.
• UID. Метаданные сообщения - UID (уникальный идентификатор) в Папке.
• SIZE. Метаданные сообщения - "сырой" размер сообщения в Папке.
• INTERNALDATE. Метаданные сообщения - его отметка о времени. Она форматируется также, как элемент Date.
• FLAGS - используются значения атрибутов метаданных сообщения.
  Дополнительную информацию о флагах сообщения в Папке смотрите в разделе Папки.

Сессия может использовать несколько Представлений Папки одновременно.

Клиент должен обслуживать внутренний вид Представления папки - массив или таблицу элементов для каждого сообщения из Представления. Клиент должен держать этот вид синхронизированным с видом Сервера (реализованным в этом Представлении Папки).

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

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

В некоторых Операциях с Папкой для задания сообщений Папки, к которым применяется операция, используется набор сообщений. Сообщения могут задаваться как по их UID, так и по номеру их индекса (по их позиции в Представлении папки).

Для задания сообщений по их UID, используйте один или более элементов UID.
Каждый элемент UID может включать в себя одно сообщение, в этом случае UID сообщения указывается как тело элемента <UID>12377</UID>.
Элемент UID может включать в себя диапазон UIDов сообщений, задаваемых при помощи атрибутов from и till: <UID from="12377" till="12455" />. Операция применяется ко всем сообщениям Папки, UID которых не меньше, чем значение атрибута from и не больше, чем значение атрибута till. Пожалуйста, помните, что сообщения в Представлении папки не отсортированы, вообще говоря, по их UIDам (за исключением случая использования атрибута sortField="UID" в операции folderOpen).

Для задания сообщения по индексу, используйте один или более элементов index.
Каждый элемент index может включать в себя одно сообщение, в этом случае индекс сообщения указывается как тело элемента <index>14</index>.
Элемент index может включать в себя диапазон индексов сообщений, задаваемых при помощи атрибутов from и till: <UID from="12" till="10000" />. Операция применяется ко всем сообщениям Представления папки, позиция (индекс) которых не меньше, чем значение атрибута from и не больше, чем значение атрибута till.

Набор сообщений может включать в себя один или более UID или один или более элементов index, но он не может включать в себя одновременно элементы UID и index.

folderBrowse

Эта операция заставляет Сервер отправить сообщения данных для указанного интервала индексов (позиций) в открытом Представлении папки.

Атрибуты:

folder

имя Представления папки.

Тело:

набор сообщений (смотрите выше). В этом наборе сообщений разрешается использовать только элементы index.

Сервер отправляет сообщение данных folderReport для каждого индекса из указанного диапазона. Атрибуты сообщения данных указывают индекс (позицию) сообщения в Представлении папке и UID сообщения.
Тело сообщения данных folderReport содержит значения viewer fields.

Для синхронизации клиента с сервером используется модель "по требованию". При добавлении, изменении или удалении сообщения из Представления папки, клиент получает асинхронное сообщение данных folderReport со значением атрибута mode, установленного в значение notify (сообщение "notify-mode").

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

Когда клиентские приложения готово обновить свой "внутренний вид", оно должно использовать операцию folderSync:

folderSync

Эта операция предписывает Серверу отправить клиенту все ожидающие изменения Представления папки.

Атрибуты:

folder

имя Папки.

Сервер отправляет сообщения данных folderReport с атрибутом mode, установленным в значение removed, added или updated.

После того, как Сервер отправляет "уведомительные" сообщения Клиенту, Сервер может не отправлять дальнейшие "уведомительные" сообщения для этого Представления папки до тех пор, пока клиент не выполнит операцию folderSync в этом Представлении папки.

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

Обратите внимание: в отличие от UIDов, индекс сообщения в Представлении папки может изменяться каждый раз при проведении операции folderSync. До того, как вы начнёте любую операцию с использованием набора сообщений, базирующегося на индексах, убедитесь, что вы корректно изменили внутренний вид в соответствии со всеми сообщениями данных folderReport, сгенерированными предыдущей операцией folderSync.

Обратите внимание: если сообщение было удалено или, наоборот, добавлено в Папку, то Сервер отправляет только сообщения данных folderReport с атрибутом mode="notify". Серверная сторона "вида" изменённого Представления Папки (логического Представления папки) не изменяется и можно безопасно использовать основывающиеся на индексах наборы сообщений для начала операции с Представлением папки.

messageCopy

Эта операция копирует сообщения из открытого Представления папки в целевую Папку.
Обратите внимание: цель является Папкой, а не Представлением папки.

Атрибуты:

folder

имя Представления папки - источника.

targetMailbox

имя Папки - приёмника.

encrypt

опциональный параметр. Если он установлен в значение YES, то все сообщения копируются в зашифрованном виде с использованием S/MIME Сертификата текущего пользователя.

Тело:

набор сообщений (смотрите выше).

messageMove

Эта операция аналогична операции messageCopy, но если сообщение было скопировано успешно, то операция удаляет оригинальное сообщение.

Эта операция также может быть использована для реализации "шифрования сообщений": выбранные сообщения должны быть передвинуты в ту же Папку с использованием атрибута encrypt операции.

messageMark

Эта операция изменяет флаги сообщения Папки в открытом Представлении папки.

Атрибуты:

folder

имя Представления папки.

flags

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

Тело:

набор сообщений (смотрите выше).

messageRemove

Эта операция удаляет сообщения из открытого Представления папки.

Атрибуты:

folder

имя Представления папки.

Тело:

набор сообщений (смотрите выше).

Операция проверяет настройку Пользователя DeleteMode и действует в зависимости от её значения:

• Немедленно - сообщения физически удаляются из Папки.
• Перенести в Корзину - сообщения передвигаются в Мусорную Корзину (её имя указывается в настройке Пользователя TrashBox). Если указанное Представление папки является Папкой Мусорной Корзины, то сообщения удаляются физически.
• Пометить - сообщения помечаются флагом Deleted.

folderExpunge

Эта операция удаляет все сообщения, помеченные флагом Deleted из Папки.
Обратите внимание: она удаляет ВСЕ отмеченные сообщения Папки, а не только сообщения, видимые в этом Представлении папки.

Атрибуты:

folder

имя Представления папки.

folderClose

Эта операция закрывает открытое Представления папки.

Атрибуты:

folder

имя Представления папки.

folderReopen

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

Атрибуты:

folder

имя Представления папки.

sortField, sortOrder, filter, filterField

эти атрибуты имеют тот же смысл, что и атрибуты операции folderOpen.

Тело:

тело запроса должно содержать как минимум один элемент <field> и эти элементы задают новый набор полей просмотра. Если не указано ни одного элемента <field>, то набор полей просмотра не изменяется.

Когда клиент использует эту команду, Сервер отправляет сообщение folderReport с атрибутом mode, установленным в значение init, уведомляя клиента о размере нового Представления папки.
Клиент должен очистить свой внутренний вид Представления папки и заново заполнить его.

Обратите внимание: если Клиент получает сообщение folderReport с атрибутом mode, установленным в значение notify, то после отправления Клиентом команды folderReopen, Клиент должен использовать команду folderSync по получению ответа на команду folderReopen.

Сервер отправляет следующие сообщения данных:

folderReport

Эти сообщения отправляются синхронно, когда Представление папки открывается или переоткрывается, а также когда клиент отправляет запросы folderBrowse или folderSync.
Эти сообщения отправляются асинхронно, когда статус Представления папки изменяется (сообщения добавляются, изменяются или удаляются), в этом случае атрибут mode устанавливается в notify.

Атрибуты:

folder

имя Представления папки.

mode

в этом опциональном атрибуте задаётся тип уведомления.

• Если значением атрибута является init, то атрибут messages указывает общее число сообщений в Представлении папки.
  Это асинхронное сообщение данных отправляется, когда Представление папки открывается или переоткрывается.
• Если значением атрибута является notify, то некоторые сообщения Папки были добавлены, изменены или удалены.
  Это сообщение отправляется как асинхронное сообщение данных.
  Ожидается, что в ответ клиент направит запрос folderSync для этого Представления папки.
• Если значением атрибута является removed, то атрибуты index и UID указывают сообщение, удаляемое из Представления папки.
  Это сообщение данных отправляется в ответ на запрос folderSync.
  Клиент должен немедленно изменить свой внутренний вид: для всех сообщений со значениями индекса большими, чем указано в значении атрибута index, значение индекса уменьшается на 1.
• Если значением атрибута является added, то атрибуты index и UID, задающие сообщение, добавляются в Представление папки.
  Это сообщение данных отправляется в ответ на запрос folderSync.
  Клиент должен немедленно изменить свой внутренний вид: для всех сообщений со значениями индекса большими либо равными, чем указано в значении атрибута index, значение индекса увеличивается на 1.
• Если значением атрибута является updated или атрибут отсутствует, то атрибуты index и UID задают сообщение Папки и в теле содержатся значения полей просмотра сообщения.

index

индекс сообщения в этом Представлении папки.
Этот атрибут не присутствует, когда значением атрибута mode является init.

UID

идентификатор сообщения (уникальный UID).
Этот атрибут не присутствует, когда значением атрибута mode является removed, updated или added.

messages

общее число сообщений в этом Представлении папки.
Этот атрибут не присутствует, когда значением атрибута mode является init, removed, или added.

Тело:

Тело присутствует, когда значением атрибута mode является updated или added.
Оно содержит набор элементов со значениями поля просмотра.

• A001: Клиент просит Сервер открыть Папку INBOX как Представление папки "INBOX" и отсортировать её по полю INTERNALDATE (которое является не фактическим полем сообщения, а элементом метаданных сообщения, указывающим время поступления сообщения в Папку). Клиент информирует Сервер, что ему необходимо получить поля FLAGS, From и Subject сообщений Папки.
• Сервер открывает Папку INBOX и сортирует её; Сервер информирует Клиента, что в Представлении папки имеется 234 сообщения.
• A002: Клиент просит Сервер отправить ему данные первых 4 сообщений, находящихся в Представлении папки и Сервер отправляет эту информацию Клиенту.
• Пока Сервер обрабатывал этот запрос, в Папку добавляется одно сообщение.
• после того, как Сервер отправил сообщение с ответом, сообщения 2 и 35 из Представления папки удаляются.
• A003: Клиент снова просит Сервер отправить ему данные первых 4 сообщений, находящихся в отсортированном Представлении папки.
• A004: Клиент просит Сервер отправить ему все изменения Представления папки.
• Сервер информирует Клиента о том, что сообщение с номером 35 удаляется. Клиент должен удалить элемент номер 35 из своей таблицы внутреннего вида и, если необходимо, обновить информацию на экране. Общее число сообщений в Представлении папки изменяется на 233.
• Сервер информирует Клиента о том, что сообщение с номером 2 удаляется. Клиент должен удалить элемент номер 2 из своей таблицы внутреннего вида. Сообщение номер 3 становится сообщением номер 2, сообщение номер 4 становится сообщением номер 3 и т.д.
• Сервер добавляет новое сообщение в Представление папки и информирует Клиента о том, что он вставил это сообщение как сообщение номер 1. Клиент должен обновить свою таблицу внутреннего вида, вставив в неё новый элемент как элемент номер 1. Элемент номер 1 становится сообщением номер 2, элемент номер 2 становится элементом номер 3 и т.д.
• A005: Клиент снова просит Сервер отправить ему данные первых 4 сообщений, находящихся в Представлении папки.

Пример 2:

• A010: Клиент просит Сервер скопировать 3 сообщения из уже открытой Папки INBOX в Папку Archive
• Папка Archive будет открыта и Сервер отправляет Клиенту сообщение уведомления

Пример 3:

• A020: Клиент просит Сервер отметить 3 сообщения (UIDы 512, 123 и 976) флагом Deleted.
• Сервер устанавливает эти флаги и отправляет Клиенту сообщение уведомления.
• A021: Клиент просит Сервер отправить ему все изменения Папки.
• Сервер отправляет изменённую информацию для сообщения с UID 512 и сообщения с UID 976. У сообщения с UID 123 флаг Deleted уже установлен, так что запрос не изменяет это сообщение и Сервер не отправляет информацию для этого сообщения.
• A022: Клиент просит Сервер вычистить Папку.
• Сервер удаляет сообщения с UIDами 512, 123 и 976, а также сообщения с UIDами 446 и 756, у которых, как оказалось, флаг Deleted тоже был установлен. Сервер отправляет Клиенту сообщение уведомления.
• A023: Клиент просит Сервер отправить ему все изменения Папки.
• Сервер отправляет сообщения данных, информируя клиента, что он удалил сообщения с UIDами 512, 123, 976, 446 и 756 из отсортированного вида Папки.
• A024: Клиент закрывает Папку INBOX.

folderRead

Эта операция указывает Серверу получить Сообщение или его часть.

Атрибуты:

folder

имя Представления папки.

UID

UID сообщения.

totalSizeLimit

максимальный общий размер всех возвращаемых частей сообщений.

messageAppend

Эта операция предписывает серверу сформировать Сообщение и добавить его в открытое представление папки или в произвольную Папку.

Атрибуты:

folder

имя целевого Представления папки. Если оно указано, то атрибут targetMailbox игнорируется.

targetMailbox

имя Папки - приёмника. Если атрибут folder отсутствует, то оно должно быть указано.

mailboxClass

этот опциональный атрибут может быть указан, если указан атрибут targetMailbox.
Если Папка - приёмник не существует и этот опциональный атрибут указан, то Папка - приёмник будет создана. Если значением этого атрибута является непустая строка, то это значение используется как Класс Папки для создаваемой Папки.

flags

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

internalDate

в этом опциональном атрибуте задаётся "внутренняя отметка о времени" для создаваемого сообщения. Если этот параметр не указан, то используется текущее время.

replacesUID

этот опциональный атрибут может быть указан, если задан атрибут folder.
Если сообщение было успешно создано и добавлено в Представление папки, то сообщение с UID replacesUID удаляется из Представления папки.

report

этот опциональный атрибут может быть указан, если задан атрибут folder. Если этот атрибут задан, то он должен иметь значение uid.
Если сообщение было успешно создано и добавлено в Представление папки, то Сервер отправляет синхронное сообщение messageAdded, содержащее UID нового добавленного сообщения.

Тело:

XML представление Сообщения (данные EMail).
Текстовые части XML представления сообщения должны использовать в качестве символа EOL символ Перевода Строки (0x0A).
Если XML представление не включает поля Message-ID или Date, то сервер создаёт эти поля сообщения самостоятельно.

Пример:
Клиент добавляет простое текстовое сообщение с флагами Seen и Answered в Папку "Sent". Если Папка не существует, то она создаётся.

C:<messageAppend id="A001" targetMailbox="Sent" flags="Seen,Answered" mailboxClass="" >
    <EMail>
      <From realName="Sender Name">fromName@domain</From><Subject>I'll be there!</Subject>
      <To realName="Recipient Name">toName@domain</To><X-Mailer>SuperClient v7.77</X-Mailer>
      <MIME type="text" subtype="plain">Dear Susan,&#x0A;&#x0A;I will come to your place tomorrow, thank you for the invitation!&#x0A;Mary.&#x0A;</MIME>
    </EMail>
  </messageAppend>
S:<response id="A001"/>

Эта операция добавляет в Папку следующее сообщение:

From: "Sender Name" <fromName@domain>
Subject: I'll be there!
To: "Recipient Name" <toName@domain>
X-Mailer: SuperClient v7.77
Date: Wed, 21 Jun 2006 21:51:24 -0800
Message-ID: <ximss-38150012@this.server.dom>
Content-Type: text/plain; charset="utf-8"

Dear Susan,

I will come to your place tomorrow, thank you for the invitation!
Mary.

Для того, что бы создать сообщения с вложенными файлами, сначала поместите файлы в "набор загруженных файлов". Затем вы можете указать их в элементах MIME, используя атрибут uploadID. Если вы не указываете явно атрибуты type и subtype, то они копируются из поля Content-Type HTTP запроса, который использовался при загрузке файла.

Пример:
Сначала клиент загружает 2 файла - test.gif (используя uploadID att01) и sample.pdf (используя uploadID att02). Затем клиент добавляет сообщение в Представление папки "Drafts" с флагом сообщения "Draft", заменяя существующее сообщение с UID 578.
В сообщении содержится некоторый текст в alternative форматах (plain и html) и загруженные файлы как вложения.
Клиент указывает Серверу отправить UID нового созданного сообщения (756).
Пока клиент добавлял новое сообщение, другой процесс добавил другие сообщения (с UID=755) в Папку "Drafts".
Затем клиент очищает "набор загруженных файлов" и повторно синхронизирует своё состояние с Представлением папки "Drafts".

C:<messageAppend id="A001" folder="Drafts" flags="Draft" replacesUID="578" report="uid" >
    <EMail>
      <From realName="Sender Name">fromName@domain</From><Subject>Text with attachments</Subject>
      <To realName="Recipient Name">toName@domain</To><X-Mailer>SuperClient v7.77</X-Mailer>
      <MIME type="multipart" subtype="mixed">
        <MIME type="multipart" subtype="alternative">
          <MIME type="text" subtype="plain">Dear Susan,&#x0A;&#x0A;I will come to your place tomorrow, thank you for the invitation!&#x0A;Mary.&#x0A;</MIME>
          <MIME type="text" subtype="html">&lt;html&gt;&lt;body&gt;&lt;i&gt;Dear Susan,&lt;/i&gt;&lt;p&gt;I will come to your place tomorrow, thank you for the invitation!&lt;p&gt;&lt;i&gt;Mary.&lt;/i&gt;</MIME>
        </MIME>
        <MIME uploadID="att01" />
        <MIME uploadID="att02" type="application" subtype="pdf" />
      </MIME>
    </EMail>
  </messageAppend>
S:<folderReport folder="Drafts" mode="notify" />
S:<messageAdded id="A001" folder="Drafts" UID="756" />
S:<response id="A001"/>
C:<clearUploaded id="A002" />
S:<response id="A002"/>
C:<folderSync id="A003" folder="Drafts"/>
S:<folderReport id="A003" folder="Drafts" index="17" UID="578" mode="removed" messages="301"/>
S:<folderReport id="A003" folder="Drafts" index="127" UID="755" mode="added" messages="302">
    <UID>755</UID>
    <From>Other Name</From>
  </folderReport>
S:<folderReport id="A003" folder="Drafts" index="17" UID="756" mode="added" messages="303">
    <UID>756</UID>
    <From>Sender Name</From>
  </folderReport>
S:<response id="A003"/>

Эта операция добавляет в Папку следующее сообщение:

From: "Sender Name" <fromName@domain>
Subject: Text with attachments
To: "Recipient Name" <toName@domain>
X-Mailer: SuperClient v7.77
Date: Wed, 21 Jun 2006 21:59:55 -0800
Message-ID: <ximss-38330025@my.server.domain>
Content-Type: multipart/mixed; boundary="_===38330025====my.server.domain===_"

--_===38330025====my.server.domain===_
Content-Type: multipart/alternative; boundary="_===38330025-X====my.server.domain===_"


--_===38330025-X====my.server.domain===_
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit

Dear Susan,

I will come to your place tomorrow, thank you for the invitation!
Mary.

--_===38330025-X====my.server.domain===_
Content-Type: text/html; charset="utf-8"
Content-Transfer-Encoding: 8bit

<html><body><i>Dear Susan,</i><p>I will come to your place tomorrow, thank you for the invitation!<p><i>Mary.</i>
--_===38330025-X====my.server.domain===_--

--_===38330025====my.server.domain===_
Content-Type: image/gif; name="test.gif"
Content-Disposition: attachment; filename="test.gif"
Content-Transfer-Encoding: base64

R0lGODlhCgAMAPf/AP//////zP//mf//Zv//M///AP/M///MzP/Mmf/MZv/MM//MAP+Z//+Z
zP+Zmf+ZZv+ZM/+ZAP9m//9mzP9mmf9mZv9mM/9mAP8z//8zzP8zmf8zZv8zM/8zAP8A//8A
zP8Amf8AZv8AM/8AAMz//8z/zMz/mcz/Zsz/M8z/AMzM/8zMzMzMmczMZszMM8zMAMyZ/8yZ
zMyZmcyZZsyZM8yZAMxm/8xmzMxmmcxmZsxmM8xmAMwz/8wzzMwzmcwzZswzM8wzAMwA/8wA
zMwAmcwAZswAM8wAAJn//5n/zJn/mZn/Zpn/M5n/AJnM/5nMzJnMmZnMZpnMM5nMAJmZ/5mZ
zJmZmZmZZpmZM5mZAJlm/5lmzJlmmZlmZplmM5lmAJkz/5kzzJkzmZkzZpkzM5kzAJkA/5kA
zJkAmZkAZpkAM5kAAGb//2b/zGb/mWb/Zmb/M2b/AGbM/2bMzGbMmWbMZmbMM2bMAGaZ/2aZ
zGaZmWaZZmaZM2aZAGZm/2ZmzGZmmWZmZmZmM2ZmAGYz/2YzzGYzmWYzZmYzM2YzAGYA/2YA
zGYAmWYAZmYAM2YAADP//zP/zDP/mTP/ZjP/MzP/ADPM/zPMzDPMmTPMZjPMMzPMADOZ/zOZ
zDOZmTOZZjOZMzOZADNm/zNmzDNmmTNmZjNmMzNmADMz/zMzzDMzmTMzZjMzMzMzADMA/zMA
zDMAmTMAZjMAMzMAAAD//wD/zAD/mQD/ZgD/MwD/AADM/wDMzADMmQDMZgDMMwDMAACZ/wCZ
zACZmQCZZgCZMwCZAABm/wBmzABmmQBmZgBmMwBmAAAz/wAzzAAzmQAzZgAzMwAzAAAA/wAA
zAAAmQAAZgAAM+4AAN0AALsAAKoAAIgAAHcAAFUAAEQAACIAABEAAADuAADdAAC7AACqAACI
AAB3AABVAABEAAAiAAARAAAA7gAA3QAAuwAAqgAAiAAAdwAAVQAARAAAIgAAEe7u7t3d3bu7
u6qqqoiIiHd3d1VVVURERCIiIhEREQAAACH+HUdpZkJ1aWxkZXIgMC40IGJ5IFl2ZXMgUGln
dWV0ACH5BAUEALkALAAAAAAKAAwAAAg1AHPlG0gw379cAgEoXHgw4UKFDfM9hIhQ4sSIEwFg
vCiQ4L+PIC1m/Cfx34qQGkVeBMkSZEAAOw==

--_===38330025====my.server.domain===_
Content-Type: application/pdf; name="sample.pdf"
Content-Disposition: attachment; filename="sample.pdf"
Content-Transfer-Encoding: base64

JVBERi0xLjIgDSXi48/TDQogDTggMCBvYmoNPDwNL0xlbmd0aCA5IDAgUg0vRmlsdGVyIC9G
bGF0ZURlY29kZSANPj4Nc3RyZWFtDQpIic2X3VLjuBaFn6DfQXfDuaCP5X9fJiQEpkNI2eFQ
[......skipped......]
Ug0vSUQgWzxjNjIyNzFiYzY4YmFlYjY3YzBkM2ViNTk4MjJiZTA4Nz48YzYyMjcxYmM2OGJh
ZWI2N2MwZDNlYjU5ODIyYmUwODc+XQ0+Pg1zdGFydHhyZWYNODc1NA0lJUVPRg0=

--_===38330025====my.server.domain===_--

Для того, что бы создать сообщения, в которых MIME части (приложения) скопированы из других сообщений, хранящихся на Сервере, используйте вместо MIME элемента элемент copyMIME:

copyMIME

Атрибуты:

folder или calendar

имя открытого Представления папки или открытого Календаря.

UID

UID сообщения.

partID

в этом опциональном атрибуте задаётся часть сообщения, которую необходимо скопировать. Если он не указан, то копируется всё сообщение.

Пример:
Клиент сохраняет Заметку в Папке "Notes", добавляя части 3 и 4 (приложения) к сообщению 156, хранящегося в представлении папки INBOX:

C:<messageAppend id="A001" targetMailbox="Notes" flags="Seen">
    <EMail>
      <From realName="Sender Name">fromName@domain</From>
      <Subject>Vacation Pictures</Subject>
      <MIME type="multipart" subtype="mixed">
        <MIME type="text" subtype="plain">The first part of the underwater shots.</MIME>
        <copyMIME folder="INBOX" UID="156" partID="3"/>
        <copyMIME folder="INBOX" UID="156" partID="4"/>
      </MIME>
    </EMail>
  </messageAppend>
S:<response id="A001"/>

Вы можете прикладывать файлы, хранящиеся в Персональном Хранилище Файлов. Укажите полное имя файла в элементах MIME, используя атрибут fileName. Вы можете явно задать атрибуты типа и подтипа и вы должны указать атрибут disposition-filename, так как атрибут fileName не используется для формирования имени приложенного файла.

Пример:
Клиент сохраняет Заметку в Папке "Notes", добавляя файл private/MyFile.jpg как приложение photo.jpg:

C:<messageAppend id="A001" targetMailbox="Notes" flags="Seen">
    <EMail>
      <From realName="Sender Name">fromName@domain</From>
      <Subject>Vacation Pictures</Subject>
      <MIME type="multipart" subtype="mixed">
        <MIME type="text" subtype="plain">Atatched please find the images I have stored as files.</MIME>
        <MIME type="image" subtype="jpeg" fileName="private/MyFile.jpg" disposition-filename="photo.jpg" />
      </MIME>
    </EMail>
  </messageAppend>
S:<response id="A001"/>

Обратите внимание: если для элемента <MIME /> значение атрибута disposition задано как none, то поле заголовка Content-Disposition: не создаётся, и поле Content-Type сохраняется без параметра name.

Обратите внимание: в качестве разделителя строк в текстовых частях MIME должен использоваться один символ перевода строки (0x0A, десятичное 10).

Вы можете попросить Сервер использовать "перетекающий" формат для MIME частей.

Пример:

C:<messageAppend id="A001" targetMailbox="Notes" flags="Seen">
    <EMail>
      <Subject>Test text</Subject>
      <MIME type="text" subtype="plain" format="flowed">This is a very long long long long long long long long long long superlong long long long long long long line, followed with a shorter line:
This is a shorter line.</MIME>
    </EMail>
  </messageAppend>
S:<response id="A001"/>

Эта операция добавляет в Папку следующее сообщение:

Subject: Test text
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; format="flowed"; charset="utf-8"

This is a very long long long long long long long long long long superlong
long long long long long long line, followed with a shorter line:
This is a shorter line.

(после слова "superlong" есть концевые пробелы)

Для того, что бы создать подписанное сообщение, убедитесь, что ваш Закрытый Ключ разблокирован и укажите атрибут sign в самом верхнем элементе EMail.

C:<messageAppend id="A001" targetMailbox="Sent" flags="Seen,Answered" >
    <EMail sign="yes">
      <From realName="Sender Name">fromName@domain</From><Subject>I'll be there!</Subject>
      <To realName="Recipient Name">toName@domain</To><X-Mailer>SuperClient v7.77</X-Mailer>
      <MIME type="text" subtype="plain">Dear Susan,&#x0A;&#x0A;I will come to your place tomorrow, thank you for the invitation!&#x0A;Mary.&#x0A;</MIME>
    </EMail>
  </messageAppend>
S:<response id="A001"/>

Эта операция добавляет в Папку следующее сообщение:

From: "Sender Name" <fromName@domain>
Subject: I'll be there!
To: "Recipient Name" <toName@domain>
X-Mailer: SuperClient v7.77
Content-Type: multipart/signed; protocol="application/x-pkcs7-signature"; micalg="SHA1"; boundary="_===signed==2610002====my.server.domain===_"

This is a signed S/MIME message

--_===signed==2610002====my.server.domain===_
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit

Dear Susan,

I will come to your place tomorrow, thank you for the invitation!
Mary.

--_===signed==2610002====my.server.domain===_
Content-Type: application/x-pkcs7-signature; name="smime.p7s"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="smime.p7s"

MIIE6wYJKoZIhvcNAQcCoIIE3DCCBNgCAQExCzAJBgUrDgMCGgUAMAsGCSqGSIb3DQEHAaCC
ArkwggK1MIICX6ADAgECAgcAk9RF+n/7MA0GCSqGSIb3DQEBBAUAMIG6MQswCQYDVQQGEwJV
UzELMAkGA1UECBMCQ0ExFDASBgNVBAcTC01pbGwgVmFsbGV5MSIwIAYDVQQKExlDb21tdW5p
.............
gIbXNT64QJ+gEYkI9mnePiS1TUOOzGYfXaLy1pqm6jmzBUt7/3UY8ZNHVIwM0Fzj7NwzqM1U
Esbkyi3WHNxTZ4HSCs8J2enGQEZjNWHOuX96xQojYGLV0m5Z/FatV9GQ8jNVBmQ9xYGKxmlY
jT9ze/oHyKuj7KR8QrgQSYiJVnn7

--_===signed==2610002====my.server.domain===_--

messageSubmit

Эта операция предписывает серверу сформировать Сообщение и передать его в Очередь на доставку. Копия сообщения может быть сохранена в Папке.

Атрибуты:

useDSN

если этот опциональный атрибут присутствует и его значением является yes, то при доставке сообщения или при ошибке в доставке генерируются соответствующие уведомления.
Если этот атрибут отсутствует, то уведомления генерируются только в том случае, если доставка сообщения завершилась неуспешно.

targetMailbox, mailboxClass, flags, internalDate

если опциональный атрибут targetMailbox указан, то созданное сообщение добавляется в указанную Папку. Эти атрибуты имеют тот же смысл, что и атрибуты операции messageAppend.

Тело:

XML представление Сообщения (элемент EMail) и ноль, один или несколько элементов Envelope-To. Каждый элемент Envelope-To должен иметь текстовое тело - адрес электронной почты, на который должно отправляться сообщение.
Если не указано никакого элемента Envelope-To, то сообщение отправляется на адрес, указанный в элементах To, Cc и Bcc, находящихся внутри элемента EMail.
При формировании MIME текста сообщения все адреса, находящиеся в элементе Bcc, пропускаются.

Пример:
Клиент отправляет простое текстовое сообщение на адрес toName@domain и его скрытую копию Bcc на адрес bccName@domain. Клиент запрашивает уведомление о доставке.

C:<messageSubmit id="A001" useDSN="yes" >
    <EMail>
      <From realName="Sender Name">fromName@domain</From>
      <Subject>I'll be there!</Subject>
      <To realName="Recipient Name">toName@domain</To>
      <X-Mailer>SuperClient v7.77</X-Mailer>
      <Bcc>bccName@domain</Bcc>
      <MIME type="text" subtype="plain">Dear Susan,&#x0A;&#x0A;I will come to your place tomorrow, thank you for the invitation!&#x0A;Mary.&#x0A;</MIME>
    </EMail>
  </messageSubmit>
S:<response id="A001"/>

Пример:
Клиент отправляет простое текстовое сообщение на адреса a1@domain и a2@domain (отличающиеся от адресов, указанных в элементах To и Cc).
Копия сообщения должна быть сохранена в Папке Отправленное ("Sent Items") с флагом Seen.
Клиент запрашивает уведомление о доставке.

C:<messageSubmit id="A001" targetMailbox="Sent Items" flags="Seen" >
    <Envelope-To>a1@domain address</Envelope-To>
    <Envelope-To>a2@domain address</Envelope-To>
    <EMail>
      <From realName="Sender Name">fromName@domain</From>
      <Subject>I'll be there!</Subject>
      <To realName="Recipient Name">toName@domain</To>
      <X-Mailer>SuperClient v7.77</X-Mailer>
      <Cc>ccName@domain</Cc>
      <MIME type="text" subtype="plain">Dear Susan,&#x0A;&#x0A;I will come to your place tomorrow, thank you for the invitation!&#x0A;Mary.&#x0A;</MIME>
    </EMail>
  </messageSubmit>
S:<response id="A001"/>

Пример:
Клиент пересылает сообщение 156, хранящееся в Представлении папки INBOX на адрес a1@domain:

C:<messageSubmit id="A001">
    <EMail>
      <From realName="Sender Name">fromName@domain</From>
      <Subject>Fwd: Sorry, I cannot make it :-(</Subject>
      <To realName="Recipient Name">a1@domain</To>
      <X-Mailer>SuperClient v7.77</X-Mailer>
      <MIME type="multipart" subtype="mixed">
        <MIME type="text" subtype="plain">Dear Susan,&#x0A;&#x0A;Attached please find the message I received this morning...&#x0A;Mary.&#x0A;</MIME>
        <copyMIME folder="INBOX" UID="156" />
    </EMail>
  </messageSubmit>
S:<response id="A001"/>

Эта операция добавляет в Папку следующее сообщение:

From: "Sender Name" <fromName@domain>
Subject: Fwd: Sorry, I cannot make it :-(
To: "Recipient Name" <toName@domain>
X-Mailer: SuperClient v7.77
Date: Wed, 21 Jun 2006 22:55:24 -0800
Message-ID: <ximss-38150012@this.server.dom>
Content-Type: multipart/mixed; boundary="_===38330025====my.server.domain===_"

--_===38330025====my.server.domain===_
Content-Type: text/plain; charset="utf-8"

Dear Susan,

Attached please find the message I received this morning...
Mary.

--_===38330025====my.server.domain===_
Content-Type: message/rfc822

From: "Barbara Smith" <barbara@domain>
Subject: Sorry, I cannot make it :-(
To: "Sender Name" <fromName@domain>
X-Mailer: OtherClient v8.88
Date: Wed, 21 Jun 2006 21:51:24 -0800
Message-ID: <zzzzzzzzz@other.server.dom>
Content-Type: text/plain; charset="utf-8"

Mary,

Sorry, but I will be out of town tomorrow...

Barbara.

--_===38330025====my.server.domain===_--

messageRedirect

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

Атрибуты:

folder

имя Представления папки.

UID

UID сообщения.

Тело:

Набор из одного или более элементов To задаёт адрес(а)получателя (получателей).

Пример:
Клиент перенаправляет сообщение 156, хранящееся в Представлении папки INBOX на адреса a1@domain и a2@domain:

C:<messageRedirect id="A001" folder="INBOX" UID="156">
    <To realName="Recipient Name">a1@domain</To>
    <To realName="Recipient-2">a2@domain</To>
  </messageRedirect>
S:<response id="A001"/>

messageForward

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

messageConfirm

Эта операция предписывает серверу сформировать MDN-уведомление (Уведомление об Открытии Сообщения) для сохранённого в папке сообщения и передать его в Очередь на доставку.
Клиентские приложения должны использовать эту операцию в следующих случаях:

• сообщение было показано пользователю, и
• сообщение имеет поле заголовка Disposition-Notification, и
• сообщения не имеет флага $MDNSent, и
• Настройка пользователя SendMDNMode установлена в значение Automatically или установлена в значение Manually и пользователь явно потребовал отправить подтверждение.

Атрибуты:

folder

имя Представления папки.

UID

UID сообщения.

type

этот атрибут должно быть установлен в auto (если подтверждение генерируется автоматически) или в manual (если пользователь явно затребовал отправку подтверждения).

Сервер отправляет следующие сообщения данных:

folderMessage

Это синхронное сообщение данных отправляется, когда Сервер обрабатывает запрос folderRead.

Атрибуты:

folder

имя Представления папки.

UID

UID сообщения.

Тело:

XML представление Сообщения.

messageAdded

Эти синхронные сообщения данных отправляются, когда Сервер обрабатывает запросы messageAppend и contactAppend с установленными атрибутами report.

Атрибуты:

folder

имя Представления папки.

UID

UID добавленного сообщения.

Обратите внимание: даже если это сообщение данных отправлено, Сервер всё-равно будет отправлять асинхронные сообщения данных folderReport, уведомляющие клиентов о том, что в Представление папки было добавлено новое сообщение. Клиент ДОЛЖЕН использовать операцию folderSync для синхронизации своего внутреннего вида с видом Сервера, в противном случае вновь добавленные сообщения не будут "видны" в Представлении папки.

MIME части с типом text и x-vcard или с подтипом dictionary содержат элементы vCard.

Для того, что бы включить данные vCard в сообщение (используя операции messageAppend, messageSubmit), включите элемент MIME с type="text" и subtype="directory". Тело элемента должно содержать один или более элементов vCard.

• в поле Subject содержится свойство vCard FN.
• в поле To содержится свойство vCard EMAIL.
• поле X-Has-Certificate существует и содержит значение true, если vCard имеет свойство KEY.

Используйте следующие операции для формирования и сохранения такого специального сообщения:

contactAppend

Эта операция создаёт специальное сообщение электронной почты, в теле которого содержатся данные vCard, а также формирует все необходимые поля заголовка сообщения электронной почты и сохраняет получившееся сообщение в указанной Папке.

Атрибуты:

folder

имя целевого Представления папки. Если оно указано, то атрибут targetMailbox игнорируется.

targetMailbox

имя Папки - приёмника. Если атрибут folder отсутствует, то оно должно быть указано.
если Папка - приёмник не существует, то она создаётся.

flags, replacesUID, report

эти опциональные атрибуты имеют тот же смысл, что и атрибуты операции messageAppend. Если атрибут flags не указан, его значение подразумевается равным Seen.

Тело:

в точности один элемент vCard.

Операция добавляет атрибуты vCard UID и FN в случае если они отсутствуют.

Пример 1:
Клиент добавляет объект vCard в Папку Contacts.

C:<contactAppend id="A011" targetMailbox="Contacts" >
    <vCard>
      <NAME>Bjorn Jensen</NAME>
      <N><FAMILY>Jensen</FAMILY><GIVEN>bjorn</GIVEN>
        <MIDDLE>A</MIDDLE><PREFIX>Mr.</PREFIX><SUFFIX>II</SUFFIX></N>
      <EMAIL><INTERNET /><USERID>bjorn@domain.dom</USERID></EMAIL>
      <TEL><WORK /><VOICE /><MSG /><NUMBER>+1 313 747-4454</NUMBER></TEL>
      <KEY><x509 /><BINVAL>dGhpcyBjb3VsZCBiZSAKbXkgY2VydGlmaWNhdGUK</BINVAL></KEY>
    </vCard>
  </contactAppend>
S:<response id="A011"/>

calendarOpen

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

Атрибуты:

calendar

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

mailbox

имя Папки. Если этот атрибут не указан, то используется имя календаря.

Сессия может использовать несколько Календарей одновременно.

findEvents

Эта операция получает объекты VEVENT из указанного Календаря. Будут получены только те События (Встречи), которые попадают в указанный временной интервал.

Атрибуты:

calendar

имя Календаря.

timeFrom, timeTill

начало и конец временного интервала (значения времени должны быть указаны для выбранного часового пояса).

limit

этот опциональный числовой атрибут ограничивает число возвращаемых Встреч.

skip

этот опциональный числовой атрибут указывает, сколько из "возвращаемых" Встреч должны быть пропущены. Используя этот атрибут клиент может получать большой набор Встреч по "кусочкам".

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

calendarClose

Эта операция закрывает открытый Календарь.

Атрибуты:

calendar

имя Календаря.

calendarRead

Эта операция указывает Серверу получить Сообщение или его часть.

Атрибуты:

calendar

имя Календаря.

UID

UID сообщения.

totalSizeLimit

максимальный общий размер всех возвращаемых частей сообщений.

calendarPublish

Эта операция помещает элемент данных календаря в Календарь. Существующие элементы данных, имеющие тот же UID, удаляются.

Атрибуты:

calendar

имя Календаря.

sendRequests

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

Тело:

Элемент iCalendar для помещения в выбранный Календарь и опциональные элементы MIME и/или copyMIME для добавления (аналогично элементам, используемым в операции messageAppend).

Элемент iCalendar должен содержать опциональные элементы vtimezone и в точности один элемент данных календаря.
Для часового пояса, используемого в элементе данных календаря, если этот часовой пояс является одним из стандартных часовых поясов, известных серверу, элемент vtimezone можно не включать.
Можно также не указывать название часового пояса в свойствах, содержащих значения данных без суффикса Z. В этом случае используется часовой пояс, выбранный для текущего пользователя.
Если элемент данных не содержит элемента UID, то Сервер генерирует такой уникальный UID и добавляет его к элементу данных.

Пример 1:
Клиент публикует объект iCalendar в календаре Calendar .

C:<calendarPublish id="A021" calendar="Calendar">
   <iCalendar xmlns="urn:ietf:params:xml:ns:xcal">
    <vCalendar method="PUBLISH" prodid="CommuniGate Pro 5.1.7" version="2.0">
     <vevent>
      <organizer CN="Big Boss">MAILTO:boss@company.dom</organizer>
      <attendee CN="Small Boy">MAILTO:boy@company.dom</attendee>
      <rrule>FREQ=WEEKLY;BYDAY=MO,TH</rrule>
      <dtstamp>20061022T091143Z</dtstamp>
      <uid>18927897984@kjjkjkjk-123444</uid>
      <sequence>0</sequence>
      <summary>Report Meeting</summary>
      <dtstart tzid="NorthAmerica/Pacific">20060515T100000</dtstart>
      <dtend tzid="NorthAmerica/Pacific">20060515T110000</dtend>
      <busystatus>BUSY</busystatus>
      <last-modified>20060516T034850Z</last-modified>
      <created>20060516T034850Z</created>
      <priority>5</priority>
      <description>A twice-a-week meeting to discuss the progress of the assigned projects.</description>
     </vevent>
    </vCalendar>
   </iCalendar>
   <MIME uploadID="att01" />
   <copyMIME folder="INBOX" UID="156" partID="3"/>
  </calendarPublish>
S:<response id="A021"/>

Обратите внимание: Если значение времени указывается без суффикса "Z", то подразумевается местное время в Часовом Поясе, выбранном для текущего пользователя.

calendarCancel

Эта операция удаляет элемент данных календаря из Календаря. Всем участникам отправляются запросы на отмену.

Атрибуты:

calendar

имя Календаря.

UID

опционально; UID сообщения (числовой).

sendRequests

если этим опциональным атрибутом является no, то всем приглашённым на встречу сообщения с запросами на отмену не отправляются.

Тело:

• опциональный элемент iCalendar, который необходимо отменить.
  Если этот элемент не указан, то из Календаря берётся элемент данных с заданным UID сообщения (это число, а не UID элемента данных календаря). Затем все элементы данных с такими же UID удаляются.
• опциональный элемент requestComment, содержащий текстовое тело - комментарий, включаемый в сообщение с запросом на отмену.

calendarUpdate

Эта операция изменяет элемент данных календаря в Календаре с использованием объекта iCalendar типа reply. Этот элемент данных указывает, принял или отвергнул данный конкретный приглашённый приглашение на встречу.

Атрибуты:

calendar

имя Календаря.

Тело:

Элемент данных iCalendar типа reply.

calendarAccept

Эта операция помещает элемент данных календаря в Календарь. Существующие элементы данных, имеющие тот же UID, удаляются.

Атрибуты:

calendar

имя Календаря.

PARTSTAT

статус принятия: ACCEPTED, TENTATIVE, IN-PROCESS (только для Заданий), COMPLETED (только для Заданий).

sendReply

если этим опциональным атрибутом является no, то организатору не отправляется сообщение с ответом.

Тело:

• Элемент iCalendar для помещения в выбранный Календарь;
• опциональные элементы MIME и/или copyMIME для добавления (аналогично элементам, используемым в операции messageAppend);
• опциональный элемент replyComment, содержащий текстовое тело - комментарий, включаемый в сообщение ответа.

Если элемент данных помещён успешно, тот организатору отправляется сообщение ответа iCalendar. Ответы не отправляются для элементов данных типа Встреча для текущего пользователя (если он является приглашённым на встречу с параметром RSVP=FALSE) или если атрибут запроса sendReply имеет значение no.

calendarDecline

Эта операция удаляет элемент данных календаря.

Атрибуты:

calendar

имя Календаря. Этот параметр является опциональным. Если он указан, то элементы данных с таким же UID удаляются из этого Календаря.

sendReply

если этим опциональным атрибутом является no, то организатору не отправляется сообщение с ответом.

Тело:

• Отклоняемый элемент iCalendar.
• опциональный элемент replyComment, содержащий текстовое тело - комментарий, включаемый в сообщение ответа.

Используйте эту операцию, если пользователь решает не присутствовать на встрече, хранящейся как опубликованный элемент данных в Календаре (если текущий пользователь является организатором встречи, используйте вместо этого операцию calendarCancel.
Укажите сам опубликованный элемент данных и атрибут calendar для удаления элемента данных из Календаря.
Операция отправляет отрицательный ответ организатору этого элемента данных (за исключением случаев, когда атрибут sendReply установлен в значение no).

Используйте эту операцию, если пользователь открывает элемент данных с запросом (во входящем сообщении электронной почты) и решает отклонить этот запрос.
Укажите элемент данных с запросом и не указывайте никаких атрибутов calendar.
Операция отправляет отрицательный ответ организатору этого элемента данных (за исключением случаев, когда атрибут sendReply установлен в значение no).

Используйте эту операцию, если пользователь открывает элемент данных с запросом на отмену (во входящем сообщении электронной почты) и решает удалить отменённый элемент данных из Календаря.
Укажите элемент данных с запросом на отмену и атрибут calendar (обычно - имя Главного Календаря) для того, что бы удалить соответствующие элементы данных из этого календаря.
Операция не отправляет никакого сообщения с ответом.

Если указанный элемент данных является запросом, то операция отправляет отрицательный ответ организатору этого элемента данных.
Если указанный элемент данных является запросом на отмену, то операция не отправляет сообщение с ответом организатору этого элемента данных; укажите атрибут calendar для удаления соответствующего элемента данных из Календаря.

Сервер отправляет следующие сообщения данных:

events

Эти синхронные сообщения данных отправляются при использовании операции findEvents.

Атрибуты:

calendar, timeFrom, timeTill, skip

аналогично запросу findEvents.

items

общее число найденных Встреч.

Тело:

набор элементов event для каждой найденной Встречи.

Атрибуты:

UID

UID сообщения Встречи.

timeFrom

время начала этой Встречи (в выбранном часовом поясе). Этот атрибут не включается для Встреч (Событий) "на весь день".

duration

продолжительность Встречи (в секундах). Этот атрибут не включается для Встреч (Событий) "на весь день".

busyStatus

строка со статусом занятости Встречи (BUSY, TENTATIVE, UNAVAILABLE, FREE).

Тело:

Поля Встречи: summary

calendarReport

Эти сообщения отправляются при изменении данных Календаря.

Атрибуты:

calendar

имя Календаря.

mode

в этом опциональном атрибуте задаётся тип уведомления.

• Если значением атрибута является notify, то некоторые сообщения были добавлены в Календарь, изменены или удалены из Календаря.
  Ожидается, что в ответ клиент направит запрос findEvents для этого Календаря.

После того, как Сервер отправляет "уведомительное" сообщение calendarReport Клиенту, Сервер может не отправлять дальнейшие "уведомительные" сообщения для этого Календаря до тех пор, пока клиент не выполнит для этого Календаря операцию findEvents.

signalBind

Эта операция позволяет текущей сессии XIMSS получать сигналы, направляемые аутентифицированному пользователю.

Атрибуты:

deviceName

опциональный параметр, указывающий используемое устройство.

presence

опциональный параметр. Если он установлен в значение yes, то клиент получает уведомления Ростера и Статуса Присутствия.

Тело (опционально):

XML представление дескриптора SDP клиента.
Дескриптор используется для указания возможностей клиента (способность принимать принимать аудио/видео вызовы) и для определения конфигураций "дальнего NAT".
Обратите внимание: для того, что бы определять "дальние NAT" конфигурации, SDP дескриптор должен содержать атрибут ip с IP адресом медиа, используемым клиентом по умолчанию (смотрите ниже).

signalUnbind

После завершения этой операции текущая сессия XIMSS не получает сигналы, направляемые аутентифицированному пользователю.

callKill

Используйте эту операцию, для того, что бы завершить вызов и освободить все связанные ресурсы.
Если звонок находился в состоянии "calling", то исходящий звонок прекращается.
Если звонок находился в состоянии "alerting", то входящий звонок отвергается.
Если звонок находился в состоянии "connected", то участнику отправляется звонок на отсоединение.

Атрибуты:

callLeg

идентификатор вызова.

После успешного завершения этой операции можно создавать новые вызовы с таким же идентификатором.

callStart

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

Атрибуты:

callLeg

новый идентификатор вызова. Текущая сессия XIMSS не должна иметь других вызовов с таким идентификатором.

peer

адрес электронной почты вызова или SIP URI вызова.

Тело:

XML представление дескриптора SDP клиента.

Если эта операция завершается успешно, то создаётся объект с новым вызовом и инициируется исходящий вызов. Сервер может отправлять ноль, одно или несколько сообщений callProvisioned, за которым следует сообщение callDisconnect или callConnected.
Обратите внимание: клиент должен быть готов обрабатывать эти сообщения Сервера даже в том случае, если до этого он получил положительный ответ на свой запрос callStart.
Обратите внимание: для того, что бы корректно обрабатывать вызовы "за NAT", SDP дескриптор должен содержать атрибут ip с IP адресом медиа, используемым клиентом по умолчанию (смотрите ниже).
Обратите внимание: если вызов заканчивается неуспешно (получено сообщение callDisconnected, то клиенту все-равно необходимо использовать операцию callKill для того, что бы освободить ресурсы, связанные с этим вызовом и сделать возможным повторное использование идентификатора вызова.

callProvision

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

Атрибуты:

callLeg

идентификатор входящего звонка.

тело (опционально):

XML представление дескриптора SDP клиента.

callRedirect

Используйте эту операцию для того, что бы перенаправить входящий вызов.

Атрибуты:

callLeg

идентификатор входящего звонка.

Тело:

один или более элементов XML To. Каждый элемент должен иметь текстовое тело, в котором указывается URI, на который необходимо перенаправить звонок.

Обратите внимание: клиенту все-равно необходимо использовать операцию callKill для того, что бы освободить ресурсы, связанные с этим вызовом и сделать возможным повторное использование идентификатора вызова.

Пример:
Перенаправление входящего вызова inp003 на user1@example.com и user2@example.com.

C:<callRedirect id="A018" callLeg="inp003" >
    <To>user1@example.com</To><To>user2@example.com</To>
  </callRedirect>
S:<response id="A018"/>

callReject

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

Атрибуты:

callLeg

идентификатор входящего звонка.

signalCode

числовой код (определяемый согласно стандартам SIP), который передаётся в компонент Signal как код ошибки.
Используйте код 486 ("Здесь занято") для того, что бы просигнализировать, что это устройство "Занято" (но другие устройства, зарегистрированные на этого пользователя, будут продолжать звонить).
Используйте код 6xx (600 - "Занято везде" или 603 - "Отклонено"_ что бы просигнализировать, что пользователь не хочет принимать этот сигнал ни на каком устройстве (все другие устройства также прекратят звонить).

Обратите внимание: клиенту все-равно необходимо использовать операцию callKill для того, что бы освободить ресурсы, связанные с этим вызовом и сделать возможным повторное использование идентификатора вызова.

Пример:
Отвергаем входящий вызов inp004 с кодом 603 "Declined":

C:<callReject id="A020" callLeg="inp004" signalCode="603" />
S:<response id="A020"/>

callAccept

Используйте эту операцию для того, что бы принять входящий вызов.

Атрибуты:

callLeg

идентификатор входящего звонка.

Тело:

XML представление дескриптора SDP клиента.

callSendDTMF

Используйте эту операцию для отправки DTMF сигнала через канал сигнализации.

Атрибуты:

callLeg

идентификатор вызова.

Тело:

строка с DTMF кодом, который необходимо отправить (10 для '*', 11 для '#').

callUpdate

Используйте эту операцию для того, что бы изменить вызов (изменить SDP дескриптор вызова).

Атрибуты:

callLeg

идентификатор вызова.

Тело:

XML представление нового дескриптора SDP клиента.

Если операция заканчивается успешно, то сервер возвращает сообщение callOpCompleted.

Если операция заканчивается неуспешно, то сервер возвращает сообщение callOpFailed.

Клиент не должен пытаться выполнять другие операции (кроме операции callKill) с этим вызовом до получения сообщения callOpCompleted или callOpFailed.

callTransfer

Используйте эту операцию, для того, что бы передать присоединённого участника другой стороне.

Атрибуты:

callLeg

идентификатор вызова.

peer

адрес электронной почты или SIP URI, на которые необходимо передать звонок. Используйте этот атрибут для того, что бы начать "несопровождаемый перевод".

otherLeg

идентификатор вызова. Он должен указывать на некоторые другие "вызовы" в этой сессии. Задача должна находиться в режиме "connected". Используйте этот атрибут для завершения операции "сопровождаемого" перевода. Удалённый участник вызова "callLeg" соединяется с удалённым участником вызова "otherLeg".

Если атрибут otherLeg указан, то атрибутpeer игнорируется.

Если операция перевода звонка завершилась успешно, то вызов "callLeg" отсоединяется (клиенту отправляется сообщение callDisconnected). В дополнении к этому, если операцией была операция "сопровождаемого" перевода, то клиент также получает сообщение callDisconnected и для вызова "otherLeg".

Если операция перевода звонка заканчивается неуспешно, то сервер возвращает сообщение callOpFailed.

makeCall

Используйте эту операцию, для того, что бы совершить звонок с использованием любого зарегистрированного устройства или клиента. Сервер инициирует вызов аутентифицированному Пользователю, что приводит к тому, что все его зарегистрированные устройства начинают звонить. Когда любое устройство отвечает на звонок, то это устройство получает указание совершить вызов указанного адреса (или телефонного номера).

Атрибуты:

peer

адрес электронной почты вызова или SIP URI вызова.

makeCallReport сообщения отправляются клиенту, информируя его о ходе звонка. Эта операция завершается или при установлении звонка, или когда операция заканчивается неуспешно, или после истечения отведённого на неё времени (15 секунд). Если вызов не был установлен до истечения времени, то операция завершается, но процесс совершения звонка продолжается.

Сервер может отправлять следующие сообщения данных:

callProvisioned

Эти асинхронные сообщения данных отправляются, когда исходящий вызов находится в процессе обработки (после того, как Сервером был получен callStart):

Атрибуты:

callLeg

идентификатор вызова.

Тело (опционально):

XML представление промежуточного отклика SDP.

callDisconnected

Эти асинхронные сообщения данных отправляются, когда исходящий вызов заканчивается неуспешно, или когда входящий звонок был прерван, или когда установленный звонок отсоединяется:

Атрибуты:

callLeg

идентификатор вызова.

errorText

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

signalCode

в этом опциональном атрибуте указывается числовой код ошибки.

Обратите внимание: клиенту все-равно необходимо использовать операцию callKill для того, что бы освободить ресурсы, связанные с этим вызовом и сделать возможным повторное использование идентификатора вызова.

callConnected

Эти асинхронные сообщения данных отправляются, когда исходящий вызов завершается успешно и устанавливается звонок:

Атрибуты:

callLeg

идентификатор вызова.

Тело:

XML представление SDP удалённой стороны.

callIncoming

Эти сообщения отправляются при получении новых входящих звонков (для получения входящих звонков вам необходимо использовать операцию signalBind):

Атрибуты:

callLeg

идентификатор вызова. Сервер самостоятельно формирует эти идентификаторы.

peer

адрес электронной почты удалённого участника.

peerName

опционально; настоящее имя удалённого участника.

Тело:

XML представление SDP запроса.

callUpdated

Эти сообщения отправляются когда существующий звонок изменяется (помещается на удержание, переключается на другого удалённого участника и т.д.:

Атрибуты:

callLeg

идентификатор вызова.

peer

опционально; адрес электронной почты удалённого участника. Он отправляется, когда звонок был переведён.

peerName

опционально; настоящее имя удалённого участника.

Тело:

XML представление изменённого SDP участника.

callOpCompleted

Эти сообщения отправляются по завершению операций, совершаемых во время звонка (таких как callUpdate).

Атрибуты:

callLeg

идентификатор вызова.

callOpFailed

Эти сообщения отправляются, если операции, совершаемые во время звонка (такие как callUpdate, callSendDTMF) закончились неуспешно.

Атрибуты:

callLeg

идентификатор вызова.

errorText

текст сообщения об ошибке.

callDTMF

Эти сообщения отправляются по получению сигнала DTMF через канал сигнализации.

Атрибуты:

callLeg

идентификатор вызова.

Тело:

Строка с полученным числовым DTMF кодом.

makeCallReport

Эти сообщения отправляются во время операции makeCall.

Тело:

Строка, содержащая статус текущей операции.

Модель Ростера и Статуса Присутствия похожа на соответствующую модель протокола XMPP.

Ростером является набор элементов данных, каждый из которых описывает "контакт" - некоторого другого локального или удалённого пользователя. Пользователь может быть наблюдать за информацией о статусе присутствия "контакта", а "контакту" могут быть предоставлены права на наблюдение за информацией о статусе присутствия пользователя.

rosterList

Эта операция получает все активные элементы данных Ростера.

Атрибуты:

Сервер отправляет сообщения данных rosterItem для всех активных "контактов" Ростера.

rosterSet

Эта операция изменяет "контакт" Ростера.

Атрибуты:

peer

адрес электронной почты контакта.

subscription

опциональный атрибут:

• remove: удаляет контакт из Ростера.
• subscribed: подтверждает запрос контакта на наблюдение за информацией о статусе присутствия пользователя.
• unsubscribed: отвергает запрос контакта на наблюдение за информацией о статусе присутствия пользователя или забирает ранее предоставленное право на наблюдение.
• subscribe: отправляет запрос на наблюдение за информацией о статусе присутствия контакта.
• subBoth: подтверждает запрос контакта на наблюдение за информацией о статусе присутствия пользователя и отправляет запрос на наблюдение за информацией о статусе присутствия контакта.
• unsubscribe: останавливает наблюдение за информацией о статусе присутствия контакта.
• update или без атрибутов: изменяет информацию контакта.

name

опциональный атрибут, в котором содержится настоящее имя Контакта.

Тело:

набор XML элементов group; тело каждого элемента указывает имя Группы, которой принадлежит этого контакт.

Операции update, subscribed и subscribe создают новый элемент данных Ростера, если ранее элемент данных с таким адресом не существовал.

presenceSet

Эта операция устанавливает статус присутствия пользователя. Сервер собирает информацию о статусе присутствия от всех подключенных клиентов (XIMSS, XMPP, SIP) и распространяет её всем сетевым субъектам, подписанным на эту информацию.

Атрибуты:

type

этот опциональный элемент может иметь значение unavailable. Он указывает, что пользователь "как будто вне сети".
Если этот атрибут отсутствует, то пользователь находится в сети.

Тело:

опциональный XML элемент show; его текстовое тело указывает статус присутствия пользователя в стиле XMPP:

• dnd - Не беспокоить, Занят(а), На телефоне.
• away - Скоро вернусь, На совещании, На перерыве.
• xa - Нет на месте ("расширенное" Нет на месте).

В качестве альтернативы вы можете использовать элемент XML presence; его текстовое тело содержит более подробный статус присутствия пользователя:

• offline - "как будто вне сети".
• online - В сети.
• on-phone - пользователь в настоящее время разговаривает.
• in-meeting - пользователь находится на совещании.
• busy - общая форма для "не могу сейчас говорить".
• be-back - пользователь скоро вернётся
• out-lunch - пользователь вышел на перерыв.
• away - Нет на месте.

При начале сессии пользователь находится "как будто вне сети". Клиент должен использовать эту операцию, для того, что бы показать, что пользователь находится в сети.

Когда пользователь отсоединяется, статус его сессии автоматически меняется на unavailable (вне сети).

Сервер отправляет следующие сообщения данных:

rosterItem

Эти синхронные сообщения данных отправляются, когда Сервер обрабатывает запрос rosterList. Для каждого элемента данных Ростера (для каждого "Контакта") отправляется одно сообщение.

Атрибуты:

peer

адрес электронной почты контакта.

subscription

• to: пользователь может наблюдать за контактом.
• from: контакт может наблюдать за пользователем.
• both: пользователь и контакт могут наблюдать друг за другом.
• both: пользователь и контакт не могут наблюдать друг за другом.

ask

этот опциональный атрибут имеет значение subscribe если пользователь затребовал подписку на информацию о статусе присутствия контакта, но этот запрос еще не был подтверждён.

name

опциональный атрибут, в котором содержится настоящее имя Контакта.

Тело:

набор XML элементов group; тело каждого элемента указывает имя Группы, которой принадлежит этого контакт.

Если для разрешения уведомлений Ростера и Статуса Присутствия была использована операция signalBind:

• Каждый раз, когда элемент данных Ростера добавляется или изменяется, Сервер отправляет сообщения rosterItem с новыми или изменёнными данными.
• Каждый раз, когда элемент данных Ростера удаляется, Сервер отправляет сообщения rosterItem с атрибутом subscription, имеющим значение remove.
• Сервер отправляет сообщения данных presence.

presence

Атрибуты:

peer

адрес электронной почты контакта.

type

опциональный атрибут:

• unavailable: контакт находится вне сети.
• subscribe: контакт требует подписку на информацию о статусе присутствия пользователя.
• absent: контакт в сети.

Тело:

XML элемент presence; его текстовое тело указывает детализированный статус присутствия контакта (смотрите выше);
опциональный XML элемент show; его текстовое тело указывает статус присутствия контакта в стиле XMPP (смотрите выше).

prefsRead

Эта операция получает Настройки аутентифицированного пользователя.

Атрибуты:

type

это опциональный параметр.
Если указанное значение является default, то возвращаются Настройки, задаваемые для Пользователя Домена по умолчанию.
Если указанное значение является custom, то возвращаются явно указанные Настройки Пользователя.
Если атрибут не указан, то будут получены все фактически действующие Настройки Пользователя.

prefsStore

Эта операция получает Настройки аутентифицированного пользователя.

Тело:

XML элементы с именами, совпадающими с именами элементов Настройки. Тело элемента содержит новое значение элемента Настройки. Если значением является строка default, то значения пользовательских Настроек удаляются и фактически действующими Настройками Пользователя становятся Настройки по умолчанию.
Если значение является массивом, то он должен быть представлен с использованием XML представления aray.
Если значением является словарь, то он должен быть представлен с использованием XML представления dictionary.

Если тело содержит элемент UserFromAddr, то Сервер использует этот элемент и опциональный элемент UserFromName для составления элемента UserFrom, имеющим значение адрес электронной почты (в формате "UserFromName_value" <UserFromAddr_value>).

Сервер отправляет следующие сообщения данных:

prefs

Это синхронное сообщение данных отправляется, когда Сервер обрабатывает запрос prefsRead.

Атрибуты:

type

опциональный атрибут, такой же, как и атрибут запроса.

Тело:

XML элементы с именами, совпадающими с имена элементов Статуса Присутствия. В теле элемента содержится значение элемента Настройки.
Если значение является массивом, то он представляется с использованием XML представления aray.
Если значением является словарь, то представляется с использованием XML представления dictionary.

Если данные prefs содержат строку UserFrom, то Сервер пытается разобрать этот адрес электронной почты. Если адрес может быть разобран, то к телу сообщения данных добавляется элемент UserFromAddr (содержащим "чистый" адрес userName@domainName) и, опционально, элемент UserFromName (с комментарием адреса).

Клиент может работать с Хранилищем Файлов Пользователя.
Если аутентифицированный пользователь имеет право администратора домена CanAccessWebSites (Полный доступ ко всем Файлам), то этот клиент, используя префикс перед именем файла ~accountName/fileName, может также работать с файлами, принадлежащими другому Пользователю.

fileList

С помощью этой операции можно получить список имеющихся файлов.

Атрибуты:

directory

опциональный атрибут с именем поддиректории в Хранилище Файлов. Если он отсутствует, то возвращается содержимое верхней директории Пользователя в Хранилище Файлов.

Сервер возвращает одно сообщение fileInfo для каждого файла или директории, находящихся в указанной директории в Хранилище Файлом.

fileWrite

Эта операция сохраняет данные в файл.

Атрибуты:

fileName

имя записываемого файла.

position

Если этот атрибут отсутствует, то эта операция полностью перезаписывает указанный файл. Если файл не существовал, то он создаётся.
Если значением этого атрибута является append, то эта операция добавляет данные в конец файла (атомарно).
Если значением этого атрибута является число, то операция перезаписывает файл, начиная с позиции (байта), указываемого этим числом.

Тело:

Либо текст с данными файла, либо XML элемент base64. Текстовым телом этого XML элемента являются данные файла в кодировке base64 (кодировка base64 позволяет вам сохранять двоичные данные).

fileStore

Эта операция сохраняет загружаемый на сервер файл как файл в Хранилище Файлов.

Атрибуты:

fileName

имя создаваемого файла.

uploadID

строка, идентифицирующая файл в "наборе загруженных файлов".

Если файл с таким именем уже существует, то старый файл сначала удаляется.

fileRead

Эта операция читает данные из файла.

Атрибуты:

fileName

имя файла, который необходимо прочитать.

position

Этот числовой атрибут задаёт позицию файла, с которой начинается чтение. Если этот атрибут отсутствует, то файл читается с начала (с позиции 0).

limit

Этот числовой атрибут задаёт максимальный размер читаемой порции данных. Если он не указан, то используется ограничение в 1Мб.

type

Если этот опциональный атрибут существует и его значением является binary, то данные файла возвращается в кодировке base64.

Сервер возвращает сообщение fileData.

fileRename

Эта операция удаляет файл или директорию из Хранилища Файлов.

Атрибуты:

fileName

имя переименовываемого файла или директории.

newName

новое имя файла или директории.

fileRemove

Эта операция удаляет файл или директорию из Хранилища Файлов.

Атрибуты:

fileName

имя удаляемого файла или директории. Удалены могут быть только пустые директории.

fileCopy

Эта операция копирует файл или содержимое сообщения в файл в Хранилище Файлов.

Атрибуты:

newName

имя создаваемого файла (для копии файла). Если файл с этим именем уже существует, то он удаляется.

fileName

опционально: этот параметр задаёт имя файла, которое необходимо скопировать.

Тело:

опциональный элемент copyMIME. Он задаёт часть сообщения, которую необходимо декодировать с скопировать в указанный файл.

Операция должна иметь либо атрибут fileName, либо один элемент тела copyMIME.

Сервер отправляет следующие сообщения данных:

fileInfo

Это синхронное сообщение данных отправляется, когда Сервер обрабатывает запрос folderList.

Атрибуты:

fileName

имя файла или поддиректории.

directory

опциональный атрибут, аналогично атрибуту directory в запросе fileList.

type

опциональный атрибут существует и содержит значение directory, если это сообщение описывает поддиректорию.

size

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

timeModified

опциональный атрибут, в котором находится дата и время изменения файла (местное время).

fileData

Это сообщение отправляется, когда Сервер обрабатывает запрос fileRead.

Атрибуты:

fileName

имя файла для чтения.

position

позиция, начиная с которое читаются данные файла.

slice

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

size

общий размер файла.

timeModified

опциональный атрибут, в котором находится дата и время изменения файла (местное время).

Тело:

Либо текст с данными файла, либо элемент base64. Телом этого XML элемента являются данные файла в кодировке base64 (кодировка base64 позволяет вам получать двоичные данные).

Примеры:

C:<fileRead id="A001" fileName="test.txt" />
S:<fileData id="A001" fileName="test.txt"position="0" slice="22" size="22" timeModified="20061018T115836">This is not your file!</fileData>
S:<response id="A001"/>

C:<fileRead id="A002" fileName="test.txt" limit="15" />
S:<fileData id="A002" fileName="test.txt"position="0" slice="15" size="22" timeModified="20061018T115836">This is not you</fileData>
S:<response id="A002"/>

C:<fileRead id="A003" fileName="test.txt" limit="15" position="15" />
S:<fileData id="A003" fileName="test.txt"position="15" slice="7" size="22" timeModified="20061018T115836">r file!</fileData>
S:<response id="A003"/>

C:<fileRead id="A004" fileName="test.txt" limit="15" position="15" type="binary" />
S:<fileData id="A004" fileName="test.txt"position="15" slice="7" size="22" timeModified="20061018T115836"><base64>ciBmaWxlIQ==</base64></fileData>
S:<response id="A004"/>

C:<fileRead id="A005" fileName="test.txt" position="25" />
S:<response id="A005" errorText="reading beyond the EOF mark" errorNum="500" />

• mailIn - входящие почтовые Правила (Правила Очереди) .
• signalIn - входящие Правила Сигналов.

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

Каждое Правило содержит ноль или более элементов condition, ноль или более элементов action и ноль или один элемент comment:

condition

Дополнительную информацию смотрите в разделе Правила.

Атрибуты:

opCode

данные условия Правил.

operator

операция условия Правил.

Тело:

параметр условия Правила.

action

Дополнительную информацию смотрите в разделе Правила.

Атрибуты:

opCode

операция действия Правила.

Тело:

параметр действия Правила.

comment

Тело:

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

ruleList

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

Атрибуты:

type

набор Правил.

ruleRead

Эта операция предписывает серверу отправить одно или более сообщений rule для указанного Правила. В теле этого сообщения содержатся XML элементы с условиями Правил, действиями и опциональный комментарий.

Атрибуты:

type

набор Правил.

name

имя Правила.

ruleSet

Эта операция сохраняет новое Правило. Если есть существующее Правило с таким же именем, то оно удаляется.
Пользователь должен иметь право указывать условия и действия, используемые как в новых, так и в старых Правилах.

Атрибуты:

type

набор Правил.

name

имя Правила.

priority

приоритет Правила.

stage

стадия применения Правила (для Правил Сигналов).

Тело:

аналогично XML элементам, используемым в сообщении rule: ноль или более элементов condition, ноль или более элементов action и ноль или один элемент comment.

ruleUpdate

Эта операция изменяет приоритет Правила и/или его стадию применения (для Правил Сигналов).
Пользователь должен иметь право указывать условия и действия, используемые в изменяемом Правиле.

Атрибуты:

type

набор Правил.

name

имя Правила.

priority

приоритет Правила.

stage

стадия применения Правила (для Правил Сигналов).

ruleRename

Эта операция переименовывает существующее Правило.
Пользователь должен иметь право указывать условия и действия, используемые в переименовываемом Правиле.

Атрибуты:

type

набор Правил.

name

имя существующего Правила.

newName

новое имя Правила.

ruleRemove

Эта операция удаляет существующее Правило.
Пользователь должен иметь право указывать условия и действия, используемые в удаляемом Правиле.

Атрибуты:

type

набор Правил.

name

имя существующего Правила.

Сервер отправляет следующие сообщения данных:

rule

Это синхронное сообщение данных отправляется, когда Сервер обрабатывает запрос ruleList или ruleRead. Смотрите выше формат сообщения rule.

Клиент может взаимодействовать с Приложениями Реального Времени, запущенными на Сервере или в Кластере CommuniGate Pro.

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

Каждая сессия XIMSS обслуживает список Описателей Задач для тех Задач, с которыми она взаимодействует. Каждый описатель в списке связан с строкой taskID. XIMSS клиент использует эти строки taskID для нахождения Задачи в списке.

taskFindMeeting

В этой операции реализована операция FindMeeting. Дополнительную информацию смотрите в разделе CG/PL.

Атрибуты:

meetingSet

опционально, имя набора Встречи. Если значение этого параметра опущено или является пустой строкой, то используется Набор Встречи, применяемый по умолчанию.

meetingName

уникальный идентификатор новой Встречи.

Если эта операция заканчивается успешно, то Сервер возвращает сообщение taskMeeting с обнаруженными данными встречи.

taskCreateMeeting

Эта операция реализует выполнение операции CreateMeeting. Дополнительную информацию смотрите в разделе CG/PL.

Атрибуты:

meetingSet

опционально, имя набора Встречи. Если значение этого параметра опущено или является пустой строкой, то используется Набор Встречи, применяемый по умолчанию.

meetingName

уникальный идентификатор новой Встречи.

Тело:

Текст, добавляемым в Событию Встреча в качестве параметра.

taskRemoveMeeting, taskClearMeeting, taskActivateMeeting, taskDeactivateMeeting

В этих операциях реализовано выполнение операций Встречи. Дополнительную информацию смотрите в разделе CG/PL.

Атрибуты:

meetingSet

опционально, имя набора Встречи. Если значение этого параметра опущено или является пустой строкой, то используется Набор Встречи, применяемый по умолчанию.

meetingName

уникальный идентификатор новой Встречи.

taskSendEvent

Эта операция отправляет Задаче Событие.

Атрибуты:

taskRef

внутренний taskID Задачи, который отправляется Событие.

eventName

имя отправляемого События.

Тело:

текст, отправляемый с Событием в качестве параметра.

taskClose

С каждым внутренним taskID связываются некоторые определённые ресурсы сессии. Если ваш клиент работает со многими задачами, то по завершению взаимодействия с какой-либо Задачей рекомендуется использование операции taskClose, что освобождает все внутренние ресурсы taskID.
Если та же Задача отправляет в эту сессию Событие или Описатель Задачи был обнаружен другим способов, то в этой сессии этой Задаче присваивается новый taskID.

Атрибуты:

taskRef

освобождаемый внутренний taskID.

Сервер отправляет следующие сообщения данных:

taskMeeting

Это синхронное сообщение данных отправляется, когда Сервер обрабатывает запрос taskFindMeeting.

Атрибуты:

meetingSet, meetingName

копия атрибутов запроса taskFindMeeting.

taskRef

опциональный атрибут: внутренний taskID Задачи, который активировал эту Встречу.

expires

опциональный атрибут с дата и временем (GMT) окончания срока действия Встречи.

Тело:

XML представление параметров Встречи.

taskEvent

Это асинхронное сообщение данных отправляется, когда некоторая Задача или сам Сервер отправляет в текущую сессию XIMSS Событие.

Атрибуты:

taskRef

внутренний taskID Задачи, отправившей Событие. Если этот атрибут отсутствует, то Событие было создано и отправлено самим Сервером.

eventName

имя полученного События.

Тело:

Текст или XML представление параметров События.

Клиент может получать доступ к глобальному Справочнику.

listDirectory

Эта операция получает данные из Справочника.

Атрибуты:

baseDN

DN записи справочника, с которой начинается поиск. Если значением атрибута является $, то baseDN устанавливается в то поддерево Справочника, в котором содержатся записи для текущего Домена Пользователя.

filter

этот опциональный атрибут задаёт фильтр поиска в формате RFC2254.

scope

в этом опциональном атрибуте задаётся тип поиска:

• base - baseDN получаемой записи (атрибут filter игнорируется)
• one (по умолчанию) - поиск осуществляется непосредственно в baseDN поддерева (одноуровневый поиск))
• sub - поиск осуществляется во всём baseDN поддерева (многоуровневый поиск)

limit

в этом опциональном атрибуте задаётся новый пароль.

Тело (опционально):

набор XML элементов field. Каждый элемент должен иметь текстовое тело, содержащее имя получаемого атрибута. Если элемент field не указан, то возвращаются все неслужебные атрибуты записи Справочника.
Обратите внимание: если атрибут mail указан явно, то Сервер сформирует значение этого атрибута для всех записей объектов CommuniGate Pro, у которых он отсутствует.

Сервер отправляет сообщение directoryData для каждой найденной записи.

Сервер отправляет следующие сообщения данных:

directoryData

Это синхронное сообщение данных отправляется для каждой записи Справочника, возвращаемой в ответ на запрос listDirectory.

Атрибуты:

name

DN записи.

Тело:

XML представление атрибутов Записи.

Массив

Словарь

EMail

Тело:

набор XML элементов, содержащих поля заголовка сообщения электронной почты, такие как From, Date и т.д., не включая поля MIME, связанные с содержанием (такие как Content-Type),
и (опционально) элемент MIME с телом сообщения.

Типом каждого XML элемента является имя поля:

<Subject>Hello, world!</Subject>

Категории полей:

Адреса: From, To, Cc, Bcc, Return-Path, Sender, Reply-To, Disposition-Notification-To, Recent-From, Recent-To, Return-Receipt-To, Errors-To

Эти элементы может содержать атрибут realName - MIME декодированный адрес части имени или комментарий.
Телом элемента является его адрес электронной почты в формате userName@domainName или в более общем формате userName[%domainA[%domainB]]@domainName.
Если поле содержит несколько адресов, то создаётся несколько XML элементов, так, что каждый элемент содержит в точности один элемент тела.

Отметки о Времени: Date, Resent-Date

Эти элементы содержат:
атрибут timeShift - разница в секундах между местным временем указанным в поле и соответствующим GMT временем.
атрибут localTime, указывающий значение времени поля (в формате iCalendar) в часовом поясе, выбранном для текущего пользователя.
Телом элемента является глобальное значение времени поля (GMT) в формате iCalendar.

Pty

Телом этих элементов являются строки High или Low. Эти значения преобразовываются в числовые значения (и из числовых значений) поля заголовка X-Priority.

Неструктурированные

Все поля, не перечисленные в предыдущих категориях, относятся к этой категории.
Тело элемента содержит MIME-декодированное значение поля.

MIME

Атрибуты:

partID

эта строка указывает размещение MIME части в сообщении. Она может использоваться для получения части сообщения.

estmatedSize

ориентировочный размер (в байтах) данных части, после декодирования данных части.

type

тип части Content-Type, без информации о подтипе.

subtype

подтип части Content-Type, если есть.

charset

кодировка части (если отсутствует, то подразумевается UTF-8).

contentID

строка Content-ID (не заключённая в угловые скобки).

disposition

строка Content-Disposition (без параметров).

description

строка Content-Description.

location

строка Content-Location.

class

строка Content-Class после удаления префиксов urn: и content-classes:.

Type-name

любой параметр поля Content-Type name и его значение, за исключением параметров boundary, charset и format.

Disposition-name

любой параметр поля Content-Disposition name и его значение.

Тело:

Тело элемента являетс опциональным. Если оно присутствует, оно содержит данные тела части.
Если Сервер не смог прочитать данные тела части элемента, то к элементу добавляется атрибут readError. Значение атрибута содержит код ошибки чтения.
Если Сервер не смог разобрать данные тела части элемента, то к элементу добавляется атрибут parseError. Значение атрибута содержит код ошибки разбора.
Формат элемента зависит от части Content-Type (символ "*" ниже обозначает любой Content-Type или подтип):

multipart/*

Ноль или более XML элементов MIME, в которых содержатся подчасти сообщения.

message/rfc822

XML элемент EMail для вложенного сообщения.

text/rfc822-headers

XML элемент EMail (не содержащий элемент тела MIME).

text/directory, text/x-vcard

Ноль или более XML элементов vCard.

text/calendar

XML элемент iCalendar.

message/disposition-notification, message/delivery-status

XML элемент MIMEReport.

text/*

Декодированный текст сообщения, в котором все символы конца строки заменены на символ Перевода Строки (0x0A).

Обратите внимание: Когда получается сообщение, запрошенное по операции folderRead, тело MIME элемента включается только его его размер плюс размер частей, уже включённых в XML ответ, не превышает атрибута операции totalSizeLimit.

Пример:

vCard

iCalendar

Тело:

элемент vCalendar.

vCalendar

Атрибуты:

version

версия vCalendar (2.0 для iCalendar)

method

опциональный атрибут с методом vCalendar

prodid

опциональная строка, идентифицирующая продукт, использованный для создания этого объекта vCalendar.

Тело:

набор элементов vtimezone, vevent и/или vtodo.

vtimezone

vevent, vtodo

xrule

sdp

Атрибуты:

ip

IP адрес медиа по умолчанию (опционально).

origUser

поле username оригинальной сессии (опционально).

sessionID

поле sess-id оригинальной сессии.

sessionVersion

поле sess-version оригинальной сессии.

origIP

IP адрес, указанный в полях nettype, addrtype и unicast-address оригинальной сессии.

subject

subject сессии (опционально). Если отсутствует, то используется subject -.

Тело:

набор media элементов.

media

Атрибуты:

media

типа медиа (такой, как audio, video). Если этот атрибут отсутствует, то используется значение audio.

ip

адрес и порт медиа.

protocol

медиа протокол (такой, как udp, tcp, RTP/AVP). Если этот атрибут отсутствует, то используется значение RTP/AVP.

direction

направление медиа (sendrecv, sendonly, recvonly, inactive).

Тело:

набор элементов codec.

codec

MIMEReport

Атрибуты:

отсутствуют

Тело:

набор XML элементов, в которых содержатся поля заголовка отчёта, такие как Reporting-MTA, /Final-Recipient и т.п.
а также (опционально) элементы MIMEReport для тела отчёта.

Получение Части Сообщения

Загрузка Файла на Сервер

Скачивание Файла

/Session/sessionID/DOWNLOAD/fileName

sessionID

текущий идентификатор сессии XIMSS, отправленный с сообщением данных session.

fileName

имя файла в сессии Хранилища Файлов Пользователя.