Импорт данных в параметры¶

Импорт данных позволяет быстро загрузить или обновить значения показателей (фактов) для выбранных параметров. Поддерживаются форматы CSV и Excel (XLSX).

Ожидаемый формат файлов¶

Формат: CSV или XLSX
Структура:
Первая строка — заголовки столбцов.
Столбцы должны соответствовать ключам измерений и мер параметра (например: activity, dpu, horizon__tech_week, value).
Для идентификации используются коды (shortname) иерархических элементов, а не внутренние id.

activity,dpu,horizon__tech_week,value
BASE,DPU1,2024-01-W01,100
BASE,DPU2,2024-01-W01,200

Как запустить импорт¶

Через пользовательский интерфейс (UI):
В разделе "Параметры" выберите нужный параметр.
Используйте функцию "Импорт данных" (кнопка или меню).
Загрузите файл, следуя подсказкам интерфейса.
Через консоль (Django shell):

from planiqum.core.parameters.libs.import_data import import_data
import_data(data="путь_к_файлу.csv", parameter="ключ_параметра")

Поддерживаются оба формата: CSV и XLSX.

Обработка ошибок¶

При импорте автоматически проверяется корректность структуры файла, наличие всех необходимых столбцов, сопоставление кодов иерархии.
Ошибки (например, нераспознанные коды, неверный формат данных) фиксируются и отображаются в журнале импортов.
В случае ошибок часть данных может быть импортирована, а часть — отклонена.

Где смотреть результаты и ошибки¶

Журнал импортов — история всех операций импорта данных в параметры.

В административной панели Django: Раздел "Параметры" → "Журнал импортов".
В журнале фиксируются:
Импортированные и отклонённые строки
Ошибки и предупреждения
Время и пользователь, выполнивший импорт

Подробнее для разработчиков¶

Для технических деталей и программного импорта см. статью для разработчика.