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