Получает полное имя объекта метаданного. Имя отвечает требованиям, предъявляемым к именам (должно начинаться с буквы, содержать только буквы, цифры или символ "_", может содержать одну точку (не начальный и не конечный символ)).
Синтаксис
ПолноеИмя()Примеры платформы
Для каждого Объект Из Метаданные.Справочники Цикл
Сообщить(Объект.ПолноеИмя());
КонецЦикла;Полное описание, параметры и ограничения
ОбъектМетаданных: Справочник.ПолноеИмя (MetadataObject: Catalog.FullName)
ОбъектМетаданных: Справочник (MetadataObject: Catalog)
ПолноеИмя (FullName)
Доступен, начиная с версии 8.0.
Синтаксис:
ПолноеИмя()
Возвращаемое значение:
Тип: Строка.
Описание:
Получает полное имя объекта метаданного. Имя отвечает требованиям, предъявляемым к именам (должно начинаться с буквы, содержать только буквы, цифры или символ "_", может содержать одну точку (не начальный и не конечный символ)).
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Пример:
// В конфигурации определены справочники "Банки", "Валюты" и "Товары"
// Результатом работы примера:
Для каждого Объект Из Метаданные.Справочники Цикл
Сообщить(Объект.ПолноеИмя());
КонецЦикла;
// будут сообщения:
// Справочник.Банки
// Справочник.Валюты
// Справочник.Товары
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Проверить, как общий реквизит включён в Номенклатуру
Ищем элемент состава по описанию справочника, затем сравниваем два способа поиска. Не считаем размер состава количеством товаров.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Описание = Метаданные.ОбщиеРеквизиты.Найти("КомментарийЯзык1");
Если Описание = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ОбщиеРеквизиты.КомментарийЯзык1";
КонецЕсли;
Справочник = Метаданные.Справочники.Найти("Номенклатура");
Если Справочник = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует Справочники.Номенклатура";
КонецЕсли;
Сообщить("Автоиспользование: " + Строка(Описание.АвтоИспользование));
Сообщить("Элементов состава: " + Строка(Описание.Состав.Количество()));
Сообщить(Описание.Состав.Содержит(Справочник));
Элемент = Описание.Состав.Найти(Справочник);
Если Элемент = Неопределено Тогда
Сообщить("Элемент состава не получен; проверьте реквизит и объект конфигурации");
Иначе
Сообщить(Элемент.Метаданные = Справочник);
Сообщить(Элемент.Использование);
Сообщить("Условие элемента: " + Строка(Элемент.УсловноеРазделение));
ПоИмени = Описание.Состав.Найти(Справочник.ПолноеИмя());
Сообщить(ПоИмени = Элемент);
КонецЕсли;Разбор по шагам
Справочник ищем отдельно и не подменяем его именем произвольного документа.
Состав хранит описания объектов и настройки включения общего реквизита.
У элемента читаем Использование; автоматическое значение нужно интерпретировать вместе с АвтоИспользование общего реквизита.
УсловноеРазделение элемента — описание условия, а не вычисленный результат разделения текущих данных.
Как проверить результат
Если элемент найден, его Метаданные совпадают с выбранным справочником; поиск по полному имени должен найти тот же элемент.
Если элемент отсутствует, обращений к его свойствам нет. Не требуйте Истина от Содержит в любой конфигурации.
Ожидаемый результат
Связаны общий реквизит, объект состава и способ включения.
На что обратить внимание
Содержит само по себе не означает фактическое использование реквизита: нужно учитывать Использование и АвтоИспользование.
Количество элементов состава — число описаний, а не количество записей номенклатуры.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Проверить ограничения Номенклатуры до загрузки товаров
Перед импортом узнаём длины кода и наименования, иерархию, владельцев и состав реквизитов. Ничего не записываем.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
В Конфигураторе найдите Справочники → Номенклатура. Пример рассчитан на конфигурацию, где этот справочник существует.
Описание = Метаданные.Справочники.Найти("Номенклатура");
Если Описание = Неопределено Тогда
ВызватьИсключение "Номенклатура отсутствует в текущей конфигурации";
КонецЕсли;
Сообщить(Описание.ПолноеИмя());
Сообщить(Описание.Представление());
Сообщить(СтрШаблон("Имя: %1; синоним: %2", Описание.Имя, Описание.Синоним));
Сообщить(Описание.Комментарий);
Сообщить(СтрШаблон("Код: длина %1, тип %2; наименование: длина %3",
Описание.ДлинаКода, Описание.ТипКода, Описание.ДлинаНаименования));
Сообщить(СтрШаблон("Автонумерация: %1; контроль уникальности: %2",
Описание.Автонумерация, Описание.КонтрольУникальности));
Сообщить(СтрШаблон("Иерархия: %1; вид: %2; уровни: %3",
Описание.Иерархический, Описание.ВидИерархии, Описание.КоличествоУровней));
Сообщить(СтрШаблон("Владельцев: %1; реквизитов: %2; табличных частей: %3",
Описание.Владельцы.Количество(), Описание.Реквизиты.Количество(), Описание.ТабличныеЧасти.Количество()));
Для Каждого Реквизит Из Описание.Реквизиты Цикл
Сообщить(СтрШаблон("%1: %2", Реквизит.Имя, Реквизит.Тип));
КонецЦикла;
НаименованиеИзФайла = "Учебная книга";
Если Описание.ДлинаНаименования > 0 И СтрДлина(НаименованиеИзФайла) > Описание.ДлинаНаименования Тогда
ВызватьИсключение "Наименование длиннее разрешённого — загрузка должна быть отклонена";
КонецЕсли;
Сообщить("Предварительная проверка длины пройдена; запись не выполнялась");Разбор по шагам
Найти возвращает описание справочника, не ссылку на конкретный товар.
По длинам и типу кода определяем ограничения полей, по иерархии — необходимость групп, по владельцам — зависимость от другого справочника.
Обходим собственные реквизиты и выводим их реальные описания типов, а не предполагаем одинаковую схему во всех конфигурациях.
Проверяем длину учебного наименования, но не создаём товар: это только один шаг предварительной проверки импорта.
Как проверить результат
Длины и тип кода совпадают с настройками Номенклатуры в вашей учебной базе.
Увеличьте НаименованиеИзФайла до значения длиннее ДлинаНаименования: получите исключение до какой-либо записи.
Число реквизитов — число описаний полей, а не число заполненных значений у товара.
Ожидаемый результат
Получен фактический контракт справочника для подготовки импорта без создания товаров.
На что обратить внимание
Контроль уникальности кода не гарантирует отсутствие товаров-дублей по артикулу или наименованию.
ДлинаНаименования=0 требует отдельной интерпретации настройки; не объявляйте поле автоматически обязательным или безграничным.
Успешная проверка длины не заменяет права доступа, обязательные реквизиты и обработчики записи.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.