Устанавливает доступные значения параметра.
Синтаксис
УстановитьДоступныеЗначения(<ДоступныеЗначения>)Полное описание, параметры и ограничения
ПараметрСхемыКомпоновкиДанных.УстановитьДоступныеЗначения (DataCompositionSchemaParameter.SetAvailableValues)
ПараметрСхемыКомпоновкиДанных (DataCompositionSchemaParameter)
УстановитьДоступныеЗначения (SetAvailableValues)
Доступен, начиная с версии 8.1.
Синтаксис:
УстановитьДоступныеЗначения(<ДоступныеЗначения>)
Параметры:
<ДоступныеЗначения> (необязательный)
Тип: СписокЗначений.
Список доступных значений поля.
Если параметр не указан, у поля не будет доступных значений.
Описание:
Устанавливает доступные значения параметра.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Ограничить выбор порога тремя учебными значениями
У собственного параметра задаём конечный список 0, 1, 3 до инициализации редактора. Получаем список из описания и проверяем допустимость 2.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В отдельной учебной базе 8.5.1.1343 создайте серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и вызовите своей учебной командой.
Схема СКД строится программно, макет в конфигурации не нужен. Источник Local выполняет запрос из двух собственных константных строк, без справочников, документов и регистров.
Каждое упражнение запускайте отдельно. Книга: 3 × 250 = 750; Ручка: 1 × 50 = 50; общая сумма 800. Результат хранится в памяти, не записывается в файл или базу.
Для исследования поставьте точку останова перед последними проверками. ТаблицаЗначений и процессоры СКД здесь создаются и используются на сервере; напрямую в тонкий клиент таблица не возвращается.
В собственной схеме добавлен числовой параметр МинимальноеКоличество и условие запроса Количество > &МинимальноеКоличество. Значение по умолчанию 1; это не отбор дерева настроек.
Тип порога имеет КвалификаторыЧисла(1, 0, Неотрицательный): целое число 0–9. Собственные значения 0, 1, 2 и 3 сохраняются без округления. Формат ЧДЦ=0 лишь оформляет ввод; допустимые значения задаёт описание типа.
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныйИсточник";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "УчебныеТовары";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 250 КАК Цена,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Ручка"", 1, 50, 50";
Настройки = Схема.НастройкиПоУмолчанию;
Для Каждого ИмяПоля Из СтрРазделить("Наименование,Количество,Цена,Сумма", ",") Цикл
Выбранное = Настройки.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных(ИмяПоля);
Выбранное.Использование = Истина;
КонецЦикла;
Детали = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
Детали.Использование = Истина;
АвтоВыбор = Детали.Выбор.Элементы.Добавить(Тип("АвтоВыбранноеПолеКомпоновкиДанных"));
АвтоВыбор.Использование = Истина;
Набор.Запрос = "ВЫБРАТЬ Товары.Наименование, Товары.Количество, Товары.Цена, Товары.Сумма
|ИЗ (
|ВЫБРАТЬ
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 250 КАК Цена,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Ручка"", 1, 50, 50
|) КАК Товары
|ГДЕ Товары.Количество > &МинимальноеКоличество";
Порог = Схема.Параметры.Добавить();
Порог.Имя = "МинимальноеКоличество";
Порог.Заголовок = "Количество больше";
Порог.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(1, 0, ДопустимыйЗнак.Неотрицательный));
Порог.Значение = 1;
Порог.Использование = ИспользованиеПараметраКомпоновкиДанных.Всегда;
Порог.ЗапрещатьНезаполненныеЗначения = Ложь;
Порог.ДоступенСписокЗначений = Ложь;
Порог.ОграничениеИспользования = Ложь;
Порог.ВключатьВДоступныеПоля = Ложь;
Перечень = Новый СписокЗначений;
Перечень.Добавить(0, "Все учебные товары");
Перечень.Добавить(1, "Количество больше одного");
Перечень.Добавить(3, "Количество больше трёх");
Порог.УстановитьДоступныеЗначения(Перечень);
Доступные = Новый ИсточникДоступныхНастроекКомпоновкиДанных(Схема);
Редактор = Новый КомпоновщикНастроекКомпоновкиДанных;
Редактор.Инициализировать(Доступные);
Редактор.ЗагрузитьНастройки(Настройки);
Значения = Редактор.Настройки.ПараметрыДанных;
ДоступныеПараметры = Значения.ДоступныеПараметры;
Если ДоступныеПараметры = Неопределено Тогда
ВызватьИсключение "Редактор не инициализировал параметры собственной схемы";
КонецЕсли;
ИмяПорога = Новый ПараметрКомпоновкиДанных("МинимальноеКоличество");
ОписаниеПорога = ДоступныеПараметры.НайтиПараметр(ИмяПорога);
Если ОписаниеПорога = Неопределено Тогда
ВызватьИсключение "Параметр МинимальноеКоличество недоступен";
КонецЕсли;
Разрешенные = ОписаниеПорога.ДоступныеЗначения;
Если Разрешенные = Неопределено Тогда
ВызватьИсключение "Не перенесён собственный перечень порогов";
КонецЕсли;
Сообщить(Разрешенные.Количество() = 3);
Сообщить(Разрешенные.НайтиПоЗначению(1) <> Неопределено);
Сообщить(Разрешенные.НайтиПоЗначению(2) = Неопределено);
ПорогПользователя = 2;
Если Разрешенные.НайтиПоЗначению(ПорогПользователя) = Неопределено Тогда
Сообщить("Порог 2 не входит в учебный перечень: настройку не меняем");
Иначе
Значения.УстановитьЗначениеПараметра(ИмяПорога, ПорогПользователя);
КонецЕсли;
Сообщить(Порог.ПолучитьДоступныеЗначения().Количество() = 3);Разбор по шагам
СписокЗначений создаём сами; значения — числа, представления — подсказки человеку.
УстановитьДоступныеЗначения относится к описанию параметра схемы. Вызываем до Инициализировать.
ДоступныеЗначения читаем с проверкой отсутствия. Сравниваем числа, а не строки представления.
Показываем явный отказ от недопустимого пользовательского порога, не полагаясь на неописанную автоматическую проверку setter.
Как проверить результат
Четыре сравнения Истина и сообщение об отказе от порога 2.
Замените ПорогПользователя на 3: сработает ветка установки, не ветка отказа.
Ожидаемый результат
Найден и проверен конечный учебный перечень, недопустимое значение не применено.
На что обратить внимание
Неопределено означает отсутствие конечного ограничения; пустой СписокЗначений — другой случай.
Этот список ограничивает настройку выбора; серверный код всё равно должен проверять входные данные.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.