SqlQuery
Запрос для получения данных с сервера.
Шаблон SqlQuery
Описание SqlQuery
Тэги, специфичные для SqlQuery
ManualLoad
Признак, определяющий, будет ли загрузка данных происходить только после ручного обновления соединения с данными, а не вместе с загрузкой формы.
Необязательный тэг. Ожидается логическое значение.
Если тэг <ManualLoad>
отсутствует, то используется значение тэга <ManualLoad>
соединения с данными.
Workflow
Процесс, в рамках которого происходит запрос.
Обязательный тэг. Значение тэга не ожидается.
В качестве значения атрибута Name
ожидается название одного из процессов, расположенных на сервере и заголовочно описанных в базе данных в таблице public.workflow_type.
Fields
Список полей запроса.
Обязательный тэг. Ожидается список тегов <Field>
.
Атрибуты тэга <Field>
<Field>
Name
Название поля запроса, которое будет использоваться на форме.
Обязательный атрибут. Ожидается любое значение, если атрибут NativeName
присутствует, или ожидается название одного из полей, возвращаемых запросом, если атрибут NativeName
отсутствует.
NativeName
Название поля запроса, описанного на сервере.
Необязательный атрибут. Ожидается название одного из полей, возвращаемых запросом.
Суть связи атрибутов Name
и NativeName
- переименование полей запроса.
Type
Тип поля.
Необязательный атрибут. Ожидается тип FormatField.
FormatString
Задает формат строки для объединения значений нескольких полей.
Необязательный атрибут. Значение атрибута любая строка, поддерживающая выражения вида "{n}", где n - индекс (начиная с 0) вложенного поля.
Parameters
Параметры, передаваемые в запрос.
Необязательный тэг. Ожидается список тэгов <Parameter>
.
Атрибуты тэга <Parameter>
<Parameter>
NativeName
Название параметра, которое используется в описании запроса на сервере.
Обязательный атрибут. Ожидается название одного из параметров, использующихся в описании запроса на сервере.
RefreshQuery
Признак, определяющий, будут ли обновлены данные запроса при изменении параметра.
Необязательный атрибут. Ожидается логическое значение.
Если атрибут RefreshQuery
отсутствует, то используется значение True.
SendAsArray
Признак, определяющий будет ли значение передаваться как массив.
Необязательный атрибут. Ожидается логическое значение.
Если атрибут SendAsArray
отсутствует, то используется значение False.
Применять значение False для атрибута RefreshQuery
имеет смысл тогда, когда обновляется более одного параметра запроса одновременно, но при этом нет необходимости выполнять запросы отдельно при обновлении каждого параметра.
Вложенные тэги тэга <Parameter>
<Parameter>
Value - значение параметра. Обязательный тэг. Ожидается любое значение;
IfNull - значение, которое будет передано в качестве значение параметра, если последний в тэге
<Value>
имеет значение NULL. Необязательный тэг. Ожидается любое значение;IfEmpty - значение, которое будет передано в качестве значение параметра, если последний в тэге
<Value>
имеет значение "". Необязательный тэг. Ожидается любое значение.
Filter
Фильтр полученных данных.
Фильтрация происходит без повторных запросов в базу данных.
Необязательный тэг. Значение тэга <Filter>
: список тэгов <And>
, <Or>
и <Not>
или тэги <Field>
, <Value>
и <DataType>
.
Атрибуты тэга <Filter>
<Filter>
Type
Тип сравнения значений.
Необязательный атрибут. Ожидается название одного из типов сравнения значений.
Если атрибут Type
отсутствует, то используется значение Equal.
FilterByNullValue
Признак, определяющий, будет ли осуществляться фильтрация для очередной строки соединения с данными, если значение фильтра будет равно NULL.
Необязательный атрибут. Ожидается логическое значение.
Если атрибут FilterByNullValue
отсутствует, то используется значение True.
RefreshFilter
Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении параметра фильтра.
Признак не работает для фильтров, содержащих внутри себя тэги <And>
, <Or>
или <Not>
, для таких фильтров данные обновляются всегда.
Необязательный атрибут. Ожидается логическое значение.
Если атрибут RefreshFilter
отсутствует, то используется значение True.
Reverse
Признак, определяющий, будет ли изменён порядок аргументов фильтра на обратный.
Необязательный атрибут. Ожидается логическое значение.
Если атрибут Reverse
отсутствует, то используется значение False.
Типы сравнения значений
Equal
Сравнение значений на равенство
NotEqual
Сравнение значений на неравенство
Greater
Сравнение значений на "больше": значение из соединения с данными больше указанного значения
NotGreater
Сравнение значений на "не больше": значение из соединения с данными не больше указанного значения
Less
Сравнение значений на "меньше": значение из соединения с данными меньше указанного значения
NotLess
Сравнение значений на "не меньше": значение из соединения с данными не меньше указанного значения
Contains
Сравнение значений на "содержит": значение из соединения с данными содержит указанное значение (значения любых типов данных преобразуются к строковому типу)
NotContains
Сравнение значений на "не содержит": значение из соединения с данными не содержит указанное значение (значения любых типов данных преобразуются к строковому типу)
In
Сравнение значений на "входит": значение из соединения с данными входит в указанный массив
NotIn
Сравнение значений на "не входит": значение из соединения с данными не входит в указанный массив
Overlap
Сравнение значений на "пересекается": массив из соединения с данными имеет общие элементы с указанным массивом
NotOverlap
Сравнение значений на "не пересекается": массив из соединения с данными не имеет общих элементов с указанным массивом
MatchSearch
Сравнение значений на "удовлетворяет поисковой строке": поисковая строка может состоять из слов, разделенных пробелами и знаками "+", "*" и "?", пробел означает "ИЛИ", "+" означает "И", "*" означает любое количество любых символов, "?" означат ровно один символ
NotMatchSearch
Сравнение значений на "не удовлетворяет поисковой строке": поисковая строка может состоять из слов, разделенных пробелами и знаками "+", "*" и "?", пробел означает "ИЛИ", "+" означает "И", "*" означает любое количество любых символов, "?" означат ровно один символ
ContainedIn
Сравнение значений на "входит": значение из соединения с данными входит в указанное значение (значения любых типов данных преобразуются к строковому типу)
NotContainedIn
Сравнение значений на "не входит": значение из соединения с данными не входит в указанное значение (значения любых типов данных преобразуются к строковому типу)
Тэг <And>
<And>
Логическое умножение нескольких фильтров.
Необязательный тэг. Значение тэга <And>
: список тэгов <Filter>
, <And>
, <Or>
и <Not>
.
Атрибуты тэга <And>
<And>
RefreshFilter
Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении вложенного фильтра.
Необязательный атрибут. Ожидается логическое значение.
Если атрибут RefreshFilter
отсутствует, то используется значение True.
Тэг <Or>
<Or>
Логическое сложение нескольких фильтров.
Необязательный тэг. Значение тэга <Or>
: список тэгов <Filter>
, <And>
, <Or>
и <Not>
.
Атрибуты тэга <Or>
<Or>
RefreshFilter
Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении вложенного фильтра.
Необязательный атрибут. Ожидается логическое значение.
Если атрибут RefreshFilter
отсутствует, то используется значение True.
Тэг <Not>
<Not>
Логическое отрицание одного фильтра.
Необязательный тэг. Значение тэга <Not>
: тэг <Filter>
, <And>
, <Or>
и <Not>
.
Атрибуты тэга <Not>
<Not>
RefreshFilter
Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении вложенного фильтра.
Необязательный атрибут. Ожидается логическое значение.
Если атрибут RefreshFilter
отсутствует, то используется значение True.
Тэг <Field>
<Field>
Поле, по значению которого полученные данные фильтруются.
Обязательный тэг. Значение тэга <Field>
: не ожидается.
Атрибуты тэга <Field>
<Field>
NativeName
Название поля, по значению которого полученные данные фильтруются.
Обязательный атрибут. Ожидается название одного из полей, описанных в тэге <Fields>
.
Тэг <Value>
<Value>
Значение, по которому полученные данные фильтруются.
Обязательный тэг. Ожидается любое значение.
Тэг <DataType>
<DataType>
Тип данных, к которому приводятся сравниваемые значения.
Необязательный тэг. Значение тэга <DataType>
: не ожидается.
Если тэг <DataType>
отсутствует, то для атрибута Type
используется значение StringDataType.
Атрибуты тэга <DataType>
<DataType>
Type
Название типа данных.
Обязательный атрибут. Ожидается название одного из типов данных, поддерживаемых формой.
Тэг <Enabled>
<Enabled>
Признак, определяющий, будет ли использоваться данный фильтр.
Необязательный тэг. Ожидается логическое значение.
Last updated