Синтаксис и применение ИмяПредопределенныхДанных в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
ИмяПредопределенныхДанных (PredefinedDataName)
ИмяПредопределенныхДанных (PredefinedDataName)
Тип: Строка.
Содержит имя предопределенных данных, связанных с видом характеристики.
Внимание! Данное поле имеет особенности сортировки. При использовании в отборе допустимо указывать только корректное имя предопределенных данных, используемое в конфигурации, или пустую строку. Данное поле не может быть использовано в соединении таблиц.
Если имя предопределенных данных указано некорректно, будет вызвано исключение.
Методическая информация
Практические примеры
Увидеть тип значения собственной характеристики
Запрос читает определения характеристик, а не значения характеристик товара.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте иерархический план видов характеристик УчебныеСвойства: группы и элементы; допустимые типы значений — Строка и Число. Код — Строка 10, Наименование — Строка 100.
Добавьте Комментарий (Строка 100), использование Для групп и элементов. Дополнительные значения характеристик для этого урока не нужны.
В отдельной учебной конфигурации создайте общий реквизит УчебныйИсточник типа Строка 20. Разделение данных — Не использовать. В составе явно включите только учебный объект этого урока; использование — Использовать.
Если общий реквизит не выведен на форму, его пустое строковое значение допустимо. Запрос всё равно покажет именованную колонку УчебныйИсточник. Это не разделитель данных и не механизм ограничения доступа.
Обновите учебную базу. В стандартной форме создайте группу Описание и элемент Вес с родителем Описание; для элемента выберите тип значения Число, комментарий Вес в килограммах. Предопределённых видов не создавайте.
Код запускается в серверной процедуре учебной обработки.
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
| Данные.Ссылка, Данные.Код, Данные.Наименование,
| Данные.Родитель, Данные.ЭтоГруппа, Данные.ТипЗначения,
| Данные.ПометкаУдаления, Данные.Предопределенный, Данные.ИмяПредопределенныхДанных,
| Данные.Представление, Данные.ВерсияДанных, Данные.Комментарий,
| Данные.УчебныйИсточник
|ИЗ ПланВидовХарактеристик.УчебныеСвойства КАК Данные";
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
Для Каждого Колонка Из Результат.Колонки Цикл
Сообщить(Колонка.Имя + ": " + Строка(Выборка[Колонка.Имя]));
КонецЦикла;
КонецЦикла;Разбор по шагам
Таблица хранит определения видов характеристик.
ТипЗначения содержит ОписаниеТипов для конкретного вида.
Родитель и ЭтоГруппа описывают иерархию; Комментарий и УчебныйИсточник определены в подготовке.
Как проверить результат
Для Вес показан тип Число и комментарий Вес в килограммах.
Группа Описание имеет ЭтоГруппа Истина; элемент Вес — Ложь и родителя Описание.
Ожидаемый результат
Свойство ТипЗначения прочитано вместе с иерархией и динамическими реквизитами.
На что обратить внимание
Не путайте план видов характеристик с регистром значений характеристик.
ТипЗначения имеет неограниченную длину: не используйте его без необходимости в группировке или сравнении.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.