Факты
Вкладка Факты экрана РПИ содержит каталог фактов — подсчитываемых значений, на основе которых рассчитываются показатели. Каждая строка таблицы — один факт. Вкладка редактируется как таблица — см. страницу Работа с таблицами РПИ.
Типы фактов
| Тип факта | Описание | Как задаются значения |
|---|---|---|
| Первичный | Факт напрямую соответствует колонке таблицы фактов в базе данных | Подключенный источник — колонка базы данных, из которой берутся значения |
| Производный | Факт рассчитывается на основе других фактов | Формула |
| Константа | Для факта используется фиксированное значение | Формула |
Два способа задания значений исключают друг друга: для первичного факта формула не используется, для производного и константного не используется подключённый источник.
Формула производного и константного факта не должна быть агрегированным вычислением — агрегация относится к показателям. Синтаксис формул описан на странице Синтаксис формул.
Колонки в РПИ таблице с фактами
| Название колонки | Описание колонки | Тип колонки | Обязательная колонка |
|---|---|---|---|
| Группировка | Текстовое поле для указания группы, к которой относится факт (например, "Финансы", "Маркетинг", "Продажи" и т.д.) | Текст | Нет |
| Блок | Текстовое поле для группировки фактов по функциональным блокам внутри группы (например, "Расходы", "Доходы", "KPI" и т.д.) | Текст | Нет |
| Наименование факта | Текстовое поле для понятного бизнес-пользователям названия факта | Текст | Да |
| Описание факта | Текстовое поле для короткого описания смысла факта | Текст | Нет |
| Тип исходного источника | Текстовое поле для ввода типа системы-источника данных (например, "База данных", "CRM", "ERP", "API", "Файл") | Текст | Нет |
| Исходный источник | Текстовое поле для указания конкретного экземпляра источника данных (например, "PostgreSQL Prod", "Microsoft Dynamics 365") | Текст | Нет |
| Исходный объект | Текстовое поле для указания имени объекта в системе-источнике (например, имя таблицы и поля или имя API-метода и параметра) | Текст | Нет |
| Тип данных в источнике | Автоматически заполняемое поле с типом данных, полученным из источника данных для поля в колонке Подключенный источник (например, "text", "int4", "uuid", "numeric(15, 3)" и т.д.) | Текст | Да |
| Тип факта | Выпадающий список для выбора типа факта, который указывает на то, требуются ли для факта дополнительные преобразования ("Первичный" - факт напрямую соответствует конкретному полю в БД; "Производный" - факт рассчитывается на основе других первичных фактов; "Константа" - для факта используется указанное фиксированное значение) | Выбор | Да |
| Формула | Текстовое поле для ввода формулы расчета (актуально для фактов типа производный или константа) | Формула | Да |
| Подключенный источник | Выпадающий список для выбора конкретного поля (колонки) в базе данных, откуда непосредственно берутся значения для данного факта (актуально для фактов первичного типа) | Выбор из БД | Да |
| Отчет для проверки | Ссылка или название отчёта, который используется для проверки качества и корректности данных | Текст | Да |
| Комментарий | Текстовое поле для ввода дополнительных комментариев и примечаний по особенностям использования факта | Текст | Да |
| Статус | Выпадающий список для выбора статуса факта (например, "В разработке", "Активный", "В архиве" и т.д.) | Выбор | Нет |
| Актуальность | Чекбокс для указания актуальности факта | Флаг/чекбокс | Нет |
| Обязательный | Чекбокс для отметки обязательности факта | Флаг/чекбокс | Нет |
| Видимость | Чекбокс для указания того, должны ли отображаться значения факта в готовых отчётах | Флаг/чекбокс | Нет |
| Ответственный за данные | Текстовое поле для указания роли, сотрудника или подразделения, отвечающего за предоставление, качество и актуальность данных факта | Текст | Нет |
Примечания:
- Наименование факта идентифицирует строку и должно быть уникальным в рамках версии проекта. При переименовании факта автоматически обновляются все формулы, таблицы фактов и витрины, которые на него ссылаются
- Обязательные колонки нельзя скрыть, а незаполненная обязательная ячейка выделяется красной рамкой
- Значок предупреждения в ячейке колонки Тип факта означает, что описание неполное: у первичного факта не указан подключённый источник либо у производного или константного не заполнена формула
- Тот же набор колонок отображается для одного факта в окне Детали из РПИ, где его также можно отредактировать