Дополнительные роли жизненного цикла и воркфлоу

Обновлено: 29.10.2025

Компонента «Роли жизненного цикла и воркфлоу» расширяет стандартную модель ролей жизненного цикла системы и позволяет создавать дополнительные (кастомные) роли, которые можно использовать в различных функциях платформы.

Компонента доступна в области Настройка — https://app.timetta-test.com/settings/lifecycle-roles.

Области применения ролейОбласти применения ролей

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

• права на переход жизненного цикла;
• право на инициацию воркфлоу;
• в функциях воркфлоу типа «Задание» и «Уведомление».

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

1. Роль по дополнительному полю. Можно добавить в сущность (например, задачу) дополнительное поле типа Пользователь с именем «Заказчик» и на его основе создать роль. Она будет автоматически определять исполнителя, связанного с этим полем.

2. Роль по связанным данным. Для проекта можно создать роль «Аналитики команды». Она будет автоматически включать всех пользователей, относящихся к роли Аналитик в составе команды проекта. Это позволяет динамически формировать состав участников на основании связанных сущностей.

Пример реализации обработчика ролиПример реализации обработчика роли

Для реализации пользовательской роли используется интерфейс ILifecycleRoleResolver<T>, где T — тип сущности, для которой определяется роль.

Ниже приведён пример обработчика роли для проекта:

/// <summary>
/// Определяет участников роли для указанного проекта.
/// </summary>
/// <param name="context">Контекст жизненного цикла.</param>
/// <param name="entity">Сущность проекта.</param>
/// <returns>Список идентификаторов пользователей, входящих в роль.</returns>
public class ProjectLifecycleRoleResolver : ILifecycleRoleResolver<Project>
{
    public async Task<List<Guid>> ResolveRole(LifecycleRoleContext context, Project entity)
    {
        return [entity.UserValue1Id ?? Guid.Empty];
    }
}

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