МенеджерСистемыВзаимодействия.НачатьПодключениеОбработчикаНовыхСообщений (CollaborationSystemManager.BeginAttachNewMessagesHandler)

МенеджерСистемыВзаимодействия (CollaborationSystemManager)

НачатьПодключениеОбработчикаНовыхСообщений (BeginAttachNewMessagesHandler)

Доступен, начиная с версии 8.3.11.

Вариант синтаксиса: По идентификатору

Синтаксис:

НачатьПодключениеОбработчикаНовыхСообщений(<ОписаниеОповещения>, <ИдентификаторОбсуждения>, <Обработчик>, <СтатусОповещенияПользователя>)

Параметры:

<ОписаниеОповещения> (необязательный)

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

<Дополнительные параметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<ИдентификаторОбсуждения> (обязательный)

Тип: ИдентификаторОбсужденияСистемыВзаимодействия.
Идентификатор обсуждения, к которому подключается обработчик.

<Обработчик> (необязательный)

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

<Сообщение> - тип СообщениеСистемыВзаимодействия. В обработчик передается копия объекта;
<ДополнительныеПараметры> - тип Произвольный. Значение, которое было указано при создании объекта ОписаниеОповещения.

<СтатусОповещенияПользователя> (необязательный)

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

Описание варианта метода:

Выполняет подключение обработчика по идентификатору обсуждения.

Вариант синтаксиса: По ключу

Синтаксис:

НачатьПодключениеОбработчикаНовыхСообщений(<ОписаниеОповещения>, <Ключ>, <Обработчик>, <СтатусОповещенияПользователя>)

Параметры:

<ОписаниеОповещения> (необязательный)

<Дополнительные параметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<Ключ> (обязательный)

Тип: Строка.
Ключ обсуждения, к которому подключается обработчик.

<Обработчик> (необязательный)

<Сообщение> - тип СообщениеСистемыВзаимодействия. В обработчик передается копия объекта.
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<СтатусОповещенияПользователя> (необязательный)

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

Описание варианта метода:

Выполняет подключение обработчика по ключу обсуждения.

Описание:

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

ИмяПроцедуры,
ИмяПроцедурыОбработкиОшибки,
Модуль,
МодульОбработкиОшибки.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент.

См. также:

МенеджерСистемыВзаимодействия, метод ПодключитьОбработчикНовыхСообщенийАсинх

Использование в версии:

Доступен, начиная с версии 8.3.11.

Методическая информация