Тип: Строка. Имя объекта метаданных.
Полное описание, параметры и ограничения
ОбъектМетаданных: ВнешнийИсточникДанных.Имя (MetadataObject: ExternalDataSource.Name)
ОбъектМетаданных: ВнешнийИсточникДанных (MetadataObject: ExternalDataSource)
Имя (Name)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Имя объекта метаданных.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Имя должно состоять из одного слова, начинаться с буквы и не содержать специальных символов, кроме «_».
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Определить владельца описания внешней таблицы
Находим именно собственную таблицу Товары. Её имя и родитель относятся к дереву конфигурации, а не к установленному соединению SQL.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте отдельную учебную конфигурацию Учебная85 без расширений, не рабочие КА2/УНФ/УТ. В Конфигураторе создайте Внешние источники данных → УчебныйВнешний → Таблицы → Товары. Строку подключения оставьте пустой: упражнения читают только метаданные, внешняя СУБД не требуется.
Для таблицы задайте вид Таблица, тип ОбъектныеДанные, имя в источнике guide_books, ТолькоЧтение=Истина. В её Полях создайте Код (Строка 20, имя book_code), Наименование (Строка 100, имя book_name), Количество (Число 9.0, имя book_quantity) и Версия (Число 15.0, имя book_version). Это описание учебного источника, не команда создания SQL-таблицы.
В ПоляКлюча и ПоляБлокировкиДанных включите Код, ПолеПредставления=Наименование, ПолеВерсииДанных=Версия, ПолеРодителя не задавайте. ВводПоСтроке: Код и Наименование. Для Количество запретите Null, задайте заполнение 0 и Подсказку «Количество книг». Для Наименование задайте Синоним «Название книги». СозданиеПриВводе оставьте без использования.
Модули и справку оставьте пустыми, не создавайте обработчики подключения и команды записи. Обновите только эту учебную конфигурацию. Фрагменты запускайте отдельно на сервере в учебной обработке: они не обращаются к данным источника и не меняют метаданные.
Источник = Метаданные.ВнешниеИсточникиДанных.Найти("УчебныйВнешний");
Если Источник = Неопределено Тогда
ВызватьИсключение "Создайте только учебный внешний источник УчебныйВнешний";
КонецЕсли;
Таблица = Источник.Таблицы.Найти("Товары");
Если Таблица = Неопределено Тогда
ВызватьИсключение "В учебном источнике нет описания таблицы Товары";
КонецЕсли;
Сообщить(Таблица.Имя = "Товары");
Сообщить("Синоним: " + Таблица.Синоним);
Сообщить("Комментарий: " + Таблица.Комментарий);
Сообщить(Таблица.ПолноеИмя());
Сообщить(Таблица.Представление());
Родитель = Таблица.Родитель();
Если Родитель = Неопределено Тогда
ВызватьИсключение "Не получен владелец собственной учебной таблицы";
КонецЕсли;
Сообщить(Родитель.Имя = "УчебныйВнешний");
Сообщить("Принадлежность: " + Строка(Таблица.ПринадлежностьОбъекта));
Сообщить("Идентификатор заимствованного объекта: " + Строка(Таблица.ОбъектРасширяемойКонфигурации));
Сообщить(Не Таблица.ЕстьИзмененияРасширениямиКонфигурации());
Сообщить(Таблица.РасширениеКонфигурации() = Неопределено);Разбор по шагам
Поиск выполняется по заранее созданным именам: не выбирается случайный первый источник рабочей конфигурации.
Имя — имя объекта конфигурации; ПолноеИмя показывает весь путь. Синоним и Представление служат отображению человеку.
Родитель проверяется на отсутствие и указывает на метаданные УчебныйВнешний.
Принадлежность и идентификатор заимствования помогают различать собственный объект и расширение. Значение идентификатора только диагностическое.
В учебной конфигурации без расширений ожидаем отсутствие расширения и изменений ими. Это не проверка доступности SQL.
Как проверить результат
Четыре сравнения Истина; остальные строки диагностические.
Выполнение не запросило пароль внешней СУБД и не установило соединение.
Ожидаемый результат
Определён владелец и происхождение учебного описания таблицы.
На что обратить внимание
Наличие метаданных таблицы не доказывает существование таблицы guide_books во внешней БД.
В другой конфигурации с расширениями диагностические значения могут отличаться; имена учебного источника не заменяйте рабочими.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Найти свой куб и проверить владельца
Объект метаданных описывает структуру конфигурации. Имя ПродажиКниг и имя guide_book_sales во внешнем источнике — разные вещи.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Работайте в отдельной учебной конфигурации без расширений. В Конфигураторе создайте Внешние источники данных → УчебныйOLAP → Кубы → ПродажиКниг. Строку подключения оставьте пустой: ни сервер OLAP, ни пароль для этих упражнений не нужны.
Задайте кубу Синоним = Продажи учебных книг и Имя в источнике данных = guide_book_sales. В Измерениях создайте Товар, в Ресурсах Количество. Это описание источника, не создание настоящего OLAP-куба.
В Таблицах измерений куба создайте Товары: Синоним = Учебные товары, Имя в источнике данных = guide_products. Создайте два поля Ключ (Строка 20) и Наименование (Строка 100); Поле представления = Наименование. Иерархическая = Ложь, модули, справку, команды, формы и макеты оставьте пустыми.
Основные формы не назначайте, Использовать стандартные команды = Истина. Обновите только учебную конфигурацию. Каждый фрагмент отдельно вставьте в тело серверной процедуры ВыполнитьПример() Экспорт собственного учебного общего модуля.
Источник = Метаданные.ВнешниеИсточникиДанных.Найти("УчебныйOLAP");
Если Источник = Неопределено Тогда
ВызватьИсключение "Создайте собственное описание УчебныйOLAP в учебной базе";
КонецЕсли;
Куб = Источник.Кубы.Найти("ПродажиКниг");
Если Куб = Неопределено Тогда
ВызватьИсключение "Нет учебного описания куба ПродажиКниг";
КонецЕсли;
Сообщить(Куб.Имя = "ПродажиКниг");
Сообщить(Куб.Синоним = "Продажи учебных книг");
Сообщить("Комментарий: " + Куб.Комментарий);
Сообщить(Куб.ПолноеИмя());
Сообщить(Куб.Представление());
Родитель = Куб.Родитель();
Если Родитель = Неопределено Тогда
ВызватьИсключение "Не получен владелец своего куба";
КонецЕсли;
Сообщить(Родитель.Имя = "УчебныйOLAP");
Сообщить("Принадлежность: " + Строка(Куб.ПринадлежностьОбъекта));
Сообщить("Идентификатор заимствования: " + Строка(Куб.ОбъектРасширяемойКонфигурации));
Сообщить(НЕ Куб.ЕстьИзмененияРасширениямиКонфигурации());
Сообщить(Куб.РасширениеКонфигурации() = Неопределено);Разбор по шагам
Два поиска с проверками отсутствия выбирают собственное описание, не первый попавшийся рабочий источник.
Имя и Синоним сравниваются с подготовкой; ПолноеИмя показывает положение куба в дереве метаданных.
Родитель проверяется до чтения Имя. Для куба это внешний источник, а не таблица измерения.
Принадлежность и идентификатор заимствования диагностируются. При отсутствии расширений два последних сравнения истинны.
Как проверить результат
Пять Истина и диагностические подписи/путь. Пароль подключения не запрашивается.
Переименуйте учебный куб вручную: поиск остановится с понятным сообщением; верните имя.
Ожидаемый результат
Найдено конкретное собственное описание куба и проверено его происхождение.
На что обратить внимание
Это не тест сетевой доступности, авторизации или данных сервера OLAP.
Не заменяйте учебное имя источником рабочей КА2.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.