Page History

Условия

...

фильтрации

...

передаются

...

списком

...

FilterContainer:

...

{

...

NextFilterLogicOperationType,

...

FilterType,

...

Value

...

}

...

.

...

FilterType определяет

...

вид

...

фильтра

...

(таблица

...

ниже),

...

Value —

...

его

...

параметры

...

в

...

формате,

...

специфичном

...

для

...

конкретного

...

FilterType.

...

Глобальные

...

фильтры

...

...

Логические операции

Между фильтрами (NextFilterLogicOperationType) и между условиями внутри PropertyFilter (NextLogicOperationType) допустимы: And, Or. Эти поля можно передавать как null (или опускать), если фильтр единственный либо последний в цепочке.

Типы операций PropertyFilter (OperationType)

Пример фильтра

[
 |
| --- | --- |
| `RouteFilter` | Фильтр по дорогам. Для сущностей, связанных с дорогами (интерфейс `IRoutIdEntity`), фильтрует по полю `routeId`. Для самой сущности дороги (`Route`) ищет указанные Id в полях `Id` и `JunctionId` (через ИЛИ). |
| `RegionFilter` | Фильтр по регионам. Для сущности региона (`Region`) ищет указанные Id в поле `Id`. Для прочих геометрических сущностей берёт геометрию указанных регионов и фильтрует по пересечению (`Intersect`). |
| `PolygonFilter` | Геометрический фильтр по полигонам. Работает только для геометрических сущностей — ищет вхождение в полигон (`Intersect`). |
| `GeometryAttributeFilter` | Фильтр по типам геометрии (`Point`/`Polygon`/`Linestring`). Работает только для геометрических сущностей. Указанный тип считается эквивалентным своему `Multi`-варианту (например, `Point` включает и `MultiPoint`). |
| `DataSourceGeometryFilter` | Фильтр по геометрии сущностей другого источника данных. Значение — список объектов ``{ DataSourceId, Filter (вложенный список `FilterContainer` для сущности этого источника), GeometryOperationType, Buffer, FilterBuffer }``. `GeometryOperationType` задаёт геометрическое отношение (`Intersects`/`Contains`/`Disjoint`/`Equals`/`Touches`/`Covers`/`Within`) между текущей сущностью (с буфером `Buffer`) и геометриями отфильтрованных сущностей источника (с буфером `FilterBuffer`). Работает только для геометрических сущностей; источник не может фильтровать сам себя. |
| `PropertyFilter` | Фильтрация по значениям полей сущности. При фильтрации по полям-словарям указывается имя поля-идентификатора (например, `BusStopTypeId`), а не значение классификатора. |
| `ProjectFilter` | Фильтр по проектам. Для сущностей, связанных с проектами (интерфейс `IProjectEntity`), фильтрует по полю `ProjectId`. |
## Логические операции
Между фильтрами (`NextFilterLogicOperationType`) и между условиями внутри `PropertyFilter` (`NextLogicOperationType`) допустимы: `And`, `Or`.
Эти поля можно передавать как `null` (или опускать), если фильтр единственный либо последний в цепочке.
## Типы операций PropertyFilter (OperationType)
| OperationType | Описание | Ограничения |
| --- | --- | --- |
| `Eq` | Равно (сравнение 1:1). | Все типы полей; допускает явный `null`. |
| `Neq` | Не равно. | Как `Eq`, с отрицанием. |
| `Lt` / `Le` | Меньше / меньше или равно. | Недопустимо для `String` и `Guid`; `null` не допускается и строки со значением `null` из БД не учитываются. |
| `Gt` / `Ge` | Больше / больше или равно. | Недопустимо для `String` и `Guid`; `null` не допускается. |
| `In` / `NIn` | Вхождение в массив значений (аналог `Eq`/`Neq` по массиву). | `In` — неявное ИЛИ между значениями, `NIn` — неявное И. |
| `Like` / `NLike` | Подстрока (аналог `contains`), регистронезависимо. | Только `String`; `null` не допускается. |
| `StartWith` / `NStartWith` | Начинается с подстроки. | Только `String`; `null` не допускается. |
| `EndWith` / `NEndWith` | Заканчивается подстрокой. | Только `String`; `null` не допускается. |
## Пример фильтра
```json
[
  { "NextFilterLogicOperationType": "And", "FilterType": "RouteFilter", "Value": ["3d8b5e7c-7637-4c52-a51b-7e1cf10d04e7"] },

  { "NextFilterLogicOperationType": "And", "FilterType": "ProjectFilter", "Value": ["3d8b5e7c-7637-4c52-a51b-7e1cf10d04e7"] },

  { "NextFilterLogicOperationType": "And", "FilterType": "RegionFilter", "Value": ["3d8b5e7c-7637-4c52-a51b-7e1cf10d04e7"] },

  { "NextFilterLogicOperationType": "And", "FilterType": "PolygonFilter", "Value": { "Srid": 4326, "Geometries": [ { "type": "Polygon", "coordinates": [[[55.893821,49.333641],[55.891733,49.328927],[55.899957,49.316499],[55.90215,49.322116],[55.893821,49.333641]]] } ] } },

  { "NextFilterLogicOperationType": "And", "FilterType": "GeometryAttributeFilter", "Value": { "type": ["Point", "Polygon"] } },

  { "NextFilterLogicOperationType": "Or", "FilterType": "DataSourceGeometryFilter", "Value": [ { "DataSourceId": "3d8b5e7c-7637-4c52-a51b-7e1cf10d04e7", "GeometryOperationType": "Intersects", "Buffer": 0, "FilterBuffer": 0, "Filter": [] } ] },

  { "NextFilterLogicOperationType": "And", "FilterType": "PropertyFilter", "Value": [

    { "NextLogicOperationType": "Or",  "PropertyName": "Name",       "OperationType": "Eq",        "Value": "Andrey" },

    { "NextLogicOperationType": "And", "PropertyName": "Name",       "OperationType": "Like",      "Value": "I" },

    { "NextLogicOperationType": "And", "PropertyName": "Name",       "OperationType": "StartWith", "Value": "I" },

    { "NextLogicOperationType": "And", "PropertyName": "Name",       "OperationType": "EndWith",   "Value": "y" },

    { "NextLogicOperationType": "And", "PropertyName": "Number",     "OperationType": "Gt",        "Value": "10" },

    { "NextLogicOperationType": "Or",  "PropertyName": "Number",     "OperationType": "Lt",        "Value": "100" },

    { "NextLogicOperationType": "None","PropertyName": "NumberUrns", "OperationType": "In",        "Value": ["5","8","10"] }

  ] }

]
```
> 

Пример

...

показывает

...

все

...

семь

...

FilterType и

...

все

...

семь

...

условий

...

PropertyFilter в

...

виде

...

валидного

...

JSON

...

без

...

//

...

-комментариев

...

и

...

висячих

...

запятых.

...

Правила

...

и

...

ограничения

Обработка

...

ошибок

...

фильтрации

...

строгая

...

—

...

нарушение

...

контракта

...

приводит

...

к

...

ошибке

...

запроса:

...

• Вызов

...

• без

...

• filterId предфильтрации

...

• и

...

• без

...

• самой

...

• фильтрации

...

• возвращает

...

• все

...

• данные

...

• (актуально

...

• только

...

• внутри

...

• бэкенда).

...

• Некорректный

...

• JSON

...

• в

...

• значении

...

• контейнера

...

• фильтра

...

• вызывает

...

• ошибку.

...

• Отсутствующий

...

• FilterType (

...

• null)

...

• вызывает

...

• ошибку.

...

• NextFilterLogicOperationType со

...

• значением

...

• null в

...

• середине

...

• логической

...

• цепочки

...

• вызывает

...

• ошибку.

...

• Некорректный

...

• JSON

...

• в

...

• Value вызывает

...

• ошибку.

...

• Все

...

• значения

...

• (числа,

...

• даты)

...

• передаются

...

• строками

...

• —

...

• для

...

• единообразия.