Предназначен для управления планом видов характеристик, как объектом конфигурации. Доступ к объекту осуществляется через свойства объекта ПланыВидовХарактеристикМенеджер. Предназначен для создания новых элементов плана видов характеристик, а также поиска элементов.
Полное описание, параметры и ограничения
ПланВидовХарактеристикМенеджер.<Имя плана видов характеристик> (ChartOfCharacteristicTypesManager.<Chart of characteristic types name>)
ПланВидовХарактеристикМенеджер.<Имя плана видов характеристик> (ChartOfCharacteristicTypesManager.<Chart of characteristic types name>)
Доступен, начиная с версии 8.0.
Свойства:
<Имя предопределенного вида характеристик> (<Predefined characteristic type name>)
Методы:
Выбрать (Select)
ВыбратьИерархически (SelectHierarchically)
ВыбратьПоСсылкам (SelectByRefs)
НайтиПоКоду (FindByCode)
НайтиПоНаименованию (FindByDescription)
НайтиПоРеквизиту (FindByAttribute)
ПолучитьДанныеВыбора (GetChoiceData)
ПолучитьИнициализациюПредопределенныхДанных (GetPredefinedDataInitialization)
ПолучитьМакет (GetTemplate)
ПолучитьОбновлениеПредопределенныхДанных (GetPredefinedDataUpdate)
ПолучитьСсылку (GetRef)
ПолучитьФорму (GetForm)
ПолучитьФормуВыбора (GetChoiceForm)
ПолучитьФормуВыбораГруппы (GetFolderChoiceForm)
ПолучитьФормуНовогоЭлемента (GetNewItemForm)
ПолучитьФормуНовойГруппы (GetNewFolderForm)
ПолучитьФормуСписка (GetListForm)
ПустаяСсылка (EmptyRef)
СоздатьГруппу (CreateFolder)
СоздатьЭлемент (CreateItem)
УстановитьИнициализациюПредопределенныхДанных (SetPredefinedDataInitialization)
УстановитьОбновлениеПредопределенныхДанных (SetPredefinedDataUpdate)
События:
ОбработкаПолученияДанныхВыбора (ChoiceDataGetProcessing)
ОбработкаПолученияПолейПредставления (PresentationFieldsGetProcessing)
ОбработкаПолученияПредставления (PresentationGetProcessing)
ОбработкаПолученияФормы (FormGetProcessing)
ОбработкаПослеЗаписиВерсийИсторииДанных (AfterWriteDataHistoryVersionsProcessing)
Описание:
Предназначен для управления планом видов характеристик, как объектом конфигурации. Доступ к объекту осуществляется через свойства объекта ПланыВидовХарактеристикМенеджер.
Предназначен для создания новых элементов плана видов характеристик, а также поиска элементов.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Возможен обмен с сервером.
См. также:
ПланыВидовХарактеристикМенеджер, свойство <Имя плана видов характеристик>
ПланВидовХарактеристикСсылка.<Имя плана видов характеристик>, метод УникальныйИдентификатор
Использование в версии:
Доступен, начиная с версии 8.0.
Описание изменено в версии 8.3.26.
Методическая информация
Практические примеры
Различить тип значений характеристики и ссылку на её описание
План УчебныеСвойства разрешает числовые и строковые значения. Его Тип — описание этих значений, а ПустаяСсылка — ссылка на вид характеристики, не значение свойства товара.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую базу и назовите корень конфигурации Учебная85. Не добавляйте учебные объекты в УТ/КА2/УНФ/БП и не подключайте расширения.
Конфигуратор → Планы видов характеристик → Добавить: имя УчебныеСвойства, синоним Учебные свойства. Укажите длину кода 10, длину наименования 100, автонумерацию и контроль уникальности включите.
Включите иерархию плана. В свойстве Тип выберите только Число (12 цифр, 2 дробных, неотрицательное) и Строка (30 символов, переменная длина). Дополнительные значения характеристик не назначайте.
Реквизиты, табличные части, предопределённые элементы, формы, команды, макеты, характеристики и дополнительные индексы не создавайте. Модуль объекта и модуль менеджера оставьте пустыми; историю данных выключите.
Создайте серверный общий модуль УчебныеЗадачи с процедурой ВыполнитьПример() Экспорт и вызывайте её из серверного обработчика учебной обработки. Обновите конфигурацию базы данных перед первым запуском.
Код этого блока не вызывает Записать, не устанавливает блокировки и не меняет настройки метаданных. Учебные виды характеристик существуют только в памяти.
Если Метаданные.ПланыВидовХарактеристик.Найти("УчебныеСвойства") = Неопределено Тогда
ВызватьИсключение "Создайте собственный план УчебныеСвойства по подготовке";
КонецЕсли;
Описание = Метаданные.ПланыВидовХарактеристик.УчебныеСвойства;
Сообщить(Описание.Имя = "УчебныеСвойства");
Сообщить(Описание.Тип.СодержитТип(Тип("Число")));
Сообщить(Описание.Тип.СодержитТип(Тип("Строка")));
Сообщить(Описание.Тип.Типы().Количество() = 2);
Сообщить(Описание.ДополнительныеЗначенияХарактеристик = Неопределено);
Сообщить(Описание.Иерархический);
Сообщить(Описание.Автонумерация);
Сообщить(Описание.КонтрольУникальности);
Сообщить(Описание.ДлинаКода = 10);
Сообщить(Описание.ДлинаНаименования = 100);
Пустая = ПланыВидовХарактеристик.УчебныеСвойства.ПустаяСсылка();
Сообщить(Пустая.Пустая());
Сообщить(ТипЗнч(Пустая) = Тип("ПланВидовХарактеристикСсылка.УчебныеСвойства"));
Сообщить("Допустимая длина кода: " + Строка(Описание.ДопустимаяДлинаКода));
Сообщить("Серия кодов: " + Строка(Описание.СерииКодов));
Сообщить("Группы сверху: " + Строка(Описание.ГруппыСверху));Разбор по шагам
Читаем описание собственной схемы. СодержитТип проверяет разрешённые типы значений, а Типы даёт их массив.
Схема разрешает ровно Число и Строка. Дополнительный справочник значений не назначен; значение свойства пока нигде не хранится.
Проверяем подготовленные настройки длины, иерархии и кодов. Эти чтения не нумеруют и не создают записи.
ПустаяСсылка имеет тип ссылки на вид характеристики. Это не число, не строка, не объект метаданных и не сам план целиком.
Как проверить результат
Двенадцать логических проверок дают Истина.
После них выводятся фактические режимы длины кода, серий кодов и показа групп; они не выдаются за значения товара.
В базе не появляются виды свойств или дополнительные значения.
Ожидаемый результат
Проверена схема ПВХ и разделены ссылка на описание свойства и допустимый тип его значения.
На что обратить внимание
План видов характеристик не хранит автоматически значение Вес у каждого товара. Для значений нужен отдельный объект/регистр с согласованной структурой.
Не сравнивайте значение 12.5 с типом ПланВидовХарактеристикСсылка.УчебныеСвойства: это ссылка на вид свойства, а не его значение.
ДополнительныеЗначенияХарактеристик — описание назначенного справочника в метаданных, не массив уже введённых значений.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Скопировать описание свойства, не меняя оригинал
Скопировать создаёт новый вид характеристики. Меняем имя копии, проверяем сохранённый тип и отдельно используем служебные дополнительные свойства оригинала.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую базу и назовите корень конфигурации Учебная85. Не добавляйте учебные объекты в УТ/КА2/УНФ/БП и не подключайте расширения.
Конфигуратор → Планы видов характеристик → Добавить: имя УчебныеСвойства, синоним Учебные свойства. Укажите длину кода 10, длину наименования 100, автонумерацию и контроль уникальности включите.
Включите иерархию плана. В свойстве Тип выберите только Число (12 цифр, 2 дробных, неотрицательное) и Строка (30 символов, переменная длина). Дополнительные значения характеристик не назначайте.
Реквизиты, табличные части, предопределённые элементы, формы, команды, макеты, характеристики и дополнительные индексы не создавайте. Модуль объекта и модуль менеджера оставьте пустыми; историю данных выключите.
Создайте серверный общий модуль УчебныеЗадачи с процедурой ВыполнитьПример() Экспорт и вызывайте её из серверного обработчика учебной обработки. Обновите конфигурацию базы данных перед первым запуском.
Код этого блока не вызывает Записать, не устанавливает блокировки и не меняет настройки метаданных. Учебные виды характеристик существуют только в памяти.
Если Метаданные.ПланыВидовХарактеристик.Найти("УчебныеСвойства") = Неопределено Тогда
ВызватьИсключение "Создайте собственный план УчебныеСвойства по подготовке";
КонецЕсли;
Описание = Метаданные.ПланыВидовХарактеристик.УчебныеСвойства;
ОписаниеВеса = ПланыВидовХарактеристик.УчебныеСвойства.СоздатьЭлемент();
ОписаниеВеса.Наименование = "Вес, кг";
ОписаниеВеса.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(8, 2, ДопустимыйЗнак.Неотрицательный));
ОписаниеВеса.ДополнительныеСвойства.Вставить("УчебнаяМетка", "Оригинал");
Копия = ОписаниеВеса.Скопировать();
Копия.Наименование = "Вес упаковки, кг";
Сообщить(ОписаниеВеса.Наименование = "Вес, кг");
Сообщить(Копия.Наименование = "Вес упаковки, кг");
Сообщить(Копия.ТипЗначения.СодержитТип(Тип("Число")));
Сообщить(Копия.ЭтоНовый());
Сообщить(ОписаниеВеса.ЭтоНовый());
Сообщить(Копия.Ссылка.Пустая());
Сообщить(Копия.ИмяПредопределенныхДанных = "");
Сообщить(Копия.ЭтотОбъект = Копия);
Метка = "";
Сообщить(ОписаниеВеса.ДополнительныеСвойства.Свойство("УчебнаяМетка", Метка));
Сообщить(Метка = "Оригинал");
Сообщить("Модифицированность копии: " + Строка(Копия.Модифицированность()));
Сообщить("Версия данных нового объекта: " + Копия.ВерсияДанных);Разбор по шагам
Исходник создаём сами, не читаем существующее рабочее свойство. Тип значения — Число.
Скопировать даёт другой новый объект. Переименование копии не меняет оригинал, а тип значения сохраняется.
ДополнительныеСвойства — служебная структура оригинала; читаем собственную метку явно. Не утверждаем, что она автоматически перенеслась в копию.
Модифицированность и ВерсияДанных выводятся как фактическая диагностика. Для нового объекта это не доказательство сохранения или версии в базе.
Как проверить результат
Десять логических сообщений дают Истина.
Оригинал называется Вес, кг, копия — Вес упаковки, кг; оба новые, обычная ссылка копии пустая.
Служебная метка оригинала равна Оригинал; в базе новый вид свойства не появился.
Ожидаемый результат
Разобрано копирование описания характеристики с независимым именем и диагностикой нового объекта.
На что обратить внимание
Копирование вида свойства не копирует значения этого свойства у товаров: таких значений пример вообще не создавал.
ДополнительныеСвойства не равны реквизитам, сохраняемым в базе. Перенос собственных служебных данных проектируйте явно.
Изменение нового объекта в памяти не означает Записать или успешную проверку всех обработчиков конфигурации.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.