Язык EQL365 (ELMA365 Query Language) — это язык запросов к данным, хранящимся в системе ELMA365. EQL-запросы составляются по разработанному синтаксису и расширяют базовые возможности поиска. Они позволяют создавать сложные выборки данных по указанным параметрам с учётом нескольких условий.
Вы можете присвоить свойствам приложения определённые значения, сравнить их между собой или вычислить значения с помощью функций. Для проверки нескольких условий в одном запросе используются логические связки — операторы. Например, в результате поиска можно отобразить все компании с заказами на определённую сумму и с договорами в указанном статусе.
Использование EQL-поиска
Поиск на странице приложения
EQL-поиск можно применять, чтобы найти элементы на странице приложения. Для этого в строке поиска нажмите значок .
В поле EQL-поиск запрос составляется по правилам синтаксиса языка EQL365. Чтобы вызвать опцию автозаполнения строки, нажмите сочетание клавиш Ctrl + Пробел. В выпадающем списке перечисляются:
- переменные текущего приложения;
- ключевые слова языка EQL365;
- функции: Дата (
Datetime
), Время (Time
), Текущий пользователь (CurrentUser
) и т. д.; - логические операторы для комбинации нескольких условий:
AND
,OR
,NOT
и т. д.
В сложном запросе каждое условие можно вводить с новой строки для более удобного чтения и редактирования. Для этого используйте клавишу Enter.
После ввода запроса нажмите Поиск. Также можно сохранить запрос как фильтр, чтобы использовать повторно.
Создание запросов в виджете EQL-поиск
Вы можете разместить на формах приложений или страницах виджет EQL-Поиск. В его настройках указывается любое приложение системы. Пользователи смогут составлять запросы и осуществлять поиск по его параметрам.
Например, на отдельной странице создан график отслеживания наиболее доходных заказов компании. Добавим на неё виджет EQL-поиск, настроить поиск по параметрам приложения Заказы. Пользователи смогут создавать сложные выборки данных с множеством условий, находить определённые элементы и открывать их карточки со страницы с графиком.
Обратите внимание, поиск данных с помощью EQL-запросов может замедлить работу системы, если в неё занесён большой объём данных. В таких случаях рекомендуем использовать поиск по параметрам.
Выборки данных в Web API
EQL-запросы можно использовать в Web API, например, добавить их в структуру запроса получения списков элементов приложения. Для этого применяется конструкция filter
, в которой можно указать несколько EQL-запросов.
При составлении запроса для ключа описания используется значение "eql"
. Для тела запроса указывается конструкция из подключа "query"
и текст условия выборки.
Например, для приложения Товары получим все элементы с ценой за единицу (код переменной price
) равной 4 000:
{
"filter": {
"eql":{
"query":"[price] = 4000"
}
}
}
Чтобы протестировать составленный запрос, перейдите в настройки приложения, выберите пункт API и откройте вкладку Список элементов.
Подробнее о Web API читайте в статье «API в приложениях». Специфика составления запросов на языке API и их примеры описаны в справке по публичному API ELMA365.