.. _dashboard-settings-client-messages: Настройки отправки уведомлений =============================== Для просмотра и редактирования настроек отправки уведомлений необходимо на странице с настройками выбрать пункт меню ``Отправка уведомлений`` или перейти по адресу: ``{адрес:порт}/settings/clientMessages``. Откроется страница, на которой находится таблица, содержащая все добавленные настройки уведомлений. .. image:: img/Dashboard_Settings_ClientMessages.png :scale: 37 :align: center :alt: Настройки отправки уведомлений Добавление новой настройки ----------------------------- Для добавления новой настройки необходимо на странице с настройками уведомлений нажать кнопку ``Добавить``. После этого появится выпадающий список, содержащий все доступные типы уведомлений. Выберите необходимый тип настроек из списка. После этого откроется страница с формой для добавления новых настроек. Если были добавлены все допустимые типы, то кнопка ``Добавить`` не показывается. Доступные типы настроек: - :ref:`Отправка через базу данных `; - :ref:`Отправка по электронной почте `; - :ref:`Отправка в Telegram `; - :ref:`Отправка через RabbitMQ `. Удаление настройки -------------------- Для удаления настройки отправки уведомлений нужно нажать на кнопку ``Удалить`` в списке настроек отправки уведомлений и подтвердить удаление записи. Изменение настройки -------------------- Для изменения настройки отправки уведомлений нужно нажать на кнопку ``Изменить`` в списке настроек отправки уведомлений. После этого откроется страница с формой для изменения настроек. .. _DashboardSettingsClientMessages-Database: Настройки отправки уведомлений через базу данных ------------------------------------------------- Страница с настройками отправки уведомлений через базу данных показана на рисунке. .. image:: img/Dashboard_Settings_ClientMessages_Database.png :scale: 76 :align: center :alt: Настройки отправки уведомлений через базу данных .. list-table:: Настройки отправки уведомлений через базу данных :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Используется - Включение или выключение отправки уведомлений. - Да * - Включить расширенное логирование - Включение или выключение расширенного логирования при отправке уведомлений. - Да * - Логировать бинарные данные - Включение или выключение логирования бинарных данных при включенном расширенном логировании. - Да .. _DashboardSettingsClientMessages-Email: Настройки отправки уведомлений по электронной почте ---------------------------------------------------- Страница с настройками отправки уведомлений по электронной почте показана на рисунке. В левой части страницы содержатся общие настройки отправки уведомлений по электронной почте, а в правой - перечень сообщений, для которых настроена отправка уведомлений. .. image:: img/Dashboard_Settings_ClientMessages_Email.png :scale: 37 :align: center :alt: Настройки отправки уведомлений по электронной почте .. list-table:: Настройки отправки уведомлений по электронной почте :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Используется - Включение или выключение отправки уведомлений. - Да * - Включить расширенное логирование - Включение или выключение расширенного логирования при отправке уведомлений. - Да * - Логировать бинарные данные - Включение или выключение логирования бинарных данных при включенном расширенном логировании. - Да * - Отправитель сообщения - Адрес почтового ящика, с которого будут отправляться уведомления. - Да * - Префикс темы сообщения - Префикс, который будет добавлен к автоматически сформированной теме сообщения. - Да .. list-table:: Настройки подключения к SMTP-серверу :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Хост - Адрес хоста SMTP-сервера. - Да * - Порт - Номер порта SMTP-сервера. - Да * - Использовать SSL - Включение или выключение использования SSL при работе с SMTP-сервером. - Да * - Логин - Логин для подключения к SMTP-серверу. - Нет * - Пароль - Пароль для подключения к SMTP-серверу. - Нет Для добавления нового типа сообщения, для которого будет выполняться отправка уведомлений, нужно нажать на кнопку ``Добавить отправку сообщений`` и выбрать в выпадающем списке нужный тип сообщения. Для изменения - нажать на кнопку ``Изменить`` Для удаления - нажать на кнопку ``Удалить``. При добавлении или изменении настройки сообщения будет открыта страница, в левой части которой расположены настройки маршрутизации, а в правой - перечень фильтров. Подробнее о настройках фильтров для различных типов сообщений можно прочитать в разделе :ref:`Настройки фильтров `. Настройки маршрутизации при отправке по электронной почте ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ В левой части страницы с настройками отправки сообщения находятся настройки маршрутизации. .. image:: img/Dashboard_Settings_ClientMessages_Email_Routing.png :scale: 75 :align: center :alt: Настройки маршрутизации для отправки по электронной почте .. list-table:: Настройки маршрутизации сообщения :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Наименование - Наименование настроек отправки сообщения. - Да * - Получатели - Перечень получателей сообщения по электронной почте. При нажатии на кнопку ``Добавить`` добавляется новый получатель. При нажатии на кнопку ``Удалить``, запись удаляется. Кнопка ``Удалить`` доступна только при наличии двух и более получателей. - Да .. _DashboardSettingsClientMessages-Telegram: Настройки отправки уведомлений в Telegram ------------------------------------------- Страница с настройками отправки уведомлений в Telegram показана на рисунке. В левой части страницы содержатся общие настройки отправки уведомлений в Telegram, а в правой - перечень сообщений, для которых настроена отправка уведомлений. .. image:: img/Dashboard_Settings_ClientMessages_Telegram.png :scale: 37 :align: center :alt: Настройки отправки уведомлений в Telegram .. list-table:: Настройки отправки уведомлений в Telegram :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Используется - Включение или выключение отправки уведомлений. - Да * - Включить расширенное логирование - Включение или выключение расширенного логирования при отправке уведомлений. - Да * - Логировать бинарные данные - Включение или выключение логирования бинарных данных при включенном расширенном логировании. - Да * - Адрес подключения к API - Адрес подключения к API Telegram. - Да * - Настройки подключения к чатам - Перечень настроек подключения к чатам в Telegram. - Да При нажатии на кнопку ``Добавить`` или ``Изменить`` в настройках подключения к чатам откроется окно, в котором можно задать настройки чата. .. image:: img/Dashboard_Settings_ClientMessages_Telegram_Chat.png :align: center :alt: Настройки чатов Telegram .. list-table:: Настройки чата в Telegram :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Наименование чата - Наименование чата для его выбора в настройках маршрутизации. - Да * - Идентификатор чата - Идентификатор чата в Telegram. - Да * - Токен для доступа к API - Токен для доступа к API Telegram. - Да Для добавления нового типа сообщения, для которого будет выполняться отправка уведомлений, нужно нажать на кнопку ``Добавить отправку сообщений`` и выбрать в выпадающем списке нужный тип сообщения. Для изменения - нажать на кнопку ``Изменить`` Для удаления - нажать на кнопку ``Удалить``. При добавлении или изменении настройки сообщения будет открыта страница, в левой части которой расположены настройки маршрутизации, а в правой - перечень фильтров. Подробнее о настройках фильтров для различных типов сообщений можно прочитать в разделе :ref:`Настройки фильтров `. Настройки маршрутизации в Telegram ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ В левой части страницы с настройками отправки сообщения находятся настройки маршрутизации. .. image:: img/Dashboard_Settings_ClientMessages_Telegram_Routing.png :scale: 75 :align: center :alt: Настройки маршрутизации для отправки по электронной почте .. list-table:: Настройки маршрутизации сообщения :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Наименование - Наименование настроек отправки сообщения. - Да * - Чаты - Перечень чатов. При нажатии на кнопку ``Добавить`` открывается окно с выбором чата для добавления. Чаты выбираются из списка чатов, заполненного ранее. При нажатии на кнопку ``Удалить``, запись удаляется. Кнопка ``Удалить`` доступна только при наличии двух и более чатов. Кнопка ``Добавить`` становится недоступна, если добавлены все чаты из настроек. - Да .. _DashboardSettingsClientMessages-Rabbit: Настройки отправки уведомлений через RabbitMQ ----------------------------------------------- Страница с настройками отправки уведомлений через RabbitMQ показана на рисунке. .. image:: img/Dashboard_Settings_ClientMessages_Rabbit.png :scale: 50 :align: center :alt: Настройки отправки уведомлений через RabbitMQ .. list-table:: Настройки отправки уведомлений через RabbitMQ :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Используется - Включение или выключение отправки уведомлений. - Да * - Включить расширенное логирование - Включение или выключение расширенного логирования при отправке уведомлений. - Да * - Логировать бинарные данные - Включение или выключение логирования бинарных данных при включенном расширенном логировании. - Да * - Хост - Наименование хоста для подключения к RabbitMQ - Да * - Порт - Номер порта для подключения к RabbitMQ - Да * - Логин - Логин для подключения к RabbitMQ - Да * - Пароль - Пароль для подключения к RabbitMQ - Да * - Виртуальный хост - Виртуальный хост RabbitMQ - Да * - Наименование очереди - Наименование очереди, в которую будут добавляться сообщения. Очередь будет создана автоматически при первом подключении. - Да .. _DashboardSettingsClientMessages-Filters: Настройки фильтров --------------------- Набор настроек фильтров зависит от типа отправляемого сообщения. Доступные типы отправляемых сообщений: - :ref:`Изменение статуса задачи `; - :ref:`Создание контрагента `; - :ref:`Изменение статуса контрагента `; - :ref:`Создание документа `; - :ref:`Изменение тегов документа `; - :ref:`Изменение статуса документа `. Если фильтры не заданы, то все сообщения указанного типа будут отправлены получателям. Если задано несколько условий, то сообщение будет отправлено только в случае выполнения всех условий. .. _DashboardSettingsClientMessages-TaskStatusChanged: Изменение статуса задачи ~~~~~~~~~~~~~~~~~~~~~~~~~ На рисунке ниже показан пример фильтра для сообщений, отправляемых при изменении статуса задачи. В данном примере сообщения будут отправлены только для задач "Приемка" или "Отклонение" ящика "ООО_тест_тест650", статус которых поменялся на "Обработан". .. image:: img/Dashboard_Settings_ClientMessages_Filters_TaskStatusChanged.png :scale: 76 :align: center :alt: Фильтр сообщения об изменении статуса задачи .. list-table:: Настройки фильтра сообщения об изменении статуса задачи :widths: 20 40 :header-rows: 1 * - Название параметра - Описание * - Типы задач - Перечень типов задач. * - Ящики - Перечень наших ящиков. * - Новые статусы задач - Перечень новых статусов задач. .. _DashboardSettingsClientMessages-ContractorCreated: Создание контрагента ~~~~~~~~~~~~~~~~~~~~~ На рисунке ниже показан пример фильтра для сообщений, отправляемых при создании контрагента. В данном примере сообщения будут отправлены только для контрагентов, созданных у операторов "Калуга Астрал" и "Такском-Файлер". .. image:: img/Dashboard_Settings_ClientMessages_Filters_ContractorCreated.png :scale: 76 :align: center :alt: Фильтр сообщения о создании контрагента .. list-table:: Настройки фильтра сообщения о создании контаргента :widths: 20 40 :header-rows: 1 * - Название параметра - Описание * - Операторы ЭДО - Перечень операторов ЭДО. .. _DashboardSettingsClientMessages-ContractorStatusChanged: Изменение статуса контрагента ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ На рисунке ниже показан пример фильтра для сообщений, отправляемых при изменении статуса контрагента. В данном примере сообщения будут отправлены только при изменении статуса контрагента с ИНН/КПП 9664364629/999918276, созданного у оператора "Калуга Астрал". .. image:: img/Dashboard_Settings_ClientMessages_Filters_ContractorStatusChanged.png :scale: 76 :align: center :alt: Фильтр сообщения об изменении статуса контрагента .. list-table:: Настройки фильтра сообщения об изменении статуса контаргента :widths: 20 40 :header-rows: 1 * - Название параметра - Описание * - Операторы ЭДО - Перечень операторов ЭДО. * - Контрагенты - Перечень ИНН и КПП контрагентов. .. _DashboardSettingsClientMessages-DocumentCreated: Создание документа ~~~~~~~~~~~~~~~~~~~ На рисунке ниже показан пример фильтра для сообщений, отправляемых при создании документа. В данном примере сообщения будут отправлены только для входящих УПД СЧФ по 820-му приказу, созданных у оператора "Калуга Астрал" и отправленных контрагентом с ИНН/КПП 9664364629/999918276 в ящик "ООО_тест_тест650". .. image:: img/Dashboard_Settings_ClientMessages_Filters_DocumentCreated.png :scale: 76 :align: center :alt: Фильтр сообщения о создании документа .. list-table:: Настройки фильтра сообщения о создании документа :widths: 20 40 :header-rows: 1 * - Название параметра - Описание * - Операторы ЭДО - Перечень операторов ЭДО. * - Контрагенты - Перечень ИНН и КПП контрагентов. * - Ящики - Перечень наших ящиков, в разрезе которых был создан документ. * - Направление документа - Направление может принимать значения "Входящий", "Исходящий" или "Любой". * - Типы документов - Типы созданных документов. * - Теги документа - Теги созданных документов. .. _DashboardSettingsClientMessages-DocumentRetagged: Изменение тегов документа ~~~~~~~~~~~~~~~~~~~~~~~~~~~ На рисунке ниже показан пример фильтра для сообщений, отправляемых при изменении перечня тегов документа. В данном примере сообщения будут отправлены только для документов из ящика "ООО_тест_тест650" с новым тегом "Исправленный УПД". .. image:: img/Dashboard_Settings_ClientMessages_Filters_DocumentRetagged.png :scale: 76 :align: center :alt: Фильтр сообщения об изменении тегов документа .. list-table:: Настройки фильтра сообщения об изменении тегов документа :widths: 20 40 :header-rows: 1 * - Название параметра - Описание * - Операторы ЭДО - Перечень операторов ЭДО. * - Контрагенты - Перечень ИНН и КПП контрагентов. * - Ящики - Перечень наших ящиков, в разрезе которых был создан документ. * - Направление документа - Направление может принимать значения "Входящий", "Исходящий" или "Любой". * - Типы документов - Перечень типов документов. * - Теги документа - Перечнь новых тегов документов. .. _DashboardSettingsClientMessages-DocumentStatusChanged: Изменение статуса документа ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ На рисунке ниже показан пример фильтра для сообщений, отправляемых при изменении статуса документа. В данном примере сообщения будут отправлены только для документов из ящика "ООО_тест_тест650" с новыми статусами "Отправлен, ПФ" или "Получен, ПФ". .. image:: img/Dashboard_Settings_ClientMessages_Filters_DocumentStatusChanged.png :scale: 76 :align: center :alt: Фильтр сообщения об изменении статусов документа .. list-table:: Настройки фильтра сообщения об изменении статусов документа :widths: 20 40 :header-rows: 1 * - Название параметра - Описание * - Операторы ЭДО - Перечень операторов ЭДО. * - Контрагенты - Перечень ИНН и КПП контрагентов. * - Ящики - Перечень наших ящиков, в разрезе которых был создан документ. * - Направление документа - Направление может принимать значения "Входящий", "Исходящий" или "Любой". * - Типы документов - Перечень типов документов. * - Теги документа - Перечнь новых тегов документов. * - Новые статусы документа - Перечень новых статусов документа.