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