Создание и редактирование сущностей

Сущность (Entity) представляет собой запись данных, созданную по определенному Шаблону (например, конкретный сервер prod-app-01, клиент ООО Вектор или тикет #104).

1. Создание Сущности в UI

Перейдите в Операции с Сущностями → Сущности в боковом меню.
Выберите целевой шаблон в Шлюзе шаблонов (например, Серверный узел).
Нажмите + Создать сущность.
Динамическая форма ввода отобразит все прикрепленные атрибуты:
- Измерения: Текстовые поля, даты, флаги и выпадающие списки.
- Метрики: Начальные числовые значения (например, Начальная загрузка CPU % или Баланс).
- Ссылки: Выпадающие списки поиска, указывающие на целевые сущности.
Нажмите Сохранить.

Список сущностей и интерфейс деталей сущности

2. Вкладки рабочего пространства сущности

При выборе сущности из списка откроется рабочее пространство с тремя вкладками:

Атрибуты: Просмотр и редактирование текущих значений каждого измерения, метрики, элемента списка и ссылки. Поля скомпонованы в структурированные карточки секций на основе Групп атрибутов шаблона (как показано на карточке сущности справа на /assets/SH-020.png) с отображением иконок, заголовков и выбранной сетки на 1 или 2 колонки.
История: Просмотр неизменяемого журнала аудита каждого изменения с деталями: что изменилось, когда и кем.
График: Анализ интерактивных графиков временных рядов для числовых метрик за выбранный период.

3. Динамическая валидация полей

Omnismith автоматически валидирует ввод атрибутов при сохранении:

Обязательные поля: Гарантирует заполнение обязательных измерений и ссылок.
Безопасность типов данных: Проверяет числовые диапазоны, форматы дат (ГГГГ-ММ-ДД), метки времени ISO и элементы списков.
Целостность ссылок: Проверяет существование и активность ссылочных целевых сущностей.

4. Программная загрузка через слаги и REST API

Omnismith позволяет внешним системам, агентам и конвейерам CI/CD создавать и обновлять сущности с помощью слагов:

Создание сущности по слагам

Отправляйте запрос напрямую на /api/v1/entities, указывая template_slug и attribute_slug:

curl -X POST "https://api.omnismith.io/api/v1/entities" \
  -H "Authorization: Bearer omni_live_secret_key_12345" \
  -H "Content-Type: application/json" \
  -d '{
    "template_slug": "server_node",
    "attribute_values": [
      {
        "attribute_slug": "hostname",
        "value": "web-prod-03"
      },
      {
        "attribute_slug": "cpu_usage",
        "value": "72.4"
      }
    ]
  }'

Получение сущностей со значениями по слагам

При чтении сущности добавьте параметр ?attribute_key=slug, чтобы получить словарь атрибутов, индексированный строковыми слагами вместо UUID:

curl -X GET "https://api.omnismith.io/api/v1/entities/{entityId}?attribute_key=slug" \
  -H "Authorization: Bearer omni_live_secret_key_12345"

{
  "id": "019fe207-38eb-7182-9a5f-70cdaeea34f2",
  "template_slug": "server_node",
  "attribute_values": {
    "hostname": {
      "value": "web-prod-03",
      "attribute_slug": "hostname"
    },
    "cpu_usage": {
      "value": "72.4",
      "attribute_slug": "cpu_usage"
    }
  }
}