Карточки здоровья показателей
Здоровье показателя показывает, готов ли показатель к использованию в таблицах фактов и витринах. Для каждого показателя система ведёт карточку здоровья с результатами пяти автоматических проверок, а общий статус карточки отображается значком рядом с наименованием показателя на вкладке Показатели экрана РПИ и на других экранах, где используются показатели.
Карточка здоровья относится к показателю в конкретной версии проекта; у измерений и фактов карточек здоровья нет. Карточки заполняет только система: вручную они не редактируются и в экспорт РПИ не входят.
Проверки
| Проверка | Когда выполняется | Что проверяется | Результат при нарушении |
|---|---|---|---|
| Проверка наименования | Всегда | Допустимость наименования: наименование не короче 2 символов, пробелы в начале и конце не учитываются. Дубликаты по наименованию: наименование не совпадает с наименованием другого показателя, измерения или факта версии проекта без учёта регистра и лишних пробелов | Ошибка |
| Проверка формулы | Только для показателей со статусом Активный | Ошибки в формуле: формула записана без ошибок, в том числе не ссылается на элементы со статусом В архиве. Циклические зависимости: в полностью развёрнутой формуле нет циклических ссылок. Зависимости с ошибками: среди элементов, от которых показатель зависит на любом уровне, нет элементов с ошибкой в формуле или со статусом В архиве, а среди показателей — с общим статусом Ошибка. Предупреждения формулы ошибкой не считаются | Ошибка |
| Генерация SQL | Только для показателей со статусом Активный | SQL показателя формируется так же, как при проверке показателя, но без фильтров для проверки: для каждой таблицы фактов, в которую входит показатель, а если показатель не входит ни в одну таблицу фактов — как для общего показателя. Запрос к базе данных не выполняется | Ошибка с текстом ошибки генерации SQL |
| Возможные дубликаты | Всегда | Нет другого показателя, который рассчитывается по той же формуле (без учёта регистра функций, пробелов и внешних скобок) или имеет такую же полностью развёрнутую формулу — с подставленными формулами элементов, на которые она ссылается | Внимание со списком совпавших показателей |
| Неполное описание | Всегда | Заполнены колонки, описывающие показатель: Описание показателя (не короче 10 символов и не совпадает с наименованием показателя), Тип данных в отображении, Тип показателя, Формула (не пустая, без ошибок и предупреждений) и Статус | Внимание со списком колонок РПИ, заполненных некорректно |
Для показателей со статусом, отличным от Активный, проверки Проверка формулы и Генерация SQL получают статус Отключено.
Статусы
Каждая проверка получает один из статусов:
| Статус | Значок | Значение |
|---|---|---|
| В норме | Зелёный круг с галочкой | Проверка пройдена |
| Ошибка | Красный треугольник | Найдена проблема, из-за которой показатель нельзя добавить в таблицы фактов и витрины |
| Внимание | Оранжевый треугольник | Найдено замечание; использование показателя не ограничивается |
| Неизвестно | Знак вопроса | Проверка ещё не запускалась («Проверка не запускалась») или не была выполнена из-за внутреннего сбоя («Проверку не удалось выполнить») |
| Отключено | Значок паузы | Проверка не применяется к показателю («Проверка включается только для показателей со статусом Активный») |
Общий статус показателя определяется по статусам проверок в следующем порядке:
- Ошибка — если хотя бы одна проверка в статусе Ошибка
- Внимание — иначе, если хотя бы одна проверка в статусе Внимание
- Отключено — если отключены все проверки
- Неизвестно — иначе, если есть проверки в статусе Неизвестно или Отключено
- В норме — во всех остальных случаях
Когда выполняются проверки
Проверки выполняются автоматически, поэтому карточка здоровья следует за изменениями в РПИ:
| Событие | Что проверяется |
|---|---|
| Изменение данных РПИ: редактирование ячеек, вставка и удаление строк, изменения через публичный API | В фоне после сохранения: изменённые показатели и связанные с ними — показатели, ссылающиеся на них в формулах, а также показатели с тем же наименованием или той же формулой |
| Импорт РПИ из файла, импорт версии из Git | В фоне после импорта: все показатели версии проекта |
| Закрытие формы редактирования окна Детали из РПИ после сохранения показателя | Все проверки этого показателя |
| Перезапуск в карточке здоровья | Сразу: выбранная проверка или все проверки показателя; зависящие от него показатели проверяются в фоне |
| Ежедневный пересчёт по расписанию, по умолчанию ежедневно в 19:00 (UTC) | Все проверки всех показателей во всех версиях проектов |
Примечания:
- Проверки выполняются в порядке зависимостей, поэтому показатель учитывает уже обновлённый общий статус показателей, на которые ссылается его формула
- Пока фоновая проверка не завершена, карточка хранит результаты предыдущей проверки
- После проверки значки здоровья обновляются автоматически у всех пользователей, у которых открыт РПИ этой версии проекта
- Новые версии и копии проектов при создании не проверяются: их карточки остаются в статусе Неизвестно до ближайшего ежедневного пересчёта или до изменения данных
Значки здоровья
Значок здоровья показывает общий статус показателя. Он выводится:
- На вкладке Показатели экрана РПИ — после названия в ячейке Наименование показателя. Во время редактирования ячейки значок скрыт
- В окне Детали из РПИ — рядом с наименованием показателя
- В конструкторе формул — в панели элементов, рядом с названием редактируемого показателя и на блоках показателей на холсте
- На диаграммах происхождения показателя и анализа влияния
- В таблицах фактов — в панели выбора и на блоках показателей в разделе Конфигурация, а также в списке показателей в разделе Показатели
- В модели данных — на блоках показателей в разделе Конфигурация и в списке показателей в разделе Показатели
- В витринах — в панели выбора и на холсте
На вкладке Показатели значок здоровья заменяет прежний значок дубликата наименования: дубликаты по наименованию перечисляются в подсказке значка здоровья.
При наведении на значок отображается подсказка со сводкой здоровья:
| Часть подсказки | Содержание |
|---|---|
| Общий статус | Общий статус показателя |
| Проблемы | Проверки в статусе Ошибка и найденные ими замечания |
| Предупреждения | Проверки в статусе Внимание и найденные ими замечания |
| Нет данных | Названия проверок в статусе Неизвестно |
| Отключено | Названия проверок в статусе Отключено |
Замечания зависят от проверки: совпадающие элементы в виде «{Таблица}, строка N», элементы с ошибками, ошибка генерации SQL, возможные дубликаты показателя или колонки РПИ, заполненные некорректно.
Окно «Карточка здоровья показателя»
Окно Карточка здоровья показателя показывает полные результаты проверок и позволяет запустить их повторно.
Как открыть — кнопкой Посмотреть карточку здоровья:
- На панели управления таблицей на вкладке Показатели, когда выделена ровно одна строка показателя
- В окне Детали из РПИ показателя
Верхняя часть окна:
| Элемент | Описание |
|---|---|
| Наименование показателя | Наименование показателя |
| Текущий общий статус | Общий статус показателя |
| Последнее обновление статуса | Дата и время последнего обновления карточки |
| Перезапустить все проверки | Повторно выполняет все пять проверок показателя и обновляет карточку |
| Редактировать показатель | Открывает окно Детали из РПИ показателя в режиме редактирования. При закрытии окна после сохранения все проверки показателя выполняются повторно |
Таблица проверок. Таблица содержит восемь строк — пять проверок, разбитых на составляющие:
| Тип проверки | Название проверки |
|---|---|
| Проверка наименования | Допустимость наименования, Дубликаты по наименованию |
| Проверка формулы | Ошибки в формуле, Циклические зависимости, Зависимости с ошибками |
| Генерация SQL | Генерация SQL |
| Возможные дубликаты | Возможные дубликаты |
| Неполное описание | Неполное описание |
Колонки таблицы: #, Тип проверки, Название проверки, Последняя проверка, Результат последней проверки, Подробности и Действия. По каждой колонке с данными доступны сортировка и фильтрация.
- Строки одной проверки разделяют её время последней проверки и перезапуск
- Строка, по которой проверка ничего не нашла, получает результат В норме
- В колонке Подробности выводится найденная проблема, а для результатов Неизвестно и Отключено — причина, по которой проверка не выполнялась
- Найденные проверкой элементы РПИ отображаются метками, окрашенными по таблице РПИ (показатели, измерения, факты). Щелчок по метке открывает окно Детали из РПИ этого элемента
Действия строки:
| Действие | Описание |
|---|---|
| Перезапустить проверку | Повторно выполняет проверку, к которой относится строка; карточка обновляется после завершения проверки |
| Посмотреть описание проверки | Открывает описание проверки: что она делает, к чему может привести её нарушение и что делать в этом случае, с таблицей Особенность работы проверки / Детали |
Если карточку не удалось загрузить, в окне выводится сообщение «Не удалось загрузить карточку здоровья показателя»; при ошибке перезапуска — «Не удалось перезапустить проверку».
Ограничение для показателей со статусом «Ошибка»
Показатель с общим статусом Ошибка нельзя добавить в таблицу фактов и в витрину:
- В панелях выбора такой показатель выбрать нельзя, подсказка сообщает: «Показатель в статусе «Ошибка» нельзя добавить»
- Если такие показатели всё же оказываются среди сохраняемых изменений, сохранение отклоняется с сообщением «Показатели в статусе «Ошибка» нельзя добавить: {names}» со списком показателей
- Показатели, уже входящие в таблицу фактов или витрину, остаются в них и могут быть удалены
- Перенос показателя витрины в другую таблицу фактов или в блок общих показателей считается добавлением
- Если витрина содержит показатели в статусе Ошибка, создать или обновить её представление в базе данных нельзя: выводится сообщение «В витрине есть показатели в статусе «Ошибка»»
Ограничение использует последний сохранённый результат проверок: пока карточка ожидает фоновой проверки, действует её предыдущий общий статус. Статус Внимание использование показателя не ограничивает.
Роли
Просмотр карточек здоровья, значков и подсказок, а также перезапуск проверок доступны всем ролям, включая Наблюдателя, и не требуют действующей лицензии. Кнопка Редактировать показатель доступна роли Разработчик и выше при действующей лицензии.