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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
 
(не показано 10 промежуточных версий 2 участников)
Строка 1: Строка 1:
!!! СТРАНИЦА НАХОДИТСЯ В РАЗРАБОТКЕ !!!
+
Фильтр выберет из справочника элементы, у которых значение указанного атрибута совпадают с заданным значением в фильтре.
<br>
 
Фильтр выберет из справочника элементы, атрибуты которых совпадают с заданным значением.
 
 
<syntaxhighlight lang="JSON" line>
 
<syntaxhighlight lang="JSON" line>
 
  "filter": {
 
  "filter": {
Строка 15: Строка 13:
 
         "conditionType": "AttributeInCollection",
 
         "conditionType": "AttributeInCollection",
 
         "inversion": false,
 
         "inversion": false,
         "conditionId": null,
+
         "conditionExpressionId": null,
         "discriminator": "ValueConditionalDictionaryFilterDto"
+
         "discriminator": "ValueConditionalDictionaryCardsFilter"
 
       },
 
       },
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 23: Строка 21:
 
|-
 
|-
 
! Свойство !! Описание
 
! Свойство !! Описание
 +
|-
 +
| inversion || В значении "false" источник-справочник принимает значения, которые удовлетворяют фильтру, в значении "true" - все значения, которые наоборот не удовлетворяют ему
 
|-
 
|-
| value || значение с которым будет сравниваться значение атрибута фильтруемого справочника. Форматы данных должны совпадать.
+
| discriminator|| ValueConditionalDictionaryCardsFilter
 
|-
 
|-
 
| attribute|| [[Платформа_3V/Справочник/Связи_атрибутов_справочников|''' Атрибут''']] текущего источника, с которым будет сравниваться заданное значение. Указывается номер Id и тип атрибута в данном случае собственный (OwnAttributeDefinitionDto), так как используются данные текущего справочника.
 
| attribute|| [[Платформа_3V/Справочник/Связи_атрибутов_справочников|''' Атрибут''']] текущего источника, с которым будет сравниваться заданное значение. Указывается номер Id и тип атрибута в данном случае собственный (OwnAttributeDefinitionDto), так как используются данные текущего справочника.
|-
 
| discriminator|| ValueConditionalDictionaryFilterDto
 
 
|-  
 
|-  
 
| conditionType || Тип условий
 
| conditionType || Тип условий
 +
|-
 +
| value || значение с которым будет сравниваться значение атрибута фильтруемого справочника. Форматы данных должны совпадать.
 
|-  
 
|-  
| inversion || В значении "false" фильтр отберет удовлетворяющие ему значения, в значении "true" - все значения, которые наоборот не удовлетворяют ему
+
| [[ Платформа_3V/Формы/Выражения|'''conditionExpressionId''']]|| Выражение с условием, при которых применяется фильтр (выражение должно возвращать true или false)
|-
 
| conditionId || [[Платформа_3V/Формы/Правила| '''Условия''']], при которых применяется фильтр  
 
 
|}
 
|}
  
 
== Пример: ==
 
== Пример: ==
В данном примере справочник "Контрагенты" отфильтрован по значению атрибута "Вид".
+
В данном примере справочник "Контрагенты" отфильтрован по значению атрибута "Вид".  
 
[[Файл:Screenshot 2021-04-20 at 16.29.17.png|обрамить|слева]]
 
[[Файл:Screenshot 2021-04-20 at 16.29.17.png|обрамить|слева]]
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
+
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
  
Атрибут "Вид" связный, в нем хранятся идентификаторы справочника "Вид контрагентов".
+
Атрибут "Вид" связный, в нем хранятся идентификаторы справочника "Виды контрагентов". Фильтр выбирает элементы со значениями 1,2 и 3.
 
[[Файл:Screenshot 2021-04-20 at 16.32.29.png|обрамить|слева]]
 
[[Файл:Screenshot 2021-04-20 at 16.32.29.png|обрамить|слева]]
 +
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
 +
 +
