Ресурсы

Помощник Easy Report умеет делать отчёты на таблицах (ресурсах в терминологии помощника), загруженных из источников данных. Здесь Вы найдёте всю необходимую информацию о том, как работать с ресурсом.

Создание ресурса

Выбор источника данных

Необходимо выбрать или создать источник данных, из которого будет загружен ресурс.

Выбор таблицы

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

Параметры ресурса

1. Имя ресурса

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

Tip

Выбирайте понятные имена на вашем языке, которые бот-пользователь сможет легко назвать голосом.

2. Группа ресурсов

Выберите или создайте группу, в которую будет входить ресурс. Бот-пользователям доступны лишь те ресурсы, которые находятся в доступной им группе.

3. Частота обновления

Укажите частоту обновления исходных данных ресурса. Поддерживаются следующие политики обновления:

• Ручное обновление (по кнопке).
• По расписанию:
  • Обновление отключено
  • Раз в час (00:00, 01:00, ..., 23:00)
  • Раз в сутки (01:00)

4. Инкрементальное обновление

Tip

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

Вы можете увеличить скорость обновления данных для больших таблиц, используя инкрементальное обновление.

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

В случае необходимости (например, изменилась структура исходной таблицы) на странице ресурса есть возможность запустить полное обновление данных за весь период.

Параметры инкрементального обновления:

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

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

  Задается в формате: Значение - положительное целое число; Формат - День, Месяц или Год.

• Период хранения, отсчитываемый назад от текущей даты, используется для ограничения объема хранимых данных. Все данные, предшествующие раcсчитанной дате, не будут учитываться в системе.

  Задается в формате: Значение - положительное целое число; Формат - День, Месяц или Год.

Пример

Задан период обновления 1 месяц, период хранения 1 год и ежедневная частота обновления.

Наступило 28 марта 2020 года. Будут обновляться данные не ранее 1 февраля 2020 года, а храниться - не ранее 1 января 2019 года.

Наступило 1 апреля 2020 года. Будут обновляться данные не ранее 1 марта 2020 года, а храниться - не ранее 1 января 2019 года.

Наступило 1 января 2021 года. Будут обновляться данные не ранее 1 декабря 2020 года, а храниться - не ранее 1 января 2020 года.

5. Создать метамодель автоматически

Наша система проанализирует выбранную таблицу и создаст простую [метамодель](./#метамодель) для быстрого старта. Вы можете отключить эту опцию, если хотите создать метамодель вручную после создания ресурса.

Автоматически сгенерированная метамодель содержит следующие записи:

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

    !!! tip
        Если в вашей таблице присутствуют столбцы числового типа, которые не являются показателями (например, идентификаторы, которые не могут быть агрегированы), то удалить подобные ошибочные записи в метамодели можно вручную после создания ресурса.

- **Дата** будет выбрана, если будет найден хотя бы один столбец с типом "Дата".

Ограничения на объем данных

Ограничение на объем загружаемых данных:

• 500 мб, если источник данных не поддерживает отдачу структуры ресурса (облачные хранилища файлов).
• Без ограничения, если источник данных поддерживает отдачу структуры ресурса (все остальные источники).

Группы ресурсов

Ресурсы можно объединять в группы для дальнейшего разграничения прав на них. Этот функционал предназначен для упрощения ведения прав доступа: бот-пользователь видит только те ресурсы, которые содержатся в назначенных ему группах.

Tip

Ресурс может входить в состав нескольких групп одновременно. Удаление любой группы не приводит к удалению самого ресурса.

Также в Easy Report существует другая возможность управления правами доступа, которая работает совместно с группами ресурсов - фильтры безопасности.

Метамодель

Метамодель - центральная сущность помощника. Каждый элемент метамодели является прослойкой между естественной речью и колонкой ресурса. Запись в метамодели задаёт для колонки:

• Тип.
• Формулу (только для расчётных показателей).
• Алиасы. Это метки, по которым помощник будет разбирать запрос. Могут состоять из нескольких слов (пример: Отдел, Прогноз оплаты).

Типы колонок могут быть следующими:

Признак

Такая колонка содержит ограниченный набор записей (обычно текстовых), которые автоматически собираются из данных при сохранении метамодели. Пример: признак Отделы с записями Бухгалтерия, Продажи, IT и т.д.

Для признаков также активна следующая настройка:

• Справочник - позволит пользователю фильтровать данные по конкретным значениям. Обычно справочниками делают столбцы с небольшим кол-вом уникальных значений.

Колонка, содержащая в себе более 1000 уникальных значений воспринимается системой, как потенциально высококардинальная. Система предложит вам подтвердить выбор колонки в качестве справочника.

Пример

В ресурсе есть колонка "Поставщик", которая содержит 8 уникальных значений. Вероятность того, что пользователь захочет отфильтровать данные по конкретному поставщику довольно высока. Такую колонку лучше сделать Справочником.

В ресурсе есть колонка "Товар", которая содержит 1515 уникальных значений. Несмотря на то, что объем потенциального Справочника большой, мы знаем, что пользователь захочет фильтровать данные по конкректному товару. Такую колонку можно сделать Справочником.

В ресурсе есть колонка "Номер чека", которая содержит 150000 уникальных значений. Объем потенциального Справочника очень большой, так как кол-во уникальных значений будет соразмерно кол-ву строк в таблице. Маловероятно, что пользователь захочет фильтровать данные по номеру чека, так как скорее всего, он его даже не знает. Такую колонку нельзя (пользы от такого справочника будет мало, а скорость формирования отчета ощутимо упадёт) делать Справочником.

Показатель

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

• сумма
• среднее
• количество
• минимум
• максимум
• остаток на день

Для показателей также активны следующие настройки:

• Точность - округляет соответствующий показатель до N знаков после запятой.
• Сортировка - позволяет установить для показателя конкретный порядок сортировки (по умолчанию сортируются по убыванию).

Расчетный показатель

Это индивидуально созданный показатель, который рассчитывается по указанной формуле.

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

Для создания такого расчетного показателя Вам необходимо:

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

Так же, как и для обычного показателя, Вы можете выбрать необходимое значение точности и сортировки для расчётного показателя.

Дата

Может быть в формате date или datetime.

Для даты также активны следующие настройки:

• Сортировка - позволяет установить для даты конкретный порядок сортировки (по умолчанию сортируются по убыванию).