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