Уведомления

Общее

Типы уведомлений

Все уведомления в CEOboard классифицируются по типами уведомлений. Предусмотрены следующие системные типы уведомлений:

  • Поручения

    • Новое поручение

    • Поручение изменено

    • Требует проверки

    • Поручение исполнено

  • Задачи

    • Новая задача

    • Запрос переноса срока

    • Решение по переносу срока

    • Наступило событие

    • Ошибка завершения события

  • Оповещения

    • Новое оповещение (вручную)

  • Отчеты

    • Опубликован

    • Предоставлен доступ

    • Обновлен

    • Обновлен с ошибкой

    • Ошибка обновления

    • Отозван

  • Предоставлен доступ к базе

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

Администратор системы может добавить свои, пользовательские типы уведомлений. Данные уведомления могут быть привязаны к объектам так же как и системные. Могут быть и периодические пользовательские уведомления, которые, если позволяют настройки, формируются самостоятельно, без привязки к объектам. В отличие от системных, все параметры пользовательских уведомлений подвержены настройкам. Настройку пользовательских уведомлений смотрите в «Пользовательские уведомления».

Способы отправки

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

  • по электронной почте,

  • по SMS,

  • создать оповещение.

Для отправки уведомления по электронной почте и sms в настройках физ. лица получателя должны быть указаны email и мобильный телефон. Телефоны могут быть перечислены через точку с запятой.

Создание оповещения подразумевает создание документа Оповещение и отправка push уведомления на подключенное мобильное устройство.


Таким образом оповещение отображается и в настольном приложении и в мобильном.


Очередь уведомлений

Работа с уведомлениями разбита на некоторые стадии. При переходе уведомления на некоторую стадию она записывается в Очередь сообщений. Очередь сообщений доступна для администратора в Главное меню — Все функции — Регистры сведений — Очередь отправки сообщений.

Каждая запись очереди сообщений содержит следующие данные:

  • Период — дата возникновения уведомления. Период не меняется от момента создания до отправки уведомления.

  • Способ отправки — описан в Способы отправки.

  • Состояние — указывает на текущую стадию обработки уведомлений. Используются следующие состояния:

    • Черновик. При возникновение события по которому регистрируется оповещение формируется запись с данным состоянием. При этом фиксируется только способ отправки, объект и тип уведомления. Никакой обработки уведомления не производится.

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

    • Отправляется провайдером — свидетельствует об успешной передачи сообщения провайдеру SMS.

    • Доставлено. Специальное регламентное задание проверяет доставку сообщений у провайдеров SMS. В случае успешной доставки уведомлению присваивается статус Доставлено. Если уведомление не было доставлено, то оно остаётся в статусе Отправляется провайдером.

    • Не отправлено провайдером — свидетельствует о возникновении ошибки в процессе отправки уведомления.

    • Отправлено провайдером — свидетельствует об успешной передачи сообщения провайдеру Email и Push. Проверок результатов доставки не предусмотрено.

    • Ошибка сообщения — формирование или отправка уведомления были прерваны. Причины могут быть различны — как ошибки настройки пользовательских уведомлений или ошибки алгоритмов времени выполнения, так и отсутствие необходимости уведомления, отсутствие номера телефона, email или подключенных мобильных устройств.

  • Объект — ссылка на объект базы данных, по которому возникло уведомление. Для периодических уведомлений устанавливается ссылка на тип уведомления.

  • Тип уведомления — описан в Типы уведомлений.

  • Настройка отправки — учетная запись, в которой хранятся настройки отправки уведомлений. Смотрите в Настройки учетных записей.

  • Внутренний идентификатор — используется для идентификации уведомлений у некоторых провайдеров SMS. Кроме того служит идентификатором который определяет одно и тоже уведомление для разных записей в очереди. Одно уведомление может располагаться в разных записях для разных получателей и разных адресов одного получателя. При создании идентификатор основывается на текущем времени.

  • Получатель — ссылка на физ. лицо получателя уведомления.

  • Номер отправки — служебное поле для нумерации записи одного уведомления. Служит разделителем для случаев, когда у одного получателя будет несколько адресов.

  • Дата записи — дата, когда произведена запись текущей строки в очереди.

  • Текст ошибки — содержит сведения об ошибках и любую информацию, помогающую ход процедуры отправки.

  • Другие реквизиты уведомления — все остальные реквизиты хранят данные сформированного уведомления.

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

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

