Метод используется для получения следующего по порядку значения из выборки данных на заданном уровне.
Синтаксис
Метод Группировка() имеет следующий синтаксис:
число Группировка(КодГруппировки[, Направление])
А также альтернативный англоязычный синтаксис:
number Group(GroupCode[,Order])
Параметры
Метод Группировка() имеет следующие параметры:
| Имя параметра | Тип | Описание | ||||||
|---|---|---|---|---|---|---|---|---|
| КодГруппировки | Число | Порядковый номер группировки (как они перечислены в тексте запроса) | ||||||
| Строка | Имя группировки (как она задана в тексте запроса) | |||||||
| Направление | Число | Направление выборки данных:
|
||||||
| *Жирным шрифтом выделены обязательные параметры | ||||||||
Возвращаемое значение
Число
Описание вариантов возвращаемых значений:
| 1 | — получено следующее значение выборки |
| 0 | — следующее значение выборки не получено |
Описание
Метод Группировка() предназначен для организации цикла получения данных из выборки, полученной методом Выполнить(). Если не указать параметр КодГруппировки, то выборка произойдет по самой первой группировке, указанной в тексте запроса.
Пример использования
Пример кода с использованием метода Выполнить()
ТекстЗапроса = "Обрабатывать НеПомеченныеНаУдаление; |ТекущийЭлемент = Справочник.Номенклатура.ТекущийЭлемент; |Группировка ТекущийЭлемент;"; Запрос = СоздатьОбъект("Запрос"); Запрос.Выполнить(ТекстЗапроса); Если Запрос.Группировка() = 0 Тогда Сообщить("Выборка пуста!"); Иначе //вывод первой найденной записи Сообщить(Запрос.ТекущийЭлемент); Пока Запрос.Группировка() = 1 Цикл //вывод остальных записей Сообщить(Запрос.ТекущийЭлемент); КонецЦикла; КонецЕсли;