From 771ad8b3780352d25c28e3a562197c8b41d09611 Mon Sep 17 00:00:00 2001 From: "pavel.korolkov" Date: Wed, 26 Aug 2026 13:48:49 +0500 Subject: [PATCH] docs: Add new entity property history widget documentations --- .../widgets/entities/property-history.ru.md | 36 +++++++++++++++++++ .../documentation/release-notes/v1.7.0.ru.md | 6 +++- 2 files changed, 41 insertions(+), 1 deletion(-) create mode 100644 content/documentation/admin/widgets/entities/property-history.ru.md diff --git a/content/documentation/admin/widgets/entities/property-history.ru.md b/content/documentation/admin/widgets/entities/property-history.ru.md new file mode 100644 index 00000000..37466e89 --- /dev/null +++ b/content/documentation/admin/widgets/entities/property-history.ru.md @@ -0,0 +1,36 @@ +--- +title: История свойств +description: График изменений свойств сущности за выбранный период. +weight: 60 +--- + +Виджет строит график изменений свойств сущности за выбранный период. +Период выбирается в заголовке виджета. + +## Отображаемые данные + +- «График» — числовые свойства отображаются линией значений, флаги — по оси со значениями «Нет» и «Да». +- «Точка на графике» — изменение свойства. В подсказке отображаются значение, источник изменения и автор. +- «Легенда» — отображается, если на графике больше одного свойства. +- «Граница хранения» — вертикальная отметка на графике, левее которой изменения уже удалены. + +## Конфигурация + +| Название | Обязательность | Описание | Значение по умолчанию | +| --------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | +| Ресурс | нет | Ресурс, из схемы которого выбираются свойства. Если ресурс не указан, свойства задаются идентификаторами, а график строится по ресурсу текущей сущности | — | +| Свойства | **да** | Свойства, изменения которых показывает график. Поддерживаются типы `Number`, `Percentage` и `Boolean`. Несколько свойств — только одного типа | — | +| Интервал по умолчанию | нет | Период, за который виджет строит график при открытии | Последние 30 дней | +| Пороговое значение | нет | Горизонтальная линия на графике, рисуется только для числовых свойств | — | +| Минимум оси | нет | Нижняя граница оси значений | По данным | +| Максимум оси | нет | Верхняя граница оси значений | По данным | + +## Особенности + +История изменений свойств ведётся только при подключённом ClickHouse. Если хранилище не настроено, виджет сообщает, что история свойств не ведётся. + +Срок хранения истории ограничен. Если выбранный период целиком старше срока хранения, виджет сообщает, что изменения за него уже удалены. + +Если за выбранный период изменений больше, чем помещается на график, виджет показывает предупреждение и называет свойства, часть изменений которых не показана. Уменьшите период или оставьте на графике меньше свойств. + +Если в числовое свойство записано нечисловое значение, например текст, показать его на оси невозможно. В этом месте линия прерывается и продолжается со следующего числового значения, а само значение видно в подсказке. diff --git a/content/documentation/release-notes/v1.7.0.ru.md b/content/documentation/release-notes/v1.7.0.ru.md index 02ff14c3..09fd81c4 100644 --- a/content/documentation/release-notes/v1.7.0.ru.md +++ b/content/documentation/release-notes/v1.7.0.ru.md @@ -1,7 +1,7 @@ --- title: v1.7.0 weight: 890 -description: Заметки о выпуске v1.7.0 — автоматическое удаление сущностей и связей сущностей после успешного выполнения действия. +description: Заметки о выпуске v1.7.0 — автоматическое удаление сущностей и связей сущностей после успешного выполнения действия, виджет «История свойств». --- {{< alert level="info" >}} @@ -14,3 +14,7 @@ description: Заметки о выпуске v1.7.0 — автоматичес - Добавлен механизм автоматического [удаления сущностей](../../admin/actions/overview/#удаление-сущностей) после успешного выполнения действия. - Добавлен механизм автоматического [удаления связей сущности](../../admin/actions/overview/#удаление-связей-сущности) после успешного выполнения действия. + +### Виджеты + +Добавлен виджет [«История свойств»](../../admin/widgets/entities/property-history/), который строит график изменений свойств сущности за выбранный период.