Настройки уведомлений

Системные настройки

Откройте Начальная страница — Мои настройки — Системные — Настройки оповещений. Будет открыт диалог настроек по типам уведомлений.

В списке отсутствует тип уведомления «Предоставлен доступ к базе», так как данное уведомление генерируется явно и отправляется только по электронной почте.

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

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

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

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

Изменении настроек действует на пользователей, у которых применяются настройки по-умолчанию. Однако у администратора может возникнуть необходимость перенести настройки какого-либо типа уведомлений для пользователей с собственными настройками. Например, при создании нового типа уведомлений, его нужно включить для всех пользователей. Это можно сделать с помощью команды Ещё — Заполнить настройки пользователей.

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

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

Для пользователей с правами администратора откройте Начальная страница — Мои настройки — Персональные — Настройки оповещений. Для пользователей с обычными правами откройте Начальная страница — Мои настройки — Настройки оповещений. Каждый пользователь может установить только свои настройки.

В списке отсутствует тип уведомления «Новое оповещение (вручную)», чтобы пользователь не мог отказаться от уведомлений, созданных вручную.

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

Разрешается свободно включать и выключать отправку любых уведомлений по Email, Оповещений и разрешенных администратором SMS. Если администратор запретил отправку SMS, то это не может быть включено в собственных настройках пользователя.

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

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

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

Настройки учетных записей

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


В обоих справочниках включается/отключается отправка по Email, SMS, Push и настраиваются учетные записи Email и SMS.

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

Пользовательские уведомления

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

Откройте Начальная страница — Мои настройки — Системные — Настройки оповещений. Будет открыт диалог настроек по типам уведомлений. Нажмите Открыть все типы уведомлений, чтобы открыть форму списка справочника Типы уведомлений. При добавлении новых элементов в этот справочник, добавляются новые пользовательские уведомления.

Настройка типа уведомления

Уведомления делятся на два вида:

  • Объектные — связаны с объектом базы данных, возникают при записи этого объекта.

  • Периодические — возникают по установленному расписанию.

Но несмотря на это настройка уведомлений во многом идентична. Она состоит из следующих шагов:

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

  • Получатели. Определяют получателей уведомления. Подробнее смотрите в Получатели.

  • Тексты. Задают заголовки и тексты уведомлений для каждого способа отправки. Подробнее смотрите в Тексты.

Каждую из этих настроек можно сделать четырьмя способами:

  • Вручную. Это лучший вариант, когда не требуются специальные отборы объектов, список получателей и тексты уведомлений фиксированные.

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

  • По запросу. Выполняется запрос, который возвращает данные необходимые для формирования уведомлений. Это расширенный вариант способа «по объекту», так как разработчику доступны все возможности языка запросов 1С, а не только обращение через точку.

  • По обработчику. Обработчик возвращает данные для проверки отборов и формирования уведомлений. Для создания обработчика требуется написать код на языке 1С:Предприятие, который имеет доступ ко всем возможностям и функциям, реализованным в системе.

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

Далее будет дано описание настроек типа уведомлений, в том числе и каждого способа для каждого шага.

Общие сведения

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

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

Вид оповещения определяет условия возникновения уведомления.

  • Объектное уведомление — возникает при первой или при каждой записи объекта в базу данных. Необходимо обязательно указать источник формирования.

  • Периодическое уведомление — возникает по установленному расписанию.

Сведения об источнике формирования задаются объектом метаданных. Для объектных уведомлений определяет тип объекта, при записи которого возникает уведомление. Для периодического уведомления вместе с обработчиком уведомления задаёт объект уведомления.

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

Пометка удаления, Устарел. При установке пометки удаления, тип уведомления игнорируется при создании новых уведомлений. Тот же эффект достигается, если установить пометку Устарел. Для установки пометки откройте форму типа уведомлений, выберите Ещё — Пометить как устаревший / Снять пометку. В списке устаревшие уведомления отображаются серым цветом.

Отбор периодического уведомления с помощью обработчика

Проверка отбора для периодического уведомления выполняется по типу объекта уведомления при выполнении следующих условий:

  • Указаны сведения об источнике формирования,

  • Обработчик вернул данные с объектом уведомления.

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

