Тип: ВнешнийИсточникДанныхТаблицаМенеджер.<Имя внешнего источника>.<Имя таблицы внешнего источника данных>. Предоставляет доступ к менеджеру таблицы по имени.
Полное описание, параметры и ограничения
ВнешнийИсточникДанныхТаблицыМенеджер.<Имя внешнего источника>.<Имя таблицы> (ExternalDataSourceTablesManager.<External source name>.<Имя таблицы>)
ВнешнийИсточникДанныхТаблицыМенеджер.<Имя внешнего источника> (ExternalDataSourceTablesManager.<External source name>)
<Имя таблицы> (<Имя таблицы>)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: ВнешнийИсточникДанныхТаблицаМенеджер.<Имя внешнего источника>.<Имя таблицы внешнего источника данных>.
Предоставляет доступ к менеджеру таблицы по имени.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Прочитать поля своей внешней карточки через менеджер, ссылку и объект
Динамические имена и поля относятся к точной своей схеме 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-источник и точное отображение его двух таблиц.
Установите собственное соединение и получите конкретный менеджер / ключ / ссылку / набор.
Прочитайте настоящие поля или измените только свой буфер, затем закройте собственное соединение.
Как проверить результат
Получены Учебная книга и количество 3 из существующего BOOK-1; объект и ссылка относятся к одной собственной строке.
Источник.УчебныеКниги и Таблицы.Карточки — именованные менеджеры из конкретных метаданных, а не произвольно созданные структуры.
ПолучитьОбъект проверяется на Неопределено: наличие сконструированной ссылки само не доказывает существование строки.
Ожидаемый результат
Именованный доступ и поля внешней таблицы показаны с настоящим источником, ключом и явным объектным / необъектным видом.
На что обратить внимание
Не добавляйте в этот пример запись или удаление внешних строк; он предназначен для чтения и собственного буфера.
Прочитать менеджера записи не следует автоматически считать доступным на сервере: выбран толстый клиент по установленной справке.
SQL, DSN, подключения и BSL здесь не выполнялись; это ручная подготовка только собственной учебной среды.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.