3.2.5.1. Синтаксис

Разбор и хранение выражений на языке DOEL обеспечиваются классом DoelExpression.

Выражения на DOEL применяются к доменным объектам и позволяют получить поля из них или связанных с ними доменных объектов, а также сами связанные объекты. Простейшим DOEL-выражением является просто имя поля, в таком случае значением выражения становится значение поля исходного доменного объекта. Однако, если это поле является связью (reference, см. {@link ru.intertrust.cm.core.config.ReferenceFieldConfig}), то значением становится сам связанный объект, который, в свою очередь, может быть использован для извлечения его полей (через точку). Например, для объекта "Персона" можно получить имя руководителя его подразделения:

Department.Head.Name

Также возможно извлечение дочерних или просто связанных объектов, хранящих ссылки на исходный внутри себя.
Для этого используется конструкция тип дочернего объекта^имя поля связи. Например, так можно получить имена всех исполнителей поручений по документу:

Commission^Document.Assignee^Commission.Name

Звёздочка, указанная после имени поля, означает повторный переход по связи, причём он может выполняться неограниченное число раз. Остальная часть выражения будет вычисляться для всех объектов, полученных на каждом шаге такого перехода. Например, если у поручения могут быть дочерние поручения, образующие иерархию неизвестной глубины, исполнители всех дочерних поручений могут быть получены таким выражением:

Commission^Parent*.Assignee^Commission.Name

Корректность DOEL-выражения (существование указанных типов объектов и полей в соответствующих типах) проверяется в момент загрузки конфигурации. Его вычисление никогда не может привести к ошибке. Если на каком-либо этапе связанные доменные объекты отсутствуют, то результатом вычисления становится пустой набор объектов.

:func(arg1,arg2,...)

Вызов функции может быть добавлен после любого элемента DOEL-выражения. Аргументы необязательны, их число (и семантика) зависит от конкретной функции; некоторые функции могут поддерживать переменное число параметров. Строковые аргументы могут заключаться в кавычки.

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

Имя функции используется для выбора класса, содержащего её реализацию.

Статус	В РАБОТЕ
Раздел

2.2. Список функций

Таблица 1 Общий список функций

