SmartDCIM

Фильтры аварии

Фильтры аварии

Фильтры аварии ​

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

Фильтры аварий имеют следующую структуру:

json
"filter": [
    [
        // filter
    ]
],
...

Для объединения фильтров можно использовать логические операторы $and и $or (И и ИЛИ соответственно):

json
"filter": [
    [
        "$and",
        [
            [
                "$or",
                [
                    [
                        // filter
                    ],
                    [
                        // filter
                    ]
                ]
            ],
            [
                // filter
            ],
            [
                // filter
            ]
        ]
    ]
],
...

Доступные фильтры ​

Замените // filter в примерах выше чтобы использовать следующие фильтры.

Фильтры аварий ​

Следующие фильтры используются для работы с полями аварии.

Время регистрации ​

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

json
"timestamp",
{
  "from": 1660734896160,
  "to": 1660738496160
}

Время аварии ​

Этот фильтр используется для получения аварий, которые произошли в промежуток времени, указанный в переменных from и to (от и до соответственно).

json
"localTimestamp",
{
  "from": 1660133723209,
  "to": 1660738523209
}

Время погашения ​

Этот фильтр используется для получения аварий, которые были погашены в промежуток времени, указанный в переменных from и to (от и до соответственно).

json
"clearTimestamp",
{
  "from": 1660734972645,
  "to": 1660738572645
}

Сущность ​

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

ID сущности должно иметь префикс objects-... для объектов и links-... для связей.

json
"entity",
"objects-61576794877b1d7a1f43c59e"

Критичность ​

Этот фильтр используется для получения аварий с указанной критичностью.

json
"severity",
// Array of severity IDs
[
  1,
  ...,
  "5c0f67acf2a9273067af328f"
]

Текст ​

Этот фильтр используется для получения аварий, поле text которых подходит под заданное условие.

Доступные логические операции:

  • Равно: _eq
  • Не равно: _neq
  • Совпадает: _m
  • Содержит: _ct
  • Не содержит: _nct
json
"text",
{
  "value": "Text",
  "op": "_eq"
}

Подтверждение аварии ​

Этот фильтр используется для получения аварий, которые были подтверждены заданным пользователем.

json
"acknowledgedBy",
"5a0b26b8c9a7733f56b01a16"// ID of a user who acknowledged an incident

Комментарий ​

Этот фильтр используется для получения аварий, которые содержат комментарий, который подходит под заданное условие.

Доступные логические операции:

  • Равно: _eq
  • Не равно: _neq
  • Совпадает: _m
  • Содержит: _ct
  • Не содержит: _nct
json
"comment",
{
  "value": "Comment",
  "op": "_eq"
}

Время изменения состояний ​

Этот фильтр используется для получения аварий, сущность которых обновляла своё Состояние в промежуток времени, указанный в переменных from и to (от и до соответственно).

json
"lastStateUpdate",
{
  "from": 1660736721329,
  "to": 1660740321329
}

Сравнение полей ​

Этот фильтр используется для получения аварий, поля которых подходят под заданное сравнение.

Поля, доступные для сравнения:

  • Время регистрации аварии: timestamp
  • Время возникновения аварии: localTimestamp
  • Время погашения аварии: clearTimestamp
  • Последнее время обновления состояния сущности: lastStateUpdate
  • Время создания сущности: created

Доступные логические операции:

  • Равно: _eq
  • Не равно: _neq
  • Совпадает: _m
  • Содержит: _ct
  • Не содержит: _nct
json
[
  "timestamp",
  "clearTimestamp"
],
"_eq"

Фильтры сущности ​

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

Класс ​

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

json
"classId",
"591c4ea02d84db763e226ced"// ID of the class

Свойство ​

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

Доступные логические операции:

  • Равно: _eq
  • Не равно: _neq
  • Совпадает: _m
  • Содержит: _ct
  • Не содержит: _nct
json
"property",
{
    "value": "value",
    "property": "property_name",
    "op": "_neq"
}

Состояние ​

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

json
"stateId",
// Array of state IDs
[
  "1",
  ...
  "591c4ea02d84db763e226ced"
]

Теги ​

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

json
"tags",
"583c54b8a9d2d27713e1be22"

Смотрите также ​