Выполняет поиск по полному имени таблицы.
Синтаксис
НайтиПоИмени(<Имя>)Полное описание, параметры и ограничения
СоединенияИсточникаЗапросаСхемыЗапроса.НайтиПоИмени (QuerySchemaQuerySourceJoins.FindByName)
СоединенияИсточникаЗапросаСхемыЗапроса (QuerySchemaQuerySourceJoins)
НайтиПоИмени (FindByName)
Доступен, начиная с версии 8.3.7.
Синтаксис:
НайтиПоИмени(<Имя>)
Параметры:
<Имя> (обязательный)
Тип: Строка.
Полное имя таблицы.
Возвращаемое значение:
Тип: СоединениеИсточникаЗапросаСхемыЗапроса.
Описание:
Выполняет поиск по полному имени таблицы.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.3.7.
Методическая информация
Практические примеры
Найти и удалить только свою связь источников
Проверяем собственное соединение по псевдониму Цены, получаем допустимый индекс и удаляем его после выполнения запроса.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В учебной обработке или общем модуле выполните каждый фрагмент отдельно на сервере. Все запросы используют только свои числа и параметры, без справочников, документов и регистров рабочей базы.
СхемаЗапроса редактирует структуру и формирует текст, а Запрос выполняет этот текст. Родительская схема должна оставаться в переменной, пока используются её дочерние объекты.
Не переносите полученные дочерние объекты между разными схемами и не обращайтесь к элементу после его удаления. Упражнения удаления работают только со своей структурой в памяти.
Схема = Новый СхемаЗапроса;
Схема.УстановитьТекстЗапроса("ВЫБРАТЬ 3 КАК Количество, 250 КАК Цена");
Если Схема.ПакетЗапросов.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один собственный запрос";
КонецЕсли;
Выбор = Схема.ПакетЗапросов.Получить(0);
Если ТипЗнч(Выбор) <> Тип("ЗапросВыбораСхемыЗапроса") Тогда
ВызватьИсключение "Первый собственный запрос не является выборкой";
КонецЕсли;
Если Выбор.Операторы.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один собственный оператор ВЫБРАТЬ";
КонецЕсли;
Оператор = Выбор.Операторы.Получить(0);
Источники = Оператор.Источники;
ТоварыИсточник = Источники.Добавить(Тип("ВложенныйЗапросСхемыЗапроса"), "Товары");
ЦеныИсточник = Источники.Добавить(Тип("ВложенныйЗапросСхемыЗапроса"), "Цены");
ТоварыИсточник.Источник.Запрос.УстановитьТекстЗапроса("ВЫБРАТЬ ""Книга"" КАК Наименование, 3 КАК Количество ОБЪЕДИНИТЬ ВСЕ ВЫБРАТЬ ""Ручка"", 1");
ЦеныИсточник.Источник.Запрос.УстановитьТекстЗапроса("ВЫБРАТЬ ""Книга"" КАК Наименование, 250 КАК Цена");
Поля = Оператор.ВыбираемыеПоля;
Поля.Очистить();
ПолеИмя = Поля.Добавить("Товары.Наименование");
ПолеКоличество = Поля.Добавить("Товары.Количество");
ПолеЦена = Поля.Добавить("ЕСТЬNULL(Цены.Цена, 0)");
КолонкаИмя = Выбор.Колонки.Найти(ПолеИмя);
КолонкаКоличество = Выбор.Колонки.Найти(ПолеКоличество);
КолонкаЦена = Выбор.Колонки.Найти(ПолеЦена);
Если КолонкаИмя = Неопределено Или КолонкаКоличество = Неопределено Или КолонкаЦена = Неопределено Тогда
ВызватьИсключение "Нет колонок собственных товаров и цен";
КонецЕсли;
КолонкаИмя.Псевдоним = "Наименование";
КолонкаКоличество.Псевдоним = "Количество";
КолонкаЦена.Псевдоним = "Цена";
Соединения = ТоварыИсточник.Соединения;
Связь = Соединения.Добавить(ЦеныИсточник, "Товары.Наименование = Цены.Наименование");
Связь.ТипСоединения = ТипСоединенияСхемыЗапроса.ЛевоеВнешнее;
Найденная = Соединения.НайтиПоПсевдониму("Цены");
Если Найденная = Неопределено Тогда
ВызватьИсключение "Не найдена собственная связь с ценами";
КонецЕсли;
Если Соединения.Количество() <> 1 Тогда
ВызватьИсключение "Ожидалась одна собственная связь";
КонецЕсли;
ИндексСвязи = Соединения.Индекс(Найденная);
Если ИндексСвязи < 0 Или ИндексСвязи >= Соединения.Количество() Тогда
ВызватьИсключение "Недопустимый индекс собственной связи";
КонецЕсли;
Сообщить(Соединения.Получить(ИндексСвязи).Источник = ЦеныИсточник);
Сообщить(Соединения.НайтиПоИмени("НетТакойУчебнойТаблицы") = Неопределено);
Запрос = Новый Запрос(Схема.ПолучитьТекстЗапроса());
ДоУдаления = Запрос.Выполнить().Выгрузить();
Если ДоУдаления.Количество() <> 2 Тогда
ВызватьИсключение "Неожиданное число собственных строк соединения";
КонецЕсли;
Сообщить(ДоУдаления.Количество() = 2);
Соединения.Удалить(ИндексСвязи);
Сообщить(Соединения.Количество() = 0);
Соединения.Очистить();
Сообщить(Соединения.Количество() = 0);Разбор по шагам
Ищем связь по псевдониму созданного нами источника, а не по подписи товара.
НайтиПоИмени предназначен для полного имени таблицы. У вложенного источника нет имени Справочник.Товары, поэтому проверяем отдельный случай отсутствия.
Индекс проверен на оба края до Получить и Удалить.
Пока связь существует, выполняем свой запрос и получаем оба товара.
Удаляем элемент собственной коллекции в памяти. После этого не используем Связь или Найденная и не выполняем старую структуру запроса.
Как проверить результат
Пять сообщений Истина.
После удаления и очистки собственная коллекция соединений пуста.
Ожидаемый результат
Разобран жизненный цикл дочернего объекта связи.
На что обратить внимание
Удаление связи может изменить смысл запроса; без осознанной перестройки его не выполняют.
Очистить здесь не удаляет ни товары, ни цены из базы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.