# PrimaryGetDataConnection

## Шаблон PrimaryGetDataConnection <a href="#template_primary_dc" id="template_primary_dc"></a>

Вариант 1: с одним запросом

```xml
<DataConnection Name="" Type="PrimaryGetDataConnection" Assembly="DataConnections">
  <Async Value="" />
  <ManualLoad></ManualLoad> 
  <SqlQuery Name="" Type="Select">
    <Async Value="" />
    <ManualLoad></ManualLoad> 
	<DependOn>
		<DataConnection Name="" />
		<DataConnection Name="" />
	</DependOn> 
    <Workflow Name="" />
    <Fields>
      <Field Name="" NativeName="" />
      <Field Name="" Type="FormatField" FormatString="">
        <Field NativeName="" />
        <Field NativeName="" />
      </Field>
    </Fields>
    <Parameters>
      <Parameter NativeName="" RefreshQuery="" SendAsArray="">
        <Value></Value>
        <IfNull></IfNull>
        <IfEmpty></IfEmpty>
      </Parameter>
    </Parameters>
    <Filter>
      <And RefreshFilter="">
        <Or RefreshFilter="">
          <Filter Type="" FilterByNullValue="" RefreshFilter="" Reverse="">
            <Field NativeName="" />
            <Value></Value>
            <DataType Type="" />
            <Enabled></Enabled>
          </Filter>
          <Filter Type="" FilterByNullValue="" RefreshFilter="" Reverse="">
            <Field NativeName="" />
            <Value></Value>
            <DataType Type="" />
            <Enabled></Enabled>
          </Filter>
        </Or>
        <Not RefreshFilter="">
          <Filter Type="" FilterByNullValue="" RefreshFilter="" Reverse="">
            <Field NativeName="" />
            <Value></Value>
            <DataType Type="" />
            <Enabled></Enabled>
          </Filter>
        </Not>
      </And>
    </Filter>
  </SqlQuery>
  <UpdateInterval Hours="" Minutes="" Seconds=""></UpdateInterval>
</DataConnection>
```

Вариант 2: с несколькими запросами

В Workflow Forms v2 в этом варианте используется пакетная загрузка запросов. Все SqlQuery из DataConnection добавляются в очередь загрузки, при этом очередь может подразделяется на несколько подочередей - для асинхронных и синхронных запросов.

```xml
<DataConnection Name="" Type="PrimaryGetDataConnection" Assembly="DataConnections">
  <Async Value="" />
  <ManualLoad></ManualLoad>
  <SqlQueries>
    <SqlQuery Name="" Type="Select">
      <Async Value="" />
      <ManualLoad></ManualLoad> 
      <Workflow Name="" />
      <Fields>
        <Field Name="" NativeName="" />
        <Field Name="" Type="FormatField" FormatString="">
          <Field NativeName="" />
          <Field NativeName="" />
        </Field>
      </Fields>
      <Parameters>
        <Parameter NativeName="" RefreshQuery="" SendAsArray="">
          <Value></Value>
          <IfNull></IfNull>
          <IfEmpty></IfEmpty>
        </Parameter>
      </Parameters>
      <Filter>
        <And RefreshFilter="">
          <Or RefreshFilter="">
            <Filter Type="" FilterByNullValue="" RefreshFilter="">
              <Field NativeName="" />
              <Value></Value>
              <DataType Type="" />
              <Enabled></Enabled>
            </Filter>
            <Filter Type="" FilterByNullValue="" RefreshFilter="">
              <Field NativeName="" />
              <Value></Value>
              <DataType Type="" />
              <Enabled></Enabled>
            </Filter>
          </Or>
          <Not RefreshFilter="">
            <Filter Type="" FilterByNullValue="" RefreshFilter="">
              <Field NativeName="" />
              <Value></Value>
              <DataType Type="" />
              <Enabled></Enabled>
            </Filter>
          </Not>
        </And>
      </Filter>
    </SqlQuery>
  </SqlQueries>
  <UpdateInterval Hours="" Minutes="" Seconds=""></UpdateInterval>
</DataConnection>
```

