| ID | 1 | what
where | Позволяет запрашивать идентификатор объекта или накладывать условия по идентификатору. Пример | 1<query class="TWorker">
2 <item part="what" special="ID"/>
3 <item part="what" name="LastName"/>
4 <item part="what" name="FirstName"/>
5 <item part="where" value="5500921" special="ID"/>
6</query> Получить идентификатор объекта, значения свойств LastName, FirstName объекта с идентификатором, равным 5500921. Ответ на запрос будет содержать элемент с именем ID. |
|
| parent | 2 | what
where | Позволяет использовать в запросах идентификатор "родителя" объекта. Пример | 1<query class="TCountry">
2 <item part="what" special="ID"/>
3 <item part="what" special="parent"/>
4 <item part="what" name="Name"/>
5 <item part="what" name="Description"/>
6</query> Получить идентификатор объекта, идентификатор родительского объекта, значения свойств Name, Description всех объектов класса TCountry. Ответ на запрос будет содержать элемент с именем Parent. |
|
| haschildren | 3 | what
where | Признак наличия дочерних объектов в иерархии. Ответ на запрос будет содержать элемент с именем HasChildren и значением "1" в случае наличия дочерних объектов и значением "0" в случае их отсутствия. Пример | 1<query class="TCountry">
2 <item part="what" name="Name"/>
3 <item part="what" name="Description"/>
4 <item part="what" special="haschildren"/>
5</query> Получить значения свойств Name, Description, а также признак наличия дочерних объектов всех объектов класса TCountry. |
|
| filter | 4 | where | Позволяет использовать для отбора условия, заданные доменами, использованными в решении на платформе. Имя или идентификатор домена указывается в атрибуте name. Условие отбора этого домена будет интерпретировано с учетом значений, переданных в дочернем элементе context. Для каждого из этих значений должны быть указаны его имя, домен и значение. Пример | 1<query class="TCountry">
2 <item part="what" name="Name"/>
3 <item part="what" name="Description"/>
4 <item part="where" name = "TRegion of UnivCountry domain" special="filter>
5 <context>
6 <UnivCountry domain="4565848">67991</UnivCountry>
7 </context>
8 </item>
9</query> Получить значения свойств Name, Description объектов класса TCountry, подходящих под условие отбора домена "TRegion of UnivCountry domain", используя значение "67991" вместо идентификатора UnivCountry.
Условие отбора домена "TRegion of UnivCountry domain":
((Self.Parent = UnivCountry) or (Self = UnivCountry)) |
|
| uplink | 5 | what
where | Используется для отбора данных в контексте выбранных родительских объектов. Связь отбираемых объектов с выборкой связанных родительских объектов будет установлена по свойству, переданному атрибутом name. В атрибуте value может быть передан идентификатор одного объекта, список идентификаторов объектов через ";" или идентификатор буфера, в который предварительного сохранен список объектов. Пример | 1<query class="TCountry">
2 <item part="where" name="Parent" value="14750" special="uplink"/>
3 <item part="what" name="Name"/>
4 <item part="what" name="Description"/>
5</query> Получить значения свойств Name, Description объектов класса TCountry, у которых значение свойства Parent равно "14750" (или входит в состав объектов, сохраненных в буфере с идентификатором "14750"). |
|
| root | 6 | where | Будут отобраны только объекты, не имеющие родителя, после наложения других условий отбора. Пример | 1<query class="TCountry">
2 <item part="what" name="Name"/>
3 <item part="what" name="Description"/>
4 <item part="where" special="root"/>
5</query> Получить значения свойств Name, Description "корневых" (не имеющих родителя) объектов класса TCountry. |
|
| desc | 7 | order | Используется для сортировки "по убыванию" для элементов с атрибутом part ="order". Без указания атрибута special будет выполнена сортировка "по возрастанию". Пример | 1<item part="order" name="LastName"/>
2<item part="order" name="BirthDate" special="desc"/> Отсортировать результат запроса по значению свойства "LastName" по возрастанию, затем по значению свойства "BirthDate" по убыванию. |
|
| count | 8 | what
having | Используется для запросов с группировкой, в элементах, у которых part = "what" или "having" для получения количества объектов в группе. Пример | 1<item part="what" name="Region"/>
2<item part="what" name="ID" special="count"/>
3<item part="group" name="Region"/>
4<item part="having" name="ID" value=">3" special="count"/> Сгруппировать результат запроса по значению свойства "Region", для каждой группы вернуть значение свойства "Region" и количество записей в группе, отобрав при этом только такие группы, количество объектов в которых больше 3-х. |
|
| sum | 9 | what
having | Используется для запросов с группировкой, в элементах, у которых part = "what" или "having" для получения суммы значений свойства, имя которого передано атрибутом name. Пример | 1<item part="what" name="Region"/>
2<item part="what" name="PayedSum" special="sum"/>
3<item part="group" name="Region"/> Сгруппировать результат запроса по значению свойства "Region", для каждой группы вернуть значение свойства "Region" и сумму значений свойства "PayedSum" для всех объектов группы. |
|
| min | 10 | what
having | Используется для запросов с группировкой, в элементах, у которых part = "what" или "having" для получения минимального значения свойства, имя которого передано атрибутом name. Пример | 1<item part="what" name="Region"/>
2<item part="what" name="BirthDate" special="min"/>
3<item part="group" name="Region"/> Сгруппировать результат запроса по значению свойства "Region", для каждой группы вернуть значение свойства "Region" и минимальное значение свойства "BirthDate" среди всех объектов группы. |
|
| max | 11 | what
having | Используется для запросов с группировкой, в элементах, у которых part = "what" или "having" для получения максимального значения свойства, имя которого передано атрибутом name. Пример | 1<item part="what" name="Region"/>
2<item part="what" name="BirthDate" special="max"/>
3<item part="group" name="Region"/> Сгруппировать результат запроса по значению свойства "Region", для каждой группы вернуть значение свойства "Region" и максимальное значение свойства "BirthDate" среди всех объектов группы. |
|
| avg | 12 | what
having | Используется для запросов с группировкой, в элементах, у которых part = "what" или "having" для получения среднего значения свойства, имя которого передано атрибутом name. Пример | 1<item part="what" name="Region"
2<item part="what" name="PayedSum" special="avg"/>
3<item part="group" name="Region"/> Сгруппировать результат запроса по значению свойства "Region", для каждой группы вернуть значение свойства "Region" и среднее значение свойства "PayedSum" среди всех объектов группы. |
|
| masterLink | 13 | where | Позволят наложить отбор на объекты класса ("подчиненный" класс) в контексте выбранных объектов класса-мастера или класса, связанного с исходным по другому свойству ("главный" класс). В атрибуте name в этом случае передаются имена свойства "главного" класса и свойства "подчиненного" класса, по которым эти классы связаны. Имена свойств указываются следующим образом: - Если одним из этих свойств является идентификатор (ID), то имя этого свойства не указывается (это свойство используется по умолчанию)
- Если оба свойства отличаются от ID, то их имена указываются через разделитель ";", например, "Master;Person"
- Если только свойство "подчиненного" класса отличается от ID, то указывается только имя этого свойства, например, "Person"
- Если только свойство "главного" отличается от ID, то вместо свойства-подчиненного указывается *, например, "Master;*"
В свойстве value передается идентификатор буфера, содержащего список выбранных объектов "главного" класса. Пример | 1<query class="TContact">
2 <item part="what" name="ContactInfo"/>
3 <item part="what" name="ContactType" special="name"/>
4 <item part="where" name="Person" value="246889" special="masterLink"/>
5</query> Получить значения свойств ContactInfo, ContactType (Имя) объектов класса TContact, для объектов, список которых сохранен в буфере с идентификатором "246889", связанным с классом TContact по свойству Person. |
|
| selectedOnly | 14 | where | Позволят наложить отбор по списку идентификаторов объектов класса, ранее сохраненных в буфере. Пример | 1<query class="TPerson">
2 <item part="what" name="LastName"/>
3 <item part="what" name="FirstName"/>
4 <item part="where" value="246889" special="selectedOnly"/>
5</query> Получить значения свойств LastName, FirstName объектов класса TPerson, список которых сохранен в буфере с идентификатором "246889". |
|
| distinct | 15 | what | Позволяет получить все уникальные значения определенного свойства или сочетания значений свойств класса. Пример | 1<query class="TPerson">
2 <item part="what" name="FirstName"/>
3 <item part="what" special="distinct"/>
4</query> Получить набор уникальных значений свойства FirstName класса TPerson. 1<query class="TPerson">
2 <item part="what" name="FirstName"/>
3 <item part="what" name="MiddleName"/>
4 <item part="what" special="distinct"/>
5</query> Получить набор уникальных сочетаний значений свойств FirstName и MiddleName класса TPerson. |
|
| view | 16 | where | Позволяет при выполнении запроса наложить отбор, используемый для определенного представления. Имя (или идентификатор) представления указывается в атрибуте name. Пример | 1<query class="TPerson">
2 <item part="where" name="Persons older 25" special="view"/>
3 <item part="what" name="FirstName"/>
4 <item part="what" name="LastName"/>
5</query> Получить значения свойств FirstName, LastName объектов класса TPerson, соответствующих условиям отбора представления Persons older 25. |
|
| caseInsensitive | 17 | where | Позволяет наложить отбор на значение свойства строкового типа без учета регистра. Без использования special поиск ведется с учетом регистра. Пример | 1<query class="TPerson">
2 <item part="what" name="FirstName"/>
3 <item part="what" name="LastName"/>
4 <item part="where" name="FirstName" value="АНДРЕЙ" special="caseInsensitive"/>
5</query> Получить значения свойств FirstName, LastName объектов класса TPerson, с отбором по значению свойства FirstName без учета регистра символов. TPerson. |
|
| string | 18 | where | Позволят явно приводить к строковому типу значения свойства, переданного атрибутом name. Пример | 1<query class="TCountry">
2 <item part="what" name="Name"/>
3 <item part="what" name="Description"/>
4 <item part="where" name="Code" value="00002" special="string"/>
5</query> Получить значения свойств Name, Description объектов класса TCountry, со значением свойства Code, равным "00002". |
|
| listed | 19 | where | Позволяет выполнять отбор по списку объектов, входящих в список, сохраненный в системе как объект класса TObjectList ("Списки"), идентификатор которого нужно передать в качестве значения атрибута value. Пример | 1<query class="TCountry">
2 <item part="what" name="Name"/>
3 <item part="what" name="Description"/>
4 <item part="where" name="ID" value="5245654" special="listed"/>
5</query> Получить значения свойств Name, Description объектов класса TCountry, входящих в список, сохраненный как объект класса TObjectList с идентификатором "5245654". |
|
| name | 20 | what
where | Для свойств-ссылок на объекты позволяет получить Имя объекта, переданного атрибутом name. В полученном ответе соответствующий элемент будет иметь имя ИмяСвойства-N. Пример | 1<query class="TCountry">
2 <item part="what" name="Name"/>
3 <item part="what" name="Description"/>
4 <item part="what" name="Parent"/>
5 <item part="what" name="Parent" special="name"/>
6</query> Для всех объектов класса TCountry получить значения свойств Name, Description, Parent, а также Имя объекта Parent. |
|
| description | 21 | what
where | Для свойств-ссылок на объекты позволяет получить Наименование объекта, переданного атрибутом name. В полученном ответе соответствующий элемент будет иметь имя ИмяСвойства-D. Пример | 1<query class="TCountry">
2 <item part="what" name="Name"/>
3 <item part="what" name="Description"/>
4 <item part="what" name="Parent"/>
5 <item part="what" name="Parent" special="description"/>
6</query> Для всех объектов класса TCountry получить значения свойств Name, Description, Parent, а также Наименование объекта Parent. |
|
| function | 22 | what
where | Позволяет использовать значения, полученные в результате вызова функций, как в элементах с атрибутом part ="what", так и в элементах с атрибутом part ="where". Имя функции должно быть передано в атрибуте value в формате Имя класса.Имя функции. Если функция имеет параметры, то для их передачи необходимо добавить дочерний элемент context, со своими дочерними элементами для каждого из параметров в формате <ИмяПараметра>Значение параметра</ИмяПараметра>. Если функция является "методом объекта", параметр "ID" добавлять не нужно, он будет использован автоматически. В элементах с атрибутом part ="what" значение атрибута name может быть любым, оно не будет использовано при выполнении запроса, но станет именем элемента данных в получаемом ответе. Пример | 01<item part="what" name="InitAndLast" value="TPerson.GetInitAndLast" special="22"/>
02<item part="what" name="ContactList" value="TPerson.GetContactList" special="22">
03 <context>
04 <ContactType>63474</ContactType>
05 </context>
06</item>
07<item part="where" name="TWorker.IsSuperior" value="1" special = "function">
08 <context>
09 <OtherWorker>625186</OtherWorker>
10 <Department></Department>
11 </context>
12</item> Получить результат выполнения функции GetInitAndLast класса TPerson (функция не имеет параметров), получить результат выполнения функции GetContactList класса TPerson с параметром ContactType = 625186. Отобрать только те объекты, для которых результат выполнения функции IsSuperior класса TWorker равен "1". Функция IsSuperior вызывается со значением 625186 параметра OtherWorker и пустым значением параметра Department. |
|
| countdistinct | 23 | what
having | Позволяет получить количество уникальных значений свойства. Пример | 1<query class="TPerson">
2 <item part="what" name="FirstName" special="countdistinct"/>
3</query> Получить количество уникальных значений свойства FirstName класса TPerson. |
|
| boolean | 24 | what
where | Позволят приводить к "логическому" типу значения свойства, переданного атрибутом name. Приведение выполняется по следующему принципу: - значение Null преобразуется в пустое значение в ответе
- значение "0" остается значением "0" в ответе
- любое непустое значение преобразуется в значение "1" в ответе
Такая возможность позволяет, например, более эффективно (без получения самих значений) определять пустоту/непустоту значений типа "большой объект". Пример | 1<query class="TCountry">
2 <item part="what" name="Name"/>
3 <item part="what" name="Description"/>
4 <item part="what" name="Code" special="boolean"/>
5</query> Получить значения свойств Name, Description, а также значение свойства Code, преобразованное к "логическому" всех объектов класса TCountry. |
|
| exact | 25 | where | При использовании значения "exact" (25) атрибута special значение, переданное в атрибуте value, будет использовано "как есть" - без преобразования типов, без трактовки символов "*", "?" как маски и т.п. Пример | 1<query class="TCountry">
2 <item part="what" name="Name"/>
3 <item part="what" name="Description"/>
4 <item part="where" name="Code" value = "002*25?" special="exact"/>
5</query> Получить значения свойств Name, Description объектов класса TCountry со значением свойства Code, равным "002*25?". |
|
| searchindex | 26 | where | Позволяет использовать индексы полнотекстового поиска при отборах. Поиск по выполняться по всем полям класса, значение атрибута name будет проигнорировано. Пример | 1<query class="TMailMessage">
2 <item part="what" name="Theme"/>
3 <item part="what" name="Body"/>
4 <item part="what" name="Created"/>
5 <item part="where" value="приглашаем *на семинар *Современные" special="searchindex">
6</query> Получить значения свойств Theme, Body, Created объектов класса TMailMessage, среди значений свойств которых будет найдена указанная строка, с использованием индекса полнотекстового поиска. |
|
| optimization | 27 | where | Позволяет использовать имеющиеся подсказки оптимизатору при выполнении запроса. Пример | 1<query class="TPerson">
2 <item part="what" name="FirstName"/>
3 <item part="what" name="LastName"/>
4 <item part="what" value="ORARefreshOnFetch=true;APPRefreshOnFetch=true" special="optimization">
5</query> Получить значения свойств FirstName, LastName объектов класса TPerson, используя при выполнении запроса подсказки оптимизатору. |
|
