1С Предприятие 7.7. Документация
ВыбратьПоЗначению
Открыть выборку документов по значению.
Синтаксис:
ВыбратьПоЗначению(<НачалоВыборки>, <КонецВыборки>, <ИмяОтбора>, <3нач>)
Англоязычный синоним:
SelectByValue
Параметры:
| <НачалоВыборки> | Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого устанавливается начало выборки документов. Если данный параметр опущен, то выборка начинается с самого первого существующего в системе документа. | ||
| <КонецВыборки> | Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки документов. Если данный параметр опущен, то выборка заканчивается самым последним существующим в системе документом. | ||
| <ИмяОтбора> | Строковое выражение, которое содержит либо название «общего реквизита» документов, либо название «графы отбора» журналов, как они заданы в конфигураторе. | ||
| <3нач> | Значение отбора, по которому строится выборка документов. |
Возвращаемое значение:
Число 1 — если действие выполнено и в выборке есть хотя бы один документ; 0 — если действие не выполнено или в выборке нет ни одного документа.
Описание:
Метод ВыбратьПоЗначению открывает выборку документов в интервале с <НачалоВыборки> по <КонецВыборки>, для которых реквизит отбора <ИмяОтбора> имеет конкретное заданное значение <3нач>.
Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возрастания даты и времени записи документов (если не задан обратный порядок методом ОбратныйПорядок).
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
Если Режим = "Подробный" Тогда
Док = СоздатьОбъект("Документ");
// открываем выборку документов
Док.ВыбратьПоЗначению(ДатаНачало, ДатаКонец, "Автор", "Сидоров");
// цикл получения документов
Пока Док.ПолучитьДокумент() > 0 Цикл
ТекДок = Док.ТекущийДокумент();
КонецЦикла;
КонецЕсли;
См. также: ПолучитьДокумент, ОбратныйПорядок
1С Предприятие 7.7. Документация
для отбора проводок может принимать
Параметр <ВидОтбора> для отбора проводок может принимать следующие значения (в скобках указан английский синоним):
|
"Счет" ("Account") |
Отбор по счету дебета или счету кредита проводки. Доступно если в метаданных включен отбор по счетам проводок. |
|
"СчетДт" ("AccountDt") |
Отбор по счету дебета проводки. Доступно если в метаданных включен отбор по дебету/кредиту счетов проводок. |
|
"СчетКт" ("AccountKt") |
Отбор по счету кредита проводки. Доступно если в метаданных включен отбор по дебету/кредиту счетов проводок. |
|
"Валюта" ("Currency") |
Отбор по валюте проводки. Доступно если в метаданных включен отбор по валюте проводок. |
|
<ВидСубконто> |
Отбор по виду субконто. Идентификатор вида субконто должен быть указан так, как он задан в метаданных. Доступно если в метаданных включен отбор по этому виду субконто. |
|
<РеквизитПроводки> |
Отбор по дополнительному реквизиту проводки. Идентификатор реквизита должен быть указан так, как он задан в метаданных. Доступно если в метаданных включен отбор по этому реквизиту проводки. |
После выполнения данного метода обход операций (проводок) осуществляется методами ПолучитьОперацию и ПолучитьПроводку.
Пример:
Опер = СоздатьОбъект("Операция");
Опер.ВыбратьПоЗначению(ДатаНач, ДатаКон, "Счет", СчетПоКоду("60"));
Пока Опер.ПолучитьПроводку() = 1 Цикл
Сообщить("Сумма " + Опер.Сумма);
КонецЦикла;
