Как добавлять мультиссылки запросом

Запросы в Интеграме умеют не только выбирать и фильтровать данные, но и записывать их обратно в таблицу — через поле SET у колонки. Раньше в ссылочную колонку запросом можно было положить только одну ссылку. Теперь, благодаря недавним изменениям, в мультиссылочное поле можно одним запросом присвоить сразу целый набор ссылок.

В этой заметке — короткий мануал, как это делается.

Что такое мультиссылочное поле

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

Включается мультивыбор в настройках колонки-ссылки: одна запись может содержать несколько значений справочника.

Короткая суть

Чтобы записать запросом сразу набор ссылок:

1. Соберите нужные значения в одну строку.
2. Перечислите их через запятую.
3. Заключите всё в квадратные скобки: [значение1,значение2,значение3].
4. Поставьте эту строку в поле SET мультиссылочной колонки.

Интеграм разберёт строку на отдельные значения и сохранит их как множество ссылок.

Синтаксис

В поле SET мультиссылочной колонки указывается набор значений в квадратных скобках:

[Тонер,картридж,xerox,phaser,6700,черный]

Каждое значение из этого списка станет отдельной ссылкой записи. Скобки и запятые — это разделители: они не сохраняются, а лишь помогают Интеграму понять, где заканчивается одно значение и начинается следующее.

Как это работает

Получив строку в квадратных скобках, Интеграм:

1. Разбивает её на отдельные значения по разделителям.
2. Ищет каждое значение в справочнике, на который ссылается колонка.
3. Берёт ID найденного значения — если такое значение в справочнике уже есть.
4. Создаёт новое значение в справочнике — если его там ещё нет, и использует ID новой записи.
5. Записывает все полученные ID как отдельные ссылки одной записи — по строке на каждую ссылку.

Два приятных следствия:

• Справочник пополняется сам. Не нужно заранее заводить все значения вручную — отсутствующие Интеграм добавит автоматически. Это особенно удобно при токенизации и разметке данных.
• Дубликаты схлопываются. Если в списке значение встречается дважды (в том числе в разном регистре — Черный и черный), ссылка создаётся одна.

Откуда брать сам набор

Чаще всего набор значений не пишут руками, а получают формулой прямо в поле SET. Подойдёт любое выражение, которое возвращает строку со значениями через запятую: CONCAT, GROUP_CONCAT, REGEXP_REPLACE и другие функции.

Хороший пример — токенизация наименований: регулярное выражение разбивает название товара на отдельные слова через запятую, а результат отправляется в мультиссылочное поле «Токен». Каждое слово становится ссылкой на справочник токенов, а новые слова добавляются в справочник автоматически. Подробно этот сценарий разобран в статье «Сопоставление каталогов продукции в конструкторе Интеграм» — именно механизм мультиссылок и делает её токенизацию возможной.

ID или значение

В поле SET можно опираться и на ID, и на значение:

• Одиночную ссылку удобно задавать по ID — числом. Интеграм найдёт запись справочника по этому ID и проставит ссылку.
• Набор ссылок в квадратных скобках сопоставляется по значениям: каждый элемент списка ищется в справочнике по тому тексту, который в нём отображается. Поэтому для множества естественнее перечислять именно значения, а не идентификаторы.

Подводные камни

• Разделяйте значения запятыми. Разделителем считается любой символ, кроме букв, цифр и пробела. Пробелы внутри значения сохраняются, поэтому [ООО Ромашка,ИП Иванов] — это две корректные ссылки. А вот знаки пунктуации внутри значения (кавычки, дефисы, слэши) разорвут его на части, так что их лучше избегать в самих значениях.
• Проверьте результат перед записью. Запрос показывает предпросмотр: какие ссылки будут добавлены или изменены (#ID значение, #ID значение, …). Изменения применяются только после подтверждения или при настроенном автоматическом выполнении запроса.

Итог

Мультиссылки запросом — это короткий путь от «сырой» строки к структурированному множеству ссылок. Соберите значения, перечислите через запятую, заключите в квадратные скобки, поставьте в SET — и Интеграм сам найдёт нужные записи справочника, заведёт недостающие и сохранит всё как набор ссылок. Никакого программирования: достаточно понимать логику запросов.