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

Справочники

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

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

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

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

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

Колонки

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

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

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

Записи

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

Пример

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

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

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

Tip

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

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

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

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

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

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