Иллюстрированный самоучитель по языку системы 1С:Предприятие

Методы документов

НайтиПоНомеру

Найти документ по номеру.

Синтаксис:

НайтиПоНомеру(<Номер>, <Дата>, <ИдентВида>)

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

FindByNum

Параметры:

<Номер> Строковое выражение, содержащее значение номера искомого документа.
<Дата> Выражение типа "дата".
<ИдентВида> Необязательный параметр. Строковое выражение, содержащее идентификатор вида документа или идентификатор Нумератора.

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

Число 1 – если действие выполнено (документ найден);

Число 0 – если действие не выполнено.

Описание:

Метод НайтиПоНомеру позиционирует документ по номеру. В качестве второго параметра задается любая дата из диапазона, в котором нужно искать документ с данным номером. Поиск зависит от выбранного в конфигураторе способа уникальности номеров (по месяцу, году и др.).

Метод может быть использован для объекта Документ общего вида, тогда для поиска нужно указать в параметре <ИдентВида> идентификатор вида документа или идентификатор Нумератора.

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

Пример:

Если ВвестиЧисло(Ном, "Введите номер приказа", 5, 0) = 1 Тогда

Док=СоздатьОбъект("Документ.ПриказыУвольнения");

// позиционируем документ по заданному номеру

Док.НайтиПоНомеру(Строка(Ном), Дата(0));

Если Док.Выбран() = 1 Тогда

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

// ...

КонецЕсли;

КонецЕсли;
Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.