NotificationService

Обновлено: 13.03.2026

Для отправки уведомлений из динамического кода используется сервис уведомлений, доступный через контекст:

var notificationService = context.GetNotificationService();

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

SendCustomNotificationAsyncSendCustomNotificationAsync

Task SendCustomNotificationAsync(
    Guid userId,
    string message,
    string subject = null,
    EntityInfo entityInfo = null
)

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

Уведомление отправляется через внутреннюю очередь событий системы и отображается в интерфейсе пользователя.

ПараметрыПараметры

• userId — идентификатор пользователя, которому будет отправлено уведомление;
• message — текст уведомления;
• subject (необязательный) — заголовок уведомления;
• entityInfo (необязательный) — информация о сущности, связанной с уведомлением. Используется для перехода пользователя к соответствующей записи в системе.

EntityInfoEntityInfo

public record EntityInfo(string EntityType, Guid EntityId);

Описание сущности, связанной с уведомлением.

Параметры:

• EntityType — тип сущности;
• EntityId — идентификатор сущности.

Если EntityInfo передан, уведомление будет связано с соответствующей сущностью.

ПримерПример

Пример отправки уведомления пользователю:

var notificationService = context.GetNotificationService();

await notificationService.SendCustomNotificationAsync(
    userId,
    "Проект был обновлён",
    "Обновление проекта"
);

Пример с привязкой к сущностиПример с привязкой к сущности

var notificationService = context.GetNotificationService();

await notificationService.SendCustomNotificationAsync(
    userId,
    "Проект был обновлён",
    "Обновление проекта",
    new EntityInfo("Project", project.Id)
);

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

ОсобенностиОсобенности

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

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