Выполняйте эти условия, только Вам действительно нужен объект уведомления, например для настроек «По объекту» или «По запросу». В противном случае рекомендуется использовать обработчик без объекта уведомления.

Отборы

Закладка Отборы появляется только для уведомлений по объекту. Если Вы хотите, чтобы уведомление формировалось не по всем объектам указанного ранее типа, то здесь можно задать условия, которые отберут нужные объекты.

Опишем каждый из четырех способов настройки.

Все объекты

Отбора нет. Уведомление формируется по всем объектам, указанных в Общие сведения.

Реквизиты объекта

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

Условия проверяются перед формированием уведомлений для каждого объекта из очереди. Если условия выполняются, то формирование продолжается дальше, если нет — в строке очереди фиксируется ошибка.

Запрос

Условия отбора задаются путем выполнения произвольного запроса к данным. Запрос оперирует объектами очереди, выбранными для формирования уведомлений, и осуществляет их отбор.

Запрос выполняется однократно перед формированием уведомлений. Он сразу возвращает все объекты, которые прошли отбор. По этим объектам формирование продолжается дальше, если каких-то объектов нет — в строке очереди фиксируется ошибка.

Обработчик

Условия отбора проверяются в коде обработчика. Так же как и запрос, обработчик принимает объект уведомления, реализует проверки и возвращает данные с объектом, если он прошел отбор. Однако обработчик работает менее эффективно чем запрос, так как он вызывается при формировании каждого объекта.

Расписание

Закладка Расписание появляется только для периодических уведомлений и содержит в себе настройки расписания создания таких уведомлений.

Каждому периодическому типу уведомлений автоматически создаётся регламентное задание. Это расписание фактически является расписанием регламентного задания, которое управляет его стартом.

Получатели

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

Опишем каждый из четырех способов настройки.

Список

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

В качестве получателей могут быть заданы элементы справочников Физ. лица, Орг. единицы, Группы сотрудников.

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

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

Реквизиты объекта

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

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

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

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

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

В правом списке указываются выражения запроса к объекту уведомления. Из каждой строки система получает данные для списка физ. лиц получателей. Имена табличный частей в тексте выражения выделены фигурными скобками {}.

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

Запрос

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

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

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

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

Обработчик

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

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

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

Тексты

Закладка Тексты служит для задания шаблонов текстов уведомления.

При выборе в списке могут быть доступны не все шаблоны. Необходимо выполнение следующих условий:

  • Подходящим считается шаблон с тем же значением источник формирования, либо с неуказанным;

  • При выборе шаблона для одного из способов отправки, этот способ должен быть включен в шаблоне;

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

Подробнее о настройке шаблонов текстов смотрите в Шаблон оповещения.

Прочие сведения

На закладке «Прочие сведения» содержатся комментарий и сведения о регистрации типа уведомлений.

Шаблон оповещения

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

Общие сведения

Наименование и Группа определяют представление элемента и его положение в иерархии. При большом количестве шаблонов организация групп облегчает навигацию и поиск нужного элемента.

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

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

Тексты

В шаблоне задаются тексты уведомлений для отправки по email, SMS и формирования оповещений. Также для email задаётся тема, а для оповещения — заголовок. Для каждого способа отправки предназначены соответствующие поля настройки текста. Допускается указать тексты для одного или нескольких способов отправки, остальные отключаются.

В примере сверху шаблон не может использоваться для Email и SMS. Но он включает настройку текста оповещения.

Настройки могут включать в себя не только фиксированные тексты темы, заголовка и самих уведомлений. Как и положено шаблону в текст могут быть вставлены параметры, выделенные квадратными скобками [], которые будут получены различными способами. Опишем каждый из четырех вариантов использования параметров.

Без параметров

Параметры не предусмотрены, шаблон содержит только фиксированные тексты. Используется для уведомлений, текст которых не зависит от объекта уведомления.

Реквизиты объектам

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

В левом списке отображаются все реквизиты объекта (кроме хранилищ значений и табличных частей). Любой ссылочный реквизит можно развернуть и получить список его реквизитов и так далее пока они не закончатся. Поместить в шаблон можно любой реквизит. В текст будет вставлено стандартное представление его значения.

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

Запрос

