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