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