Запросы и агрегации в таблице Tulip
  • 26 Mar 2024
  • 3 Минуты для чтения
  • Авторы

Запросы и агрегации в таблице Tulip


Article Summary

Цель

Узнайте, как выполнять запросы к таблицам Tulip и создавать агрегации, доступные в приложениях Tulip Apps.

В этой статье вы узнаете...

  • Возможности запросов к таблицам
  • Как создавать запросы и агрегации
  • Как использовать запросы и агрегации в приложениях

Обзор табличных запросов и агрегаций таблиц

С помощью запросов к таблицам и агрегаций таблиц вы можете запрашивать и динамически фильтровать таблицы Tulip в приложениях.

В этой статье мы будем ссылаться на следующую таблицу заказов, содержащую 10 строк:

В правом верхнем углу вы можете видеть кнопки Запросы и Агрегации. Нажмите на Queries, чтобы добавить новый запрос.

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

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

В следующем примере суммируется поле таблицы " Количество товара":

Параметры запроса

Фильтр

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

Примеры вариантов сравнения включают:

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

Static Value будет статически задаваться при построении запроса, а App Input будет настраиваться в самом приложении. App Input может быть настроен как:

  • Переменная
  • Статическое значение
  • Информация приложения
  • Запись в таблице Tulip

Теперь вы можете использовать поля Created At и Updated At в запросах к таблице.

Сортировка

Настройте отображение записей, задав параметр Sort. Примеры включают:

  • От A до Z / От Z до A
  • от 0 до 9 / от 9 до 0

Лимит

Установите ограничение на количество записей, возвращаемых запросом, настроив лимит.

Максимальное значение лимита - 1 000 записей.

Тестирование

После настройки запроса с помощью параметров фильтра, сортировки и ограничения его можно протестировать прямо в таблице, нажав кнопку Test. Это позволит смоделировать, что запрос будет возвращать в приложении.

Агрегации

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

  • Среднее
  • Count
  • Max
  • Min
  • Режим
  • Сумма
  • Уникальные значения

:::(Info) (Агрегации и ограничения) Поскольку агрегации настраиваются поверх табличных запросов, ограничения, установленные для родительского табличного запроса агрегации, применяются и к ней. Это означает, что агрегации могут учитывать максимум 1 000 записей:

Использование запросов и агрегаций в приложениях

Добавление запросов в приложения

Чтобы добавить запрос в приложение, сначала добавьте таблицу в приложение, нажав на вкладку Records и +Add Table. Затем нажмите кнопку Запрос.

В появившемся модале задайте запросу имя запроса и, если применимо, настройте App Input, связанный с фильтром. В этом примере мы видим запрос Products Not Shipped:

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

Встроенная таблица отобразит результаты запроса. В этом примере возвращены 3 записи, удовлетворяющие фильтру**"Отгружено", равному "Нет"**:

Добавление агрегаций в приложения

Аналогично тому, как запрос добавляется в приложение, добавьте агрегацию, нажав +Add Aggregation, и назначьте имя агрегации.

В этом примере агрегация Total Qty Products Ordered выполняется на запросе, который возвращает только записи, которые не были отправлены. По этой причине имя агрегации - Количество товаров, которые будут отгружены:

Чтобы встроить агрегацию в приложение, поместите переменную в приложение и выберите Datasource - Tulip Table Aggregation. Затем выберите имя агрегации, которое было настроено при добавлении агрегации в приложение.

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

Использование агрегаций в логике приложений

С помощью агрегаций вы можете построить логику приложения на основе значения агрегации. Смотрите пример ниже:

Обратите внимание, что аналитика Single Number Tulip Analytics в настоящее время недоступна из приложения и не может быть напрямую использована в логике приложения. Запустив агрегацию в запросе, вы сможете нацелиться на это значение и, таким образом, построить логику приложения на его основе.


Была ли эта статья полезной?