В справочнике "Виды контрагентов" этим значениям соответствуют Индивидуальный предприниматель (физ. лицо), Индивидуальный предприниматель (юр. лицо) и Публичное акционерное общество.
 
[[Файл:Screenshot 2021-04-20 at 16.34.44.png|обрамить|слева]]
 
[[Файл:Screenshot 2021-04-20 at 16.34.44.png|обрамить|слева]]
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
+
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
 +
Для этого соответственно настроить фильтр, где "value" - это id элементов "Виды контрагентов", "attribute" - это id фильтруемого атрибута "Вид контрагента" спр."Контрагенты" (который мы фильтруем) и "conditionType": "AttributeInCollection" - чтобы атрибут проверялся на наличие элемента из коллекции прописанных в "value"
 +
 
 +
<syntaxhighlight lang="JSON" line>
 +
"filter": {
 +
        "value": [
 +
          1,
 +
          2,
 +
          3
 +
        ],
 +
        "attribute": {
 +
          "id": 21,
 +
          "discriminator": "OwnAttributeDefinitionDto"
 +
        },
 +
        "conditionType": "AttributeInCollection",
 +
        "inversion": false,
 +
        "conditionId": null,
 +
        "discriminator": "ValueConditionalDictionaryCardsFilter"
 +
      },
 +
</syntaxhighlight>
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">
Строка 53: Строка 73:
 
{
 
{
 
   "id": 10826,
 
   "id": 10826,
   "name": "Пример фильтра по значениям (ValueConditionalDictionaryFilterDto)",
+
   "name": "Пример фильтра по значениям (ValueConditionalDictionaryCardsFilter)",
 
   "description": null,
 
   "description": null,
 
   "title": "Пример фильтрации по конкретному значению",
 
   "title": "Пример фильтрации по конкретному значению",
Строка 97: Строка 117:
 
         "inversion": false,
 
         "inversion": false,
 
         "conditionId": null,
 
         "conditionId": null,
         "discriminator": "ValueConditionalDictionaryFilterDto"
+
         "discriminator": "ValueConditionalDictionaryCardsFilter"
 
       },
 
       },
 
       "sortingOptions": null,
 
       "sortingOptions": null,

Текущая версия на 03:25, 21 апреля 2022

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

 1  "filter": {
 2         "value": [
 3           1,
 4           2,
 5           3
 6         ],
 7         "attribute": {
 8           "id": 21,
 9           "discriminator": "OwnAttributeDefinitionDto"
10         },
11         "conditionType": "AttributeInCollection",
12         "inversion": false,
13         "conditionExpressionId": null,
14         "discriminator": "ValueConditionalDictionaryCardsFilter"
15       },

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

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

Пример:

В данном примере справочник "Контрагенты" отфильтрован по значению атрибута "Вид".

Screenshot 2021-04-20 at 16.29.17.png


















Атрибут "Вид" связный, в нем хранятся идентификаторы справочника "Виды контрагентов". Фильтр выбирает элементы со значениями 1,2 и 3.

Screenshot 2021-04-20 at 16.32.29.png



























В справочнике "Виды контрагентов" этим значениям соответствуют Индивидуальный предприниматель (физ. лицо), Индивидуальный предприниматель (юр. лицо) и Публичное акционерное общество.

Screenshot 2021-04-20 at 16.34.44.png

















Для этого соответственно настроить фильтр, где "value" - это id элементов "Виды контрагентов", "attribute" - это id фильтруемого атрибута "Вид контрагента" спр."Контрагенты" (который мы фильтруем) и "conditionType": "AttributeInCollection" - чтобы атрибут проверялся на наличие элемента из коллекции прописанных в "value"

 1  "filter": {
 2         "value": [
 3           1,
 4           2,
 5           3
 6         ],
 7         "attribute": {
 8           "id": 21,
 9           "discriminator": "OwnAttributeDefinitionDto"
10         },
11         "conditionType": "AttributeInCollection",
12         "inversion": false,
13         "conditionId": null,
14         "discriminator": "ValueConditionalDictionaryCardsFilter"
15       },
JSON серверной карточки