Е. Ю. Хрусталева

Язык запросов «1С:Предприятия 8». Издание 3-е, стереотипное

Е. Ю. Хрусталева

Язык запросов «1С:Предприятия 8». Издание 3-е, стереотипное

Электронная книга в формате ePub; ISBN 978-5-9677-3478-6.

Версия издания от 12.12.2024.

Электронный аналог издания "Язык запросов «1С:Предприятия 8». Издание 3-е, стереотипное"
(ISBN978-5-9677-3476-2, М.: ООО "1С-Паблишинг", 2024; артикул печатной книги по прайс-листу фирмы "1С": 4601546148667; по вопросам приобретения печатных изданий издательства "1С-Паблишинг" обращайтесь к партнеру "1С", обслуживающему вашу организацию, или к другим партнерам фирмы "1С".)

---

Запросы – это один из базовых механизмов «1С:Предприятия» наряду со встроенным языком, который позволяет читать и обрабатывать данные, хранящиеся в базе. Для составления запросов «1С:Предприятие» использует собственный язык, основанный на SQL.
Эта книга поможет начинающим разработчикам, не знакомым с SQL, освоить язык запросов «1С:Предприятия». Книга также будет полезна и тем, кто имеет опыт составления SQL-запросов в других средах разработки, поскольку язык запросов «1С:Предприятия» содержит значительное количество расширений, ориентированных на специфику финансово-экономических задач.
В книге рассматривается значительное количество практических примеров. Для создания примеров использована версия 8.3.3.715 платформы «1С:Предприятие». С портала ИТС можно скачать демонстрационные конфигурации, иллюстрирующие эти примеры, и учебную версию платформы «1С:Предприятие 8».
Книга выпущена под редакцией Максима Радченко.

© ООО «1С-Паблишинг», 2024
© Оформление. ООО «1С-Паблишинг», 2024

Все права защищены.
Материалы предназначены для личного индивидуального использования приобретателем.
Запрещено тиражирование, распространение материалов, предоставление доступа по сети к материалам без письменного разрешения правообладателей.
Разрешено копирование фрагментов программного кода для использования в разрабатываемых прикладных решениях.

---

Фирма "1С"
123056, Москва, а/я 64, Селезневская ул., 21.
Тел.: (495) 737-92-57.
1c@1c.ru, http://www.1c.ru/
Издательство ООО "1С-Паблишинг"
127434, Москва, Дмитровское ш., д. 9.
Тел.: (495) 681-02-21.
publishing@1c.ru, http://books.1c.ru/

Установка системы «1С:Предприятие» и демонстрационных конфигураций

Учебную платформу и дополнительные материалы, которые понадобятся вам для этой книги, можно бесплатно скачать с портала ИТС по адресу https://its.1c.ru/bmk/query83.

Скачанный файл – это самораспаковывающийся архив query.exe. Запустите его и распакуйте в отдельную папку. Эта папка понадобится вам не только для установки системы «1С:Предприятие», но и в дальнейшем при чтении книги.

Если у вас еще не установлена платформа «1С:Предприятие», то вы можете установить учебную версию платформы и демонстрационные конфигурации. Если у вас уже установлена какая-либо версия платформы, то вы можете установить только демонстрационные конфигурации (Выбрать устанавливаемые компоненты – Демонстрационные конфигурации).

Чтобы установить систему «1С:Предприятие» и демонстрационные конфигурации, запустите файл autorun.exe и выберите первый пункт Быстрая установка (рекомендуется) (рис. 0.1).

Рис. 0.1. Быстрая установка

Будет установлена платформа, а также шаблоны пяти демонстрационных конфигураций, которыми вы можете пользоваться для самостоятельной проверки. Программа сразу же предложит вам запустить «1С:Предприятие». В дальнейшем вы можете запускать «1С:Предприятие» с помощью ярлыка, который появился у вас на рабочем столе, или через меню «Пуск» (рис. 0.2).

Рис. 0.2. Запуск через меню «Пуск»

Чтобы создать демонстрационную базу из шаблона:

Запустите «1С:Предприятие» и нажмите Добавить.

Выберите вариант Создание новой информационной базы и нажмите Далее.

Выберите вариант Создание информационной базы из шаблона и выберите нужный шаблон. Например, демонстрационная база «Язык запросов» (рис. 0.3). Нажмите Далее.

Рис. 0.3. Шаблон база «Язык запросов»

