> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yume.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Вложения: Ссылки

> Прикрепление внешних веб-адресов к любому объекту системы с привязкой к компании.

Механизм «Ссылка-вложение» позволяет прикрепить внешний веб-адрес к любому объекту — например, к заказу, клиенту или
единице оборудования. Привязка устроена так же, как у прочих [вложений](/ru/logic/attachments).

Полный перечень полей — в [глоссарии ссылок](/ru/logic/attachments/links-glossary).

## Логика

**Поля записи:**

| Поле                  | Тип        | Назначение                                                                                                           |
| --------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- |
| Название              | текст      | Необязательная подпись ссылки                                                                                        |
| Веб-адрес             | ссылка     | Обязательный внешний адрес                                                                                           |
| Тип объекта           | связь      | Вид родительского объекта (в API — по имени вида объекта)                                                            |
| Идентификатор объекта | число      | Номер конкретного родительского объекта                                                                              |
| Дата создания         | дата/время | Заполняется автоматически в момент создания                                                                          |
| Кем создано           | связь      | Пользователь, добавивший ссылку. При удалении этого пользователя ссылка остаётся, а авторство становится неизвестным |

При создании клиент передаёт обязательный веб-адрес, вид родительского объекта и его идентификатор; название можно не
указывать. Компания, автор («Кем создано») и дата создания проставляются автоматически. Поля с собственным
идентификатором записи, датой создания и автором доступны только для чтения; идентификатор родительского объекта клиент
указывает сам.

<Note>
  Поле «Компания» заполняется автоматически из контекста запроса при создании — клиент не может задать его вручную и не
  может создать ссылку от имени другой компании.
</Note>

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

<Tip>
  Чтобы получить все ссылки конкретного объекта, комбинируйте фильтр по виду объекта и фильтр по идентификатору объекта —
  вместе они однозначно указывают на нужную запись-родителя.
</Tip>

При удалении компании все её ссылки удаляются автоматически; ссылка также удаляется при удалении соответствующего типа
объекта. При этом удаление самого родительского объекта не обязательно удаляет прикреплённую к нему ссылку — связь с
объектом вычисляемая, поэтому осиротевшие ссылки просто перестают указывать на существующий объект.

## Кто что может

Все операции со ссылками доступны **только авторизованному сотруднику**: анонимный запрос получает отказ по авторизации,
в том числе на чтение списка и на создание.

Изменять и удалять конкретную ссылку может **только её автор** — тот, кто её добавил, — либо **владелец компании**
(суперпользователь компании). Остальные сотрудники компании чужую ссылку править и удалять не могут: они получают отказ
по правам доступа. Ограничение действует и на изменение, и на удаление.

<Note>
  Авторство ссылки — настоящая связь с пользователем, а не просто записанное число: целостность гарантируется базой данных.
  Если пользователя, добавившего ссылку, удалить, сама ссылка остаётся на месте, а её авторство становится неизвестным
  («без автора») — вместе с этим доступ на изменение остаётся только у владельца компании.
</Note>