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

       

ВыбратьПодчиненныеДокументы


Открыть выборку подчиненных документов.

Синтаксис:

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

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

SelectChildDocs

Параметры:



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

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

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

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

<Докум>

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

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

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

Описание:

Метод ВыбратьПодчиненныеДокументы открывает выборку всех доку­ментов, подчиненных заданному документу <Докум> в интервале с <НачалоВыборки> по <КонецВыборки>. Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возраста­ния даты и времени записи документов (если не задан обратный порядок мето­дом ОбратныйПорядок).

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

Пример:

//Проверка того, что по Счету были документы отгрузки

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

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

ДокТест.ВыбратьПодчиненныеДокументы('01.01.80', '31.12.99', ПоСчету);

// получение документа

Если ДокТест.ПолучитьДокумент() = 1 Тогда

   Предупреждение("По данному Счету были отгрузки!");

КонецЕсли;

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



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