Нажмите Далее и задайте какое-нибудь понятное вам имя для этой информационной базы.

После этого, ничего не меняя, нажмите еще три раза Далее – и демонстрационная база появится в списке.

Глава 1. Механизм запросов

Как хранятся данные в «1С:Предприятии»

Прикладные решения, разработанные на платформе «1С:Предприятие», работают с данными, которые интерактивно вводит пользователь, заполняя различные формы ввода справочников, документов и т. д. Из этих форм данные с помощью встроенного языка записываются в базу данных и хранятся в ней. На основе введенных данных пользователю обычно требуется получить некоторую обобщенную информацию, необходимые ему итоговые данные, отчеты и т. д. Для этого используется механизм запросов, который рассматривается в данной книге.

Поэтому, прежде чем начинать осваивать язык запросов, важно понять, как хранятся данные в «1С:Предприятии». Для хранения данных «1С:Предприятие» использует реляционные базы данных. Реляционная база данных представляет собой совокупность различной информации, представленной в виде двумерных таблиц. Таблица базы данных состоит из набора строк и столбцов. Каждая строка (запись) этой таблицы характеризуется рядом значений, содержащихся в ее столбцах (полях).

В качестве примера можно привести данные о клиентах компании, хранящиеся в справочнике клиентов. В самом упрощенном виде данные о клиентах хранятся в одной – основной – таблице, где каждому клиенту соответствует одна запись, имеющая один и тот же набор полей, например: Код, Наименование, Адрес, Телефон и т. п. (табл. 1.1).

Таблица 1.1. Справочник клиентов в информационной базе (основная таблица)

Ссылка	Код	Наименование	Адрес	Телефон
Ref1	000000001	Соколов Иван Андреевич	Москва, …	8-916-222-33-55
Ref2	000000002	Орлов Сергей Иванович	Москва, …	8-926-555-66-77
Ref3	000000003	Маслова Ирина Николаевна	Санкт-Петербург, …	8-915-4447799

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

Например, при создании в конфигураторе справочника Клиенты платформа «1С:Предприятие» автоматически создает в информационной базе основную таблицу этого справочника с полями Ссылка, Код, Наименование, ПометкаУдаления, Предопределенный и ВерсияДанных.

ПРИМЕЧАНИЕ

Имена полей Код, Наименование и т. п. мы используем для простоты изложения. На самом деле имена полей таблиц в базе данных будут техногенными, например: _Code, _Description и т. п.

Затем пользователь в режиме 1С:Предприятие заполняет справочник данными, которые сохраняются в базе данных (рис. 1.1).

Рис. 1.1. Структура простого справочника в конфигураторе, в «1С:Предприятии» и в информационной базе

Поле Ссылка является уникальным идентификатором записи о клиенте, поля Код, Наименование, ПометкаУдаления, Предопределенный и ВерсияДанных являются стандартными реквизитами, которые платформа добавляет в любой справочник.

На рис. 1.1 также показаны три понятия, которые важно различать. В конфигураторе создается объект конфигурацииСправочник Клиенты. Данные этого объекта конфигурации (все записи справочника) вводятся в режиме 1С:Предприятие, затем эти данные записываются в таблицу справочника Клиенты в информационной базе. В этой таблице объектом базы данных является одна запись (данные одного элемента справочника), однозначно идентифицирующаяся значением поля Ссылка.

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

При добавлении реквизитов справочника в конфигураторе платформа создает поля соответствующего типа в основной таблице справочника (рис. 1.2).

Рис. 1.2. Структура справочника, имеющего реквизиты, в конфигураторе, в «1С:Предприятии» и в информационной базе

Если справочник является иерархическим, то платформа добавляет в структуру основной таблицы справочника в информационной базе поле Родитель и поле ЭтоГруппа (в случае если справочник имеет тип иерархии Иерархия групп и элементов) – рис. 1.3.

Рис. 1.3. Структура иерархического справочника в конфигураторе и в информационной базе

Например, справочник Товары является иерархическим с иерархией групп и элементов. При этом в таблице базы данных для записей, являющихся группой, поле ЭтоГруппа принимает значение Истина; для записей, не являющихся группой, поле ЭтоГруппа принимает значение Ложь, а поле Родитель является ссылкой на родительскую запись. Благодаря этому можно получить информацию о дочерних записях и родителях для каждого элемента справочника (рис. 1.4).

