Показатели в таблицах фактов

В разделе "Показатели" отображаются все показатели (базовые и расчетные), связанные с текущей таблицей фактов — как выбранные в «Конфигурации», так и добавленные через этот раздел. Этот раздел также предоставляет функции для создания новых показателей, редактирования существующих и их проверки.

Список показателей

Для каждого показателя отображается информация из РПИ:

• Блок
• Название
• Описание
• Тип данных
• Ограничения
• Формула
• Комментарий
• Действия для каждого показателя:
  • Проверить — запускает процесс проверки показателя
  • Посмотреть происхождение — показывает зависимости для показателя
  • Редактировать — открывает диалог редактирования показателя
  • Убрать — удаляет показатель из таблицы фактов (но не из РПИ)

Добавление нового показателя

Кнопка «Добавить показатель» открывает диалог для создания нового показателя. Новый показатель будет сохранен одновременно в текущую таблицу фактов и в РПИ текущей версии проекта.

Необходимая информация:

Поле	Требования
Название	Обязательно. Должно быть уникальным среди всех существующих показателей и измерений в соответствующей версии РПИ. Требования совпадают с требованиями к столбцу Название показателя в РПИ.
Формула	Обязательно. Вводится текстом в редакторе формул (как в РПИ).

Дополнительная информация (необязательно):

• Блок
• Описание
• Тип данных
• Ограничения
• Комментарий

Особенности интерфейса:

• Необязательные поля по умолчанию скрыты
• Вы можете показать/скрыть эти поля при необходимости
• Поля ввода соответствуют типам полей соответствующих столбцов в РПИ

Процесс сохранения:

• Изменения в диалоге НЕ сохраняются автоматически.

• Нажмите «Сохранить», чтобы добавить показатель. После сохранения:

  1. Показатель добавляется в таблицу показателей в РПИ в текущей версии проекта
  2. Сохраненный показатель и все его зависимости (из формулы) автоматически добавляются в конфигурацию таблицы фактов
  3. Показатель немедленно появляется в списке для всех пользователей, открывающих раздел «Показатели»
  4. Вы возвращаетесь в раздел «Показатели»

• При попытке выйти из диалога (например, переключившись на другой экран) появится системное предупреждение с вопросом о сохранении.

• Вы можете выйти из диалога без сохранения в любой момент; дополнительного подтверждения не требуется.

Редактирование существующего показателя

Действие «Редактировать» открывает диалог, предварительно заполненный текущими данными показателя. Он функционирует идентично диалогу «Добавить показатель».

Правила редактирования:

• Вы можете редактировать любое поле, показанное в диалоге (Название, Блок, Описание и т.д.)
• Требования к каждому полю совпадают с требованиями при добавлении показателя
• Поля, которые существуют в РПИ, но не отображаются в диалоге (например, тип показателя), нельзя изменить здесь
• Если изменяется Формула, конфигурация таблицы фактов автоматически перестраивается для отражения новых зависимостей

Сохранение изменений:

• Нажмите «Сохранить», чтобы применить изменения. Перед сохранением появится предупреждение о подтверждении, сообщающее, что изменение затронет всех пользователей и элементы проекта, использующие этот показатель
• После сохранения:
  1. Изменения применяются в разделе «Конфигурация» таблицы фактов (связи обновляются, если изменилась формула)
  2. Соответствующие поля обновляются в РПИ
• Вы можете выйти из диалога редактирования без сохранения в любой момент; дополнительного подтверждения не требуется

Проверка показателей

Действие «Проверить» позволяет выполнить двухэтапную проверку любого показателя из списка. Это помогает убедиться в корректности формулы и получить реальные данные из подключенных баз данных.

Процесс проверки состоит из 2 шагов:

Шаг 1: Генерация SQL-скрипта

Система автоматически создает SQL SELECT-запрос на основе формулы показателя из РПИ.

Что происходит на этом шаге:

• SQL-код генерируется из формулы согласно правилам трансляции, определенным в описании языка формул.
• Код генерируется для той СУБД, которая выбрана в настройках подключения, используемого для таблицы фактов
• Созданный SQL-код отображается в читаемом формате (с правильными отступами и переносами строк, аналогично форматерам SQL)
• Доступны опции:
  • Копировать SQL-код в буфер обмена
  • Экспортировать SQL-код в текстовый файл

Шаг 2: Выполнение SQL-скрипта

Система предоставляет возможность выполнить сгенерированный SQL SELECT-запрос на подключенных базах данных.

Что можно сделать на этом шаге:

• Просмотреть результаты выполнения скрипта
• В зависимости от формулы, результат может быть:
  • Единым агрегированным значением (например, сумма, среднее)
  • Столбцом с отдельными результатами для разных записей данных
• Для неагрегированных расчетов с множеством результатов система показывает таблицу, содержащую:
  • Столбец с результатами расчета
  • Столбцы со значениями полей, использованных в скрипте
• Экспортировать результаты выполнения в формате CSV

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

Если система не может сгенерировать или выполнить SQL-скрипт для показателя, появляется уведомление с объяснением:

• Что пошло не так (например, синтаксическая ошибка в формуле, отсутствие подключения к БД, несуществующее поле)
• Как исправить проблему (если это возможно)

Просмотр происхождения показателя (Lineage)

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

Что показывает диаграмма происхождения:

1. Иерархия зависимостей: Показатель отображается на верхнем уровне. Ниже — все элементы, используемые в его формуле. Если эти элементы сами являются показателями, то отображаются их зависимости, и так вглубь до базовых элементов.
2. Базовый слой: Внизу отображаются конечные факты и измерения, а также таблицы и поля БД, к которых они привязаны
3. Полная картина: Диаграмма объединяет в себе информацию из логические связи и физические подключения к БД из «Конфигурации» таблицы фактов

Возможности в режиме просмотра происхождения:

• Навигация: Масштабирование и перемещение по диаграмме.
• Просмотр свойств: Нажмите на любой элемент (показатель, факт, измерение), чтобы увидеть его детали из РПИ
• Быстрое редактирование:
  • Можно редактировать сам показатель, открыв его диалог прямо отсюда
  • Можно изменять подключения к БД для фактов и измерений как при конфигурации таблицы фактов
• Автообновление: После сохранения внесенных изменений диаграмма происхождения автоматически обновляется