Название функции	Пример использования	Краткое описание	Обязательные параметры	Опциональные параметры	Принимаемые типы	Возвращаемые типы	Принимает множественные значения	Возвращает множественные значения
Status	*Commission^parent:Status(Assigned,Executing).Job^parent.Assignee*	Фильтрует доменные объекты по статусу	Допустимый статус	Допустимые статусы до 999	REFERENCE	REFERENCE	Да	Да
isEmpty	*RegDate:isEmpty* - не заполнено поле дата регистрации	Проверяет, что в поле нет значения (в колонке лежит null), для типов String/Text длина строки отлична равно 0	Отсутствуют	Отсутствуют	Любой	BOOL	Нет	Нет
isNotEmpty	*RegDate:isNotEmpty* - заполнено поле дата регистрации	Проверяет, есть ли значение (в поле не null), для типов String/Text длина строки отлична от 0	Отсутствуют	Отсутствуют	Любой	BOOL	Нет	Нет
format	*HierRoot.createdDate:format("dd-MM-yyyy"*) - преобразует дату создания корневого объект в строку по формату "dd-MM-yyyy" sum:format("#.####") - ограничивает отображение 3-мя знаками после запятой	Выполняет форматирование числовых и временных значений.	1 - шаблон форматирования	Отсутствуют	DATETIME DATETIMEWITHTIMEZONE TIMELESSDATE DECIMAL LONG	STRING	Да	Да
split	*Subject:split(";")* - разбивает заголовок на массив строк по символу ";"	Производит разбиение строк по regex. Является обёрткой для java.lang.String#split(java.lang.String)	1 - regex делимитер	Отсутствуют	STRING TEXT	LIST<STRING>	Да (в этом случае возвращает LIST<LIST<STRING>	Да
get*	*Subject:split(";"):getString("1")* - разбивает заголовок на подстроки и берёт вторую из них	Получение из массива значений, значения под порядковым номером. Для каждого типа выделена отдельная функция, т.к. DOEL жестко типизирован и для дальнейшей работы необходимо однозначно знать, что вернулось из массива, на этапе построения цепочки вызовов. Функции по типам описаны в таблице 2	1 - номер элемента массива	Отсутствуют	LIST	Зависит от функции, подробно в таблице 2	Да	Нет (в случае LIST<LIST> возвращается элемент LIST, который внутри себя содержит множественное значение)
in	*Module.Type.Alias:in("OutputDocs", "OutputDocsPrev")* - проверяет, что в ss_moduletype, который получается стандартной цепочкой вызовов, лежит строка "OutputDocs" или "OutputDocsPrev" с учётом регистра	Проверяет, есть ли значение результат вычисления в переданном массиве параметров с учётом регистра.	от 1 до (Integer.MAX_VALUE-1) список допустимых значения для поля	Отсутствуют	STRING	BOOL	Да (если подходит хоть одно значение из массива, считаем что попадаем условие соблюдено)	Нет
inIgnoreCase	*Module.Type.Alias:inIgnoreCase("OUTPUTDOCS", "OutputDOcsPrev")* - проверяет, что в ss_moduletype, который получается стандартной цепочкой вызовов, лежит строка "OUTPUTDOCS" или "OutputDocsPrev" без учёта регистра	Проверяет, есть ли значение результат вычисления в переданном массиве параметров без учёта регистра.	от 1 до (Integer.MAX_VALUE-1) список допустимых значения для поля	Отсутствуют	STRING	BOOL	Да (если подходит хоть одно значение из массива, считаем что попадаем условие соблюдено)	Нет
max	*F_DP_Rkk_SigningInfo^Owner.idx:max* - возвращает максимальный порядковый номер подписанта (позволяет определить количество подписантов)	Определяет максимальное значение из предоставленного списка	Отсутствуют	Отсутствуют	DATETIME DATETIMEWITHTIMEZONE TIMELESSDATE DECIMAL LONG	Совпадает с переданным	Да	Нет
min	*Log_OpenEvent_Apr^owner.createdDate:min* - возвращает время, в которое первый из раз ЛС был открыт пользователем	Определяет минимальное значение из предоставленного списка	Отсутствуют	Отсутствуют	DATETIME DATETIMEWITHTIMEZONE TIMELESSDATE DECIMAL LONG	Совпадает с переданным	Да	Нет
not	*active:not*	Отрицание для bool значение	Отсутствуют	Отсутствуют	BOOL	BOOL	Нет	Нет
qty	*F_DP_Rkk_SigningInfo^Owner:qty* - подсчёт количества подписантов	Возвращает количество значений в списке. Не имеет параметров. При подсчёте количества значений учитываются только значения, отличные от NULL (заполненные).	Отсутствуют	Отсутствуют	Любой	LONG	Да	Нет
id	punid:split("FF"):getString("0"):id - получение id объекта из nunid2punid_map, по punid	Преобразует строковое представление platformId к Reference	Отсутствуют	Отсутствуют	STRING	REFERENCE	Да	Да
join	*F_DP_Rkk_SigningInfo^Owner.signer.orig_shortname:join(", ")* - объединяет shortName подписантов через запятую	Объединяет массив строк в одну строку через сепаратор	1- сепаратор, через который нужно объединить строки	Отсутствуют	LIST<STRING>	STRING	Да	Нет
toString	volume:toString	Приводит значение к строке. Для REFERENCE - строит stringRepresentation, для LIST рекурсивно вызывает себя для для элементов массива. Для остальных типов вызывает java.lang.Object#toString, для value	Отсутствуют	Отсутствуют	Любой	STRING LIST<STRING>	Да	Нет

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

Таблица 2 Детализация get функций

Имя функции	Тип для обработки
getBool	BOOL
getDateTime	DATETIME
getDateTimeWithZone	DATETIMEWITHTIMEZONE
getDecimal	DECIMAL
getList	LIST
getLong	LONG
getRef	REFERENCE
getString	STRING
getTimelessDate	TIMELESSDATE

Дерево страниц

3.2.5.1. Синтаксис

2.2. Список функций