ОбъектМетаданных: ПланОбмена

Типы · MetadataObject: ExchangePlan

Используется для обращения к метаданным объекта конфигурации - план обмена.

Полное описание, параметры и ограничения

ОбъектМетаданных: ПланОбмена (MetadataObject: ExchangePlan)

ОбъектМетаданных: ПланОбмена (MetadataObject: ExchangePlan)

Доступен, начиная с версии 8.1.

Свойства:
Имя (Name)
Комментарий (Comment)
ОбъектРасширяемойКонфигурации (ExtendedConfigurationObject)
ПринадлежностьОбъекта (ObjectBelonging)
Синоним (Synonym)
СтандартныеРеквизиты (StandardAttributes)
БыстрыйВыбор (QuickChoice)
ВводитсяНаОсновании (BasedOn)
ВводПоСтроке (InputByString)
ВключатьРасширенияКонфигурации (IncludeConfigurationExtensions)
ВключатьСправкуВСодержание (IncludeHelpInContents)
ВыполнятьОбработкуПослеЗаписиВерсииИсторииДанных (ExecuteAfterWriteDataHistoryVersionProcessing)
ДлинаКода (CodeLength)
ДлинаНаименования (DescriptionLength)
ДополнительнаяФормаДляВыбора (AuxiliaryChoiceForm)
ДополнительнаяФормаОбъекта (AuxiliaryObjectForm)
ДополнительнаяФормаСписка (AuxiliaryListForm)
ДополнительныеИндексы (AdditionalIndexes)
ДопустимаяДлинаКода (CodeAllowedLength)
ИспользоватьСтандартныеКоманды (UseStandardCommands)
ИсторияВыбораПриВводе (ChoiceHistoryOnInput)
ИсторияДанных (DataHistory)
Команды (Commands)
Макеты (Templates)
МодульМенеджера (ManagerModule)
МодульОбъекта (ObjectModule)
ОбновлятьИсториюДанныхСразуПослеЗаписи (UpdateDataHistoryImmediatelyAfterWrite)
ОсновнаяФормаДляВыбора (DefaultChoiceForm)
ОсновнаяФормаОбъекта (DefaultObjectForm)
ОсновнаяФормаСписка (DefaultListForm)
ОсновноеПредставление (DefaultPresentation)
ПолнотекстовыйПоиск (FullTextSearch)
ПолнотекстовыйПоискПриВводеПоСтроке (FullTextSearchOnInputByString)
ПоляБлокировкиДанных (DataLockFields)
Пояснение (Explanation)
ПредставлениеОбъекта (ObjectPresentation)
ПредставлениеСписка (ListPresentation)
РаспределеннаяИнформационнаяБаза (DistributedInfoBase)
РасширенноеПредставлениеОбъекта (ExtendedObjectPresentation)
РасширенноеПредставлениеСписка (ExtendedListPresentation)
РежимПолученияДанныхВыбораПриВводеПоСтроке (ChoiceDataGetModeOnInputByString)
РежимУправленияБлокировкойДанных (DataLockControlMode)
Реквизиты (Attributes)
СозданиеПриВводе (CreateOnInput)
Состав (Content)
СпособВыбора (ChoiceMode)
СпособПоискаСтрокиПриВводеПоСтроке (SearchStringModeOnInputByString)
СпособРедактирования (EditType)
Справка (Help)
ТабличныеЧасти (TabularSections)
Формы (Forms)
Характеристики (Characteristics)

Методы:
ЕстьИзмененияРасширениямиКонфигурации (ChangedByConfigurationExtensions)
ПолноеИмя (FullName)
Представление (Presentation)
РасширениеКонфигурации (ConfigurationExtension)
Родитель (Parent)

Описание:

Используется для обращения к метаданным объекта конфигурации - план обмена.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.

См. также:
ПланОбменаОбъект.<Имя плана обмена>, метод Метаданные
ПланОбменаСсылка.<Имя плана обмена>, метод Метаданные

Использование в версии:

Доступен, начиная с версии 8.1.

Описание изменено в версии 8.3.26.

Методическая информация

Практические примеры

Получить памятку и описания настроек узла

Собственный текстовый макет читается по заданному имени. Настройка комментария истории остаётся на черновике и не имитирует уже записанную версию.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.

  2. Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.

  3. Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.

  4. Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.

  5. Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.

  6. В отдельной пустой конфигурации Учебная85 создайте Планы обмена → УчебныйОбмен: длина кода 9, тип Строка, наименование длиной 100. Распределённая информационная база выключена; состав плана пустой.

  7. Добавьте реквизит АдресУчебногоУзла: Строка длиной 100, Проверка заполнения = Показывать ошибку. Модуль объекта и подписки должны быть пустыми; не добавляйте отправку сообщений или внешние действия.

  8. Добавьте макет УчебнаяПамятка типа Текстовый документ, одна строка: Этот узел используется только для учебных примеров. История данных для плана не включена. Обновите конфигурацию базы данных.

  9. Каждый фрагмент запускайте отдельно на сервере в ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи. УчебныйОбмен не является существующим рабочим обменом КА2 или УТ.

  10. Узел каждый раз новый и периферийный. Существующие узлы и текущий узел базы не меняются. Запись, блокировка и удаление далее выполняются только над своим новым UUID в собственной отменяемой транзакции.

Если Метаданные.ПланыОбмена.Найти("УчебныйОбмен") = Неопределено Тогда
    ВызватьИсключение "Сначала создайте собственный учебный план обмена";