Позволяет получить параметры путем выполнения произвольного запроса.

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

В левом списке отображаются поля запроса, который указывается в настройках запроса. Для удобства поля можно переносить в тексты уведомлений. Но если список полей запроса не заполнен, то параметр в тексте шаблона можно указать вручную. Главное, чтобы результат запроса действительно содержал указанное поле.

Обработчик

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

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

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

Прочие сведения

На закладке «Прочие сведения» содержатся комментарий и сведения о регистрации шаблона.

Запрос оповещения

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

Параметры запроса

Запрос выполняется для получения данных из объектов уведомлений. При выполнении список объектов уведомлений передаётся в запрос с помощью параметра Объекты.

Текст запроса

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

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

Поля запроса

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

Обработчик оповещения

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

Входные данные

При выполнении кода обработчику доступны следующие входные переменные:

  • Объект — ссылка на объект уведомления. Предполагается, что обработчик получит данные для объекта уведомления. Для регламентных оповещений объект отсутствует.

  • ОбработчикОповещения — указывает на текущий обработчик оповещения.

  • ТипУведомления — тип формируемого уведомления, в настройках которого указан данный обработчик.

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

    • ЭтоНовый — признак установлен, если производится запись нового объекта. Присутствует для оповещения по объекту.

    • РежимЗаписи — содержит режим записи документа. Присутствует для оповещения по объекту.

    • РежимПроведения — содержит режим проведения документа. Присутствует для оповещения по объекту.

    • ТекущееФизЛицо — содержит ссылку на пользователя сформировавшего оповещение. Предназначен для исключения текущего пользователя из списка получателей оповещений.

  • СпособОтправки — указывает каким из 3-х предусмотренных способов будет отправлено данное сообщение.

Выходные данные

После выполнения кода система ожидает заполнения следующих переменных:

  • РеквизитыОбработчика — переменная в которую обработчик помещает настройки и данные.

  • Отказ — признак прерывания формирования оповещения.

  • ТекстОшибки — Строка, текст сообщения об ошибке, предназначен записи в очередь уведомлений. Для прерывания формирования оповещения достаточно заполнить либо ТекстОшибки, либо Отказ.

Переменная РеквизитыОбработчика может быть следующих типов:

  • Структура — содержит данные одного объекта. Удобно применять для одного сообщения в оповещениях по объекту.

  • Соответствие — содержит данные нескольких объектов. Удобно применять для регламентных оповещений с получением данных уэкОбщегоНазначения.ЗначенияРеквизитовОбъекта. В общем случает ключ соответствия содержит ссылку на объект, значение - структуру данных.

  • Таблица значений — содержит данные нескольких объектов и/или сообщений. Удобно применять для регламентных оповещений с получением данных запросом. Каждая строка таблицы соответствует отдельному сообщению.

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

Отбор с помощью обработчика

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

Аналогичным образом следует заполнить реквизиты объекта в обработчике, указанному в качестве обработчика регламентного оповещения. Объект в регламентном оповещении нужен для определения получателей и текстов по объектам и по запросам. В остальных случаях указывать поле ОбъектУведомления необязательно. Однако, если объект будет задан, то он должен иметь тип, указанный в типе оповещений (если задан).

Получатели с помощью обработчика

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

  • ФизЛица, ОргЕдиницы, ГруппыСотрудников — коллекции элементов соответствующего типа. Коллекция может быть массивом, либо результатом запроса с колонками соответственно ФизЛицо, ОргЕдиница, ГруппаСотрудников.

  • ФизЛицо, ОргЕдиница, ГруппаСотрудников — ссылки на элементы справочников соответствующего типа. Поля с одиночными элементами будут применяться, только если отсутствуют поля соответствующих коллекций.

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

Тексты с помощью обработчика

Обработчик может содержать дополнительные поля, данные из которых используются при формировании текстов сообщений. Для удобства настроек список полей заполняется на закладке Реквизиты данных. Этот список используется в настройке текста шаблона оповещения. Следует использовать такие данные в этих полях, которые не теряют смысл при стандартном строковом преобразовании. Например, такие данные как ХранилищеЗначений или Массив при преобразовании в строку не будут иметь смысла, поэтому их не стоит использовать.


Написать нам
Задайте нам свой вопрос и мы обязательно постараемся вам помочь