Методы
Синтаксис:
Выбрать(<Тип обхода>, <Группировки>, <ГруппировкиДляЗначенийГруппировок>)
Параметры:
<Тип обхода> Необязательный
Тип: системное перечисление ОбходРезультатаЗапроса. Задает тип обхода записей в получаемой выборке.
Значение по умолчанию: ОбходРезультатаЗапроса.Прямой
<Группировки> Необязательный
Тип: Строка. Список группировок, разделенных запятыми, по которым будет производиться обход.
Для детальных записей указывается пустая строка. В случае, если группировки не указаны - будет использоваться следующая группировка, указанная в предложении запроса "ИТОГИ".
<ГруппировкиДляЗначенийГруппировок> Необязательный
Тип: Строка. Список группировок, разделенных запятыми, из которых будут выбираться значения группировок для обхода. Если указано "Все", то будут выбираться все значения группировок. Если указана пустая строка, то значения для группировок будут выбираться с предыдущей группировки.
Возвращаемое значение:
Тип: ВыборкаИзРезультатаЗапроса.
Описание:
Позволяет получить выборку вложенных записей для текущей записи результата.
Синтаксис:
Группировка()
Возвращаемое значение:
Тип: Строка. Возвращает имя группировки текущей записи. Если группировки нет, возвращается пустая строка.
Описание:
Позволяет получить имя группировки текущей записи выборки.
Пример:
ТекГрупиировка = Выборка.Группировка();
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число.
Описание:
Количество записей в выборке.
Синтаксис:
НайтиСледующий (< Структура поиска> )
Параметры:
<Структура поиска> Обязательный
Тип: Структура. Структура, которая определяет условия поиска. В ключе структуры находятся имена полей, в значениях - искомые значения.
Возвращаемое значение:
Тип: Булево. Истина, если запись найдена, Ложь - в противном случае.
Описание:
Позволяет найти запись по указанным условиям и установить указатель выборки на нее.
Примечание:
Текущая запись не рассматривается.
Пример:
СтуктураПоиска = Новый Структура("Товар, Контрагент");
СтуктураПоиска.Товар = НужныйТовар;
СтуктураПоиска.Контрагент = НужнайКонтрагент;
Пока Выборка.НайтиСледующий(СтуктураПоиска) Цикл
КонецЦидла;
Сбросить
Синтаксис:
Сбросить()
Описание:
Сбросить выборку. После вызова метода Следующий выборка спозиционируется на первую запись в ней.
Следующий (Next)
Синтаксис:
Следующий()
Возвращаемое значение:
Тип: Булево. Истина - если следующая запись выбрана. Ложь - если достигнут конец выборки.
Описание:
Выполняет получение следующей записи из результата запроса. Для обхода результата запроса нужно после получения выборки вызвать данный метод для позиционирования на первый элемент и далее вызывать до тех пор пока не будет возвращено значение Ложь.
Пример:
Пока Выборка.Следующий() Цикл
КонецЦикла;
СледующийПоЗначениюПоля (NextByFieldValue)
Синтаксис:
СледующийПоЗначениюПоля(< Имя поля>)
Параметры:
<Имя поля> Обязательный
Тип: Строка. Имя поля результата запроса, в котором будет осуществляться поиски следующего значения.
Возвращаемое значение:
Тип: Булево. Истина - если следующая запись выбрана. Ложь - в противном случае.
Описание:
Позволяет получить следующую запись по значению указанного поля. Выборка становится на следующую запись со значением в данном поле, отличающемся от текущего значения. При первом вызове - остается на текущей записи.
Пример:
Пока Выборка.СледующийПоЗначениюПоля("Товар") Цикл
КонецНикла;
ТипЗаписи (RecordType)
Синтаксис:
ТипЗаписи()
Возвращаемое значение:
Тип: системное перечисление ТипЗаписиЗапроса.
Описание:
Позволяет определить тип текущей записи выборки.
Пример:
ТекТип = Выборка.ТипЗаписи();
Уровень (Level)
Синтаксис:
Уровень()
Возвращаемое значение:
Тип: Число. Уровень текущей записи.
Описание:
Позволяет получить уровень текущей записи в иерархии и группировках. Уровень считается от начальной выборки из результата запроса.
Пример:
ТекУровень = Выборка.Уровень();
