Ссылочные связи

Ссылочные атрибуты (Reference Attributes) позволяют связывать сущности из разных шаблонов, создавая реляционные связи, аналогичные внешним ключам (Foreign Keys) в базах данных.

---

Распространенные примеры из реальной жизни

Исходный шаблон	Ссылочное поле	Целевой шаблон	Пример реляционной связи
Заявка в поддержку	Клиент	Профиль клиента	Заявка №104 → ООО “Вектор”
Серверный узел	Дата-центр	Площадка	prod-db-01 → US-East Region
Заказ	Товар	Каталог товаров	Заказ №5021 → Беспроводные наушники
Инцидент	Ответственный	Сотрудник	Инцидент №88 → Анна Иванова

---

1. Как работают ссылочные атрибуты

При настройке ссылочного атрибута вы указываете:

1. Целевой шаблон: Шаблон, сущности которого будут доступны для выбора (например, Профиль клиента).
2. Целевой отображаемый атрибут: Поле целевого шаблона, служащее понятным заголовком в выпадающих списках и сводных таблицах (например, Название компании).

flowchart LR
    subgraph Сущность Заявка
        T1["Заявка №104"]
        T2["Статус: Открыта"]
        T3["Приоритет: Высокий"]
    end

    subgraph Ссылочная связь
        T1 -->|Ссылается на| C1
    end

    subgraph Сущность Клиент
        C1["ООО Вектор"]
        C2["Контакт: Анна"]
        C3["Тариф: Enterprise"]
    end

---

2. Пошаговая настройка ссылки

1. Перейдите в Моделирование данных → Атрибуты.
2. Нажмите + Создать атрибут.
3. Укажите Название (например, Закрепленный клиент).
4. Установите Тип атрибута в значение Ссылка (Reference).
5. На панели Конфигурация ссылки:
   • Выберите Целевой шаблон (например, Профиль клиента).
   • Выберите Целевой атрибут для отображения (например, Название компании).
6. Нажмите Сохранить изменения.
7. Прикрепите атрибут Закрепленный клиент к исходному шаблону (например, Заявка в поддержку).

---

3. Работа со ссылками в формах сущностей

После прикрепления ссылочного атрибута к шаблону:

• При создании или редактировании сущности появится выпадающий список поиска с целевыми сущностями.
• На странице деталей сущности клик по ссылке выполняет переход к деталям связанной сущности.
• В таблицах поиска сущностей можно фильтровать записи по связанным ссылкам (например, Показать все Заявки, где Клиент = ООО Вектор).

---

💡 Примечание для разработчиков

[!NOTE] Реляционная целостность и запросы API: Ссылки хранят UUID целевой сущности. При запросе сущностей через OpenAPI (GET /api/v1/entity/template/{templateId}) идентификаторы ссылок разрешаются без проблемы N+1 SQL-запросов, возвращая как сырой ID, так и значение отображаемого атрибута.

---

Следующие шаги

[!TIP]

• Освойте создание и редактирование сущностей в разделе Операции с Сущностями → Создание и редактирование.
• Выполняйте сложную фильтрацию по ссылкам в Поиске и фильтрах.