СписокКонтрагентов.ВыбратьСтроки();

Пока СписокКонтрагентов.ПолучитьСтроку() = 1 Цикл

ВыбПоставщик.ДобавитьЗначение(СписокКонтрагентов.Контрагенты);

КонецЦикла;

Создание списка поставщиков производится таким же способом, как и создание списка номенклатуры.

2.5.3 Создание объекта типа Запрос

Функция СоздатьОбъект создает объект агрегатного типа данных и возвращает ссылку на него. Данная функция обычно используется одновременно с неявным определением переменной и присвоением ей ссылки на объект агрегатного типа данных.

Во всех программных модулях доступ к атрибутам и методам запросов может выполняться только через переменную, созданную функцией СоздатьОбъект. Чтобы вызвать атрибут или метод объекта, имя этого атрибута, метода (с указанием необходимых параметров пишется через точку после имени переменной. При создании объекта типа «Запрос» в качестве параметра функции СоздатьОбъект используют ключевое слово Запрос.

Запрос = СоздатьОбъект("Запрос");

ТекстЗапроса =

"//{{ЗАПРОС(Сформировать)

"//}}ЗАПРОС

Текст описания запроса на языке запросов состоит из последовательности операторов. Концом оператора является символ «;». Операторы могут записываться в любом порядке, Начинается построение запроса с прочтения временного периода, который указан пользователем на форме. Затем переменным запроса присваиваются ссылки на агрегатные типы данных, по которым будет проходить отбор. Далее следуют внутренние переменные, функции запроса, возвращающие количественное значение и на конец группировка отобранной в запросе информации. Кроме того запрос содержит указанные пользователем условия отбора.

С помощью переменных запроса происходит обращение к требуемым данным.

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

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

|Период с ВыбНачПериода по ВыбКонПериода;

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

Внутренние переменные используются в тексте запроса для образования ссылок на объекты конфигурации, чтобы использовать их при построении таких операторов запроса, как Группировка, Функция, Условие.

В объявлении внутренней переменной можно указывать несколько вариантов <ОписанияПеременной>. Все описания должны указывать на один и тот же тип данных (число, строку, справочник или документ). Переменной, указывающей на разные справочники или документы присваивается тип данных «Справочник неопределенного вида» или «Документ неопределенного вида» соответственно.

|Фирма = Регистр.ПартииНаличие.Фирма;

|Номенклатура = Регистр.ПартииНаличие.Номенклатура;

|Партия = Регистр.ПартииНаличие.Партия;

|Поставщик = Регистр.ПартииНаличие.Партия.Поставщик;

|Количество = Регистр.ПартииНаличие.Количество;

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

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

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

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

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

Синтаксис:

Функция<ИмяФункции>=<ТипФункции>(<Параметр>!<Уточненный Параметр>) [Когда (<Условие>)];

Параметры:

<ИмяФункции> Имя, которое присваивается функции. Поэтому имени можно в дальнейшем обращаться к значению вычисленной функции из вызывающего программного модуля как к атрибуту запроса. Данную внутреннюю переменную заранее объявлять не нужно. Она фактически неявно объявляется в операторе Функция.

<ТипФункции> Ключевое слово одной из встроенных функций языка.

<Параметр> Имя объявленной ранее внутренней переменной, значение которой используется как параметр встроенной функции <ТипФункции>. < У точненныйПараметр> Конкретизация объявленной ранее внутренней переменной, значение которой используется как аргумент встроенной функции.

< ТипФункции> Необязательное добавочное ключевое слово, использование которого в команде означает, что вычисление функции следует производить только при условии, когда заданное логическое выражение <Условие> истинно.

<Условие> Логическое выражение встроенного языка 1С:Предприятие. В логическом выражении могут участвовать как внутренние, так и внешние переменные запроса. Используется только после ключевого слова Когда.

Типы функции:

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

|Функция КоличествоНачОст = НачОст(Количество);

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

|Функция КоличествоКонОст = КонОст(Количество);

Приход Вычисляет приход для выбранных по запросу значений параметра.

|Функция КоличествоПриход = Приход(Количество);

Расход Вычисляет расход для выбранных по запросу значений параметра.

|Функция КоличествоРасход = Расход(Количество);

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

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

Группировка позволяет получить следующее значение выборки запроса на заданном уровне группировки.

Синтаксис:

Группировка (<Группировка> , <Направление>)

Параметры:

<Группировка> Выражение, содержащее порядковый номер или имя группировки.

<Направление> Необязательный параметр. Числовое выражение:

1 -- выборка значений группировки по возрастанию; -1 (минус единица) -- выборка значений группировки по убыванию. Значение по умолчанию: 1.

Возвращаемое значение:

Число: 1 -- если получено следующее значение выборки запроса, 0 -- если нет.

Описание:

Метод Группировка служит для организации цикла получения данных из выборки, сформированной в результате работы метода Выполнить. Метод Группировка позиционирует в выборке очередную строку в порядке, определенном параметром <Группировка>. Нельзя использовать метод группировка, задавая в качестве параметра младшие группировки, не использовав предварительно этот метод для позиционирования по старшим группировкам. Старшинство группировок определяется порядком их следования в тексте запроса.

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

Несколько операторов Группировка, следующих друг за другом в описании запроса, создают вложенные группировки запроса. Первая группировка -- самая старшая, в нее будет вложена следующая группировка, далее будет вложена следующая и т.д. По смыслу, вложенная группировка осуществляет более детальный просмотр объекта внешней группировки. Например, если во внешней группировке мы просматриваем регистр, то во вложенной группировке можно просмотреть документы движений этого регистра, а далее можно сформировать группировку по номерам строк этих документов.

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

Если в тексте запроса используется группировка по многоуровневому справочнику и не указано "Без Групп", то итоги по группам справочника будут накапливаться. Другими словами, если в запросе не нужны итоги по группам справочника, то в тексте запроса кроме использования оператора "Без Итогов" дополнительно следует в операторах "Группировка ..." использовать ключевое слово "Без Групп".

|Группировка Номенклатура без групп все;

|Группировка Поставщик;

Оператор Условие позволяет назначить условие включения информации в запрос.

Синтаксис:

Условие(<ЛогическоеВыражение>);

Параметры:

<ЛогическоеВыражение> Логическое выражение встроенного языка 1С: Предприятие.

Описание:

Оператор Условие назначает условие включения информации в запрос. Если значение <ЛогическоеВыражение> верно, то информация включается в запрос, иначе нет.

В логическом выражении могут участвовать как внутренние, так и внешние переменные запроса, т.е. переменные программного модуля, доступные в процедуре, использующей запрос. В параметре оператора Условие, в принципе, можно записывать логические выражения любой сложности, используя любые логические операторы (>, <, =, >=, о, И, ИЛИ, НЕ и другие). Кроме обычных логических операторов в операторе "Условие ..." языка запросов можно использовать дополнительный оператор - логический оператор принадлежности.

Оператор языка запросов "Условие (А в Б) ;" говорит о том. что условие истинно, когда значение А является подмножеством значения Б.

Следует отметить, что если значение Б пустое (объект не выбран), то условие является истинным, в отличии от оператора « = » (равно).

Если на принадлежность проверяется значение типа элемент справочника, то проверка выполняется с учетом его возможного вхождения в группу справочника.

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

|Условие(Фирма = ВыбФирма);

|Условие(Номенклатура в ВыбНоменклатура);

|Условие(Поставщик в ВыбПоставщик);

Таким образом, запрос будет осуществляться по указанным пользователем на форме диалога условиям.

Далее необходимо включить метод Выполнить, который анализирует описание запроса, содержащееся в тексте запроса <ТекстЗапроса>, выполняет выборку данных, формирует временный выходной набор данных (выборку), вычисляет значения функций запроса. Язык запросов предназначен для описания запросов к базе данных. Написанный на языке запросов текст описания передается методу Выполнить в качестве параметра. Метод Выполнить непосредственно выполняет запрос. В результате его выполнения формируется временный выходной набор данных, который в дальнейшем используется для заполнения формы отчета.