Получает индекс элемента в коллекции.
Синтаксис
Индекс(<Элемент>)Полное описание, параметры и ограничения
КоллекцияДоступныхПолейКомпоновкиДанных.Индекс (DataCompositionAvailableFieldCollection.IndexOf)
КоллекцияДоступныхПолейКомпоновкиДанных (DataCompositionAvailableFieldCollection)
Индекс (IndexOf)
Доступен, начиная с версии 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.
Отсутствие чужого идентификатора проверяем отдельно. Удаление/добавление доступных полей не вызывается.
Как проверить результат
Три сравнения Истина и диагностический индекс.
Измените порядок полей в собственной схеме: урок должен находить поле по идентификатору, а не по ожидаемой позиции.
Ожидаемый результат
Проверены поиск, индекс и обратное получение собственного доступного поля.
На что обратить внимание
Строковый идентификатор поля не является ИдентификаторКомпоновкиДанных, используемым другими методами адресации настроек.
Поиск только в Элементы не следует выдавать за рекурсивный обход всех вложенных папок.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.