Перейти к содержанию

Справочники

Справочник создает виртуальное представление/объединение ресурсов (физических таблиц) и рассчитывает уникальные записи справочника для использования их в качестве фильтров при запросе бизнес-пользователя.

Справочник из нескольких ресурсов

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

Общие настройки

  • Название справочника
  • Частота обновления - настраивайте, как часто будут пересчитываться записи справочника.
  • Признак - привяжите признак из словаря бота, чтобы обращаться к этому справочнику в запросах.

Колонки

Связывайте колонки различных типов:

  • Главный ключ - pk-колонка для определения уникальной записи справочника. Их может быть несколько, если ключ справочника составной (из нескольких колонок).
  • Основной текст - колонка, содержащая основной текст, который будет рассчитан в качестве значения записи. Может быть только одна.
  • Ссылка на справочник - fk-колонка, которая может быть использована для связи с другими справочниками. Может быть любое количество.

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

Записи

Каждая запись может быть использована в качестве фильтра в запросе бизнес-пользователя.

Пример

Создан справочник Регион. В этом справочнике рассчитаны записи, так как были созданы главный ключ и основной текст.

Одна из записей имеет текст "Рязань".

Бизнес-пользователь в своем запросе может написать "Покажи мне выручку по Рязани". Easy Report найдет связь с записью в справочнике и отфильтрует отчет только по этому региону.

Tip

Вы можете наложить произвольное количество паттернов поиска на любую из записей.

Связи со справочниками

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

  • Выбрать целевой справочник
  • Описать связь текущего справочника с целевым, создавая пары колонок:
    • Колонка типа главный ключ из целевого справочника
    • Колонка типа ссылка на справочник из текущего справочника

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

При SQL-генерации справочники будут связываться с помощью конструкции INNER JOIN.

Типы справочников

Справочники играют ключевую роль в фильтрации данных в системе, позволяя группировать и агрегировать информацию по заранее определённым наборам значений. В зависимости от характера данных и требований к фильтрации, в системе могут использоваться следующие типы справочников:

1. Пользовательский справочник

Описание:
Пользовательский справочник предназначен для работы с данными, представленными в виде текстовых значений. Он оптимизирован для случаев, когда необходимо учитывать вариативность ввода со стороны пользователя — опечатки, неполные совпадения или различные варианты написания.

Ключевые особенности:

  • Гибкий поиск: При вводе пользователем части названия или с ошибками, система ищет наиболее похожие совпадения. Это позволяет обеспечить удобство использования и повысить вероятность успешного фильтрования даже при неидеальном вводе.
  • Вывод всех значений: Если ни одно из значений не соответствует введенному пользователем запросу, система может вывести все записи справочника, что позволяет избежать пустых отчетов.

Примеры использования:

  • Регион или город: Если справочник содержит список регионов (например, "Рязань", "Москва", "Тверь"), то запрос вида "Покажи выручку по Рязани" автоматически сопоставляет введённое значение с наиболее похожей записью, даже если пользователь ввёл "Рязань".
  • Список продуктов: В справочнике с названиями товаров можно использовать частичный поиск для нахождения нужного продукта, например, по запросу "айфон" система покажет все записи, содержащие "iPhone", даже если написание может варьироваться.

2. Справочник статей показателей

Описание:
Этот тип справочника используется, когда детализирующие значения хранятся в отдельных строках таблицы, что характерно для представления показателей в аналитических моделях. Он помогает разбивать агрегированные данные на более мелкие категории, такие как виды затрат или виды доходов.

Ключевые особенности:

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

Примеры использования:

  • Финансовые отчеты: В таблице фактических данных значения могут быть разбиты по колонке "Статья", где каждая запись отражает определённую категорию расходов или доходов (например, "Аренда", "Зарплата", "Материалы"). При формировании отчета система автоматически фильтрует данные согласно выбранной статье.
  • Отчеты по продажам: Если данные детализированы по видам товаров или услуг, справочник позволяет выбрать конкретную статью для анализа, что упрощает выделение ключевых сегментов.

3. Числовой справочник

Описание:
Числовой справочник применяется для работы с данными числового типа, где критически важно точное совпадение значений. В отличие от пользовательского справочника, здесь не предусмотрена гибкая логика поиска по неточным совпадениям, что обеспечивает высокую точность фильтрации.

Ключевые особенности:

  • Строгое соответствие: Система ищет полное и точное совпадение введённого числового значения. Если пользователь укажет число, которое не совпадает с ни одной записью справочника, результатом будет пустой отчет.
  • Предсказуемость результатов: Такой подход позволяет избежать ошибок, когда нет необходимости интерпретировать или исправлять вводимые данные. Пользователь всегда получает данные, соответствующие строго заданным параметрам.

Примеры использования:

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

Сравнение и выбор типа справочника

  • Пользовательский справочник рекомендуется использовать там, где данные вводятся в свободной форме и возможны варианты написания. Он обеспечивает гибкость и удобство для конечного пользователя.
  • Справочник статей показателей целесообразен в аналитических моделях, где данные разбиты по категориям и требуется детальная разбивка показателей.
  • Числовой справочник подходит для работы с данными, где требуется строгая проверка на точное соответствие. Это важно для корректности аналитики, когда любые расхождения могут привести к неверной интерпретации результатов.