Использование литерала запроса

Обход результата запроса

Чтобы выполнить запрос, используйте метод Выполнить(). ТипизированныйЗапрос.Выполнить() вернет значение обобщенного типа РезультатЗапроса<тип-строки-результата-запроса>. Этот тип является производным от типа Обходимое<тип-строки-результата-запроса>, поэтому результат запроса сразу же можно использовать в цикле для ... из, создать массив на его основе или использовать иные методы типа Обходимое (например — Обходимое.Единственный()).

// Задать текст запроса.
знч Запрос = Запрос{ВЫБРАТЬ 
                        Сотрудники.Ссылка КАК Ссылка,
                        Сотрудники.ФИО КАК ФИО 
                    ИЗ
                        Сотрудники КАК Сотрудники}

// Обойти результат запроса и обработать его.
для СтрокаРезультата из Запрос.Выполнить()
   пер СотрудникСсылка = СтрокаРезультата.Ссылка    
   пер СотрудникФИО    = СтрокаРезультата.ФИО
; 

// Получить единственную запись
знч ЕдинственнаяСтрока = Запрос.Выполнить().Единственный()

В этом цикле «1С:Шина» будет выдавать строки запроса в порядке получения их из базы данных, то есть в том порядке, который указан в тексте запроса. Переменная СтрокаРезультата будет иметь тип тип-строки-результата-запроса.

// Задать текст запроса.
знч Запрос = Запрос{ВЫБРАТЬ 
                        Сотрудники.Ссылка КАК Ссылка,
                        Сотрудники.ФИО КАК ФИО
                    В СТРУКТУРУ 
                        Сотрудник
                    ИЗ
                        Сотрудники КАК Сотрудники}

// Создание массива на основе результата запроса.
знч Результат = новый ЧитаемыйМассив(Запрос.Выполнить())

Явное указание имени типа строки

ДругойМетод(РезультатЗапроса<тип-строки-результата-запроса>)

// Задать текст запроса.
знч Запрос = Запрос{ВЫБРАТЬ 
                        Сотрудники.Ссылка КАК Ссылка,
                        Сотрудники.ФИО КАК ФИО 
                     В СТРУКТУРУ
                        Сотрудник
                     ИЗ
                        Сотрудники КАК Сотрудники}

// Передать результат запроса в другой метод.
ДругойМетод(Запрос.Выполнить())


метод ДругойМетод(РезультатЗапроса: РезультатЗапроса<Сотрудник>)
;

Параметры запроса

Параметры в литерал запроса передаются с помощью символа %:

• либо %имя-переменной
• либо %{выражение}

где выражение — это выражение встроенного языка. При этом, значения одинаковых выражений вычисляются только один раз, а не на каждое вхождение выражения в литерал.

Например, можно передать параметр Возраст.

// Установить значения параметров запроса.
знч Возраст = 40

// Задать текст запроса.
знч Запрос = Запрос{ВЫБРАТЬ 
                        Сотрудники.Ссылка КАК Ссылка,
                        Сотрудники.ФИО КАК ФИО 
                     ИЗ
                        Сотрудники КАК Сотрудники
                     ГДЕ
                        Сотрудники.Возраст < %Возраст}

Временные таблицы

Использование временных таблиц в запросах с литералами имеет свои особенности. Общие, для литералов и произвольных запросов, принципы работы с временными таблицами отражены здесь.

У временной таблицы, созданной в литерале запроса, есть краткое имя и полное имя. Краткое имя это собственное имя таблицы, указанное при ее создании. Полное имя — это краткое имя, к которому добавлено имя типа, владеющего модулем.

Например, если таблица ОценкиТоваров создана в модуле объекта справочника Товары, то у нее будут следующие имена:

• ОценкиТоваров,
• Товары.Объект.ОценкиТоваров.

В рамках одного модуля все имена временных таблиц должны быть уникальными. В то же время, временные таблицы, содержащиеся в разных модулях, могут иметь одинаковые имена.

Например, если в проекте есть периодический регистр сведений КурсыВалют, то в модуле этого регистра КурсыВалют можно объявить временную таблицу КурсыВалют. Обращаться к ней можно как КурсыВалют.КурсыВалют.

В то же время в этом модуле нельзя объявить временную таблицу с именем СрезПоследних, т.к. полное имя этой таблицы, КурсыВалют.СрезПоследних, будет пересекаться с именем виртуальной таблицы этого регистра КурсыВалют.СрезПоследних.

Временные таблицы видны за пределами литерала, в котором они объявлены, только если это не пакетный запрос на выборку данных (ВЫБРАТЬ без ПОМЕСТИТЬ). В таком пакетном запросе временная таблица уничтожается по окончании выполнения пакета.

В запросах, заданных литералом, можно обращаться к временным таблицам, объявленным в других литералах. Обращаться к временным таблицам, объявленным в рамках этого же пакета запросов, тоже можно.

По короткому имени можно обращаться в пределах литералов запросов того же модуля, в котором объявлена временная таблица. При этом, если есть обычная таблица с таким же именем, как и у временной таблицы, то обращение по короткому имени будет разрешено в пользу обычной таблицы. Чтобы в этой ситуации обратиться к временной таблице, нужно использовать ее полное имя.

По полному имени можно обращаться из литералов запросов других модулей к временным таблицам этого модуля, если этот модуль им виден.