КонецЕсли;
Узел = ПланыОбмена.УчебныйОбмен.СоздатьУзел();
Если Узел.ЭтотУзел Тогда
    ВызватьИсключение "Нельзя изменять текущий узел информационной базы";
КонецЕсли;
Описание = Узел.Метаданные();
Сообщить(Описание.Имя = "УчебныйОбмен");
Памятка = Узел.ПолучитьМакет("УчебнаяПамятка");
Если ТипЗнч(Памятка) <> Тип("ТекстовыйДокумент") Тогда
    ВызватьИсключение "Нужен собственный макет типа Текстовый документ";
КонецЕсли;
Сообщить(СтрНайти(Памятка.ПолучитьТекст(), "Этот узел используется только для учебных примеров.") > 0);
Узел.ЗаписьИсторииДанных.КомментарийВерсии = "Учебный черновик, версия не записана";
Сообщить(Узел.ЗаписьИсторииДанных.КомментарийВерсии = "Учебный черновик, версия не записана");
Сообщить(Не Узел.ОбменДанными.Загрузка);
Сообщить(Узел.ЭтоНовый());

Разбор по шагам

  1. Метаданные возвращает описание плана обмена, а не текущее состояние сети.

  2. ПолучитьМакет использует точное имя собственной памятки; тип проверяется до чтения текста.

  3. КомментарийВерсии настраивается у параметров будущей записи. При выключенной истории и без Записать никакая версия не появляется.

  4. ОбменДанными.Загрузка остаётся Ложь. Флаг не используется для обхода проверок или прав.

Как проверить результат

  1. Пять сравнений Истина.

  2. Прочитан свой макет; нет новой версии истории и сетевого обмена.

Ожидаемый результат

Разобраны описание плана, макет и параметры записи черновика.

На что обратить внимание

  1. Текстовый макет не является кодом модуля объекта.

  2. Комментарий не включает историю данных автоматически.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Использовать ЭтотОбъект в модуле своего узла

Экспортный метод получает собственный новый узел через контекст модуля. Это не параметр ИсходныйОбъект и не поиск чужой записи.

Где и как запускать

Текст экспортной процедуры для модуля объекта Планы обмена → УчебныйОбмен. Не вставляйте эту процедуру внутрь ВыполнитьПример или общего модуля; вызов своего экземпляра указан отдельно в подготовке.

Подготовка

  1. Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.

  2. Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.

  3. Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.

  4. Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.

  5. Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.

  6. В отдельной пустой конфигурации Учебная85 создайте Планы обмена → УчебныйОбмен: длина кода 9, тип Строка, наименование длиной 100. Распределённая информационная база выключена; состав плана пустой.

  7. Добавьте реквизит АдресУчебногоУзла: Строка длиной 100, Проверка заполнения = Показывать ошибку. Модуль объекта и подписки должны быть пустыми; не добавляйте отправку сообщений или внешние действия.

  8. Добавьте макет УчебнаяПамятка типа Текстовый документ, одна строка: Этот узел используется только для учебных примеров. История данных для плана не включена. Обновите конфигурацию базы данных.

  9. Каждый фрагмент запускайте отдельно на сервере в ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи. УчебныйОбмен не является существующим рабочим обменом КА2 или УТ.

  10. Узел каждый раз новый и периферийный. Существующие узлы и текущий узел базы не меняются. Запись, блокировка и удаление далее выполняются только над своим новым UUID в собственной отменяемой транзакции.

  11. Только для этого урока вставьте приведённый экспортный метод в конец модуля объекта Планы обмена → УчебныйОбмен. Это обычный метод, не обработчик события; остальные уроки не вызывают его.

  12. После обновления учебной базы в серверной ВыполнитьПример() создайте свой экземпляр и вызовите метод: Узел = ПланыОбмена.УчебныйОбмен.СоздатьУзел(); Узел.Наименование = "Узел проверки контекста"; Узел.УчебныйПаспортЧерновика();

  13. Не объявляйте локальную переменную, параметр или модульную Перем с именем ЭтотОбъект. Они могут затенить контекст и изменить смысл примера.

Процедура УчебныйПаспортЧерновика() Экспорт
    Если ЭтотОбъект.Метаданные().Имя <> "УчебныйОбмен" Или ЭтотОбъект.ЭтотУзел Тогда
        ВызватьИсключение "Нужен собственный периферийный учебный узел";
    КонецЕсли;
    Сообщить(ЭтотОбъект.Наименование = "Узел проверки контекста");
    Сообщить(ЭтотОбъект.ЭтоНовый());
    Сообщить(ЭтотОбъект.Ссылка.Пустая());
КонецПроцедуры

Разбор по шагам

  1. Метод находится именно в модуле объекта учебного плана обмена, а не в общем модуле.

  2. Новый узел создаётся явным вызовом в подготовке и передаётся методу через контекст самого экземпляра.

  3. ЭтотОбъект.Метаданные и ЭтотУзел защищают от вызова на другом плане или текущем узле.

  4. Проверяем имя, новый статус и пустую ссылку; ни запись, ни передача сообщения не выполняются.

Как проверить результат

  1. Три сравнения Истина при точном вызове из подготовки.

  2. Новый учебный узел по-прежнему только в памяти; процедура не принимает внешний объект и не обращается к рабочим узлам.

Ожидаемый результат

Показан правильный контекст ЭтотОбъект на своём реальном экземпляре.

На что обратить внимание

  1. В общем модуле этот код не получает контекст плана обмена автоматически.

  2. Имя ЭтотОбъект нельзя использовать для другого локального значения в этом примере.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.