НайтиДокумент

Найти документ по значению.

Синтаксис:

НайтиДокумент(<Документ>)

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

FindDocument

Параметры:

<Документ>

Выражение, содержащее значение типа «Документ».

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

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

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

Описание:

Метод НайтиДокумент выполняет поиск документа по значению, заданно­му параметром <Документ>. Данный метод используется для позиционирова­ния объекта на конкретный документ.

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

Пример:

Процедура УдалДок(Докум)

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

// позиционируем созданный объект на заданном документе

Док.НайтиДокумент(Докум);

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

// если документ найден, то удалим его

Док.Удалить();

Иначе

Предупреждение ("Неверно задан документ!");

КонецЕсли;

КонецПроцедуры

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

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

Синтаксис:

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

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

FindByNum

Параметры:

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

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

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

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

Описание:

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

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

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

Пример:

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

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

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

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

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

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

// ...

КонецЕсли;

КонецЕсли;

Получить Строку ПоНомеру

Получить строку документа по номеру.

Синтаксис:

ПолучитьСтрокуПоНомеру(<Номер>)

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

GetLineByNum

Параметры:

<Номер>

Выражение, содержащее номер искомой строки.

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

Число 1 — если действие выполнено;

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

Описание:

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

Пример:

Процедура УдалЗаданнойСтроки(Док, Стр)

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

// если переданный параметр содержит значение документа, то

// найдем в нем строку

Док.ПолучитьСтрокуПоНомеру(Стр);

// удалим найденную строку спецификации документа

Док.УдалитьСтроку();

Иначе

Предупреждение("Документ не выбран!");

КонецЕсли;

КонецЕсли;