ВыбратьПоЗначению

Открыть выборку документов по значению.

Синтаксис:

ВыбратьПоЗначению(<НачалоВыборки>, <КонецВыборки>, <ИмяОтбора>, <3нач>)

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

SelectByValue

Параметры:

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

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

Число 1 — если действие выполнено и в выборке есть хотя бы один доку­мент; 0 — если действие не выполнено или в выборке нет ни одного документа.

Описание:

Метод ВыбратьПоЗначению открывает выборку документов в интервале с <НачалоВыборки> по <КонецВыборки>, для которых реквизит отбора <ИмяОтбора> имеет конкретное заданное значение <3нач>.

Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возрастания даты и времени записи документов (если не задан обратный порядок методом ОбратныйПорядок).

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

Пример:

Если Режим = "Подробный" Тогда

Док = СоздатьОбъект("Документ");

// открываем выборку документов

Док.ВыбратьПоЗначению(ДатаНачало, ДатаКонец, "Автор", "Сидоров");

// цикл получения документов

Пока Док.ПолучитьДокумент() > 0 Цикл

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

КонецЦикла;

КонецЕсли;

См. также: ПолучитьДокумент, ОбратныйПорядок

ВыбратьПоНомеру

Открыть выборку документов по номеру.

Синтаксис:

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

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

SelectByNum

Параметры:

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

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

Число 1 — если действие выполнено и в выборке есть хотя бы один доку­мент; 0 — если действие не выполнено или в выборке нет ни одного документа.

Описание:

Метод ВыбратьПоНомеру открывает выборку всех документов с данным номером одного вида или одного нумератора (например, для поиска всех доку­ментов с совпадающими номерами).

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

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

Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возрастания даты и времени записи документов (если не задан обратный порядок методом ОбратныйПорядок).

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

Пример:

Если Режим = "Подробный" Тогда

Док = СоздатьОбъект("Документ");

// открываем выборку документов

Док.ВыбратьПоНомеру("Ав-0005", '01.01.98', "АктПереоценки");

// цикл получения документов

Пока Док.ПолучитьДокумент() > 0 Цикл

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

КонецЦикла;

КонецЕсли;

См. также: ПолучитьДокумент, ОбратныйПорядок