Тип: Строка. Имя объекта метаданных.
Полное описание, параметры и ограничения
ОбъектМетаданных: ПланОбмена.Имя (MetadataObject: ExchangePlan.Name)
ОбъектМетаданных: ПланОбмена (MetadataObject: ExchangePlan)
Имя (Name)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Имя объекта метаданных.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Имя должно состоять из одного слова, начинаться с буквы и не содержать специальных символов, кроме «_».
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Получить памятку и описания настроек узла
Собственный текстовый макет читается по заданному имени. Настройка комментария истории остаётся на черновике и не имитирует уже записанную версию.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.
В отдельной пустой конфигурации Учебная85 создайте Планы обмена → УчебныйОбмен: длина кода 9, тип Строка, наименование длиной 100. Распределённая информационная база выключена; состав плана пустой.
Добавьте реквизит АдресУчебногоУзла: Строка длиной 100, Проверка заполнения = Показывать ошибку. Модуль объекта и подписки должны быть пустыми; не добавляйте отправку сообщений или внешние действия.
Добавьте макет УчебнаяПамятка типа Текстовый документ, одна строка: Этот узел используется только для учебных примеров. История данных для плана не включена. Обновите конфигурацию базы данных.
Каждый фрагмент запускайте отдельно на сервере в ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи. УчебныйОбмен не является существующим рабочим обменом КА2 или УТ.
Узел каждый раз новый и периферийный. Существующие узлы и текущий узел базы не меняются. Запись, блокировка и удаление далее выполняются только над своим новым UUID в собственной отменяемой транзакции.
Если Метаданные.ПланыОбмена.Найти("УчебныйОбмен") = Неопределено Тогда
ВызватьИсключение "Сначала создайте собственный учебный план обмена";
КонецЕсли;
Узел = ПланыОбмена.УчебныйОбмен.СоздатьУзел();
Если Узел.ЭтотУзел Тогда
ВызватьИсключение "Нельзя изменять текущий узел информационной базы";
КонецЕсли;
Описание = Узел.Метаданные();
Сообщить(Описание.Имя = "УчебныйОбмен");
Памятка = Узел.ПолучитьМакет("УчебнаяПамятка");
Если ТипЗнч(Памятка) <> Тип("ТекстовыйДокумент") Тогда
ВызватьИсключение "Нужен собственный макет типа Текстовый документ";
КонецЕсли;
Сообщить(СтрНайти(Памятка.ПолучитьТекст(), "Этот узел используется только для учебных примеров.") > 0);
Узел.ЗаписьИсторииДанных.КомментарийВерсии = "Учебный черновик, версия не записана";
Сообщить(Узел.ЗаписьИсторииДанных.КомментарийВерсии = "Учебный черновик, версия не записана");
Сообщить(Не Узел.ОбменДанными.Загрузка);
Сообщить(Узел.ЭтоНовый());Разбор по шагам
Метаданные возвращает описание плана обмена, а не текущее состояние сети.
ПолучитьМакет использует точное имя собственной памятки; тип проверяется до чтения текста.
КомментарийВерсии настраивается у параметров будущей записи. При выключенной истории и без Записать никакая версия не появляется.
ОбменДанными.Загрузка остаётся Ложь. Флаг не используется для обхода проверок или прав.
Как проверить результат
Пять сравнений Истина.
Прочитан свой макет; нет новой версии истории и сетевого обмена.
Ожидаемый результат
Разобраны описание плана, макет и параметры записи черновика.
На что обратить внимание
Текстовый макет не является кодом модуля объекта.
Комментарий не включает историю данных автоматически.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Использовать ЭтотОбъект в модуле своего узла
Экспортный метод получает собственный новый узел через контекст модуля. Это не параметр ИсходныйОбъект и не поиск чужой записи.
Где и как запускать
Текст экспортной процедуры для модуля объекта Планы обмена → УчебныйОбмен. Не вставляйте эту процедуру внутрь ВыполнитьПример или общего модуля; вызов своего экземпляра указан отдельно в подготовке.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.
В отдельной пустой конфигурации Учебная85 создайте Планы обмена → УчебныйОбмен: длина кода 9, тип Строка, наименование длиной 100. Распределённая информационная база выключена; состав плана пустой.
Добавьте реквизит АдресУчебногоУзла: Строка длиной 100, Проверка заполнения = Показывать ошибку. Модуль объекта и подписки должны быть пустыми; не добавляйте отправку сообщений или внешние действия.
Добавьте макет УчебнаяПамятка типа Текстовый документ, одна строка: Этот узел используется только для учебных примеров. История данных для плана не включена. Обновите конфигурацию базы данных.
Каждый фрагмент запускайте отдельно на сервере в ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи. УчебныйОбмен не является существующим рабочим обменом КА2 или УТ.
Узел каждый раз новый и периферийный. Существующие узлы и текущий узел базы не меняются. Запись, блокировка и удаление далее выполняются только над своим новым UUID в собственной отменяемой транзакции.
Только для этого урока вставьте приведённый экспортный метод в конец модуля объекта Планы обмена → УчебныйОбмен. Это обычный метод, не обработчик события; остальные уроки не вызывают его.
После обновления учебной базы в серверной ВыполнитьПример() создайте свой экземпляр и вызовите метод: Узел = ПланыОбмена.УчебныйОбмен.СоздатьУзел(); Узел.Наименование = "Узел проверки контекста"; Узел.УчебныйПаспортЧерновика();
Не объявляйте локальную переменную, параметр или модульную Перем с именем ЭтотОбъект. Они могут затенить контекст и изменить смысл примера.
Процедура УчебныйПаспортЧерновика() Экспорт
Если ЭтотОбъект.Метаданные().Имя <> "УчебныйОбмен" Или ЭтотОбъект.ЭтотУзел Тогда
ВызватьИсключение "Нужен собственный периферийный учебный узел";
КонецЕсли;
Сообщить(ЭтотОбъект.Наименование = "Узел проверки контекста");
Сообщить(ЭтотОбъект.ЭтоНовый());
Сообщить(ЭтотОбъект.Ссылка.Пустая());
КонецПроцедурыРазбор по шагам
Метод находится именно в модуле объекта учебного плана обмена, а не в общем модуле.
Новый узел создаётся явным вызовом в подготовке и передаётся методу через контекст самого экземпляра.
ЭтотОбъект.Метаданные и ЭтотУзел защищают от вызова на другом плане или текущем узле.
Проверяем имя, новый статус и пустую ссылку; ни запись, ни передача сообщения не выполняются.
Как проверить результат
Три сравнения Истина при точном вызове из подготовки.
Новый учебный узел по-прежнему только в памяти; процедура не принимает внешний объект и не обращается к рабочим узлам.
Ожидаемый результат
Показан правильный контекст ЭтотОбъект на своём реальном экземпляре.
На что обратить внимание
В общем модуле этот код не получает контекст плана обмена автоматически.
Имя ЭтотОбъект нельзя использовать для другого локального значения в этом примере.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.