Запросы предназначены для извлечения и обработки информации из базы данных для предоставления пользователю в требуемом виде. Под обработкой здесь подразумевается группировка полей, сортировка строк, расчет итогов и т.д. Изменять данные с помощью запросов в 1С нельзя!
Запрос выполняется в соответствии с заданными инструкциями — текстом запроса . Текст запроса составляется в соответствии с синтаксисом и правилами языка запросов . Язык запросов 1С:Предприятие 8 основан на базе стандартного SQL , но имеет некоторые отличия и расширения.
Схема работы с запросом
Общая схема работы с запросом состоит из нескольких последовательных этапов:
- Создание объекта Запрос и установка текста запроса;
- Установка параметров запроса;
- Выполнение запроса и получение результата;
- Обход результата запроса и обработка полученных данных.
1. Объект Запрос имеет свойство Текст , которому необходимо присвоить текст запроса.
// Вариант 1
Запрос = Новый Запрос;
Запрос. Текст =
«ВЫБРАТЬ
| КурсыВалют.Период,
| КурсыВалют.Валюта,
| КурсыВалют.Курс
|ИЗ
|ГДЕ
;// Вариант 2
Запрос = Новый Запрос («ВЫБРАТЬ
| КурсыВалют.Период,
| КурсыВалют.Валюта,
| КурсыВалют.Курс
|ИЗ
| РегистрСведений.КурсыВалют КАК КурсыВалют
|ГДЕ
| КурсыВалют.Валюта = &Валюта» );
2. Установка значений параметров осуществляется методом УстановитьПараметр(< Имя>, < Значение>) . Параметры в тексте запроса обозначаются символом «& » и обычно используются в условиях отбора (секция ГДЕ) и в параметрах виртуальных таблиц.
Запрос);
3. После присвоения текста и установки параметров запрос необходимо выполнить и получить результат выполнения. Выполнение производится методом Выполнить () , который возвращает объект РезультатЗапроса . Из результата запроса можно:
- получить выборку с помощью метода Выбрать(< ТипОбхода>, < Группировки>, < ГруппировкиДляЗначенийГруппировок>) ;
- выгрузить значения в таблицу значений или дерево значений с помощью метода Выгрузить(< ТипОбхода>) .
// Получение выборки
Выборка = РезультатЗапроса. Выбрать ();// Получение таблицы значений
РезультатЗапроса = Запрос. Выполнить();
Таблица = РезультатЗапроса. Выгрузить ();
4. Обойти выборку результата запроса можно с помощью цикла:
Пока Выборка .Следующий () Цикл
Сообщить (Выборка .Курс );
КонецЦикла;
Полный пример работы с запросом может выглядеть так:
// Этап 1. Создание запроса и установка текста запроса
Запрос = Новый Запрос;
Запрос. Текст =
«ВЫБРАТЬ
| КурсыВалют.Период,
| КурсыВалют.Валюта,
| КурсыВалют.Курс
|ИЗ
| РегистрСведений.КурсыВалют КАК КурсыВалют
|ГДЕ
| КурсыВалют.Валюта = &Валюта» ;// Этап 2. Установка параметров
Запрос. УстановитьПараметр(«Валюта» , ВыбраннаяВалюта );// Этап 3. Выполнение запроса и получение выборки
РезультатЗапроса = Запрос. Выполнить();
Выборка = РезультатЗапроса. Выбрать ();// Обход выборки
Пока Выборка .Следующий () Цикл
Сообщить (Выборка .Курс );
КонецЦикла;
Состав текста запроса
Текст запроса состоит из нескольких секций:
- Описание запроса — перечень выбираемых полей и источников данных;
- Объединение запросов — выражения «ОБЪЕДИНИТЬ» и «ОБЪЕДИНИТЬ ВСЕ»;
- Упорядочивание результатов — выражение «УПОРЯДОЧИТЬ ПО …»;
- Автоупорядочивание — выражение «АВТОУПОРЯДОЧИВАНИЕ»;
- Описание итогов — выражение «ИТОГИ … ПО …».
Обязательной является только первая секция.
Временные таблицы и пакетные запросы
Язык запросов 1С поддерживает использование временных таблиц — таблиц, полученных в результате выполнения запроса и сохраненных на временной основе.
Часто можно столкнуться с ситуацией, когда в качестве источника запроса нужно использовать не таблицы базы данных, а результат выполнения другого запроса. Эту задачу можно решить с помощью вложенных запросов или временных таблиц . Применение временных таблиц позволяет упростить текст сложного запроса, разделив его на составные части, а также, в некоторых случаях, ускорить выполнение запроса и уменьшить количество блокировок. Для работы с временными таблицами используется объект МенеджерВременныхТаблиц . Создание временной таблицы производится при помощи ключевого слова ПОМЕСТИТЬ, за которым следует наименование временной таблицы.
МенеджерВТ = Новый МенеджерВременныхТаблиц;
Запрос = Новый Запрос;
Запрос. МенеджерВременныхТаблиц = МенеджерВТ;Запрос. Текст =
«ВЫБРАТЬ
| Валюты.Код,
| Валюты.Наименование
|ПОМЕСТИТЬ ВТВалюты
|ИЗ
| Справочник.Валюты КАК Валюты» ;РезультатЗапроса = Запрос. Выполнить ();
Для использования временной таблицы ВТВалюты в других запросах необходимо этим запросам присвоить общий менеджер временных таблиц — МенеджерВТ.
Пакетный запрос — это запрос, в котором содержится несколько запросов, разделенных символом «;». При выполнении пакетного запроса все входящие в него запросы выполняются последовательно, причем результаты всех временных таблиц доступны всем последующим запросам. Явное присвоение менеджера временных таблиц пакетным запросам не обязательно. Если менеджер временных таблиц не присвоен, то все временные таблицы удалятся сразу после выполнения запроса.
Для пакетных запросов доступен метод ВыполнитьПакет () , который выполняет все запросы и возвращает массив результатов. Временные таблицы в пакетном запросе будут представлены таблицей с одной строкой и одной колонкой «Количество», в которой хранится количество записей. Для отладки пакетных запросов можно использовать метод ВыполнитьПакетСПромежуточнымиДанными () : он возвращает реальное содержимое временных таблиц, а не количество записей.
// Пример работы с пакетным запросом
Запрос = Новый Запрос;
Запрос. Текст =
«ВЫБРАТЬ
| Валюты.Наименование
|ИЗ
| Справочник.Валюты КАК Валюты
|;
|ВЫБРАТЬ
| Номенклатура.Наименование
|ИЗ
| Справочник.Номенклатура КАК Номенклатура» ;РезультатПакета = Запрос. ВыполнитьПакет();
ТЗВалюты = РезультатПакета[ 0 ]. Выгрузить();
ТЗНоменклатура = РезультатПакета[ 1 ]. Выгрузить();// Пример использования временных таблиц в пакетном запросе
Запрос = Новый Запрос;
Запрос. Текст =
«ВЫБРАТЬ
| Товары.Ссылка КАК Товар
|ПОМЕСТИТЬ ВТТовары
|ИЗ
| Справочник.Номенклатура КАК Товары
|ГДЕ
| Товары.Производитель = &Производитель
|;
|ВЫБРАТЬ
| ВТТовары.Товар,
| ПТУ.Количество,
| ПТУ.Цена,
| ПТУ.Ссылка КАК ДокументПоступления
|ИЗ
| ВТТовары КАК ВТТовары
| ЛЕВОЕ СОЕДИНЕНИЕ Документ.ПоступлениеТоваровУслуг.Товары КАК ПТУ
| ПО ВТТовары.Товар = ПТУ.Номенклатура» ;Запрос. УстановитьПараметр(«Производитель» , Производитель);
РезультатЗапроса = Запрос. Выполнить();
Выборка = РезультатЗапроса. Выбрать ();Пока Выборка .Следующий () Цикл
КонецЦикла;
Виртуальные таблицы
Виртуальные таблицы — это таблицы, которые не хранятся в базе данных, а формируются платформой. По своей сути это вложенные запросы к одной или нескольким физическим таблицам, выполняемые платформой. Виртуальные таблицы получают информацию только из регистров и, в основном, предназначены для решения узкоспециализированных задач.
Существуют следующие виртуальные таблицы (в скобках указаны возможные параметры):
- Для регистров сведений:
- СрезПервых(<Период>, <Условие>) — наиболее ранние записи на указанную дату;
- СрезПоследних(<Период>, <Условие>) — наиболее поздние записи на указанную дату;
- Для регистров накопления:
- Остатки(<Период>, <Условие>) — остатки на указанную дату;
- Обороты(<НачалоПериода>, <КонецПериода>, <Периодичность>, <Условие>) — обороты за период;
- ОстаткиИОбороты(<НачалоПериода>, <КонецПериода>, <Периодичность>, <МетодДополненияПериодов>, <Условие>) — остатки и обороты за период;
- Для регистров бухгалтерии:
- Остатки(<Период>, <УсловиеСчета>, <Субконто>, <Условие>) — остатки на указанную дату в разрезе счета, измерений и субконто;
- Обороты(<НачалоПериода>, <КонецПериода>, <Периодичность>, <УсловиеСчета>, <Субконто>, <Условие>, <УсловиеКорСчета>, <КорСубконто>) — обороты за период в разрезе счета, измерений, кор. счета, субконто, кор. субконто;
- ОстатковИОборотов(<НачалоПериода>, <КонецПериода>, <Периодичность>, <МетодДополненияПериодов>, <УсловиеСчета>, <Субконто>, <Условие>) — остатки и оборотов в разрезе счета, измерений и субконто;
- ОборотыДтКт(<НачалоПериода>, <КонецПериода>, <Периодичность>, <УсловиеСчетаДт>, <СубконтоДт>, <УсловиеСчетаКт>, <СубконтоКт>, <Условие>) — обороты за период в разрезе счета Дт, счета Кт, Субконто Дт, Субконто Кт;
- ДвиженияССубконто(<НачалоПериода>, <КонецПериода>, <Условие>, <Порядок>, <Первые>) — движения вместе со значениями субконто;
- Для регистров расчета:
- База(<ИзмеренияОсновногоРегистра>, <ИзмеренияБазовогоРегистра>, <Разрезы>, <Условие>) — базовые данные регистра расчета;
- ДанныеГрафика(<Условие>) — данные графика;
- ФактическийПериодДействия(<Условие>) — фактический период действия.
При работе с виртуальными таблицами следует накладывать отборы в параметрах виртуальных таблиц, а не в условии ГДЕ. От этого сильно зависит время выполнения запроса.
Конструктор запроса
Для ускорения ввода текстов запросов платформа имеет специальные инструменты: Конструктор запроса и Конструктор запроса с обработкой результата . Для вызова конструкторов необходимо щелкнуть правой кнопкой мыши и выбрать требуемый пункт:
Также конструкторы можно вызвать из главного меню Текст .
При помощи конструктора запроса программист может интерактивно сконструировать текст запроса. Для этого мышкой выбираются нужные таблицы и поля, устанавливаются связи, группировки, итоги и т.д. Данный подход позволяет экономить время и избавиться от возможных ошибок. В результате своей работы конструктор запроса формирует текст запроса.
Конструктор запроса с обработкой результата кроме формирования текста запроса создает готовый фрагмент кода для получения и обработки данных.
Объект СхемаЗапроса
Платформа позволяет программно создавать и редактировать текст запроса при помощи объекта СхемаЗапроса . Объект имеет единственное свойство ПакетЗапросов , в котором объекта хранятся свойства всех запросов, редактируемых в данный момент. Объект СхемаЗапроса поддерживает следующие методы:
- УстановитьТекстЗапроса(< Текст>) — заполняет свойство ПакетЗапросов на основании переданного текста запроса;
- ПолучитьТекстЗапроса () — возвращает сформированный на основании свойства ПакетЗапросов текст запроса;
НайтиПараметры () — возвращает параметры запроса.
Рассмотрим пример работы с объектом СхемаЗапроса. Для программного формирования текста запроса
УПОРЯДОЧИТЬ ПО
Валюты.Код
Код на встроенном языке может выглядеть так:
СхемаЗапроса = Новый СхемаЗапроса;
Пакет1 = СхемаЗапроса. ПакетЗапросов[ 0 ];
Оператор1 = Пакет1. Операторы[ 0 ];
// добавление источника
ТаблицаРегистра = Оператор1. Источники. Добавить(«Справочник.Валюты» , «Валюты» );
// добавление полей
ПолеСсылка = Оператор1. ВыбираемыеПоля. Добавить(«Валюты.Ссылка» , 0 );
ПолеКод = Оператор1. ВыбираемыеПоля. Добавить(«Валюты.Код» , 1 );
// указание псевдонимов полей
Пакет1. Колонки[ 0 ]. Псевдоним = «Валюта» ;
Пакет1. Колонки[ 1 ]. Псевдоним = «Код» ;
// добавление условия
Оператор1. Отбор. Добавить(«НЕ ПометкаУдаления» );
// добавление упорядочивания
Пакет1. Порядок. Добавить(ПолеКод);
ТекстЗапроса = СхемаЗапроса. ПолучитьТекстЗапроса ();
Думаю все вы согласитесь с тем, что тема запросов в системе 1С:Предприятие 8 сегодня может похвастаться своей актуальностью. Именно поэтому нашу сегодняшнюю статью мы решили посвятить теме, связанной с объединением запросов, получении последних по дате документов в 1С запросе и соединением запросов. Давайте все таки начнем.
Итак, для того, чтобы создать в системе 1С:Предприятие пакетный запрос следует использовать предложение ПОМЕСТИТЬ. Пакетный запрос подразумевают под собой сразу же несколько запросов, описанных как один большой запрос. Все они выполняются последовательно один за другим. В результате использования любого из этих запросов, их можно поместить во внутрь временной таблицы и потом обратится к ней используя для этого уже какой то другой запрос. Наверное большинство из вас спросят: в чем же плюсы этого метода?
У нас есть ответ на этот вопрос. Лично я считаю, что самым большим преимуществом этого метода является возможность помещать его результаты во внутрь так называемой временной таблицы. В ней они могут использоваться несколько раз. Более того, вам при всем этом не нужно будет несколько раз подряд выполнять один и тот же вложенный запрос, все что вам будет нужно это просто напросто выбирать данные из уже готовой таблицы. Некоторые из вас спросят: есть ли в этой методике какие то минусы. Безусловно, как и во всем в нашем мире в этой методике есть некоторые, определенные недостатки.
К самым существенным можно отнести то, что во время использования временных таблиц в пакетных запросах система может формировать в базе данных вполне реальные таблицы. Возможно некоторые спросят: так в что же здесь такого плохого? С одной стороны это хорошо. Но, с другой вы будете тратить значительную часть своего времени для того, чтобы создавать запросы, а после того, как вы их используете, вам придется уделить некоторое время еще и для того, чтобы удалить их.
Вот, например:
ВЫБРАТЬ
Номенклатура,
Сумма(Сумма) КАК Сумма,
ПОМЕСТИТЬ ДокПриход
ИЗ
В результате, после того, как вы выполните этот запрос выведется только то количество записей, которое было помещено в таблицу. Результаты при этом будут находится в той же самой таблице. Давайте сделаем подобный запрос для расходного документа. Для этого нам потребуется разделить эти два запроса с помощью символа ";". Именно он способен рассказать пользователю о том, что закончился один пакетный запрос и начинается другой.
ВЫБРАТЬ
Номенклатура,
Сумма(Количество) КАК Количество,
Сумма(Сумма) КАК Сумма,
ПОМЕСТИТЬ ДокПриход
ИЗ
Документ.ПоступлениеТоваровУслуг.Товары
СГРУППИРОВАТЬ ПО Номенклатура
;
ВЫБРАТЬ
Номенклатура,
Сумма(Количество) КАК Количество,
Сумма(Сумма) КАК Сумма,
ПОМЕСТИТЬ ДокРасход
ИЗ
Документ.РеализацияТоваровУслуг.Товары
СГРУППИРОВАТЬ ПО Номенклатура
;
ВЫБРАТЬ
*
ИЗ
ДокПриход КАК ДокПриход
ПОЛНОЕ СОЕДИНЕНИЕ
ДокРасход КАК ДокРасход
ПО
Из этого можно увидеть, что третий запрос соединяет данные из этих двух запросов.
Давайте теперь попытаемся привести запрос к еще более красивому виду. Для этого в результате запроса попытаемся понять какие суммы и количество у нас были приходными, а какие расходными. Для того, чтобы сделать это следует немного изменить текст третьего запроса.
ВЫБРАТЬ
ДокПриход.Номенклатура,
ДокРасход.Номенклатура,
ИЗ
ДокПриход КАК ДокПриход
ПОЛНОЕ СОЕДИНЕНИЕ
ДокРасход КАК ДокРасход
ПО
ДокПриход.Номенклатура = ДокРасход.Номенклатура
В результате мы получим данные по приходу и расходу. Но, у нас все же осталась проблема, связанная с тем, каким образом можно было бы объединить два столбца, «Номенклатура» и «Номенклатура1»? В том случае, если брать значение из столбца «Номенклатура», то мы в итоге так и не получим значение из последней строки, ну а если же брать значение из столбца «Номенклатура1», то не получим в итоге значение из третьей строки. Для этого следует воспользоватся функцией «ЕСТЬNULL».
В итоге запрос будет иметь такой вид:
ВЫБРАТЬ
КАК Номенклатура,
ДокПриход.Количество КАК КолПриход,
ДокПриход.Сумма КАК СумПриход,
ДокРасход.Количество КАК КолРасход,
ДокРасход.Сумма КАК СумРасход
ИЗ
ДокПриход КАК ДокПриход
ПОЛНОЕ СОЕДИНЕНИЕ
ДокРасход КАК ДокРасход
ПО
ДокПриход.Номенклатура = ДокРасход.Номенклатура
При этом может возникнуть еще одна проблема, связанная с тем, каким образом можно было бы заменить значения на числовое ноль? Для этого вам опять придется воспользоватся функцией «ЕСТЬNULL» и написать запрос:
ВЫБРАТЬ
ЕСТЬNULL(ДокПриход.Номенклатура,ДокРасход.Номенклатура)
КАК Номенклатура,
ЕСТЬNULL(ДокПриход.Количество,0) КАК КолПриход,
ЕСТЬNULL(ДокПриход.Сумма,0) КАК СумПриход,
ЕСТЬNULL(ДокРасход.Количество,0) КАК КолРасход,
ЕСТЬNULL(ДокРасход.Сумма,0) КАК СумРасход
ИЗ
ДокПриход КАК ДокПриход
ПОЛНОЕ СОЕДИНЕНИЕ
ДокРасход КАК ДокРасход
ПО
ДокПриход.Номенклатура = ДокРасход.Номенклатура
Конструктор запросов в 1С 8.3 и 8.2 — мощнейший инструмент разработки. Он позволяет составить текст запроса при помощи специальной визуальной среды. Таким образом, чтобы создать запрос 1с не обязательно знать встроенный язык запросов, достаточно ориентироваться в не сложном и интуитивно понятном интерфейсе конструктора.
Конструктор запросов представляет из себя набор вкладок, каждая из которых отвечает за свою часть запроса. Так заполняя вкладку Таблицы и поля мы выбираем таблицы из которых запрос 1с будет получать данные и поля этих таблиц необходимые для решения конкретной задачи. Заполняя в кладку Условия мы накладываем условия на выбранные таблицы, для того чтобы выбрать из них только нужные нам данные и так далее.
Описание конструктора запросов на официальном сайте 1С 8: v8.1c.ru
Таблицы и поля; ; ; ; ; ; Вложенные запросы (в разработке).
Для того чтобы вызвать конструктор запросов 1с 8 в программном коде необходимо:
- Создать новый запрос
- Задать пустую строку текста запроса
- Поставить курсор мышки между кавычками, нажать правую кнопку мыши. В открывшемся контекстном меню выбрать пункт Конструктор запроса и ответить Да на вопрос о создании нового запроса. Если текст запроса уже записан, то необходимо щелкнуть на любом месте внутри него и вызвать конструктор;
Рассмотрим на небольших примерах с возрастающей сложностью все основные вкладки конструктора запросов. Такой подход позволит начинающему программисту 1с более эффективно изучить конструктор и все его возможности. Для примеров будем использовать конфигурацию Бухгалтерия 3.0.
Урок №1. Конструктор запросов — простейший пример использования.
Задача: написать запрос к справочнику номенклатура, выбрать всю номенклатуру справочника.
Новые вкладки: Таблицы и поля.
Новые механизмы: просмотр и редактирование текста запроса при помощи кнопки «Запрос».
Для начала создания запроса создадим новый запрос и вызовем конструктор (как это делается написано несколькими абзацами выше). После этого откроется окно конструктора на вкладке Таблицы и поля.
Теоретическая часть урока №1
Вкладка Таблицы и поля состоит из трех разделов:
База данных . В данном разделе представлены все таблицы базы данных, которые можно использовать для построения запроса;
Таблицы . В данный раздел выбираются таблицы необходимые для данного запроса. Для тогда чтобы переместить их из раздела база данных нужно:
- Либо дважды щелкнуть по таблице;
- Либо воспользоваться кнопками «>» или «>>».
Над разделом Таблицы присутствует ряд кнопок. Про большинство из них будет подробнее рассказано в следующих уроках. А пока дам только краткие пояснения.
- Создать вложенный запрос (красная линия). Предназначена для создания нового вложенного запроса;
- Создать описание временной таблицы (желтая линия). Позволяет задать имя временной таблицы, которая расположена вне данного запроса, также можно использовать для передачи в запрос таблицы значений;
- Изменить текущий элемент (зеленая линия). Позволяет перейти в выделенный вложенный запрос, временную таблицу или описание временной таблицы;
- Удалить текущий элемент (голубая линия). Удаляет выделенную таблицу из выбранных таблиц;
- Заменить таблицу (синяя линия). Открывает диалог замены выделенной таблицы. Полезно, если вы неверно выбрали виртуальную таблицу регистра, так как происходит позиционирование на текущей выбранной таблице в списке.
- Параметры виртуальной таблицы (фиолетовая линия). Открывает параметры виртуальной таблицы регистра.
Поля . В данный раздел выбираются поля таблиц из предыдущего раздела. Эти поля будут колонками таблицы или выборки полученной в результате выполнения запроса. Нужны они прежде всего, для того чтобы получить из выбранных таблиц только нужную в конкретном случае информацию. Для того чтобы переместить их из раздела Таблицы необходимо:
- Либо дважды щелкнуть по полю;
- Либо воспользоваться кнопками «>» или «>>»;
- Также можно добавить новое поле самостоятельно, используя произвольное выражение из полей выбранных таблиц и функций языка запросов.
Над разделом Поля присутствует ряд кнопок. Про создание полей при помощи произвольных выражений будет подробнее рассказано в следующих уроках. А пока дам только краткие пояснения.
- Добавить (зеленая линия). Предназначена для добавления нового поля при помощи редактора произвольных выражений;
- Изменить текущий элемент (красная линия). Позволяет изменить выделенное поле при помощи редактора;
- Удалить текущий (синяя линия). Удаляет выделенное поле из списка.
Практическая часть урока №1
Мы разобрались с теорией необходимой для выполнения задания, предусмотренного в данном уроке. Напомню как оно звучит: написать запрос к справочнику номенклатура, выбрать всю номенклатуру справочника.
Приступим к созданию запроса по номенклатуре:
- Создадим новый запрос и откроем конструктор методом указанным в начале урока;
- В разделе База данных , откроем ветку Справочники и найдем там справочник Номенклатура;
- Выделим его и при помощи кнопки «>» перенесем в раздел Таблицы;
- В разделе Таблицы раскроем справочник номенклатура при помощи значка «+»;
- В раскрывшемся списке полей найдем поле Ссылка и перенесем его в раздел Поля при помощи кнопки «>»
- Запрос по номенклатуре готов, нажимаем кнопку «ОК» в нижней части окна конструктора.