Рис. 1.4. Содержимое иерархического справочника в «1С:Предприятии» и в информационной базе

ПРИМЕЧАНИЕ

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

Если справочник является подчиненным (например, справочник РасчетныеСчета подчинен справочнику Поставщики), то в основную таблицу подчиненного справочника платформа добавляет поле Владелец, которое ссылается на элемент справочника-владельца (рис. 1.5).

Рис. 1.5. Структура подчиненного справочника в конфигураторе и в информационной базе

Благодаря этому можно получить информацию о том, какие элементы справочника-владельца владеют какими элементами подчиненного справочника – например, какие расчетные счета относятся к конкретному поставщику (рис. 1.6).

Рис. 1.6. Содержимое подчиненного справочника и справочника-владельца в «1С:Предприятии» и в информационной базе

ПРИМЕЧАНИЕ

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

Кроме реквизитов каждый элемент справочника может содержать некоторый набор информации, которая одинакова по своей структуре, но различна по количеству и относится к разным элементам справочника. Например, каждый элемент справочника Поставщики может содержать информацию о договорах, заключенных с этим поставщиком. Для каждого поставщика состав информации и количество записей в ней будут разными, а структура информации (например, дата начала и окончания действия договоров) – одинакова. Для описания подобной информации могут быть использованы табличныечасти справочника.

При добавлении в справочник табличной части в информационной базе создается подчиненная таблица со стандартными полями Ссылка и НомерСтроки и реквизитами табличной части, заданными в конфигураторе. Таблица, содержащая табличную часть, связана по полю Ссылка с основной таблицей. Благодаря этому можно получить информацию из табличной части, относящуюся к конкретному элементу справочника (рис. 1.7).

Рис. 1.7. Справочник с табличной частью в конфигураторе, в «1С:Предприятии» и в информационной базе

ПРИМЕЧАНИЕ

В поле Ссылка подчиненной таблицы, содержащей табличную часть, на самом деле хранится ссылка на запись основной таблицы, но для большей ясности в таблице на рис. 1.7 в этом поле отражено представление ссылки в виде наименования.

В информационной базе создается столько подчиненных таблиц, сколько табличных частей задано у справочника.

Таким образом, на примере справочника, имеющего табличную часть, мы видим, что одному объекту конфигурации в информационной базе могут соответствовать несколько таблиц: основная и одна или несколько подчиненных ей по полю Ссылка. При этом одному объекту базы данных соответствует одна запись в основной таблице и одна или несколько записей в подчиненных таблицах, содержащих табличные части (см. рис. 1.7).

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

Например, в конфигурации существует документ, имеющий поле, ссылающееся на справочник Клиенты (рис. 1.8).

Рис. 1.8. Документ, имеющий поле ссылочного типа, в конфигураторе, в «1С:Предприятии» и в информационной базе

ПРИМЕЧАНИЕ

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

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

Таким образом, мы рассмотрели примеры хранения в информационной базе «1С:Предприятия» ссылочных типов данных, таких как справочники, документы, планы видов характеристик и т. д.

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

Например, периодический регистр сведений предназначен для хранения данных (ресурсов) в разрезе измерений с привязкой ко времени. Благодаря стандартному полю Период регистр сведений может хранить не только актуальные значения данных, но и историю их изменения во времени.

На основе объекта конфигурации Регистр сведений платформа создает в информационной базе таблицу, в которой может храниться произвольная информация, «привязанная» к набору измерений и периоду. Например, периодический регистр сведений Цены, имеющий измерение Товар и ресурс Цена, хранит изменяющуюся во времени информацию о ценах на товары (рис. 1.9).

Рис. 1.9. Периодический регистр сведений в конфигураторе, в «1С:Предприятии» и в информационной базе

ПРИМЕЧАНИЕ

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

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

Как мы видим, в таблице регистра нет поля Ссылка, посредством которого мы можем сослаться на конкретную запись регистра. Ключом записи, однозначно идентифицирующим запись, является в случае периодического регистра сведений совокупность значений измерений регистра и периода.

В целом для нессылочных данных мы не можем получить какую-то конкретную запись из таблицы. Но мы можем получить некоторый набор записей по какому-либо условию (например, отобрать данные регистра сведений по периоду) и затем перебирать его в цикле.

Исходные таблицы для запросов

