Получает индекс элемента в коллекции.
Синтаксис
Индекс(<Элемент>)Полное описание, параметры и ограничения
СоставФункциональнойОпции.Индекс (FunctionalOptionContent.IndexOf)
СоставФункциональнойОпции (FunctionalOptionContent)
Индекс (IndexOf)
Доступен, начиная с версии 8.2.
Синтаксис:
Индекс(<Элемент>)
Параметры:
<Элемент> (обязательный)
Тип: ЭлементСоставаФункциональнойОпции.
Элемент, индекс которого определяется.
Возвращаемое значение:
Тип: Число.
Описание:
Получает индекс элемента в коллекции.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Найти ЗаказКлиента в составе опции и проверить обратный доступ по индексу
Поиск получает описание документа или его полное имя. Индекс относится к элементу состава, не к номеру заказа.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Описание = Метаданные.ФункциональныеОпции.Найти("ИспользоватьЗаказыКлиентов");
Если Описание = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ФункциональныеОпции.ИспользоватьЗаказыКлиентов";
КонецЕсли;
Документ = Метаданные.Документы.Найти("ЗаказКлиента");
Если Документ = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует Документы.ЗаказКлиента";
КонецЕсли;
Сообщить(Описание.Состав.Содержит(Документ));
Элемент = Описание.Состав.Найти(Документ);
Если Элемент = Неопределено Тогда
ВызватьИсключение "ЗаказКлиента не найден в составе этой опции; проверьте текущую конфигурацию";
КонецЕсли;
Индекс = Описание.Состав.Индекс(Элемент);
Если Индекс < 0 Тогда
ВызватьИсключение "Для найденного элемента не получен допустимый индекс";
КонецЕсли;
Сообщить(Описание.Состав.Получить(Индекс) = Элемент);
Сообщить(Элемент.Объект = Документ);
ПоИмени = Описание.Состав.Найти(Документ.ПолноеИмя());
Сообщить(ПоИмени = Элемент);Разбор по шагам
Документ — описание метаданных, не ссылка на запись.
Найти возвращает элемент состава или Неопределено; проверяем результат.
Индекс принимает именно элемент состава; его положение не является бизнес-приоритетом.
Получить и поиск по полному имени проверяют два пути обратно к тому же элементу.
Как проверить результат
Для указанного XML Содержит и три проверки совпадения дают Истина.
Подставьте описание документа, отсутствующего в составе: ожидается понятное исключение до чтения свойств элемента, не ошибка индекса.
Ожидаемый результат
Разобраны поиск по объекту/имени и безопасный доступ по индексу.
На что обратить внимание
Порядок элементов не используйте как постоянный внешний идентификатор.
Результат не удостоверяет видимость документа при всех параметрах формы и правах.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.