Тип: Строка. Содержит имя параметра связи. Должно отвечать требованиям, предъявляемым к именам (должно начинаться с буквы, содержать только буквы, цифры или символ "_", может содержать одну точку (не начальный и не конечный символ)). Правильные значения: "Отбор.Владелец", ПользовательскийПараметр". НеправильныеЗначения: "Отбор.", "Отбор.Владелец.Наименование".
Полное описание, параметры и ограничения
ПараметрВыбора.Имя (ChoiceParameter.Name)
ПараметрВыбора (ChoiceParameter)
Имя (Name)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: Строка.
Содержит имя параметра связи. Должно отвечать требованиям, предъявляемым к именам (должно начинаться с буквы, содержать только буквы, цифры или символ "_", может содержать одну точку (не начальный и не конечный символ)).
Правильные значения: "Отбор.Владелец", ПользовательскийПараметр".
НеправильныеЗначения: "Отбор.", "Отбор.Владелец.Наименование".
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Прочитать постоянный отбор единиц веса и создать его учебное описание
ВесЕдиницаИзмерения имеет единственный параметр Отбор.ТипИзмеряемойВеличины = Вес. Получаем его из схемы, а не выбираем первую попавшуюся единицу.
Где и как запускать
Полный серверный общий модуль учебной копии КА2 Progress. Только схема и собственные значения в памяти.
Подготовка
Используйте отдельную учебную копию КА2 Progress, соответствующую C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Названия и настройки проверены по реальным Catalogs/Номенклатура.xml и Catalogs/ВидыПодарочныхСертификатов.xml.
Создайте серверный общий модуль УчебныеЗадачи, вставьте полный модуль одного урока и вызовите ВыполнитьПример() из своего серверного обработчика учебной команды.
Примеры читают схему и создают значения только в памяти. Они не создают и не записывают товары, не меняют метаданные, не запускают заполнение объекта или перестроение поискового индекса.
Процедура ВыполнитьПример() Экспорт
Справочник = Метаданные.Справочники.Найти("Номенклатура");
Если Справочник = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует Справочники.Номенклатура";
КонецЕсли;
Описание = Справочник.Реквизиты.Найти("ВесЕдиницаИзмерения");
Если Описание = Неопределено Тогда
ВызватьИсключение "В найденном справочнике нет нужного реквизита учебного урока";
КонецЕсли;
Параметры = Описание.ПараметрыВыбора;
Если Параметры.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один документированный параметр выбора единицы веса";
КонецЕсли;
Параметр = Параметры[0];
Если ТипЗнч(Параметр) <> Тип("ПараметрВыбора") Тогда
ВызватьИсключение "Элемент массива должен иметь тип ПараметрВыбора";
КонецЕсли;
Сообщить(Параметр.Имя = "Отбор.ТипИзмеряемойВеличины");
Сообщить(Параметр.Значение = Перечисления.ТипыИзмеряемыхВеличин.Вес);
УчебныйПараметр = Новый ПараметрВыбора(Параметр.Имя, Параметр.Значение);
Сообщить(УчебныйПараметр.Имя = Параметр.Имя);
Сообщить(УчебныйПараметр.Значение = Параметр.Значение);
Состав = Новый Массив;
Состав.Добавить(УчебныйПараметр);
ГотовыеПараметры = Новый ФиксированныйМассив(Состав);
Сообщить(ГотовыеПараметры.Количество() = 1);
КонецПроцедурыРазбор по шагам
ПараметрыВыбора — фиксированный массив. Сначала проверяем ожидаемый состав, затем обращаемся к индексу 0.
Виды веса заданы настоящим пользовательским перечислением ТипыИзмеряемыхВеличин.Вес. Это не число и не строка Вес.
Имя параметра содержит одну точку: Отбор.ТипИзмеряемойВеличины. Такие имена разрешены справкой; произвольная цепочка из трёх точек — не то же самое.
Новый ПараметрВыбора создаёт отдельное неизменяемое описание с именем и значением. Далее готовим собственный фиксированный массив для будущего учебного поля выбора.
Массив не присваивается рабочей форме. Выбор единицы и вычисление коэффициента обмена здесь не выполняются.
Как проверить результат
Пять контрольных Истина: имя, значение, два свойства собственной копии и количество массива.
Исходный фиксированный массив метаданных не очищен и не дополнен.
Ожидаемый результат
Получен типизированный набор постоянного отбора для дальнейшего построения своего поля выбора.
На что обратить внимание
Не используйте Отбор по типу веса как доказательство одинаковых коэффициентов всех единиц.
ПараметрВыбора не допускает Неопределено в качестве значения; здесь передано существующее значение перечисления.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Проверить настройки выбора ссылочного ресурса Партнер
В АрендованныеОС ресурс Партнер ссылается на справочник Партнеры. Параметры выбора описывают интерфейс, не содержат выбранного партнёра записи.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Регистр = Метаданные.РегистрыСведений.Найти("АрендованныеОС");
Если Регистр = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует РегистрыСведений.АрендованныеОС";
КонецЕсли;
Ресурс = Регистр.Ресурсы.Найти("Партнер");
Если Ресурс = Неопределено Тогда
ВызватьИсключение "В АрендованныеОС отсутствует ресурс Партнер";
КонецЕсли;
Сообщить(Ресурс.Тип.СодержитТип(Тип("СправочникСсылка.Партнеры")));
Сообщить("Группы/элементы: " + Строка(Ресурс.ВыборГруппИЭлементов));
Сообщить("Быстрый выбор: " + Строка(Ресурс.БыстрыйВыбор));
Сообщить("Создание при вводе: " + Строка(Ресурс.СозданиеПриВводе));
Сообщить("Параметры выбора: " + Строка(Ресурс.ПараметрыВыбора.Количество()));
Сообщить("Связи параметров: " + Строка(Ресурс.СвязиПараметровВыбора.Количество()));
НайденОтбор = Ложь;
Для Каждого Параметр Из Ресурс.ПараметрыВыбора Цикл
Если Параметр.Имя = "Отбор.ПрочиеОтношения" Тогда
НайденОтбор = Истина;
Сообщить(ТипЗнч(Параметр.Значение) = Тип("Булево"));
Сообщить(Параметр.Значение = Истина);
КонецЕсли;
КонецЦикла;
Сообщить(Ресурс.СвязьПоТипу);
ФормаВыбора = Ресурс.ФормаВыбора;
Если ФормаВыбора <> Неопределено Тогда
Сообщить(ФормаВыбора.ПолноеИмя());
Иначе
Сообщить("Особая форма выбора явно не назначена");
КонецЕсли;
Сообщить(Ресурс.ПараметрыВыбора.Количество() = 1);
Сообщить(НайденОтбор);
Сообщить(Ресурс.СвязиПараметровВыбора.Количество() = 0);Разбор по шагам
Сначала подтверждаем ссылочный тип конкретного ресурса.
БыстрыйВыбор, СозданиеПриВводе и ВыборГруппИЭлементов — самостоятельные настройки выбора.
Считаем фиксированные массивы параметров и связей. Реальный параметр Отбор.ПрочиеОтношения содержит Истина; проверяем его имя, тип и значение, не изменяем массив.
Перед ПолноеИмя назначенной формы проверяем Неопределено. СвязьПоТипу не означает выбранное значение поля.
Как проверить результат
По XML подтверждение ссылочного типа Истина; найден один Отбор.ПрочиеОтношения с булевым Истина, массив связей пуст. Все явные проверки Истина.
Особая форма не назначена; ни форма выбора, ни реальный партнёр не открываются.
Ожидаемый результат
Изучен контракт выбора значения без извлечения контактных данных партнёров.
На что обратить внимание
СозданиеПриВводе не разрешает безусловно создавать партнёров при импорте.
Отбор выбора не заменяет права, RLS или проверку входных ссылок при записи.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.