ВыбратьДокументы
Открыть выборку документов.
Синтаксис:
ВыбратьДокументы(<НачалоВыборки>, <КонецВыборки>)
Англоязычный синоним:
SelectDocuments
Параметры:
<НачалоВыборки> |
Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого устанавливается начало выборки документов. Если данный параметр опущен, то выборка начинается с самого первого существующего в системе документа. |
<КонецВыборки> |
Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки документов. Если данный параметр опущен, то выборка заканчивается самым последним существующим в системе документом. |
Возвращаемое значение:
Число 1 — если действие выполнено и в выборке есть хотя бы один документ;
Число 0 — если действие не выполнено или в выборке нет ни одного документа.
Описание:
Метод ВыбратьДокументы открывает выборку документов в интервале с <НачалоВыборки> по <КонецВыборки>.
Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возрастания даты и времени записи документов (если не задан обратный порядок методом ОбратныйПорядок).
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
Если Режим = "Подробный" Тогда
Док = СоздатьОбъект("Документ");
// открываем выборку документов
Док.ВыбратьДокументы(ДатаНачало, ДатаКонец);
// цикл получения документов
Пока Док.ПолучитьДокумент() > 0 Цикл
ТекДок = Док.ТекущийДокумент();
КонецЦикла;
КонецЕсли;
См. также: ПолучитьДокумент, ОбратныйПорядок