Синтаксис и применение Ссылка в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
Ссылка (Ref)
Ссылка (Ref)
Тип: ВнешнийИсточникДанныхТаблицаСсылка.<Имя внешнего источника>.<Имя таблицы внешнего источника данных>.
Содержит ссылку на элемент таблицы внешнего источника данных.
Примечание:
Доступно только для объектных таблиц.
Методическая информация
Практические примеры
Запросить ссылку, представление и реальные поля своей внешней таблицы
Динамические имена и поля относятся к точной своей схеме SQL, метаданным УчебныеКниги и подготовленной строке. Объектные и необъектные данные не смешиваются.
Где и как запускать
Тело процедуры своей кнопки обычной формы, толстый клиент Windows: перед основным кодом блок собственного соединения.
Подготовка
Только собственный локальный SQL Server и отдельная учебная база 1С без рабочих внешних источников. SQL-блок выполните вручную в SSMS своего экземпляра: он создаёт новую GuideExternalBooks и две собственные таблицы. Если имя уже занято, существующую базу не удаляйте и не заменяйте.
В ODBC Data Sources разрядности серверного процесса 1С создайте собственный System DSN GuideOwnBooks: ваш localhost SQL Server, база GuideExternalBooks, Windows-аутентификация. Пользователь серверного процесса 1С должен иметь доступ только к этой учебной базе. Настройте нормальное доверие сертификату драйвера, проверку TLS не отключайте.
В Конфигураторе создайте ВнешниеИсточникиДанных → УчебныеКниги, автоматическое управление блокировками. Таблица Карточки: имя dbo.lesson_items, тип ОбъектныеДанные, ТолькоЧтение Ложь; Код=book_id Строка20, Название=title Строка100, Количество=quantity Число9.0. Null запрещён, ПоляКлюча и ПоляБлокировкиДанных — Код, представление — Название.
Таблица Строки: имя dbo.lesson_lines, тип НеобъектныеДанные, ТолькоЧтение Ложь; Урок=lesson_id Строка20, Номер=line_no Число9.0, Название=title Строка100, Количество=quantity Число9.0. Null запрещён, поля ключа / блокировки — Урок и Номер именно в этом порядке.
Основной блок и блок соединения выполните в теле одной процедуры кнопки собственной обычной формы, толстый клиент Windows. Сначала настройка своего сеансового соединения, затем основной блок. Управляемая форма и её обработчики здесь не нужны.
Толстый клиент выбран явно: публичный Прочитать менеджера записи внешней таблицы в установленной справке доступен только ему. Не переносите этот вызов в серверную процедуру по аналогии с обычным регистром сведений.
Источник и DSN принадлежат только этой учебной задаче. Пример закрывает только это собственное соединение. Данные SQL предварительно созданы вручную и дальше только читаются.
Попытка
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Данные.Ссылка, Данные.Представление, Данные.Название, Данные.Количество
|ИЗ ВнешнийИсточникДанных.УчебныеКниги.Таблица.Карточки КАК Данные
|ГДЕ Данные.Код = &Код";
Запрос.УстановитьПараметр("Код", "BOOK-1");
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
Сообщить(Строка(Выборка.Ссылка));
Сообщить(Выборка.Представление);
Сообщить(Выборка.Название + ": " + Строка(Выборка.Количество));
КонецЦикла;
Исключение
Источник.РазорватьСоединение();
ВызватьИсключение;
КонецПопытки;
Источник.РазорватьСоединение();Вручную в своём SSMS: новые учебные таблицы и две строки, не BSL
CREATE DATABASE GuideExternalBooks;
GO
USE GuideExternalBooks;
GO
CREATE TABLE dbo.lesson_items (
book_id nvarchar(20) NOT NULL PRIMARY KEY,
title nvarchar(100) NOT NULL,
quantity numeric(9,0) NOT NULL
);
CREATE TABLE dbo.lesson_lines (
lesson_id nvarchar(20) NOT NULL,
line_no numeric(9,0) NOT NULL,
title nvarchar(100) NOT NULL,
quantity numeric(9,0) NOT NULL,
PRIMARY KEY (lesson_id, line_no)
);
INSERT INTO dbo.lesson_items VALUES (N'BOOK-1', N'Учебная книга', 3);
INSERT INTO dbo.lesson_lines VALUES (N'LESSON-1', 1, N'Учебная строка книги', 3);Перед основным блоком в той же процедуре толстого клиента: только своё соединение
Источник = ВнешниеИсточникиДанных.УчебныеКниги;
Параметры = Источник.ПолучитьПараметрыСоединенияСеанса();
Параметры.СУБД = "MSSQLServer";
Параметры.СтрокаСоединения = "DSN=GuideOwnBooks;";
Параметры.АутентификацияОС = Истина;
Параметры.АутентификацияСтандартная = Ложь;
Параметры.ИмяПользователя = "";
Параметры.Пароль = "";
Источник.УстановитьПараметрыСоединенияСеанса(Параметры);
Источник.УстановитьСоединение();Разбор по шагам
Создайте вручную собственный SQL-источник и точное отображение его двух таблиц.
Установите собственное соединение и получите конкретный менеджер / ключ / ссылку / набор.
Прочитайте настоящие поля или измените только свой буфер, затем закройте собственное соединение.
Как проверить результат
У объектной таблицы Карточки доступны Ссылка и Представление, а Название / Количество происходят из её конкретных отображённых полей.
Условие ограничивает запрос собственным BOOK-1. Это язык запросов 1С, а не вставка SQL-имён dbo.lesson_items в текст запроса 1С.
Представление настроено по Название. Поле Ссылка не обещается у таблицы Строки с НеобъектныеДанные.
Ожидаемый результат
Именованный доступ и поля внешней таблицы показаны с настоящим источником, ключом и явным объектным / необъектным видом.
На что обратить внимание
Не добавляйте в этот пример запись или удаление внешних строк; он предназначен для чтения и собственного буфера.
Прочитать менеджера записи не следует автоматически считать доступным на сервере: выбран толстый клиент по установленной справке.
SQL, DSN, подключения и BSL здесь не выполнялись; это ручная подготовка только собственной учебной среды.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.