Ссылочные поля
Используйте поля типа Reference, чтобы соединить различные записи друг с другом. Эти поля извлекают значения из таблицы, на которую ссылаются, например, поле Часовой пояс ссылается на таблицу Часовые пояса (sys_timezone).
В SimpleOne поле сопровождается иконкой лупы , открывающей справочник, и иконкой плюса , открывающей окно создания новой записи в таблице, на которую ссылается поле.
Создание новой записи через поле типа Reference доступно на форме.
Чтобы создать недостающую запись в таблице, на которую ссылается поле, выполните следующие шаги:
- Нажмите на иконку плюса .
- В модальном окне заполните поля.
- Нажмите Сохранить.
Обратите внимание, что новая запись будет создана в таблице, на которую ссылается поле. Если в таблице Инциденты вы создали поле типа Reference, которое ссылается на таблицу Задачи, то запись будет создана в таблице Задачи, а не в Инциденты.
На списках для таких полей доступно встроенное редактирование.
Используйте следующие типы колонок для создания ссылки:
- Reference
- List
Учтите ограничения по использованию dot-walking для полей типа List:
- Не используйте dot-walking c цепочкой больше одного поля для построения условий в конструкторе.
- Не используйте dot-walking при настройке представления списков и форм.
| Reference | List | |
|---|---|---|
| Описание | Ссылается на запись в указанной таблице. Хранит ID записи.  | Ссылается на несколько записей в указанной таблице. Хранит ID записей. |
| Скалярный тип | int8 | text |
| Критерии проверки | Вы можете использовать следующий диапазон целочисленных значений: [-9223372036854775808 … 9223372036854775807] | Все элементы должны быть отделены запятой. |
Иногда в полях типа Reference вместо значений записей отображаются ID. Значения не могут быть показаны из-за образовавшихся циклов.
Например, поле ссылается на таблицу с колонкой, у которой активен атрибут Отображаемое поле. Эта колонка также может быть типа Reference. В какой-то момент, следующая колонка может отсылать к таблице, которая уже была просмотрена. Это значит, что образовался цикл и невозможно определить отображаемое значение в начальном поле. Показанный ID – это способ перейти к необходимой записи.
Создание поля типа Reference
При создании поля типа Reference, кроме обязательных, нужно заполнить следующие поля:
- Настройка типа
- Определитель ссылок
- Значение по умолчанию
| Поле | Обязательно | Описание |
|---|---|---|
| Ссылка | Да | Укажите таблицу со значениями, которые вам необходимы. |
| При удалении | Нет | Выберите действие, которое буд ет выполняться при удалении записи, на которую есть ссылка. Доступные варианты выбора:
Не забудьте задать значение по умолчанию в секции Значение по умолчанию, если выбрана опция Присвоить значение по умолчанию. В случае, если значение по умолчанию не установлено, а ссылочная запись удалена, ссылка на запись будет удалена из поля (значение будет равно null). |
Удаление записи А приведет к ошибке обновления ссылаемой на нее записи Б, если колонка, которая ссылается на запись А, является обязательной, а действие при удалении установлено Присвоить NULL.
Невозможно обновить запись {link}, так как она ссылается на удаленную запись
| Поле | Обязательно | Описание |
|---|---|---|
| Тип определителя ссылок | Нет | Укажите тип определителя ссылок:
|
| Условия определителя ссылок | Нет | Настройте фильтры, используя конструктор условий. Поле появляется, когда выбран Простой тип определителя ссылок. |
| Динамический определитель ссылок | Нет | Выберите динамический определитель ссылок из списка. Поле появляется, когда выбран Динамический тип определителя ссылок. |
| Зафиксировать определитель | Нет | Установите флажок, чтобы зафиксировать фильтр в навигационной цепочке. Эта функция блокирует использование конструктора условий. |
| Поле | Обязательно | Описание |
|---|---|---|
| Значение по умолчанию | Да/Нет | Укажите значение по умолчанию. Если в поле При удалении выбрана опция Присвоить значение по умолчанию, будет использоваться значение из этого поля. |
Определитель ссылок
Определитель ссылок позволяет создавать фильтры для выборки данных по определенным условиям и возврата их в поля типа Reference.
Эти поля хранят ID записей определенной таблицы. То есть это поле содержит ссылку на записи и поля в указанной таблице.
Определитель ссылок может состоять из:
- ссылки на таблицу.
- типа определителя ссылок.
- условия определителя ссылок, созданных с помощью конструктора условий.
- опций динамических фильтров.
Вы можете создать определитель ссылок для самой таблицы и ее дочерних таблиц, указав определитель ссылок при создании поля.
Вы также можете изменить определитель ссылок в расширенных таблицах через переопределение полей. Для каждого поля, формы или таблицы может быть задан только один определитель ссылок.
Существует два метода использования определителя ссылок:
- Простой
- Динамический
Простой определитель ссылок
В простом определители ссылок для настройки фильтров используются утверждения И/ИЛИ. Используйте их для несложных условий фильтрации. Например, чтобы отфильтровать только активных пользователей в справочнике Пользователи И/ИЛИ только компании из тихоокеанского часового пояса из справочника Компании. Подробнее о фильтрах читайте в статье Конструктор условий.
Чтобы создать простой определитель ссылок, выполните следующие шаги:
- Перейдите в Настройка системы → Все колонки.
- Найдите колонку, для которой вам нужно создать определитель ссылок, используя поля поиска над списком.
- Нажмите на секцию Определитель ссылок.
- Из выпадающего списка выберите Простой тип определителя.
- Укажите условия для определителя, используя конструктор условий. Вы можете задавать сложные фильтры, используя несколько И и ИЛИ в одном условии.
- (опционально) Установите флажок Зафиксировать определитель, чтобы закрепить условие в навигационной цепочке. Активный атрибут заблокирует возможность использования конструктора условий.
Динамический определитель ссылок
Чтобы создать динамический определитель ссылок, выполните следующие шаги:
- Перейдите в Настройка системы → Все колонки.
- Найдите колонку, для которой вам нужно создать определитель ссылок, используя поля поиска над списком.
- Нажмите на секцию Определитель ссылок.
- Из выпадающего списка выберите Динамический тип определителя.
- Укажите динамический фильтр в поле Динамический определитель ссылок, которое ссылается на таблицу Настройки динамических фильтров.
- (опционально) Установите флажок Зафиксировать определитель, чтобы закрепить условие в навигационной цепочке. Активный атрибут заблокирует возможность использования конструктора условий.
Пример использования
В какой-то таблице есть поле Назначено на, которое ссылается на таблицу Пользователи (user). По умолчанию, когда вы начинаете печатать какое-то значение в поле, отображаются все значения таблицы в автозаполнении и можно выбрать любое из них. Это происходит потому, что не задан определитель ссылок, который ограничивал бы количество выдаваемых результатов. Вы можете выбрать любого пользователя, из любого отдела, из любого города и даже неактивных пользователей (например, ушедших на пенсию). Чтобы избежать таких случаев, используйте определитель ссылок, как описано ниже, или так, как этого требует решение вашей задачи.
Вам необходимо ограничить список пользователей, которые могут быть назначены на выполнение задач (их имя указано в поле Назначено на). Например, задачи могут быть назначены только сотруднику службы поддержки.
Чтобы настроить определитель ссылок, выполните следующие шаги:
- Откройте форму записи, которая содержит нужное вам поле.
- Правой кнопкой мыши нажмите на заголовок поля Назначено на и выберите Настройка поля в контекстном меню.
- На форме колонки, перейдите во вкладку Определитель ссылок.
- Настройте определитель ссылок:
- Тип определителя ссылок – Простой
- У словия определителя ссылок – [Отдел] [равно] [Служба поддержки]
- Нажмите Сохранить или Сохранить и выйти.
Чтобы убедиться, что настройки были выполнены верно, введите имя пользователя, который не является сотрудником службы поддержки. Автозаполнение не предоставит никаких результатов.
Полезно знать
- Убедитесь, что все пользователи имеют доступ к полю, в которое вы добавляете определитель. Иначе, определитель скроет записи для пользователей, у которых нет доступа к указанному полю из-за правил контроля доступа (ACL).
- Секция Определитель ссылок доступна только для полей типа Reference и List. Для полей других типов используйте опции конструктора условий.
- Длина условия для таких полей ограничена, поэтому имеет смысл использовать условия вида (название_поля=значение) вместо поиска записи по ID в массиве.