Узнайте, как выполнять запросы к таблицам Tulip и создавать агрегаты, доступные в приложениях Tulip
В этой статье вы узнаете...
- Возможности запросов к таблицам и агрегаций
- Как создавать запросы и агрегации
- Как использовать запросы и агрегаты в приложениях
Обзор
Табличные запросы и агрегации позволяют динамически взаимодействовать с таблицами, фильтруя и обобщая данные для использования в приложениях.
В этой статье мы будем использовать следующую таблицу заказов, состоящую из 10 строк:

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

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

Запросы
Запрос позволяет фильтровать и сортировать данные в таблицах. В запросах можно использовать как статические значения, так и динамические значения, основанные на вводе данных в приложении.
Фильтры
Фильтруйте записи, сравнивая значение одного или нескольких столбцов со статическим значением или введенными в приложении данными.
Примеры вариантов сравнения:
- равно / не равно
- значение равно нулю / значение не равно нулю
- содержит / не содержит
- начинается с / не начинается с
- заканчивается на / не заканчивается на
- находится в
- больше или равно / меньше или равно
- находится после или равен / находится до или равен
Статическое значение будет задано статически при построении запроса, а ввод из приложения будет настраиваться в самом приложении. Ввод из приложения можно настроить как:
- переменной
- Статическое значение
- Информация о приложении
- Запись в таблице Tulip
Теперь в запросах к таблицам можно использовать поля «Создано» и «Обновлено ».
Сортировка
Настройте отображение записей, используя параметр «Сортировка ». Примеры:
- От A до Z / От Z до A
- От 0 до 9 / От 9 до 0
Ограничения
Максимальное количество записей, возвращаемых по запросу.
- По умолчанию: 1 000
- Максимум: 1 000
:::(Предупреждение) (Поведение при достижении предела)
Если в таблице содержится больше записей records, соответствующих фильтрам запроса (или вообще, если фильтры не заданы), чем предусмотрено ограничением, в результат запроса включается только то количество записей, которое указано в ограничении.
Если запрос содержит сортировку, будут включены первые records в соответствии с этой сортировкой.
:::
Тестирование
После настройки запроса с помощью параметров «Фильтр», «Сортировка» и «Ограничение» запрос можно протестировать прямо в таблице, нажав кнопку «Тест». Это позволит увидеть, какие результаты запрос вернет в приложении.
Использование запросов в приложениях
Чтобы добавить запрос в приложение, сначала добавьте таблицу в приложение, перейдя на вкладку «Записи» и нажав «+Добавить таблицу». Затем нажмите «Запрос ».
В появившемся модальном окне присвойте запросу «Имя запроса» и, если необходимо, настройте «Ввод данных приложения», связанный с фильтром. В этом примере рассмотрим запрос «Неотправленные товары»:

Теперь, когда запрос настроен в приложении, встройте интерактивную таблицу и выберите в качестве источника данных этот запрос.
Во встроенной таблице будут отображаться результаты запроса. В данном примере возвращаются 3 записи, соответствующие фильтру:«Отправлено» равно «Нет»:

Агрегации
Агрегации — это сводные значения, которые вычисляются на основе запросов и могут определять одно из следующих значений для конкретного столбца:
Среднее* — возвращает среднее значение чисел или целых чисел
Count* — возвращает количество записей; поле не требуется
Max* — возвращает максимальное значение из числа или целого числа
Min* — возвращает минимальное значение из числа или целого числа
Мода* Возвращает наиболее часто встречающееся значение* Примечание: если два значения имеют одинаковую частоту встречаемости, всегда возвращается меньшее значение.
Sum* — возвращает сумму чисел или целых чисел
Уникальные значения* Возвращает массив отдельных уникальных значений заданного запроса, независимо от типа данных
Ограничения
Агрегации могут учитывать не более 1 000 записей.
Агрегации выполняются над записями, возвращаемыми настроенным запросом. Ограничение, установленное для родительского запроса агрегации, также применяется к самой агрегации (1 000 записей).
Агрегация может показать неожиданные результаты, если в таблице содержится больше записей, соответствующих заданным фильтрам, чем предусмотрено ограничением, а пользователь не знает об ограничении запроса.
Если вам необходимо выполнить агрегацию более 1 000 записей для использования в приложении, воспользуйтесь конечной точкой runAggregation API Tulip, которая поддерживает до 100 000 записей, через функцию коннектора.
Если вам нужно лишь визуализировать агрегацию, содержащую более 1 000 записей, создайте анализ «Одиночное значение» (Single Value ) с помощью Analytics, который позволяет проводить агрегацию по всем записям в таблице.
Использование агрегаций в приложениях
Аналогично тому, как запрос добавляется в приложение, добавьте агрегацию, нажав «+Добавить агрегацию», и присвойте ей имя.
В данном примере агрегация «Общее количество заказанных товаров » выполняется над запросом, который возвращает только записи, не отгруженные. По этой причине агрегация получила название «Количество товаров, подлежащих отгрузке»:

Чтобы встроить агрегацию в приложение, перетащите переменную в приложение и выберите источник данных — «Агрегация таблицы Tulip». Затем выберите имя агрегации, которое было задано при добавлении агрегации в приложение.
В данном примере агрегация «Сумма количества товаров » была запущена на основе запроса, возвращающего записи, которые необходимо отправить. В результате получается итоговое значение 17:

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

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