feat: ctx.users.recalcFieldAverage + документация автопересчёта среднего history-number

This commit is contained in:
2026-09-04 20:14:51 +03:00
parent 6aececeb4a
commit ba723aa0b7
3 changed files with 15 additions and 4 deletions

View File

@@ -83,8 +83,12 @@ const CODE_TEMPLATE = `// ======================================================
// ctx.users.updateStatus(id, statusId) — сменить статус пользователя
// ctx.users.setFieldValue(id, fieldCodeOrId, value) — записать значение кастомного поля профиля
// пользователя (по id или code поля, с аудитом от имени «Автоматизация»). Для полей типа
// «history-number» значение дополнительно добавляется в историю user_field_history
// (с привязкой к задаче триггера); нечисловое значение вызовет ошибку автоматизации.
// «history-number» переданное число добавляется в историю user_field_history
// (с привязкой к задаче триггера), а значением поля становится среднее за текущий месяц
// (автопересчёт); нечисловое значение вызовет ошибку автоматизации.
// ctx.users.recalcFieldAverage(id, fieldCodeOrId) — принудительный пересчёт среднего
// за текущий месяц для history-number поля (например, ежедневно по schedule;
// нет записей в месяце — поле очищается).
//
// Триггеры:
// manual — запуск вручную
@@ -319,8 +323,11 @@ export function AutomationsContent() {
ctx.users.list() / ctx.users.get(userId)
ctx.users.update(userId, updates) / ctx.users.updateStatus(userId, statusId)
ctx.users.setFieldValue(userId, fieldCodeOrId, value) — записать кастомное поле профиля
(с аудитом; для полей «history-number» значение также пишется в историю user_field_history,
(с аудитом; для полей «history-number» число пишется в историю user_field_history,
а значением поля становится среднее за текущий месяц — автопересчёт;
нечисловое значение — ошибка автоматизации)
ctx.users.recalcFieldAverage(userId, fieldCodeOrId) — принудительный пересчёт среднего
за текущий месяц для history-number поля (нет записей в месяце — поле очищается)
Логирование: ctx.log(msg)