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

Назначение

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

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

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

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

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

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

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

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

Агрегации добавляются поверх запроса и строятся на уровне таблицы, как и запросы. Щелкните на Aggregations (Агрегации ), чтобы создать новую агрегацию.

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

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

Фильтр

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

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

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

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

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

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

Сортировка

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

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

Ограничение

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

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

Параметры агрегирования

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

• Среднее
• Count
• Max
• Min
• Mode
• Sum
• Уникальные значения

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

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

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

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

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

Встроенная таблица отобразит результаты запроса. В данном примере возвращены 3 записи, удовлетворяющие фильтру**'Shipped', равному 'No'**:

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

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

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

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

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

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

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

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