Описание встроенного языка системы 1С Предприятие

ВыбратьДокументы


Открыть выборку документов.

Синтаксис:

ВыбратьДокументы(<НачалоВыборки>, <КонецВыборки>)

Англоязычный синоним:

SelectDocuments

Параметры:



<НачалоВыборки>

Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого уста­навливается начало выборки документов. Если дан­ный параметр опущен, то выборка начинается с само­го первого существующего в системе документа.

<КонецВыборки>

Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором уста­навливается конец выборки документов. Если дан­ный параметр опущен, то выборка заканчивается самым последним существующим в системе докумен­том.

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

Число 1 — если действие выполнено и в выборке есть хотя бы один доку­мент;

Число 0 — если действие не выполнено или в выборке нет ни одного доку­мента.

Описание:

Метод ВыбратьДокументы открывает выборку документов в интервале с <НачалоВыборки> по <КонецВыборки>.

Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возрастания даты и времени записи документов (если не задан обратный порядок методом ОбратныйПорядок).

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

Пример:

Если Режим = "Подробный" Тогда

   Док = СоздатьОбъект("Документ");

   // открываем выборку документов

   Док.ВыбратьДокументы(ДатаНачало, ДатаКонец);

   // цикл получения документов

   Пока Док.ПолучитьДокумент() > 0 Цикл

      ТекДок = Док.ТекущийДокумент();

   КонецЦикла;

КонецЕсли;

См. также: ПолучитьДокумент, ОбратныйПорядок



Содержание раздела