Тип: КоллекцияДоступныхПолейКомпоновкиДанных. Содержит коллекцию доступных полей.
Полное описание, параметры и ограничения
ДоступныеПоляКомпоновкиДанных.Элементы (DataCompositionAvailableFields.Items)
ДоступныеПоляКомпоновкиДанных (DataCompositionAvailableFields)
Элементы (Items)
Доступен, начиная с версии 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";
Настройки = Схема.НастройкиПоУмолчанию;
Для Каждого ИмяПоля Из СтрРазделить("Наименование,Количество,Цена,Сумма", ",") Цикл
Выбранное = Настройки.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных(ИмяПоля);
Выбранное.Использование = Истина;
КонецЦикла;
Детали = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
Детали.Использование = Истина;
АвтоВыбор = Детали.Выбор.Элементы.Добавить(Тип("АвтоВыбранноеПолеКомпоновкиДанных"));
АвтоВыбор.Использование = Истина;
Доступные = Новый ИсточникДоступныхНастроекКомпоновкиДанных(Схема);
Редактор = Новый КомпоновщикНастроекКомпоновкиДанных;
Редактор.Инициализировать(Доступные);
Редактор.ЗагрузитьНастройки(Настройки);
Рабочие = Редактор.Настройки;
Сообщить("Для выбора: " + Строка(Рабочие.ДоступныеПоляВыбора.Элементы.Количество()));
Сообщить("Для группировок: " + Строка(Рабочие.ДоступныеПоляГруппировок.Элементы.Количество()));
Сообщить("Для отбора: " + Строка(Рабочие.ДоступныеПоляОтбора.Элементы.Количество()));
Сообщить("Для отбора структуры: " + Строка(Рабочие.ДоступныеПоляОтбораЭлементовСтруктуры.Элементы.Количество()));
Сообщить("Для дополнительного отбора: " + Строка(Рабочие.ДоступныеПоляДополнительныхОтборов.Элементы.Количество()));
Сообщить("Для порядка: " + Строка(Рабочие.ДоступныеПоляПорядка.Элементы.Количество()));
Сообщить("Для параметров данных: " + Строка(Рабочие.ДоступныеПоляПараметровДанных.Элементы.Количество()));
Сообщить("Доступных вложенных объектов: " + Строка(Рабочие.ДоступныеОбъекты.Элементы.Количество()));
ПолеКоличества = Рабочие.ДоступныеПоляВыбора.НайтиПоле(Новый ПолеКомпоновкиДанных("Количество"));
Сообщить(ПолеКоличества <> Неопределено);
Сообщить(Рабочие.Выбор.Элементы.Количество() = 4);Разбор по шагам
Инициализируем редактор источником на основании собственной схемы и загружаем настройки.
Берём именно Редактор.Настройки: доступные поля относятся к инициализированным рабочим настройкам.
Семь категорий полей и набор вложенных объектов показываем отдельно; их состав/системные элементы могут различаться.
НайтиПоле получает ПолеКомпоновкиДанных. Проверяем наличие Количество и четыре собственных выбранных поля.
Как проверить результат
Восемь диагностических количеств и два сравнения Истина.
Не ожидайте в каждом доступном контейнере ровно 4: это доступные поля настройки, а не готовые строки запроса.
Ожидаемый результат
Разделены источники доступных полей, выбранные поля и данные результата.
На что обратить внимание
У нового неинициализированного объекта доступные поля могут отсутствовать/не быть подготовлены.
Количество доступных вложенных объектов не равно количеству элементов Структура.
В этой задаче сам процессор компоновки не запускается; Книга/Ручка ещё не получены как результат.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.