Прежде чем переходить к конкретным примерам использования языка запросов, остановимся также на составе таблиц базы данных, являющихся источниками запросов. Состав таблиц, доступных для запроса, и их описание мы можем увидеть в синтакс-помощнике в разделе Работа с запросами - Таблицы запросов.

Важно понимать, что прямого доступа к физическим таблицам, в которых хранится информация в базе данных, из «1С:Предприятия» получить нельзя. Это связано с тем, что в прикладном решении могут использоваться разные СУБД, имеющие свою специфику, а текст запроса должен быть универсальным и одинаково работать на любой используемой СУБД. Поэтому при выполнении запроса платформа автоматически транслирует текст запроса в набор инструкций, которые «понимает» конкретная СУБД. Кроме того, физические таблицы и поля в них имеют техногенные имена, из которых непонятно, что именно хранится в данном поле.

Поэтому с помощью запросов мы обращаемся к данным не напрямую, а через специальную «прослойку» в виде таблиц языка запросов. Этот процесс можно представить на следующей схеме (рис. 1.10).

Рис. 1.10. Доступ к данным в «1С:Предприятии»

Таким образом, все таблицы, к которым можно обратиться с помощью языка запросов, являются придуманными, воображаемыми, в большей или меньшей степени соответствующими реальным физическим таблицам СУБД. Однако по степени похожести на физические таблицы их принято разделять на реальные и виртуальные таблицы.

Реальные таблицы

Отличительной особенностью реальных таблиц является то, что они содержат данные какой-либо одной физической таблицы, хранящейся в базе данных, и то, что реальная таблица очень похожа на свою физическую таблицу. Например, реальной является таблица Справочник.Клиенты, соответствующая справочнику Клиенты, или таблица РегистрСведений.Цены, соответствующая регистру сведений Цены.

Для примера сравним структуру реальной и физической таблицы, хранящей данные справочника (табл. 1.2).

Таблица 1.2. Реальная и физическая таблица справочника «Клиенты»

Реальная таблица	Физическая таблица
Справочник.Клиенты	_Reference<n>
Ссылка	_Id<suff>
ВерсияДанных	_Version
ПометкаУдаления	_Marked
Предопределенный	_IsMetadata
Родитель	_ParentId<suff>
Владелец	_OwnerId<suff>
ЭтоГруппа	_Folder
Код	_Code
Наименование	_Description
<Имя реквизита>	_Fld<n><suff>
<Имя общего реквизита>	_Fld<n><suff>
Представление	–
<Имя табличной части>	–

Как мы видим, не все поля реальной и физической таблицы соответствуют друг другу. Например, поле Представление – виртуальное, то есть оно не хранится в физической таблице базы данных, а генерируется в момент выполнения запроса.

ПОДРОБНЕЕ

О поле Представление рассказано в разделе Как получить текстовое представление ссылочного поля.

О поле Имя табличной части рассказано в разделе Как получить данные из табличной части документа в качестве вложенной таблицы.

Но в целом реальная таблица очень похожа на физическую по набору полей, а также количество записей в обеих таблицах одинаково.

Реальные таблицы подразделяются на объектные (ссылочные) и необъектные (нессылочные).

В объектных (ссылочных) таблицах представлена информация ссылочных типов данных (справочники, документы, планы видов характеристик и т. д.). А в необъектных (нессылочных) – всех остальных типов данных (константы, регистры и т. д.).

Отличительной особенностью объектных (ссылочных) таблиц является то, что они включают в себя стандартное поле Ссылка, которое позволяет однозначно идентифицировать каждую запись (данные об объекте базы данных). Эти таблицы могут быть иерархическими, подчиненными, и поля таких таблиц могут содержать вложенные таблицы (табличные части).

Виртуальные таблицы

Виртуальные таблицы формируются в момент выполнения запроса на основе реальных таблиц базы данных. Например, виртуальная таблица РегистрСведений.Цены.СрезПоследних формируется на основе таблицы регистра сведений Цены (рис. 1.11).

Рис. 1.11. Физическая и виртуальная таблица регистра сведений

ПРИМЕЧАНИЕ

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

Как мы видим из рисунка 1.11, при заполнении цен товаров в регистре сведений Цены в «1С:Предприятии» данные за период по каждому товару сохраняются в физической таблице регистра сведений в базе данных.

Мы уже рассказывали выше про периодический регистр сведений (см. рис. 1.9). Благодаря стандартному полю Период регистр может хранить изменяющуюся во времени информацию для одних и тех же измерений, но для различных периодов.

