Skip to main content
Механизм «Ссылка-вложение» позволяет прикрепить внешний веб-адрес к любому объекту — например, к заказу, клиенту или единице оборудования. Привязка устроена так же, как у прочих вложений. Полный перечень полей — в глоссарии ссылок.

​
Логика

Поля записи: При создании клиент передаёт обязательный веб-адрес, вид родительского объекта и его идентификатор; название можно не указывать. Компания, автор («Кем создано») и дата создания проставляются автоматически. Поля с собственным идентификатором записи, датой создания и автором доступны только для чтения; идентификатор родительского объекта клиент указывает сам.
Поле «Компания» заполняется автоматически из контекста запроса при создании — клиент не может задать его вручную и не может создать ссылку от имени другой компании.
Список ссылок возвращается без постраничной разбивки (в пределах компании и применённых фильтров), от новых к старым. Доступна фильтрация по автору, по идентификатору объекта и по типу объекта (по имени вида объекта, можно несколько).
Чтобы получить все ссылки конкретного объекта, комбинируйте фильтр по виду объекта и фильтр по идентификатору объекта — вместе они однозначно указывают на нужную запись-родителя.
При удалении компании все её ссылки удаляются автоматически; ссылка также удаляется при удалении соответствующего типа объекта. При этом удаление самого родительского объекта не обязательно удаляет прикреплённую к нему ссылку — связь с объектом вычисляемая, поэтому осиротевшие ссылки просто перестают указывать на существующий объект.

​
Кто что может

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