Low-code дизайнер > Приложение / Поисковые запросы на языке EQL365

Поисковые запросы на языке EQL365

Язык EQL365 (ELMA365 Query Language) — это язык запросов к данным, хранящимся в системе ELMA365. EQL-запросы составляются по разработанному синтаксису и расширяют базовые возможности поиска. Они позволяют создавать сложные выборки данных по указанным параметрам с учётом нескольких условий.

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

Использование EQL-поиска

Поиск на странице приложения

EQL-поиск можно применять, чтобы найти элементы в приложениях. Для этого на странице приложения в строке поиска нажмите на значок Pipeline_icon.

В поле EQL-поиск запрос составляется по правилам синтаксиса языка EQL365. Чтобы вызвать опцию автозаполнения строки, нажмите сочетание клавиш Ctrl + Пробел. В выпадающем списке перечисляются:

  • переменные текущего приложения;
  • ключевые слова языка EQL365;
  • функции: Дата (Datetime), Время (Time), Текущий пользователь (CurrentUser) и т. д.;
  • логические операторы для комбинации нескольких условий: AND, OR, NOT и т. д.

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

eql-search-1

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

Выборки данных в Web API

EQL-запросы можно использовать в Web API, например, добавить их в структуру запроса получения списков элементов приложения в конструкции filter. Использовать можно несколько EQL-запросов. При составлении запроса для ключа описания используется значение "eql". Для тела запроса указывается конструкция из подключа "query" и текст условия выборки.

Например, для приложения Товары получим все элементы с ценой за единицу (код переменной price) равной 4 000:

{
    "filter": {
        "eql":{
            "query":"[price] = 4000"
        }
    }
}

Чтобы протестировать составленный запрос, перейдите в настройки приложения, выберите пункт API и откройте вкладку Список элементов. Подробнее о Web API читайте в статье «API в приложениях» и в справке по публичному API ELMA365.