Синтаксис и применение Ссылка в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
Ссылка (Ref)
Ссылка (Ref)
Ссылки на выбранные объекты, входящие в отбор.
Методическая информация
Практические примеры
Найти свою записку по ссылке через настоящий критерий отбора
Создаём собственную карточку и документ, связанный с ней. Таблица критерия получает именно ссылку карточки и возвращает ссылки входящих в состав отбора документов.
Где и как запускать
Тело серверной процедуры собственной учебной обработки; критерий и оба вида данных явно созданы в отдельной учебной конфигурации.
Подготовка
В отдельной пустой учебной конфигурации создайте неиерархический справочник УчебныеКарточкиКритерия: строковый код 10 с автонумерацией, наименование 100.
Создайте документ УчебнаяЗапискаКритерия: строковый номер 12 с автонумерацией, проведение не требуется. Добавьте реквизит Карточка типа СправочникСсылка.УчебныеКарточкиКритерия.
В Общие → Критерии отбора создайте УчебныеДокументыПоКарточке. Тип отбора — СправочникСсылка.УчебныеКарточкиКритерия. В Состав включите реквизит Документ.УчебнаяЗапискаКритерия.Карточка.
Обновите только учебную базу. Основной код выполняйте в теле серверной процедуры своей обработки. Он создаёт новые собственные данные, не ищет и не изменяет рабочую номенклатуру.
Карточка = Справочники.УчебныеКарточкиКритерия.СоздатьЭлемент();
Карточка.Наименование = "Собственная книга критерия";
Карточка.Записать();
Документ = Документы.УчебнаяЗапискаКритерия.СоздатьДокумент();
Документ.Дата = Дата(2026, 10, 15);
Документ.Карточка = Карточка.Ссылка;
Документ.Записать();
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Связанные.Ссылка КАК Ссылка
|ИЗ КритерийОтбора.УчебныеДокументыПоКарточке(&Карточка) КАК Связанные";
Запрос.УстановитьПараметр("Карточка", Карточка.Ссылка);
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
Сообщить("Своя связанная записка: " + Строка(Выборка.Ссылка));
КонецЦикла;Разбор по шагам
Создаём собственную карточку и сохраняем её, чтобы получить действительную ссылку.
Создаём свою записку и указываем в ней эту ссылку.
Передаём ссылку обязательным параметром таблицы критерия и читаем ссылки результата после Следующий.
Как проверить результат
Результат содержит ссылку на созданную свою записку, у которой Карточка совпадает с параметром.
В параметр передаётся СправочникСсылка, не строка с наименованием и не объект СправочникОбъект.
Если реквизит не включён в состав критерия, платформа не обязана найти записку только по похожему имени реквизита.
Ожидаемый результат
Критерий отбора использован с реальным типом параметра, подготовленным составом и собственными связанными данными.
На что обратить внимание
Критерий не ищет произвольный текст по всем объектам базы. Его состав и тип определены в метаданных.
Не подставляйте ссылку рабочего справочника вместо созданной собственной карточки.
При сборке HTML код 1С не исполнялся и записи в базу не выполнялись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.