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