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