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