Платформа 3V/Формы/Источники данных/Справочник/Фильтрация/По значению в элементе управления

Фильтр EntryUiFilter позволяет фильтровать данные справочника по значению элемента управления.
Структура фильтра:

 1 "filter": {
 2         "uiSourceId": 1,
 3         "attribute": {
 4           "id": 2,
 5           "discriminator": "OwnAttributeDefinitionDto"
 6         },
 7         "conditionType": "ContainsString",
 8         "inversion": false,
 9         "conditionId": null,
10         "discriminator": "EntryUiFilter"
11       },

Тип данных в элементе управления должен совпадать с типом данных в атрибуте справочника по которому идет фильтрация.

Описание свойств фильтра

Свойство	Описание
uiSourceId	Номер элемента управления (контрола) от значения которого идет фильтрация
attribute	Атрибут текущего источника, с которым сравнивается значение в контроле. Указывается номер Id и тип атрибута в данном случае собственный (OwnAttributeDefinitionDto), так как используются данные текущего справочника.
conditionType	Тип условий
inversion	В значении "false" источник-справочник принимает значения, которые удовлетворяют фильтру, в значении "true" - все значения, которые наоборот не удовлетворяют ему
"conditionExpressionId": 1	Выражение с условиями, при которых применяется фильтр
discriminator	EntryUiFilter

Пример:

В поле "Наименование" введен искомый текст, в поле "Контрагенты" отфильтрованы элементы списка, содержащие данный текст.

Для этого необходимо:

1. Добавить Текстовое поле "Наименование", в которое мы будем вводить искомое значение
2. Добавить источник, который требуется отфильтровать от Текстового поля и настроить фильтр указанный выше

Примечание: При необходимости фильтровать сразу после ввода значения в текстовом поле необходимо указать "Выполнить действие при изменении значения": true ("doActionOnChangeValue"). При необходимости применения фильтрации по кнопке, требуется отключить флаг, добавить кнопку и добавить на нее действие по обновлению источника-справочника "Контрагенты"

развернуть

JSON серверной карточки

 1 {
 2   "id": 10928,
 3   "name": "Пример фильтра по значению в контроле (EntryUiFilter)",
 4   "description": null,
 5   "title": "Пример фильтра по значению в контроле",
 6   "entrySettings": null,
 7   "uiSources": [
 8     {
 9       "id": 1,
10       "caption": "Наименование",
11       "enable": true,
12       "visible": true,
13       "hint": null,
14       "doActionOnChangeValue": true,
15       "onAfterChangeValueConditionalActions": null,
16       "onAfterChangeValueByClientConditionalActions": null,
17       "rebuildDependentsObjectOnChange": true,
18       "enableRuleIds": [],
19       "visibleRuleIds": [],
20       "access": null,
21       "isValueChanged": true,
22       "expressionId": null,
23       "discriminator": "StringSourceEntry"
24     },
25     {
26       "trimSpaces": false,
27       "defaultValue": null,
28       "value": null,
29       "id": 2,
30       "caption": "Контрагент",
31       "enable": true,
32       "visible": true,
33       "hint": null,
34       "doActionOnChangeValue": false,
35       "onAfterChangeValueConditionalActions": null,
36       "onAfterChangeValueByClientConditionalActions": null,
37       "rebuildDependentsObjectOnChange": true,
38       "enableRuleIds": [],
39       "visibleRuleIds": [],
40       "access": null,
41       "isValueChanged": false,
42       "dataSourceId": 3,
43       "discriminator": "DictionarySourceEntry",
44       "hasMultipleValue": true
45     }
46   ],
47   "entryDataSources": [
48     {
49       "dictionaryId": 10755,
50       "hierarchyId": null,
51       "filter": {
52         "uiSourceId": 1,
53         "attribute": {
54           "id": 2,
55           "discriminator": "OwnAttributeDefinitionDto"
56         },
57         "conditionType": "ContainsString",
58         "inversion": false,
59         "conditionId": null,
60         "discriminator": "EntryUiFilterDto"
61       },
62       "sortingOptions": null,
63       "groupingOptions": null,
64       "dictionaryAttributes": [],
65       "defaultValue": [],
66       "defaultValueExpressionId": null,
67       "parameterId": null,
68       "dictionarySourceSelectionMode": "SelectAll",
69       "dataSourceAttributesAdditionsSettings": [],
70       "externalFileStorageUrl": null,
71       "filePrefix": null,
72       "defaultNewElementSettings": null,
73       "id": 3,
74       "name": "Контрагенты",
75       "isReadOnly": false,
76       "dataEditRuleIds": [],
77       "beforeSaveDataActions": [],
78       "afterSaveDataActions": [],
79       "discriminator": "DictionaryDataSource"
80     }
81   ],
82   "parameters": [],
83   "binaryConditionsRules": [],
84   "submitValidateRules": [],
85   "expressions": [],
86   "controlsValueCalculateRules": [],
87   "actions": [],
88   "conditionActionIdsOnOpen": [],
89   "conditionalActions": [],
90   "selectionSets": [],
91   "reportTemplates": [],
92   "useNewDependenciesBuilder": null
93 }