Платформа 3V/Формы/Источники данных/Справочник/Фильтрация/По параметру
Содержание
СТРАНИЦА НАХОДИТСЯ В РАЗРАБОТКЕ
Фильтр EntryParameterFilterDto позволяет выбрать данные в справочнике по заданному параметру. Например, выбрать элемент справочника с конкретным id. Элемент "filter" добавляется в источник, который необходимо отфильтровать. Фильтр имеет следующую структуру:
1 "filter": {
2 "parameterId": 1,
3 "attribute": {
4 "id": 1,
5 "discriminator": "OwnAttributeDefinitionDto"
6 },
7 "conditionType": "AttributeInCollection",
8 "inversion": false,
9 "conditionId": null,
10 "discriminator": "EntryParameterFilterDto"
11 }
Описание свойств выражений
| Свойство | Описание |
|---|---|
| parameterId | id параметра |
| attribute | Атрибут текущего источника - справочника, элемент которого будет выбран по заданному параметру. Указывается номер Id и тип атрибута в данном случае собственный (OwnAttributeDefinitionDto), так как используются данные текущего справочника. |
| discriminator | EntryParameterFilterDto |
| conditionType | Тип условий |
| inversion | В значении "false" фильтр отберет удовлетворяющие ему значения, в значении "true" - все значения, которые наоборот не удовлетворяют ему |
| conditionId | Условия, при которых применяется фильтр |
Далее необходимо описать параметр в соответствующем разделе json:
1 "parameters": [
2 {
3 "id": 1,
4 "name": "Объект",
5 "defaultValue": [7]
6 }
7 ]
Где id=1, соответствуют номеру, который указан в parameterId.
Особенности работы карточек с фильтром по параметру
Фильтр EntryParameterFilterDto предполагает два сценария работы карточки:
1. Выбери записи справочника по параметру,
2. Запись новых элементов справочника.
Если в карточку приходит не пустое значение параметра, но отрабатывается первый сценарий, если же значение параметра пустое, то карточка откроется на редактирование, и в справочнике можно будет создать новый элемент, при условии что свойство справочника "агаisReadOnly" имеет значение "false".
Пример
Показать запись из справочника "Контрагенты" по параметру ParameterId=1. В пользовательскую карточку приходит значение параметра, в данном случае оно задано по умолчанию, справочник "Контрагенты" фильтруется по данному параметру и показывает соответствующую запись.