## Описание PrimaryGetDataConnection <a href="#description_primary_dc" id="description_primary_dc"></a>

### Вариант 1: с одним запросом <a href="#option_1_single_query" id="option_1_single_query"></a>

```xml
<DataConnection Name="PrimaryGetDataConnectionName" Type="PrimaryGetDataConnection" Assembly="DataConnections">
  <!--Тэги, специфичные для PrimaryGetDataConnection-->
</DataConnection>
```

### Тэги, специфичные для PrimaryGetDataConnection <a href="#option_1_tags_primary_dc" id="option_1_tags_primary_dc"></a>

### Async <a href="#async" id="async"></a>

Признак, определяющий, будет ли загрузка данных происходить в асинхронном режиме (в фоновом потоке).

Необязательный тэг. Значение тэга `<Async>`: не ожидается.

Если тэг `<Async>` отсутствует, то для атрибута `Value` используется значение False.

```xml
<Async Value="False" />
```

#### Атрибуты тэга `<Async>` <a href="#attributes_tag_async" id="attributes_tag_async"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Value</td><td><p>Значение.</p><p></p><p>Обязательный атрибут. Ожидается логическое значение.</p></td></tr></tbody></table>

### ManualLoad <a href="#manual_load" id="manual_load"></a>

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

Необязательный тэг. Ожидается логическое значение.

Если тэг `<ManualLoad>` отсутствует, то используется значение False.

```xml
<ManualLoad>False</ManualLoad>
```

### DependOn <a href="#depend_on" id="depend_on"></a>

Признак, определяющий зависимость от других соединений с данными. Загрузка данных этого соединения будет осуществлена после загрузки всех указанных соединений.

