Настройка правил нормализации для интеграций

В данном разделе приведена инструкция по добавлению правил нормализации для интеграций с внешними системами.

Подробная информация о работе с правилами нормализации приведена в разделе Правила нормализации.

О правилах нормализации

В контексте интеграций с внешними системами правила нормализации используются для преобразования исходных данных о сущности во внешней системе в формат, который требуется для добавления информации о сущности в домен. Например:

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

В системе предустановлены правила нормализации данных об ИБ-активах, например:

Account.isassets.rvision.ru.Accounts — правило нормализации данных об ИБ-активах типа Учетные записи;
BusinessProcess.isassets.rvision.ru.BusinessProcesses — правило нормализации данных об ИБ-активах типа Бизнес-процессы;
Software.isassets.rvision.ru.Software — правило нормализации данных об ИБ-активах типа ПО.

Просмотреть код этих правил можно в разделе Экспертиза.

Добавление правила нормализации

Чтобы добавить правило нормализации для интеграции, выполните следующие действия:

Перейдите в раздел Экспертиза веб-интерфейса R-Vision VM. Система отобразит сведения об имеющихся элементах экспертизы.
Нажмите на кнопку Создать и выберите из выпадающего списка пункт Правило нормализации. Система отобразит окно создания правила нормализации.

Заполните поля правила нормализации, чтобы определить логику его работы.

Подробная информация о структуре правил нормализации приведена в разделе Работа с элементами экспертизы, а справка о языке VRL — в разделе Справочник по языку преобразования данных VRL.

Ниже приведен пример правила Account.isassets.rvision.ru.Accounts:

id: Account.isassets.rvision.ru.Accounts
name: Правило нормализации для учетных записей
type: normalization_rule
description: ""
version: 1.0.0
status: stable
date: "2026-04-14"
tags:
  - Accounts
  - entity
author: R-Vision

filter: !vrl |
  true

normalizer: !vrl |
  if is_null(.login){.accountLogin="Нет данных"} else {.accountLogin = .login }
  if is_null(.name){.accountName="Нет данных"} else {.accountName = .name }
  .SID = .sid
  .accountCreatedAt = .createdAt
  if .sources == null { .sources = [] }
  .accountSource = join!(.sources, separator: ", ")
  .accountLastUse = .lastUse
  .accountPwdSet = .pwdSet
  .UpdatedAt = .updatedAt
  .accountDomainAd = .domainAd
  .accountGroupAd = .groupAd

Интерпретация правила:

id — идентификатор правила нормализации в разделе Экспертиза.
name — человекочитаемое имя правила.
type — тип элемента экспертизы.
description — опциональное описание правила.
version — версия правила в формате Semantic Versioning.
status — текстовое обозначение статуса правила.
date — дата последнего обновления правила.
tags — теги для быстрого поиска правила в разделе Экспертиза.
author — идентификатор автора правила.
filter — выражение для фильтрации на языке VRL. Для интеграций всегда имеет значение true.
normalizer — блок кода на языке VRL, который определяет преобразование входных данных в выходные.

Перед идентификатором каждого поля следует ставить точку, например, .login.

Пример преобразования поля Логин:
```
if is_null(.login){.accountLogin="Нет данных"} else {.accountLogin = .login }
```
Здесь:
- login — идентификатор поля или столбца, содержащего логин пользователя, в импортируемом файле.
- is_null — функция проверки, которая возвращает true, если в поле login отсутствует значение.
- accountLogin — идентификатор поля Логин сущности Учетная запись в схеме домена ИБ-активы.
Интерпретация преобразования: если поле login в строке исходного файла не заполнено, то свойство Логин импортируемой учетной записи примет значение Нет данных, иначе ему будет присвоено значение поля login.

Нажмите на кнопку Опубликовать версию. Система создаст правило нормализации и отобразит соответствующее уведомление. Новое правило появится в таблице раздела Экспертиза.
Включите созданное правило нормализации:
1. Выберите созданное правило нормализации в списке. Откроется карточка этого правила.
2. Переведите переключатель состояния правила нормализации в верхней части карточки в активное положение. Отобразится окно подтверждения включения правила нормализации.
3. Нажмите на кнопку Включить. Система включит правило нормализации и отобразит соответствующее уведомление.
Добавьте правило нормализации в таблицу Правила нормализации окна настроек интеграции.

Была ли полезна эта страница?

Обратная связь