Методы запросов

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

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

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

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

Необязательный параметр <Направление> представляется числом 1, если сгруппированные данные выбираются с одновременной сортировкой по возрастанию, и числом -1 – по убыванию. Значение по умолчанию: 1.

Метод Группировка возвращает число 1, если получено следующее значение выборки запроса, и число 0, если не получено. Метод используется последовательно сначала для позиционирования по старшим группировкам, затем по младшим. Старшинство группировок определяется порядком их следования в тексте запроса.

Пример:

Пока Запрос.Группировка(1) = 1 Цикл

Таб.ВывестиСекцию("Итоги");

Пока Запрос.Группировка(2)=1 Цикл

К = Запрос.Сотр;

К1 = Запрос.Код;

Таб.ВывестиСекцию("Список")

КонецЦикла;

КонецЦикла;

Фрагмент модуля относится к форме отчета, представленной на рис. 34. Модуль должен содержать два цикла в том случае, если необходимо вывести списки сотрудников по каждой должности. Внешний цикл обрабатывает группировку по должностям – это старшая группировка, в которой в качестве параметра метода может использоваться имя группировки из текста запроса (Долж) или число 1, а внутренний цикл – это младшая группировка, которая была выполнена по сотрудникам (в качестве параметра может использоваться имя Сотр или число 2).

Создание таблиц значений в модулях

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

1. Объект Таблица создается с помощью функции СоздатьОбъект.

2. Заполняются ячейки таблицы в соответствии с требованиями вывода данных.

3. Определяются секции таблицы.

4. Используются методы для формирования вывода данных в виде результирующей таблицы.

Пример:

Таб = СоздатьОбъект("Таблица");

Таб.ВывестиСекцию("Шапка");

Пока Запрос.Группировка(1)=1 Цикл

Таб.ВывестиСекцию("Строка");

КонецЦикла;

Таб.ВывестиСекцию("Итоги");

Таб.Показать();

Методы таблиц

ИсходнаяТаблица(<Строка>) – переназначает в качестве исходной таблицы-шаблона одну из таблиц той формы, в программном модуле которой запущена данная процедура. Имя таблицы сначала ищется в текущей форме, потом – в общих таблицах. Параметр Строка – это имя таблицы, заключенное в кавычки, если в форме создана одна таблица, то имя можно опустить, например ИсходнаяТаблица(“”).

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

Пример:

Запрос.Выполнить(ТекстЗапроса);

Таб=СоздатьОбъект("Таблица");

Таб.ВывестиСекцию("Все<");

Таб.ВывестиСекцию("К");

Таб.ВывестиСекцию("Все>");

Таб.Показать();

КонецПроцедуры

Пример демонстрирует создание таблицы значений для вывода результатов запроса (рис. 34).

Рис. 34. Таблица вывода результатов запроса

В данном примере таблица значений состоит из двух секций. Имена секций: Все, К. Секция К содержит имя исходной переменной ВыбДолж и результат работы запроса Запрос.Колво. Секция Все делится на две части, каждая из которых задается соответствующим параметром метода ВывестиСекцию ("Все<" или "Все>"). Секция "Все<" содержит заголовок таблицы и заголовки столбцов таблицы. Секция "Все>" содержит пустые строки.

ТолькоПросмотр(<Режим>) – позволяет или запрещает выполнять редактирование результирующей таблицы в зависимости от значения параметра Режим (1 – только просмотр, 0 – допускается редактирование).

Показать(<Заголовок>, <ИмяФайла>, <Активизировать>) – открывает окно с таблицей для просмотра и редактирования. Все параметры метода являются необязательными, поэтому чаще всего метод используется в следующем виде: Показать().

ПараметрыСтраницы(<Ориентация>, <Масштаб>, <РежимПечати  Копий>), <ПолеСлева>, <ПолеСправа>, <ПолеСверху>, <ПолеСнизу>,  <КолонтитулСверху>, <КолонтитулСнизу>, <Автомасштаб>, <ФлагЧерноБелойПечати>, <ИмяПринтера>).

Все параметры метода являются необязательными. Для параметра Ориентация используется число 1 (книжная) или число 0 (альбомная). Масштаб указывается в процентах, поля и колонтитулы задаются в миллиметрах. Для параметра РежимПечатиКопий используются числа 1 и 0 (1 – выводить страницы копий по порядку).