параметры: введение ¶
Журнал импортов¶
История импорта данных в параметры
Измерения ¶
Набор измерений, на которых "строятся" параметры (например, Товар, Клиент, Неделя и т.д.)
Различные параметры могут использовать одно и то же измерение
(например, и План продаж, и Текущие запасы содержат измерение Товар)
| Поле | Название | Описание | Обязательное |
|---|---|---|---|
| id | id | Уникальный идентификатор в базе (заполняется автоматиески) | |
| shortname | Имя | Отображение для пользователя | Да |
| description | Описание | Текстовое описание | |
| key | Ключ | Уникальный идентификатор для разработчика, определяется при создании, не рекоменудется изменять в процессе работы | Да |
| hierarchy_level | Уровень | Уровень иерархии, на котором задано измерение (может принимать значения из его элементов) | Да |
| null_allowed | Допускается пустое значение |
Меры ¶
Набор мер, которые используются в параметрах (например, План продаж.Кол-во, План продаж.Сумма, Текущие запысы.Кол-во и т.д.)
Каждая мера может использоваться только в одном параметре.
В одном параметре может использоваться несколько мер.
Подробнее: Для создания сложных метрик, рассчитываемых автоматически, см. Пользовательские меры (SQL и агрегация).
Параметры¶
Обзор¶
Мета-данные, объединяющие информацию об измерениях и мерах (например, План продаж, Текущие запасы).
После создания параметра или его изменения необходимо выполнить действие синхронизации:
выбрать параметры в списке параметров, в выпадающем списке "Действие" выбрать "Синхронизировать параметры" и нажать кнопку "Выполнить".
В результате синхронизации будут созданы или обновлены таблицы, соответствующие параметрам.
Подробнее о синхронизации: См. Синхронизация параметров — полное описание процесса синхронизации и потенциальных проблем.
| Поле | Название | Описание | Обязательное |
|---|---|---|---|
| id | id | Уникальный идентификатор в базе (заполняется автоматиески) | |
| shortname | Имя | Отображение для пользователя | Да |
| description | Описание | Текстовое описание | |
| key | Ключ | Уникальный идентификатор для разработчика, определяется при создании, не рекоменудется изменять в процессе работы | Да |
| app_name | Имя приложения | Имя приложения, к которому относится параметр, служит для разделения параметров | |
| is_backup | Является архивом | Показывает, что параметр содержит "архив" данных (версии). Заполняется автоматически при создании такого параметра. | |
| has_backup | Поддерживает архивирование | Показывает, что параметр поддерживает создание архивов. Устанавливается пользователем. |
Права на просмотр и редактирование¶
Для каждого параметра автоматически создаются права на просмотр (can_view) и редактирование (can_edit).
Права на просмотр и редактирование могут быть выданы группе пользователей
В группах могут быть заданы "области видимости"
Внимание! Механизмы хранения истории изменений через "ревизии" и "корректировки" больше не используются. История изменений теперь доступна только через кнопки "История ревизий" и "История корректировок" в дашборде. Описанные ниже механизмы считаются устаревшими и приведены только для справки.
Ревизии¶
При каждом изменении данных система автоматически создаёт "ревизию", которая хранит информацию о том кто и когда менял данные.
Изменения внутри системы привязаны к ревизиям, что позволяет отслеживать всю историю изменений.
Настройка ревизий¶
Для включения механизма ревизий для параметра необходимо:
- Открыть параметр в панели администратора
- В разделе "История изменений" установить галочку "Отслеживать ревизии"
- Сохранить параметр
Важно: Если пользователь не видит историю ревизий, проверьте права на просмотр параметра и настройки параметра.
Права на просмотр истории ревизий:
- Для просмотра истории ревизий пользователю необходимо право view_revision_history (Может просматривать историю ревизий).
- Права можно выдать через группы пользователей или индивидуально.
После включения ревизий система будет автоматически: - Создавать новую ревизию при каждом изменении данных - Сохранять информацию о том, кто и когда внес изменения - Позволять просматривать историю изменений
Просмотр истории ревизий¶
Для просмотра истории ревизий пользователю необходимо глобальное право view_revision_history (Может просматривать историю ревизий). Это право выдаётся на уровне всей системы и даёт доступ ко всем параметрам, поддерживающим ревизии.
Историю ревизий можно просмотреть: 1. В панели администратора в разделе "Ревизии" 2. В дашборде по кнопке "История ревизий" (см. Параметры для пользователей — История ревизий)
Корректировки¶
Корректировки — это механизм для отслеживания конкретных изменений значений с детальной информацией о том, что именно изменилось.
Настройка корректировок¶
Для включения механизма корректировок для параметра необходимо:
- Открыть параметр в панели администратора
- В разделе "История изменений" установить галочку "Отслеживать корректировки"
- Сохранить параметр
Важно: Если пользователь не видит историю корректировок, проверьте права на просмотр параметра и настройки параметра.
Права на просмотр истории корректировок:
- Для просмотра истории корректировок пользователю необходимо право view_corrections_history (Может просматривать историю корректировок).
- Права можно выдать через группы пользователей или индивидуально.
После включения корректировок система будет автоматически: - Сохранять информацию о каждом изменении значения - Записывать старое и новое значение - Сохранять информацию о том, кто и когда внес изменения - Сохранять информацию о методе корректировки
Просмотр истории корректировок¶
Для просмотра истории корректировок пользователю необходимо глобальное право view_corrections_history (Может просматривать историю корректировок). Это право выдаётся на уровне всей системы и даёт доступ ко всем параметрам, поддерживающим корректировки.
Историю корректировок можно просмотреть: 1. В панели администратора в разделе "Ревизии" 2. В дашборде по кнопке "История корректировок" (см. Параметры для пользователей — История корректировок)
Особенности отчёта об истории корректировок¶
- Скачиваемый Excel‑файл содержит агрегированную карточку корректировки и ссылку на детализацию.
- Для перехода к детальному отчёту нажмите на ссылку в колонке «Ячейки» соответствующей строки.
- В детализации отображается поле «Примененный фильтр» — человекочитаемое представление фильтра, применённого при внесении изменений.
- Фильтр формируется динамически из
filter_data(JSON) методом /src/planiqum/core/filters/libs/filter.py: Filter.get_multistring; хранить отформатированную строку в БД не требуется.