При обращении запросом к виртуальной таблице РегистрСведений.Цены.СрезПоследних мы получим не все записи физической таблицы, а только последние по времени данные о ценах на товары. То есть срез последних записей регистра сведений возвращает по каждому значению измерения (Товары) одну наиболее позднюю (по времени, по значению поля Период) запись.

Таким образом, виртуальные таблицы мало похожи на какую-то физическую таблицу и содержат совсем иной состав записей, чем реальные таблицы.

Язык запросов «1С:Предприятия»

Механизм запросов позволяет получить доступ к разнообразной информации, хранящейся в базе данных «1С:Предприятия». Путем выполнения запроса к информационной базе из всей совокупности информации можно получить различные выборки данных из одной или нескольких взаимосвязанных таблиц, отобранных по определенному условию, отсортированных определенным образом и пр. Далее полученные данные могут быть проанализированы для решения различных прикладных задач, построения отчетов и т. п.

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

Общая схема выполнения запросов

Запрос формируется и выполняется разработчиком из встроенного языка. Для этого предназначены следующие программные объекты:

• Запрос,
• РезультатЗапроса,
• ВыборкаИзРезультатаЗапроса.

Не углубляясь в детали, рассмотрим самую распространенную и простейшую схему выполнения запроса.

ПОДРОБНЕЕ

Другие варианты выполнения запросов и обработки их результатов будут рассмотрены позднее в разделе Выполнение запросов из встроенного языка.

1. Сначала во встроенном языке создается объект Запрос (листинг 1.1).

Листинг 1.1. Создание запроса

• У объекта Запрос есть свойство Текст, в которое нужно поместить текст запроса, написанный на языке запросов. В тексте запроса описывается, какие данные, из каких таблиц нужно получить и как эти данные представить (листинг 1.2).

Листинг 1.2. Заполнение текста запроса

• Далее запрос выполняется с помощью метода Выполнить() объекта Запрос. Именно в этот момент и происходит чтение данных из базы данных. Прочитанные данные возвращаются в виде объекта РезультатЗапроса, содержащего выбранные данные из базы данных (листинг 1.3).

Листинг 1.3. Выполнение запроса

• Чтобы обработать данные, содержащиеся в объекте РезультатЗапроса, из результата запроса получается выборка с помощью метода Выбрать(), который возвращает новый объект ВыборкаИзРезультатаЗапроса, то есть коллекцию данных, предназначенную для последовательного обхода ее элементов (листинг 1.4).

Листинг 1.4. Получение выборки из результата запроса

• Далее выборка обходится с помощью цикла Пока Выборка.Следующий() Цикл, а в теле цикла производятся какие-то действия над данными, полученными с помощью запроса (листинг 1.5).

Листинг 1.5. Обход выборки

В результате, если соединить вместе текст листингов 1.1–1.5, мы получим процедуру встроенного языка, в которой создается и выполняется запрос, в данном примере выводящий наименования всех товаров из справочника Товары в окно сообщений (листинг 1.6).

Листинг 1.6. Вывод наименований всех товаров в окно сообщений

Пример этой процедуры находится в демонстрационной конфигурации «Язык запросов», прилагающейся к книге, в обработке Работа с запросами.

ПРИМЕЧАНИЕ

Установка демонстрационной конфигурации описана в разделе Установка системы «1С:Предприятие» и демонстрационных конфигураций.

Результат выполнения данной процедуры представлен на рис. 1.12.

Рис. 1.12. Вывод наименований всех товаров в окно сообщений

Чтобы не усложнять восприятие материала, пока мы не будем подробно останавливаться на выводе и обработке результатов запросов. Сначала мы начнем изучать сам язык запросов, то есть научимся правильно составлять текст запросов. Для выполнения запросов и просмотра результатов мы будем использовать специальную обработку Консоль запросов. Данная обработка помогает отлаживать и просматривать результаты выполнения запросов в режиме 1С:Предприятие.

Обработка Консоль запросов добавлена в демонстрационную конфигурацию «Язык запросов», прилагающуюся к книге. Самая последняя версия этой обработки опубликована на ИТС (http://its.1c.ru/db/metod81#content:4500:1).

ПРИМЕЧАНИЕ

Установка демонстрационной конфигурации описана в разделе «Установка системы "1С:Предприятие" и демонстрационных конфигураций».