Необязательный тэг. Значение тэга `<DependOn>`: список тэгов [`<DataConnection>`](#depend_on_dc).

```xml
<DependOn>
  <DataConnection Name="" />
  <DataConnection Name="" />
</DependOn> 
```

#### Тэг `<DataConnection>` <a href="#depend_on_dc" id="depend_on_dc"></a>

Загружающее соединение с данными.

Обязательный тэг.

#### Атрибуты тэга `<DataConnection>` <a href="#attributes_tag_depend_on_dc" id="attributes_tag_depend_on_dc"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Name</td><td><p>Название загружающего соединения с данными.</p><p></p><p>Обязательный атрибут. Ожидается название одного из загружающих соединений с данными, описанных в форме.</p></td></tr></tbody></table>

### SqlQuery <a href="#sql_query" id="sql_query"></a>

Запрос для получения данных.

Обязательный тэг. Значение тэга `<SqlQuery>`: тэги [`<Async>`](#sql_query_async), [`<ManualLoad>`](#sql_query_manual_load), [`<Workflow>`](#sql_query_workflow), [`<Fields>`](#sql_query_fields), [`<Parameters>`](#sql_query_parameters) и [`<Filter>`](#sql_query_filter).

```xml
<SqlQuery Name="" Type="Select">
  <Async />
  <ManualLoad />
  <Workflow />
  <Fields />
  <Parameters />
  <Filter />
</SqlQuery>
```

#### Атрибуты тэга `<SqlQuery>` <a href="#attributes_tag_sql_query" id="attributes_tag_sql_query"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Name</td><td><p>Название запроса.</p><p></p><p>Обязательный атрибут. Ожидается название одного из запросов, описанных на сервере.</p></td></tr><tr><td align="center">Type</td><td><p>Тип запроса.</p><p></p><p>Обязательный атрибут. Ожидается значение Select.</p></td></tr></tbody></table>

#### Тэг `<Async>` <a href="#sql_query_async" id="sql_query_async"></a>

Признак, определяющий, будет ли загрузка данных происходить в асинхронном режиме (в фоновом потоке).

Необязательный тэг. Значение тэга `<Async>`: не ожидается.

Если тэг `<Async>` отсутствует, то для атрибута `Value` используется значение атрибута [`<Async>`](#async) соединения с данными.

```xml
<Async Value="False" />
```

#### Атрибуты тэга `<Async>` <a href="#attributes_tag_sql_query_async" id="attributes_tag_sql_query_async"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Value</td><td><p>Значение.</p><p></p><p>Обязательный атрибут. Ожидается логическое значение.</p></td></tr></tbody></table>

#### Тэг `<ManualLoad>` <a href="#sql_query_manual_load" id="sql_query_manual_load"></a>

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

Необязательный тэг. Ожидается логическое значение.

Если тэг `<ManualLoad>` отсутствует, то используется значение тэга [`<ManualLoad>`](#manual_load) соединения с данными.

```xml
<ManualLoad>False</ManualLoad>
```

#### Тэг `<Workflow>` <a href="#sql_query_workflow" id="sql_query_workflow"></a>

Процесс, в рамках которого происходит запрос.

Обязательный тэг. Значение тэга `<Workflow>`: не ожидается.

```xml
<Workflow Name="WorkflowName" />
```

#### Атрибуты тэга `<Workflow>` <a href="#attributes_tag_sql_query_workflow" id="attributes_tag_sql_query_workflow"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Name</td><td><p>Название процесса.</p><p></p><p>Обязательный атрибут. Ожидается название одного из процессов, расположенных на сервере и заголовочно описанных в базе.</p></td></tr></tbody></table>

#### Тэг `<Fields>` <a href="#sql_query_fields" id="sql_query_fields"></a>

Поля запроса.

Обязательный тэг. Значение тэга `<Fields>`: список тэгов [`<Field>`](#sql_query_fields_field).

```xml
<Fields>
  <Field Name="field_name1" />
  <Field Name="FieldName2" NativeName="field_name2" />
  <Field Name="FieldName3" Type="FormatField" FormatString="{0} ({1})">
    <Field NativeName="field_name3" />
    <Field NativeName="field_name4" />
  </Field>
</Fields>
```

#### Тэг `<Field>` <a href="#sql_query_fields_field" id="sql_query_fields_field"></a>

Поле запроса.

Необязательный тэг.&#x20;

#### Атрибуты тэга `<Field>` <a href="#attributes_tag_sql_query_fields_field" id="attributes_tag_sql_query_fields_field"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Name</td><td><p>Название поля запроса, которое будет использоваться на форме.</p><p></p><p>Обязательный атрибут. Ожидается любое значение, если атрибут <code>NativeName</code> присутствует, или ожидается название одного из полей, возвращаемых запросом, если атрибут <code>NativeName</code> отсутствует.</p></td></tr><tr><td align="center">NativeName</td><td><p>Название поля запроса, описанного на сервере.</p><p></p><p>Необязательный атрибут. Ожидается название одного из полей, возвращаемых запросом.</p><p></p><p>Суть связи атрибутов <code>Name</code> и <code>NativeName</code> - переименование полей запроса.</p></td></tr><tr><td align="center">Type</td><td><p>Тип поля.</p><p></p><p>Необязательный атрибут. Ожидается тип FormatField.</p></td></tr><tr><td align="center">FormatString</td><td><p>Форматная строка объединения значений нескольких полей.</p><p></p><p>Необязательный атрибут. Значение атрибута <code>FormatString</code>: любое значение, включающее в себя выражения вида "{n}", где n - индекс (начиная с 0) вложенного поля.</p></td></tr></tbody></table>

#### Тэг `<Parameters>` <a href="#sql_query_parameters" id="sql_query_parameters"></a>

Параметры, передаваемые в запрос.

Необязательный тэг. Значение тэга `<Parameters>`: список тэгов [`<Parameter>`](#sql_query_parameters_parameter).

```xml
<Parameters>
  <Parameter NativeName="NativeName" RefreshQuery="False" SendAsArray="True">
    <Value>Value</Value>
    <IfNull>Value</IfNull>
    <IfEmpty>Value</IfEmpty>
  </Parameter>
</Parameters>
```

#### Тэг `<Parameter>` <a href="#sql_query_parameters_parameter" id="sql_query_parameters_parameter"></a>

Параметр, передаваемый в запрос.

Необязательный тэг. Значение тэга `<Parameter>`: не ожидается.

#### Атрибуты тэга `<Parameter>` <a href="#attributes_tag_sql_query_parameters_parameter" id="attributes_tag_sql_query_parameters_parameter"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">NativeName</td><td><p>Название параметра, которое используется в описании запроса на сервере.</p><p></p><p>Обязательный атрибут. Ожидается название одного из параметров, использующихся в описании запроса на сервере.</p></td></tr><tr><td align="center">RefreshQuery</td><td><p>Признак, определяющий, будут ли обновлены данные запроса при изменении параметра.</p><p></p><p>Необязательный атрибут. Ожидается логическое значение.</p><p></p><p>Если атрибут <code>RefreshQuery</code> отсутствует, то используется значение True.</p></td></tr><tr><td align="center">SendAsArray</td><td><p>Признак, определяющий будет ли значение передаваться как массив.</p><p></p><p>Необязательный атрибут. Ожидается логическое значение.</p><p></p><p>Если атрибут <code>SendAsArray</code> отсутствует, то используется значение False.</p></td></tr></tbody></table>

{% hint style="info" %}
Применять значение False для атрибута `RefreshQuery` имеет смысл тогда, когда обновляется более одного параметра запроса одновременно, но при этом нет необходимости выполнять запросы отдельно при обновлении каждого параметра.
{% endhint %}

#### Вложенные тэги тэга `<Parameter>` <a href="#tags_sql_query_parameters_parameter" id="tags_sql_query_parameters_parameter"></a>

* **Value** - значение параметра. Обязательный тэг. Ожидается любое значение;
* **IfNull** - значение, которое будет передано в качестве значение параметра, если последний в тэге `<Value>` имеет значение NULL. Необязательный тэг. Ожидается любое значение;
* **IfEmpty** - значение, которое будет передано в качестве значение параметра, если последний в тэге `<Value>` имеет значение "". Необязательный тэг. Ожидается любое значение.

#### Тэг `<Filter>` <a href="#sql_query_filter" id="sql_query_filter"></a>

Фильтр полученных данных.

Фильтрация происходит без повторных запросов в базу данных.

Необязательный тэг. Значение тэга `<Filter>`: список тэгов [`<And>`](#sql_query_filter_and), [`<Or>`](#sql_query_filter_or) и [`<Not>`](#sql_query_filter_not) или тэги [`<Field>`](#sql_query_filter_field), [`<Value>`](#sql_query_filter_value) и [`<DataType>`](#sql_query_filter_data_type).

```xml
<Filter>
  <And RefreshFilter="True">
    <Or RefreshFilter="True">
      <Filter Type="Equal" FilterByNullValue="True" RefreshFilter="True" Reverse="True">
        <Field NativeName="FieldName1" />
        <Value>Value</Value>
        <DataType Type="DataTypeName" />
        <Enabled>True</Enabled>
      </Filter>
      <Filter Type="Equal" FilterByNullValue="True" RefreshFilter="True" Reverse="True">
        <Field NativeName="FieldName2" />
        <Value>Value</Value>
        <Enabled>True</Enabled>
      </Filter>
    </Or>
    <Not RefreshFilter="True">
      <Filter Type="Equal" FilterByNullValue="True" RefreshFilter="True" Reverse="True">
        <Field NativeName="FieldName3" />
        <Value>Value</Value>
        <DataType Type="DataTypeName" />
        <Enabled>True</Enabled>
      </Filter>
    </Not>
  </And>
</Filter>
```

#### Атрибуты тэга `<Filter>` <a href="#attributes_tag_sql_query_filter" id="attributes_tag_sql_query_filter"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Type</td><td><p>Тип сравнения значений.</p><p></p><p>Необязательный атрибут. Ожидается название одного из <a href="#filter_types">типов сравнения</a> значений.</p><p></p><p>Если атрибут <code>Type</code> отсутствует, то используется значение Equal.</p></td></tr><tr><td align="center">FilterByNullValue</td><td><p>Признак, определяющий, будет ли осуществляться фильтрация для очередной строки соединения с данными, если значение фильтра будет равно NULL.</p><p></p><p>Необязательный атрибут. Ожидается логическое значение.</p><p></p><p>Если атрибут <code>FilterByNullValue</code> отсутствует, то используется значение True.</p></td></tr><tr><td align="center">RefreshFilter</td><td><p>Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении параметра фильтра.</p><p>Признак не работает для фильтров, содержащих внутри себя тэги <a href="#sql_query_filter_and"><code>&#x3C;And></code></a>, <a href="#sql_query_filter_or"><code>&#x3C;Or></code></a> или <a href="#sql_query_filter_not"><code>&#x3C;Not></code></a>, для таких фильтров данные обновляются всегда.</p><p></p><p>Необязательный атрибут. Ожидается логическое значение.</p><p></p><p>Если атрибут <code>RefreshFilter</code> отсутствует, то используется значение True.</p></td></tr><tr><td align="center">Reverse</td><td><p>Признак, определяющий, будет ли изменён порядок аргументов фильтра на обратный.</p><p></p><p>Необязательный атрибут. Ожидается логическое значение.</p><p></p><p>Если атрибут <code>Reverse</code> отсутствует, то используется значение False.</p></td></tr></tbody></table>

#### Типы сравнения значений <a href="#filter_types" id="filter_types"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Equal</td><td>Сравнение значений на равенство</td></tr><tr><td align="center">NotEqual</td><td>Сравнение значений на неравенство</td></tr><tr><td align="center">Greater</td><td>Сравнение значений на "больше": значение из соединения с данными больше указанного значения</td></tr><tr><td align="center">NotGreater</td><td>Сравнение значений на "не больше": значение из соединения с данными не больше указанного значения</td></tr><tr><td align="center">Less</td><td>Сравнение значений на "меньше": значение из соединения с данными меньше указанного значения</td></tr><tr><td align="center">NotLess</td><td>Сравнение значений на "не меньше": значение из соединения с данными не меньше указанного значения</td></tr><tr><td align="center">Contains</td><td>Сравнение значений на "содержит": значение из соединения с данными содержит указанное значение (значения любых типов данных преобразуются к строковому типу)</td></tr><tr><td align="center">NotContains</td><td>Сравнение значений на "не содержит": значение из соединения с данными не содержит указанное значение (значения любых типов данных преобразуются к строковому типу)</td></tr><tr><td align="center">In</td><td>Сравнение значений на "входит": значение из соединения с данными входит в указанный массив</td></tr><tr><td align="center">NotIn</td><td>Сравнение значений на "не входит": значение из соединения с данными не входит в указанный массив</td></tr><tr><td align="center">Overlap</td><td>Сравнение значений на "пересекается": массив из соединения с данными имеет общие элементы с указанным массивом</td></tr><tr><td align="center">NotOverlap</td><td>Сравнение значений на "не пересекается": массив из соединения с данными не имеет общих элементов с указанным массивом</td></tr><tr><td align="center">MatchSearch</td><td>Сравнение значений на "удовлетворяет поисковой строке": поисковая строка может состоять из слов, разделенных пробелами и знаками "+", "*" и "?"<em>,</em> пробел означает "ИЛИ", "+" означает "И", "*" означает любое количество любых символов, "?" означат ровно один символ</td></tr><tr><td align="center">NotMatchSearch</td><td>Сравнение значений на "не удовлетворяет поисковой строке": поисковая строка может состоять из слов, разделенных пробелами и знаками "+", "*" и "?"<em>,</em> пробел означает "ИЛИ", "+" означает "И", "*" означает любое количество любых символов, "?" означат ровно один символ</td></tr><tr><td align="center">ContainedIn</td><td>Сравнение значений на "входит": значение из соединения с данными входит в указанное значение (значения любых типов данных преобразуются к строковому типу)</td></tr><tr><td align="center">NotContainedIn</td><td>Сравнение значений на "не входит": значение из соединения с данными не входит в указанное значение (значения любых типов данных преобразуются к строковому типу)</td></tr></tbody></table>

#### Тэг `<And>` <a href="#sql_query_filter_and" id="sql_query_filter_and"></a>

Логическое умножение нескольких фильтров.

Необязательный тэг. Значение тэга `<And>`: список тэгов [`<Filter>`](#sql_query_filter), `<And>`, [`<Or>`](#sql_query_filter_or) и [`<Not>`](#sql_query_filter_not).

#### Атрибуты тэга `<And>` <a href="#attributes_tag_sql_query_filter_and" id="attributes_tag_sql_query_filter_and"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">RefreshFilter</td><td><p>Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении вложенного фильтра.</p><p></p><p>Необязательный атрибут. Ожидается логическое значение.</p><p></p><p>Если атрибут <code>RefreshFilter</code> отсутствует, то используется значение True.</p></td></tr></tbody></table>

#### Тэг `<Or>` <a href="#sql_query_filter_or" id="sql_query_filter_or"></a>

Логическое сложение нескольких фильтров.

Необязательный тэг. Значение тэга `<Or>`: список тэгов [`<Filter>`](#sql_query_filter), [`<And>`](#sql_query_filter_and), `<Or>` и [`<Not>`](#sql_query_filter_not).

#### Атрибуты тэга `<Or>` <a href="#attributes_tag_sql_query_filter_or" id="attributes_tag_sql_query_filter_or"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">RefreshFilter</td><td><p>Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении вложенного фильтра.</p><p></p><p>Необязательный атрибут. Ожидается логическое значение.</p><p></p><p>Если атрибут <code>RefreshFilter</code> отсутствует, то используется значение True.</p></td></tr></tbody></table>

#### Тэг `<Not>` <a href="#sql_query_filter_not" id="sql_query_filter_not"></a>

Логическое отрицание одного фильтра.

Необязательный тэг. Значение тэга `<Not>`: тэг [`<Filter>`](#sql_query_filter), [`<And>`](#sql_query_filter_and), [`<Or>`](#sql_query_filter_or) и `<Not>`.

#### Атрибуты тэга `<Not>` <a href="#attributes_tag_sql_query_filter_not" id="attributes_tag_sql_query_filter_not"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">RefreshFilter</td><td><p>Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении вложенного фильтра.</p><p></p><p>Необязательный атрибут. Ожидается логическое значение.</p><p></p><p>Если атрибут <code>RefreshFilter</code> отсутствует, то используется значение True.</p></td></tr></tbody></table>

#### Тэг `<Field>` <a href="#sql_query_filter_field" id="sql_query_filter_field"></a>

Поле, по значению которого полученные данные фильтруются.

Обязательный тэг. Значение тэга `<Field>`: не ожидается.

#### Атрибуты тэга `<Field>` <a href="#attributes_tag_sql_query_filter_field" id="attributes_tag_sql_query_filter_field"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">NativeName</td><td><p>Название поля, по значению которого полученные данные фильтруются.</p><p></p><p>Обязательный атрибут. Ожидается название одного из полей, описанных в тэге <a href="#sql_query_fields"><code>&#x3C;Fields></code></a>.</p></td></tr></tbody></table>

#### Тэг `<Value>` <a href="#sql_query_filter_value" id="sql_query_filter_value"></a>

Значение, по которому полученные данные фильтруются.

Обязательный тэг. Ожидается любое значение.

#### Тэг `<DataType>` <a href="#sql_query_filter_data_type" id="sql_query_filter_data_type"></a>

[Тип данных](https://wfsys.gitbook.io/workflow-mobile-forms-syntax/workflow_mobile_forms/dataconnections/broken-reference), к которому приводятся сравниваемые значения.

Необязательный тэг. Значение тэга `<DataType>`: не ожидается.

Если тэг `<DataType>` отсутствует, то для атрибута `Type` используется значение StringDataType.

#### Атрибуты тэга `<DataType>` <a href="#attributes_tag_sql_query_filter_data_type" id="attributes_tag_sql_query_filter_data_type"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Type</td><td><p>Название типа данных.</p><p></p><p>Обязательный атрибут. Ожидается название одного из типов данных, поддерживаемых формой.</p></td></tr></tbody></table>

#### Тэг `<Enabled>` <a href="#sql_query_filter_enabled" id="sql_query_filter_enabled"></a>

Признак, определяющий, будет ли использоваться данный фильтр.

Необязательный тэг. Ожидается логическое значение.

### UpdateInterval <a href="#update_interval" id="update_interval"></a>

Интервал автоматического обновления первичного соединения с данными.

Необязательный тэг. Ожидается логическое значение.

Если значение тэга `<UpdateInterval>` пустое, то используется значение True.

```xml
<UpdateInterval Hours="" Minutes="" Seconds="">True</UpdateInterval>
```

#### Атрибуты тэга `<UpdateInterval>` <a href="#attributes_tag_update_interval" id="attributes_tag_update_interval"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="459.3333333333333"></th></tr></thead><tbody><tr><td align="center">Hours</td><td><p>Интервал в часах.</p><p></p><p>Обязательный атрибут. Ожидается целое положительное числовое значение.</p></td></tr><tr><td align="center">Minutes</td><td><p>Интервал в минутах.</p><p></p><p>Необязательный атрибут. Ожидается целое положительное числовое значение.</p></td></tr><tr><td align="center">Seconds</td><td><p>Интервал в секундах.</p><p></p><p>Необязательный атрибут. Ожидается целое положительное числовое значение.</p></td></tr></tbody></table>

### Вариант 2: с несколькими запросами <a href="#option_2_multiple_query" id="option_2_multiple_query"></a>

```xml
<DataConnection Name="PrimaryGetDataConnectionName" Type="PrimaryGetDataConnection" Assembly="DataConnections">
  <!--Тэги, специфичные для PrimaryGetDataConnection-->
</DataConnection>
```

### Тэги, специфичные для PrimaryGetDataConnection <a href="#option_2_tags_primary_dc" id="option_2_tags_primary_dc"></a>

### SqlQueries <a href="#sql_queries" id="sql_queries"></a>

Запросы для получения данных.

Обязательный тэг. Значение тэга `<SqlQueries>`: список тэгов [`<SqlQuery>`](#sql_query).

Описание тэга [`<SqlQuery>`](#sql_query) смотри в варианте 1.

## Get-проперти для получения свойств <a href="#get_property_primary_dc" id="get_property_primary_dc"></a>

### Count <a href="#get_count" id="get_count"></a>

Возвращает количество строк, возвращенных определенным запросом загружающего соединения с данными.

Значение тэга `<Property>`: ожидается имя одного из запросов указанного загружающего соединения с данными.

Если значение тэга `<Property>` равно NULL, то по умолчанию используется первый запрос.

```xml
<DataConnection SourceDataConnection="PrimaryGetDataConnectionName">
  <Property Name="Count">SqlQueryName</Property>
</DataConnection>
```