ПараметрСхемыКомпоновкиДанных.УстановитьДоступныеЗначения

Методы · SetAvailableValues

Устанавливает доступные значения параметра.

Синтаксис

УстановитьДоступныеЗначения(<ДоступныеЗначения>)
Полное описание, параметры и ограничения

ПараметрСхемыКомпоновкиДанных.УстановитьДоступныеЗначения (DataCompositionSchemaParameter.SetAvailableValues)

ПараметрСхемыКомпоновкиДанных (DataCompositionSchemaParameter)

УстановитьДоступныеЗначения (SetAvailableValues)

Доступен, начиная с версии 8.1.

Синтаксис:
УстановитьДоступныеЗначения(<ДоступныеЗначения>)
Параметры:

<ДоступныеЗначения> (необязательный)
Тип: СписокЗначений.
Список доступных значений поля.
Если параметр не указан, у поля не будет доступных значений.
Описание:

Устанавливает доступные значения параметра.

Доступность:

Сервер, толстый клиент, внешнее соединение.

Использование в версии:

Доступен, начиная с версии 8.1.

Методическая информация

Практические примеры

Ограничить выбор порога тремя учебными значениями

У собственного параметра задаём конечный список 0, 1, 3 до инициализации редактора. Получаем список из описания и проверяем допустимость 2.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. В отдельной учебной базе 8.5.1.1343 создайте серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и вызовите своей учебной командой.

  2. Схема СКД строится программно, макет в конфигурации не нужен. Источник Local выполняет запрос из двух собственных константных строк, без справочников, документов и регистров.

  3. Каждое упражнение запускайте отдельно. Книга: 3 × 250 = 750; Ручка: 1 × 50 = 50; общая сумма 800. Результат хранится в памяти, не записывается в файл или базу.

  4. Для исследования поставьте точку останова перед последними проверками. ТаблицаЗначений и процессоры СКД здесь создаются и используются на сервере; напрямую в тонкий клиент таблица не возвращается.

  5. В собственной схеме добавлен числовой параметр МинимальноеКоличество и условие запроса Количество > &МинимальноеКоличество. Значение по умолчанию 1; это не отбор дерева настроек.

  6. Тип порога имеет КвалификаторыЧисла(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);

Разбор по шагам

  1. СписокЗначений создаём сами; значения — числа, представления — подсказки человеку.

  2. УстановитьДоступныеЗначения относится к описанию параметра схемы. Вызываем до Инициализировать.

  3. ДоступныеЗначения читаем с проверкой отсутствия. Сравниваем числа, а не строки представления.

  4. Показываем явный отказ от недопустимого пользовательского порога, не полагаясь на неописанную автоматическую проверку setter.

Как проверить результат

  1. Четыре сравнения Истина и сообщение об отказе от порога 2.

  2. Замените ПорогПользователя на 3: сработает ветка установки, не ветка отказа.

Ожидаемый результат

Найден и проверен конечный учебный перечень, недопустимое значение не применено.

На что обратить внимание

  1. Неопределено означает отсутствие конечного ограничения; пустой СписокЗначений — другой случай.

  2. Этот список ограничивает настройку выбора; серверный код всё равно должен проверять входные данные.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.