ВыборГруппы

Устанавливает или сбрасывает признак выбора группы.

Синтаксис:

ВыборГруппы([<ФлагВыбораГруппы>])

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

SelectGroup

Параметры:

<ФлагВыбораГруппы>

Необязательный параметр. Числовое выражение: 1 — выбирать группы; 0 — не выбирать группы.

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

Текущее числовое значение режима выборки групп (на момент до исполнения метода).

Описание:

Метод ВыборГруппы устанавливает режим выборки групп для формы списка счетов, которая открыта в режиме выбора или подбора счета. Открытие такой формы списка счетов обычно производится вызовом метода Выбрать или нажатием кнопки выбора, если выбираемый счет является элементом диалога.

По умолчанию выбор группы разрешен. Режим, устанавливаемый данным методом для списка счетов, влияет на интерактивный выбор пользователем значения типа «Счет» из списка счетов (плана счетов). Установка режима позволяет разрешить или запретить пользователю выбирать счета-группы (счета, которые могут иметь субсчета).

Пример:

ВыборГруппы(0);

ВыборГруппы

Установить режим выборки групп для элемента диалога типа «справочник».

Синтаксис:

ВыборГруппы(<Режим>)

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

SelectGroup

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 1 — выбирать группы; 0 — не выбирать группы. Значение по умолчанию — 1.

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

Текущее числовое значение режима выборки групп для элемента диалога (на момент до исполнения метода).

Описание:

Метод ВыборГруппы устанавливает режим выборки групп для выбранного элемента диалога типа «справочник».

По умолчанию, выборка элементов справочников для реквизитов в формах документов, журналов и справочников установлена без выбора групп, а в форме отчета — с выбором групп. Поэтому реально имеет смысл применять данный метод только в том случае, если надо изменить режим выборки групп.

Особенно необходим данный метод в случае, когда необходимо установить возможность выбора групп в графе табличной части документа.

Доступ к данному методу возможен только в контексте Модуля формы.

Пример:

* Если в табличной части документа существует какой-либо реквизит, например, «Статус» и необходимо, чтобы он мог принимать значения как элемента, так и группы, то в форме документа этому реквизиту следует установить:

Форма.Статус.ВыборГруппы(1);

Выбран

Проверить факт выбора элемента справочника.

Синтаксис:

Выбран()

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

Selected

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

Числовое значение: 1 — если элемент справочника выбран (спозиционирован); 0 — если не выбран.

Описание:

Метод Выбран возвращает число со значением 1 — если элемент справочника выбран (спозиционирован), 0 — если элемент справочника не выбран.

Пример:

// В диалоге формирования некоторого отчета

// ВыбСклад - реквизит диалога типа «справочник.Склад»

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

// Если Склад в диалоге не выбран, то формируем без условий

Заг1 = "По всем складам.";

Иначе

// если в диалоге выбран Склад

// то формируем отчет только по выбранному складу

Заг1 = "Отчет по складу " + ВыбСклад.Наименование;

КонецЕсли;

Выбран

Возвратить флаг выбора элемента перечисления.

Синтаксис:

Выбран()

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

Selected

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

Числовое значение: 1 — если элемент перечисления выбран (спозиционирован); 0 — если не выбран.

Описание:

Метод Выбран возвращает число со значением 1 — если элемент перечисления выбран (спозиционирован), 0 — если элемент перечисления не выбран.

Пример:

// В диалоге формирования некоторого отчета

// ВыбЕдИзмер — реквизит диалога типа «Перечисление.Единицы»

Если ВыбЕдИзмер.Выбран() = 0 Тогда

// Если единица измерений в диалоге не выбрана, то формируем отчет без условий

Заг1 = "По всем единицам измерения.";

Иначе

// если в диалоге выбрана единица измерений

// то формируем отчет только по выбранным единицам

Заг1 = "Отчет по товарам с единицей измерения " + ВыбЕдИзмер;

КонецЕсли;

Выбран

Возвратить флаг выбора документа.

Синтаксис:

Выбран()

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

Selected

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

Числовое значение: 1 — если документ выбран, 0 — если документ не выбран.

Описание:

Метод Выбран позволяет проверить сам факт позиционирования объекта типа «документ».

Пример:

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

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

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

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

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

// открываем выборку строк спецификации документа

Док.ВыбратьСтроки();

// цикл выбора строк спецификации документа

Если Док.КоличествоСтрок() > 0 Тогда

Пока Док.ПолучитьСтроку() = 1 Цикл

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

КонецЦикла;

КонецЕсли;

Выбран

Проверяет наличие значения.

Синтаксис:

Выбран()

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

Selected

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

Числовое значение: 1 — значение не пусто; 0 — значение пусто.

Описание:

Данный метод позволяет определить — пусто значение типа «ПланСчетгт или нет.

Пример:

* ИспПланСчетов — является реквизитом диалога формы, имеет тип «План Счетов».

Если ИспПланСчетов.Выбран() = 1 Тогда

БухИтоги.ИспользоватьПланСчетов(ИспПланСчетов);

КонецЕсли;

Выбран

Проверяет наличие значения.

Синтаксис:

Выбран()

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

Selected

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

Числовое значение:

1 — значение не пусто;

0 — значение пусто.

Описание:

Данный метод позволяет определить — пусто значение типа «ВидСубконто» или нет.

Пример:

* ВыбВидСубк1 — является реквизитом диалога формы типа «ВидСубконто».

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

БухИтоги.ИспользоватьСубконто(ВыбВидСубк1);

КонецЕсли;

Выбран

Проверяет факт выбора счета.

Синтаксис:

Выбран()

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

Selected

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

Числ: 1 — если счет выбран (спозиционирован); 0 — если не выбран.

Описание:

Метод Выбран для объекта созданного функцией СоздатьОбъект определяет, спозиционирован ли объект на каком либо счете или нет, для объекта хранящего значение типа «Счет» он определяет является значение пустым или нет. Метод возвращает число со значением 1 — если счет выбран (спозиционирован) или значение не пустое, 0 — если не выбран или значение пустое.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду ("76.02");

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

Сообщить("Счет найден");

КонецЕсли;

Выбран

Возвращает признак того, выбран конкретный вид расчета или нет.

Синтаксис:

Выбран()

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

Selected

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

Число: 1 — если конкретный вид расчета выбран; 0 в противном случае.

Описание:

Этот метод предназначен для определения, не является ли «пустым» значение переменной или реквизита типа «ВидРасчета».

Вид расчета (в отличие от группы расчетов, например) в рамках описываемого встроенного языка — сохраняемый агрегатный тип данных, т. е. объекты этого типа могут сохраняться в информационной базе. Например, реквизиты справочника, документа или журнала расчетов, могут иметь тип «ВидРасчета» и, следовательно, хранить ссылки на конкретные виды расчетов. При этом часто необходимо иметь возможность определить выбрано ли конкретное значение для реквизита (например, справочника или документа) этого типа.

Пример:

// Допл — объект типа "группа расчетов"

Допл = ГруппаРасчетов.Доплаты;

ЖЗ = СоздатьОбъект("ЖурналРасчетов.Зарплата");

// Док — ссылка на документ, имеющий реквизит Сотрудник

ЖЗ.ВыбратьЗаписиПоОбъекту(Док.Сотрудник);

Пока ЖЗ.ПолучитьЗапись() = 1 Цикл

Если ЖЗ.ВидРасч.ВходитВГРуппу(Допл) = 1 Тогда

// предполагается, что документы-основания этих

// видов расчета имеют реквизит ВР

Если ЖЗ.Документ.ВР.Выбран() = 0 Тогда

Сообщить("Не указан конкретный вид расчета в документе!");

КонецЕсли;

КонецЦикла;

Выбран

Возвращает признак того, выбран конкретный календарь или нет.

Синтаксис:

Выбран()

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

Selected

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

Число: 1, если конкретный календарь выбран; 0 в противном случае.

Описание:

Этот метод предназначен для определения, не является ли «пустым» значение переменной или реквизита типа «Календарь».

Календарь в рамках описываемого встроенного языка — сохраняемый агрегатный тип данных, т. е. объекты этого типа могут сохраняться в информацион-йой базе. Например, реквизиты справочника, документа или журнала расчетов, Могут иметь тип «Календарь» и, следовательно, хранить ссылки на конкретные календари. При этом часто необходимо иметь возможность определить выбрано ли конкретное значение для реквизита (например, справочника или документа) этого типа.

Пример:

// реквизит справочника Календ имеет тип "Календарь"

Спр = СоздатьОбъект("Справочник.Категории");

Спр.ВыбратьЭлементы();

Пока Спр.ПолучитьЭлемент() = 1 Цикл

Если Спр.Календ.Выбран() = 0 Тогда

Сообщить("Не указан конкретный календарь! ");

КонецЕсли;

КонецЦикла;

Выбран

Проверяет спозиционирован ли объект типа «Метаданные» на конкретном объекте метаданных или нет.

Синтаксис:

Выбран()

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

Selected

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

Число: 1 — если объект соответствует объекту метаданных (спозиционирован); 0 — если не соответствует.

Описание:

Метод Выбран возвращает число со значением 1 — объект соответствует объекту метаданных (спозиционирован), 0 — если не соответствует. Например, при обращении к массиву подчиненных метаданных по идентификатору, если метаданного с таким идентификатором не существует, возвращается не спозиционированный объект типа «Метаданные».

Пример:

Если Метаданные.Справочник("Организации").Выбран() = 1 Тогда

Сообщить("Есть справочник органиазаций");

КонецЕсли;

Выбрана

Определяет выбрана ли в данный момент операция.

Синтаксис:

Выбрана()

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

Selected

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

Число: 1 — операция выбрана; 0 — операция не выбрана.

Описание:

При использовании объекта «Операция» созданного функцией СоздатьОбъект метод Выбрана определяет спозиционирован ли объект в настоящий момент на некоторой операции или нет.

При использовании данного метода к атрибуту документа Операция (который имеет тип «Операция») он определяет, существует ли реально операция у документа или нет.

При использовании в форме журнала операций (проводок) метод определяет спозиционирован ли курсор.

При использовании в форме операции метод определяет, записана новая операция или нет.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Если Опер.Выбрана() = 0 Тогда

Сообщить("Операция не найдена");

КонецЕсли;

Выбрана

Проверить факт: выбрана ли корректная проводка.

Синтаксис:

Выбрана()

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

Selected

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

Число: 1 — если корректная проводка выбрана; 0 — если не выбрана.

Описание:

Метод Выбрана возвращает число со значением 1 — объект выбран или 0 — если не выбран.

Пример:

КП = СоздатьОбъект("КорректныеПроводки");

КП.ВыбратьКорректныеПроводки();

Пока КП.ПолучитьКорректнуюПроводку() = 1 Цикл

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

Сообщить(КП.Комментарий + " счет кредита — " + КП.СчетКт);

КонецЕсли;

КонецЦикла;

ВыбранаПоДт, ВыбранаПоКт

ВыбранаПоДт — определение, выбран ли итог по дебету;

ВыбранаПоКт — определение, выбран ли итог по кредиту.

Синтаксис:

ВыбранаПоДт()

ВыбранаПоКт()

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

SelectedByDt

SelectedByKt

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

Число: 0 —данный итог по дебету(кредиту) не выбран; 1 —данный итог по дебету(кредиту) выбран.

Описание:

Данные функция используются при обходе результатов запроса с детализацией периода по операциям и проводкам. Они показывают для текущей операции (проводки) попала ли она в запрос по дебетовой (кредитовой) корреспонденции.

Пример:

БухИтоги.ВыполнитьЗапрос(Дата1, Дата2, "50", , , , "Проводки");

БухИтоги.ВыбратьСчета();

БухИтоги.ВыбратьПериоды();

КолПрих=0;

КолРасх=0;

Пока БухИтоги.ПолучитьПериод() = 1 Цикл

Если БухИтоги.ВыбранаПоДт() = 1 Тогда

КолПрих = КолПрих + 1;

КонецЕсли;

Если БухИтоги.ВыбранаПоКт() = 1 Тогда

КолРасх = КолРасх + 1;

КонецЕсли;

КонецЦикла;

This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.

ВыбранныйПланСчетов

Возвращает план счетов, выбранный пользователем в параметрах системы.

Синтаксис:

ВыбранныйПланСчетов()

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

DefaultChartOfAccounts

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

Значение типа «ПланСчетов».

Описание:

Функция ВыбранныйПланСчетов позволяет определить текущее значение параметра «Основной план счетов», выбранное пользователем при работе с системой.

Пример:

Сч = СоздатьОбъект("Счет");

Сч.ИспользоватьПланСчетов(ВыбранныйПланСчетов());

Выбрать

Выбрать элемент справочника в диалоге.

Синтаксис:

Выбрать(<Подсказка>, <Форма Списка>)

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

Choose

Параметры:

<Подсказка>

Текст заголовка окна диалога выбора. Может использоваться в качестве подсказки конечному пользователю.

<ФормаСписка>

Строковое выражение идентификатора той формы списка справочника (как он объявлен в конфигураторе), которая должна использоваться для выбора. Если это значение пустое, то используется форма списка по умолчанию.

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

Числовое значение: 1 — если элемент выбран; 0 — если не выбран.

Описание:

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

Пример:

// данная процедура присваивает некоторому реквизиту "Фирма"

// значение из Справочника.Фирмы

Процедура УстФирмы()

// Создадим объект требуемого справочника

Фрм = СоздатьОбъект("Справочник.Фирмы");

// реквизиты справочника могут быть периодическими

// поэтому установим дату выборки периодических реквизитов

Фрм.ИспользоватьДату(ДатаДок);

// Вызываем диалог выбора элемента Справочника

Если Фрм.Выбрать("Выберите фирму", "") > 0 Тогда

Фирма = Фрм.ТекущийЭлемент();

КонецЕсли;

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

См. также: ВидыДляВыбора

Выбрать

Вызов диалога для выбора документа.

Синтаксис:

Выбрать(<Подсказка>, <ФормаЖурнала>, <КомуПодч>)

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

Choose

Параметры:

<Подсказка>

Текст заголовка окна диалога ввода. Может использоваться в качестве подсказки конечному пользователю.

<ФормаЖурнала>

Строковое выражение идентификатора той формы журнала документа (как он объявлен в конфигураторе), которая должна использоваться для выбора. Если это значение пустое, то используется форма журнала по умолчанию.. Можно указывать имя объекта в следующем виде:

"Журнал.ХХХХХ", где ХХХХХ — имя вида соответствующего объекта, как он задан в конфигураторе, например: "Справочник.Товары";

"Журнал.Подчиненные";

"ЖурналОпераций";

"ЖурналОпераций.YYYYY", где YYYYY — имя формы журнала операций, как оно задано в конфигураторе;

<КомуПодч>

Необязательный параметр. Используется при открытии выбора по журналу подчиненных документов, т.е когда второй параметр <ФормаЖурнала> имеет значение "Журнал.Подчиненные". В данном случае в этом параметре передается документ-владелец, по которому следует построить журнал подчиненных документов.

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

Числовое значение: 1 — если документ выбран; 0 — если не выбран.

Описание:

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

Пример:

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

// вызываем диалог выбора документа

Если Док.Выбрать("Найди документ") > 0 Тогда

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

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

КонецЕсли;

См. также: ВидыДляВыбора

Выбрать

Выбрать счет из плана счетов в диалоге.

Синтаксис:

Выбрать(<Подсказка>, <ФормаСписка>)

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

Choose

Параметры:

<Подсказка>

Необязательный параметр. Символьное выражение — текст заголовка окна диалога выбора счета. Может использоваться в качестве подсказки.

<ФормаСписка>

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

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

Число: 1 — счет выбран; 0 — счет не выбран.

Описание:

Метод Выбрать вызывает на экран диалог, содержащий план счетов. Пользователь должен интерактивно выбрать требуемый счет.

Если счет выбран, метод возвращает 1 и позиционирует объект на выбранном счете.

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

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.Выбрать("Выберите счет", "ДляВыбораВДиалоге");

Выбрать ДвиженияСОстатками

Выбрать все движения регистра с остатками.

Синтаксис:

ВыбратьДвиженияСОстатками(<КонецВыборки>, <ГрафаОтбора>)

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

SelectActsWithRests

Параметры:

<КонецВыборки>

Выражение типа дата, документ или позиция документа задающее конец временного интервала выбора движений регистра.

<ГрафаОтбора>

"*" — автоматический выбор графы отбора.

Пустая строка — не использовать графу отбора.

По умолчанию устанавливается автоматический выбор графы отбора.

Описание:

Метод ВыбратьДвиженияСОстатками инициирует выбор всех движении регистра в указанном интервале дат. До вызова данной процедуры может быть установлен фильтр (см. УстановитьФильтр), ограничивающий выборку значений из регистра. Если <КонецВыборки> не указан или равен 0, то конном временного интервала выбора движений регистра считается ТА.

Данный метод отличается от метода ВыбратьДвижения тем, что после получения очередного движения метод Остаток будет выдавать актуальные значения остатков для этого регистра. Но для этого перед вызовом метода ВыбратьДвиженияСОстатками регистру должен быть установлен признак временногоРасчета» (см. ВременныйРасчет) и должен быть выполнен временный расчет (см. РассчитатьРегистрыНа и РассчитатьРегистрыПо) — его дата и будет являться начальной датой выбираемых движений регистра. Данная возможность не может быть использована совместно с дальнейшими «Временными» расчетами.

Собственно выбор первого и последующих движений регистра осуществляется методом ПолучитьДвижение.

Данный метод используется только для регистров остатков.

Пример:

Рег = СоздатьОбъект("Регистр.Взаиморасчеты");

Рег.ВременныйРасчет();

Рег.УстановитьФильтр(Клиент, );

РассчитатьРегистрыНа(ДатаНачала);

Рег.ВыбратьДвиженияСОстатками(ДатаКонца);

Пока Рег.ПолучитьДвижение() = 1 Цикл

Прих = 0;

Расх = 0;

Если Рег.Приход = 1 Тогда

Прих = Рег.Долг;

Иначе

Расх = Рег.Долг;

КонецЕсли;

ТекущееСальдо = Рег.Остаток(Клиент, "Задолженность");

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

Таб.ВывестиСекцию("Документ");

КонецЦикла;

См. также: УстановитьФильтр, ПолучитьДвижение, ВыбратьДвижения, ВременныйРасчет, РассчитатьРегистрыНа, РассчитатьРегистрыПо

ВыбратьДаты

Открывает выборку записей календаря.

Синтаксис:

ВыбратьДаты(<ДатаНачала>, <ДатаОкончания>)

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

SelectDates

Параметры:

<ДатаНачала>

Дата начала периода выборки.

<ДатаОкончания>

Дата окончания периода выборки.

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

Число: 1 — выборка открыта и в ней есть хоть одна запись; 0 — не обнаружено записей.

Описание:

Метод ВыбратьДаты открывает выборку записей календаря. Выбираются все элементы с даты начала по дату окончания включительно.

Пример:

// Календарь служащих

Календ = СоздатьОбъект("Календарь.Служащие");

Календ.ВыбратьДаты(ДатаНачала, ДатаОкончания);

Пока Календ.СледующаяДата() = 1 Цикл

// ...

КонецЦикла;

См. также: СледующаяДата

ВыбратьДаты

Открывает выборку записей праздников.

Синтаксис:

ВыбратьДаты(<ДатаНачала>, <ДатаОкончания>)

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

SelectDates

Параметры:

<ДатаНачала>

Дата начала периода выборки.

<ДатаОкончания>

Дата окончания периода выборки.

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

Число: 1 — выборка открыта и в ней есть хоть одна запись; 0 — не обнаружено записей.

Описание:

Метод ВыбратьДаты открывает выборку записей праздников. Выбираются все элементы с даты начала по дату окончания включительно.

Пример:

// Праздничные дни

Празд = СоздатьОбъект("Праздники");

Празд.ВыбратьДаты(ДатаНачала, ДатаОкончания);

Пока Празд.СледующаяДата() = 1 Цикл

// ...

КонецЦикла;

См. также: СледующаяДата

ВыбратьДокументы

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

Синтаксис:

ВыбратьДокументы(<НачалоВыборки>, <КонецВыборки>)

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

SelectDocuments

Параметры:

<НачалоВыборки>

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

<КонецВыборки>

Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки документов. Если данный параметр опущен, то выборка заканчивается самым последним существующим в системе документом.

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

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

Число 0 — если действие не выполнено или в выборке нет ни одного документа.

Описание:

Метод ВыбратьДокументы открывает выборку документов в интервале с <НачалоВыборки> по <КонецВыборки>.

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

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

Пример:

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

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

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

Док.ВыбратьДокументы(ДатаНачало, ДатаКонец);

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

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

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

КонецЦикла;

КонецЕсли;

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

ВыбратьДвижения

Выбрать все движения регистра по датам.

Синтаксис:

ВыбратьДвижения(<НачалоВыборки>, <КонецВыборки>, <ГрафаОтбора>)

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

SelectActs

Параметры:

<НачалоВыборки>

Выражение типа дата, документ или позиция документа, задающее начало временного интервала выбора движений регистра.

<КонецВыборки>

<ГрафаОтбора>

Необязательный параметр. Строковое выражение — идентификатор графы отбора, как он задан в конфигураторе. Данный параметр устанавливает режим использования определенной графы отбора. "*" — автоматический выбор графы отбора. Пустая строка — не использовать графу отбора. По умолчанию устанавливается автоматический выбор графы отбора.

Описание:

Метод ВыбратьДвижения инициирует выбор всех движений регистра в указанном интервале дат. До вызова данной процедуры может быть установлен фильтр (см. УстановитьФильтр), ограничивающий выборку значений из регистра. Если <КонецВыборки> не указан или равен 0, то концом временного интервала выбора движений регистра считается ТА.

Собственно выбор первого и последующих движений регистра осуществляется функцией ПолучитьДвижение.

Пример:

Рег1 = СоздатьОбъект("Регистр.Взаиморасчеты");

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

Рег1.УстановитьФильтр(Клиент);

Рег1.ВыбратьДвижения(ДатаНачало, );

Пока Рег1.ПолучитьДвижение() > 0 Цикл

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

Дв_Баз_Сум = Рег1.СуммаБазовая;

Дв_Вал_Сум = Рег1.СуммаВалютная;

Если Рег1.Расход = 1 Тогда

Таб.ВывестиСекцию("Расход2");

Иначе

Таб.ВывестиСекцию("Приход2");

КонецЕсли;

КонецЦикла;

КонецЕсли;

См. также: ПолучитьДвижение

ВыбратьДвиженияДокумента

Выбрать все движения регистра по документу.

Синтаксис:

ВыбратьДвиженияДокумента(<Документ>)

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

SelectDocActs

Параметры:

<Документ>

Значение типа Документ.

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

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

Описание:

Метод ВыбратьДвиженияДокумента инициирует выбор всех движений регистра по указанному документу <Документ>.

Собственно выбор первого и последующих движений регистра осуществляется функцией ПолучитьДвижение.

Пример:

Процедура Взаиморасчеты(ВыбКлиент, ДатаНачало, ДатаКонец)

// Создание Таблицы для выходного отчета

Заг = "Неизвестно.";

Таб = СоздатьОбъект("Таблица");

Клн = СоздатьОбъект("Справочник.Клиенты");

Клн.ИспользоватьДату(ДатаКонец);

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

Рег = СоздатьОбъект("Регистр.Взаиморасчеты");

Рег1 = СоздатьОбъект("Регистр.Взаиморасчеты");

Рег.ВременныйРасчет();

РассчитатьРегистрыНа(ДатаКонец);

Если ВыбКлиент.Выбран() = 0 Тогда

//Без условий

Заг = "По всем клиентам.";

ИначеЕсли ВыбКлиент.ЭтоГруппа() = 1 Тогда

Клн.ВключатьПодчиненные(ВыбКлиент);

Клн.ИспользоватьРодителя(ВыбКлиент);

Заг = "По клиентам группы " + ВыбКлиент.Наименование;

Иначе

Предупреждение("Выберите группу клиентов!");

Возврат;

КонецЕсли;

Таб.ВывестиСекцию("Отчет");

Клн.ВыбратьЭлементы();

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

Если Клн.ЭтоГруппа() = 1 Тогда

Таб.ВывестиСекцию("Группа");

Иначе

Рег.Клиент = Клн.ТекущийЭлемент();

Рег.ОстаткиПолучить();

Баз_сум = Рег.СуммаБазовая;

Вал_сум = Рег.СуммаВалютная;

Таб.ВывестиСекцию("Клиент");

// цикл по всем документам

Док.ВыбратьДокументы(ДатаНачало, ДатаКонец);

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

            // отфильтруем документы

            Если (Док.Вид() = "Перемещение") ИЛИ (Док.Вид() = "Счет") ИЛИ

                 (Док.Вид() = "Списание") ИЛИ

                 (Док.Вид() = "РучноеИзмОстатка") Тогда

             // Эти Документы не изменяют Взаиморасчеты

               Продолжить;

            КонецЕсли;

            // выберем все движения регистра по документу

            Рег1.ВыбратьДвиженияДокумента(Док.ТекущийДокумент());

            Пока Рег1.ПолучитьДвижение() > 0 Цикл

               Если Строка(Рег1.Клиент.Код) <> Строка(Клн.Код) Тогда

                  // не тот клиент

                  Продолжить;

               КонецЕсли;

               Дв_Баз_Сум = Рег1.СуммаБазовая;

               Дв_Вал_Сум = Рег1.СуммаВалютная;

               Если Рег1.Приход = 1 Тогда

                  Таб.ВывестиСекцию("Приход");

               Иначе

                  Таб.ВывестиСекцию("Расход");

               КонецЕсли;

            КонецЦикла;

         КонецЦикла;

     КонецЕсли;

   КонецЦикла;

   //Вызов выходного отчета в окно просмотра и редактирования.

   Таб.ТолькоПросмотр(1);

   Таб.Опции(0, 0, 4, 0);

   Таб.Показать("Взаиморасчеты с клиентами", "");

   ВыбКлиент = 0;

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

См. также: ПолучитьДвижение

ВыбратьФайл

Открывает окно диалога выбора/сохранения файла.

Синтаксис:

ВыбратьФайл(<ТипДиалога>, <ИмяФайла>, <ИмяНачКаталога>, <3аголовокОкна>, <Фильтр>,

<Расширение>, <Таймаут>)

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

SelectFile

Параметры:

<TипДиaлoгa>

Числовое выражение, значение которого определяет тип открываемого диалога. Допустимые значения: 0 — диалог типа «открыть», 1 — диалог типа «сохранить».

<ИмяФайла>

Имя переменной, содержащей строковое значение с именем файла. В эту же переменную система возвращает имя выбранного файла.

<ИмяНачКаталога>

Имя переменной, содержащей строковое значение с именем начального каталога. В эту же переменную система возвращает имя выбранного каталога.

<ЗаголовокОкна>

Строковое выражение, с помощью которого можно задать заголовок открываемого окна.

<Фильтр>

Строковое выражение, с помощью которого можно задать список фильтров отбора файлов. Фильтр состоит из двух частей, разделенных сиволом "" (вертикальная черта): строки представления, которая отображается в окне выбора файла, и непосредственно строки маски. В строке маски можно использовать символ "*", что означает наличие любого числа произвольных символов. Символ "?" в строке маски означает наличие одного произвольного символа. Одновременно можно задавать несколько фильтров в виде списка, в качестве разделителей используется символ "|" (вертикальная черта). Например, список из двух фильтров:

"Текст(*.txt)|*.txt| Таблицы(*.mxl)|*.mxl"

<Расширение>

Строковое выражение, с помощью которого можно задать расширение файла по умолчанию, которое используется системой при записи файла.

<Таймаут>

Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя.

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

Число: 0 — если в окне диалога нажата кнопка «Отмена»; 1 — если в окне диалога нажата кнопка «ОК», при этом в переменную <ИмяФайла> возвращается выбранное имя файла, а в переменную <ИмяНачКаталога> возвращается имя выбранного каталога; -1 (минус единица) — закончилось время <Таймаут> ожидания отклика пользователя.

Описание:

Метод ВыбратьФайл открывает окно диалога выбора/сохранения файла.

Пример:

* В данном примере приведена процедура вызова диалога выбора файла.

Процедура УдалФ()

ИмяВыбрФайла = "";

ИмяПути="";

Если ФС.ВыбратьФайл(0, ИмяВыбрФайла, ИмяПути, "Выберите файл",

"Все файлы (*.*)!*.*", , ) = 1 Тогда

ФС.УдалитьФайл(ИмяПути + ИмяФайла);

КонецЕсли;

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

ВыбратьФайлКартинки

Открывает окно диалога выбора/сохранения файла картинки.

Синтаксис:

ВыбратьФайлКартинки(<ТипДиалога>, <ИмяФайла>, <ИмяНачКаталога>, <3аголовокОкна>,

<Расширение>, <Таймаут>)

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

SelectPictFile

Параметры:

<ТипДиалога>

<ИмяФайла>

<ИмяНачКаталога>

<3аголовокОкна>

Строковое выражение, с помощью которого можно задать заголовок открываемого окна.

<Расширение>

<Таймаут>

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

Описание:

Метод ВыбратьФайлКартинки открывает окно диалога (с возможностью предварительного просмотра) выбора/сохранения файла картинки.

Пример:

* В данном примере приведена процедура вызова диалога выбора файла картинки.

// Фото — Объект типа "Картинка"

Процедура ЗагрКарт()

ИмяВыбрФайла = "";

ИмяПути = "";

// Выбор файла с просмотром

Если ФС.ВыбратьФайлКартинки(0, ИмяВыбрФайла, ИмяПути,

"Выберите файл", "bmp", ) = 1 Тогда

Фото.Загрузить(ИмяПути + ИмяВыбрФайла);

КонецЕсли;

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

ВыбратьИтоги

Выбрать все остатки регистра.

Синтаксис:

ВыбратьИтоги()

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

SelectTotals

Описание:

Метод ВыбратьИтоги инициирует перебор текущих или временных (см. ВременныйРасчет) остатков по регистру, при этом используется фильтр, если он установлен (см. УстановитьФильтр). Открывается выборка остатков по всем записанным значениям измерений.

Собственно выбор первого и последующих остатков регистра осуществляется функцией ПолучитьИтог.

Пример:

Процедура ВыбратьКредит()

Список = СоздатьОбъект("СписокЗначений");

Рег = СоздатьОбъект("Регистр.ТоварныйКредит");

Рег.УстановитьФильтр(Клиент, );

Рег.ВыбратьИтоги();

Ном = 0;

Пока Рег.ПолучитьИтог() = 1 Цикл

Док = Рег.Документ;

Список.ДобавитьЗначение(Док, "" + Док + " — Остаток = " + Рег.Долг);

Если Ном = 0 Тогда

ВыбДок = Док;

КонецЕсли;

Ном = Ном + 1;

КонецЦикла;

Если Ном > 0 Тогда

Если Список.ВыбратьЗначение(ВыбДок, "Выберите кредит") = 1 Тогда

ДокКредита = ВыбДок;

КонецЕсли;

Возврат;

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

См. также: УстановитьФильтр, ПолучитьИтог, ВыбратьДвижения, ВременныйРасчет, РассчитатьРегистрыНа, РассчитатьРегистрыПо

ВыбратьЭлементы

Открыть выборку элементов справочника

Синтаксис:

ВыбратьЭлементы(<Режим>)

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

SelectItems

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 1 — выбирать элементы с учетом иерархии; 0 — выбирать элементы без учета иерархии. Значение по умолчанию — 1.

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

Число 1 — если действие выполнено и в выборке есть хотя бы один элемент;

Число 0 — если действие не выполнено или в выборке нет ни одного элемента.

Описание:

Метод ВыбратьЭлементы предоставляет возможность выбирать элементы (открывает выборку) при помощи метода ПолучитьЭлемент.

Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить среди элементов текущего справочника в порядке, установленном заранее при помощи методов: ПорядокНаименований, ПорядокКодов, ВключатьПодчиненные, ИспользоватьРодителя, ИспользоватьВладельца, ИспользоватьДату.

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

Пример:

Акц = СоздатьОбъект("Справочник.Акционеры");

Таб = СоздатьОбъект("Таблица");

Акц.ИспользоватьДату(ДатаОтчета);

Таб.ВывестиСекцию("Отчет");

// Открываем выборку Акц.ВыбратьЭлементы();

// Цикл получения элементов справочника

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

Если Акц.ЭтоГруппа() = 1 Тогда

Таб.ВывестиСекцию("Группа");

Иначе

Таб.ВывестиСекцию("Акционер");

КонецЕсли;

КонецЦикла;

См. также: ПолучитьЭлемент, ПорядокНаименований, ПорядокКодов, ВключатьПодчиненные, ИспользоватьРодителя, ИспользоватьВладельца, ИспользоватьДату.

ВыбратьЭлементыПоРеквизиту

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

Синтаксис:

ВыбратьЭлементыПоРеквизиту(<ИмяРеквизита>, <3начение>, <РежимИерархии>,

<РежимГрупп>)

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

Select ItemsByAttribute

Параметры:

<ИмяРеквизита>

Строковое выражение с именем реквизита справочника, который задает порядок обхода элементов справочника.

<3начение>

Значение реквизита для выборки.

<РежимИерархии>

<РежимГрупп>

Числовое выражение: 1 — выбирать среди групп справочника; 0 — выбирать среди элементов справочника.

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

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

Описание:

Метод ВыбратьЭлементыПоРеквизиту предоставляет возможность выбирать элементы (открывает выборку) при помощи метода ПолучитьЭлемент.

Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить среди элементов текущего справочника, имеющих значение реквизита <ИмяРеквизита> равным <3начение>, в порядке, установленном параметрами <РежимИерархии> и <РежимГрупп>, а также согласно установкам, сделанным заранее при помощи методов:

ПорядокНаименований,

ПорядокКодов,

ВключатьПодчиненные,

ИспользоватьРодителя,

ИспользоватьВладельца,

ИспользоватьДату.

Данный метод может использоваться только в том случае, если в конфигураторе при описании данного реквизита установлен признак «Сортировка» (Свойства реквизита - Дополнительные - Сортировка).

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

Пример:

Акц = СоздатьОбъект("Справочник.Акционеры");

Таб = СоздатьОбъект("Таблица");

Акц.ИспользоватьДату(ДатаОтчета);

Таб.ВывестиСекцию("Отчет");

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

Акц.ВыбратьЭлементыПоРеквизиту("Отдел", НомерОтдела, 1, 0);

// Цикл получения элементов справочника

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

Если Акц.ЭтоГруппа() = 1 Тогда

Таб.ВывестиСекцию("Группа");

Таб.ВывестиСекцию("Акционер");

КонецЕсли;

КонецЦикла;

См. также: ПолучитьЭлемент, ПорядокНаименований, ПорядокКодов, ОбратныйПорядок, ВключатьПодчиненные, ИспользоватьРодителя, ИспользоватьВладельца, ИспользоватьДату

ВыбратьКаталог

Открывает окно диалога выбора каталога.

Синтаксис:

ВыбратьКаталог(<ИмяКаталога>, <3аголовок>, <Таймаут>)

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

SelectDirectory

Параметры:

<ИмяКаталога>

<3аголовок>

Строковое выражение, с помощью которого можно задать заголовок открываемого окна.

<Таймаут>

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

Число: 0 — если в окне диалога нажата кнопка «Отмена»; 1 — если в окне диалога нажата кнопка «ОК», при этом в переменную <ИмяНачКаталога> возвращается имя выбранного каталога; -1 (минус единица) — закончилось время <Таймаут> ожидания отклика пользователя.

Описание:

Метод ВыбратьКаталог открывает окно диалога выбора каталога.

Пример:

* В данном примере приведена процедура вызова диалога выбора каталога.

Функция УстКат(ИмяПути)

Если ФС.ВыбратьКаталог(ИмяПути, "Выберите каталог", 10) = 1 Тогда

Возврат ИмяПути;

Иначе

Возврат КаталогПользователя();

КонецЕсли;

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

ВыбратьКорректныеПроводки

Открыть выборку корректных проводок по плану счетов.

Синтаксис:

ВыбратьКорректныеПроводки(<ПланСчетов>)

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

SelectCorrectEntries

Параметры:

<ПланСчетов>

Необязательный параметр. Значение типа «План счетов». Если не задан, то по всем.

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

Число: 1 — если есть хотя бы одна корректная проводка, удовлетворяющая условию; 0 — нет ни одной корректной проводки.

Описание:

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

Дальнейшая выборка при помощи метода ПолучитьКорректнуюПроводку будет происходить среди корректных проводок указанного плана счетов.

Пример:

КП = СоздатьОбъект("КорректныеПроводки");

КП.ВыбратьКорректныеПроводки();

Пока КП.ПолучитьКорректнуюПроводку() = 1 Цикл

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

Сообщить(КП.Комментарий + " счет кредита — " + КП.СчетКт);

КонецЕсли;

КонецЦикла;

ВыбратьКорректныеПроводкиПоСчету

Открыть выборку корректных проводок для указанного счета.

Синтаксис:

ВыбратьКорректныеПроводкиПоСчету(<Счет>, <ТипСчета>, <ПланСчетов>)

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

SelectCorrectEntriesByAccount

Параметры:

<Счет>

Код счета или сам счет для которого отбирать корректные проводки.

<ТипСчета>

Необязательный параметр. Число: 0 — переданный счет является счетом дебета; 1 — переданный счет является счетом кредита. Значение по умолчанию 0.

<ПланСчетов>

Необязательный параметр. Значение типа «План счетов». Значение по умолчанию — главный план счетов.

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

Описание:

Метод ВыбратьКорректныеПроводкиПоСчету предоставляет возможность выбирать корректные проводки (открывает выборку) при помощи метода ПолучитьКорректнуюПроводку.

Пример:

КП = СоздатьОбъект("КорректныеПроводки");

КП.ВыбратьКорректныеПроводкиПоСчету("41.1");

Пока КП.ПолучитьКорректнуюПроводку() = 1 Цикл

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

Сообщить(КП.Комментарий + " счет кредита — " + КП.СчетКт);

КонецЕсли;

КонецЦикла;

ВыбратьКорСчета

Открывает выборку корреспондирующих счетов, для которых были получены итоги методом ВыполнитьЗапрос.

Синтаксис:

ВыбратьКорСчета(<ФлагВсе>, <ФлагДК>, <Номер>)

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

SelectCorAccounts

Параметры:

<ФлагВсе>

Необязательный параметр.

0 — отбирать те счета, которые имели итоги на этом уровне обхода итогов запроса;

1 — включить в выборку все счета, которые имели итоги в данном запросе;

-1, -2 ... — включить в выборку счета, которые имели итоги в группировке n-го вышестоящего уровня.

По умолчанию — 0.

<ФлагДК>

Необязательный параметр.

1 — включать в выборку счета только с дебетовыми оборотами;

2 — включать в выборку счета только с кредитовыми оборотами.

0 — включать в выборку счета вне зависимости от дебетовых/кредитовых оборотов.

По умолчанию 0.

<Номер>

Необязательный параметр. Положительное целое число — номер выборки. Если параметр не указан, выборке присваивается номер 0.

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

Число: 1 — если действие выполнено и в выборке есть хотя бы один счет;

0 — если действие не выполнено или в выборке нет ни одного счета.

Описание:

Метод ВыбратьКорСчета должен использоваться после получения итогов методом ВыполнитьЗапрос. Метод открывает выборку счетов, вошедших в запрос.

Дополнительные условия на содержание выборки могут накладываться параметрами <ФлагВсе> и <ФлагДК>.

Непосредственно извлечение счетов из выборки осуществляется при помощи метода ПолучитьКорСчет. Счета извлекаются в порядке возрастания кода счета.

Выборке, открываемой методом ВыбратьКорСчета, может быть присвоен номер — положительное целое число. Номер — это «метка» выборки. Номер может использоваться для обращения к результатам выборки при помощи метода ПолучитьКорСчет. Использование этой метки необходимо, если требуется получить две группировки по счету.

Пример:

БухИтоги.Запрос(Дата1, Дата2);

БухИтоги.ВыбратьСчета();

Пока БухИтоги.ПолучитьСчет() = 1 Цикл

БухИтоги.ВыбратьКорСчета();

Пока БухИтоги.ПолучитьКорСчет() = 1 Цикл

Деб = БухИтоги.ДО();

Кред = БухИтоги.КО();

КонецЦикла;

ВыбратьКорСубконто

Открывает выборку по корреспондирующим субконто.

Синтаксис:

ВыбратьКорСубконто(<Индекс>, <ФлагВсе>, <ФлагДК>, <Номер>, <Сортировка>,

<РежимОбхода>)

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

SelectCorSubconto

Параметры:

<Индекс>

Необязательный параметр. Число —порядковый номер вызова метода ИспользоватьКорСубконто.

<ФлагВсе>

Необязательный параметр.

0 — отбирать те субконто, которые имели итоги на этом уровне обхода итогов запроса;

1 — включить в выборку все субконто, которые имели итоги в данном запросе;

-1, -2 ... — включить в выборку субконто, которые имели итоги в группировке п-го вышестоящего уровня.

По умолчанию — 0.

<ФлагДК>

Необязательный параметр.

1 — включать в выборку субконто только с дебетовыми оборотами;

2 — включать в выборку субконто только с кредитовыми оборотами.

0 — включать в выборку субконто вне зависимости от дебетовых/кредитовых оборотов.

По умолчанию 0.

<Номер>

<Сортировка>

Необязательный параметр. Строка — идентификатор реквизита субконто (если субконто — справочник или документ или счет), который будет использован для упорядочивания обхода субконто методом ПолучитьКорСубконто. Если значение пустое — используется стандартное представление.

<РежимОбхода>

Необязательный параметр. Положительное целое число — порядок выборки результатов:

0 — выборка в прямом порядке,

1 — выборка в обратном порядке.

По умолчанию 0.

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

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

Описание:

Метод ВыбратьКорСубконто должен использоваться после вызова метода ВыполнитьЗапрос. Метод открывает выборку по корреспондирующим субконто.

Если обработка по корреспондирующим субконто задавалась путем нескольких вызовов метода ИспользоватьКорСубконто, то параметр <Индекс> позволяет сослаться на субконто конкретного вида в порядке вызова метода ИспользоватьКорСубконто. Для этого параметром <Индекс> задается номер вызова метода ИспользоватьКорСубконто.

Дополнительные условия на содержание выборки могут накладываться параметрами <ФлагВсе> и <ФлагДК>.

Извлечение субконто из выборки осуществляется при помощи метода ПолучитьКорСубконто.

Выборке, открываемой методом ВыбратьКорСубконто, может быть присвоен номер — «метка» выборки. Номер может использоваться для обращения к результатам выборки при помощи метода ПолучитьКорСубконто. Это позволяет получить две группировки по субконто данного вида.

Пример:

БухИтоги.ИспользоватьСубконто(ВидыСубконто.Товары, , 1);

БухИтоги.ИспользоватьКорСубконто(ВидыСубконто.Клиенты, , 1);

БухИтоги.ВыполнитьЗапрос(ДатаНач, ДатаКон);

БухИтоги.ВыбратьСубконто();

Пока БухИтоги.ПолучитьСубконто() = 1 цикл

   БухИтоги.ВыбратьКорСубконто();

   Пока БухИтоги.ПолучитьКорСубконто() =1 цикл

      Деб = БухИтоги.КорДО();

      Кред = БухИтоги.КорКО();

   КонецЦикла;

КонецЦикла;

ВыбратьОперации

Открывает выборку операций за период.

Синтаксис:

ВыбратьОперации(<НачалоПериода>, <КонецПериода>)

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

SelectOpers

Параметры:

<НачалоПериода>

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

<КонецПериода>

Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки операций.

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

Число: 1 — действие выполнено и в выборке есть хотя бы одна операция;

0 — действие не выполнено или в выборке нет ни одной операции.

Описание:

Метод ВыбратьОперации открывает выборку, содержащую операции за указанный период.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.ВыбратьОперации(ДатаНач, ДатаКон);

Пока Опер.ПолучитьОперацию() = 1 Цикл

Сообщить("Операция " + Опер.Содержание);

КонецЦикла;

ВыбратьОперацииСПроводками

Открывает выборку оперций с проводками за указанный период.

Синтаксис 1:

ВыбратьОперацииСПроводками(<НачалоПериода>, <КонецПериода>, <Фильтр>, <Валюта>,

<ПланСчетов>, <РазделительУчета>)

Синтаксис 2:

ВыбратьОперацииСПроводками(<НачалоПериода>, <КонецПериода>, <Счет>, <КорСчет>,

<Флаг>, <Валюта>, <ПланСчетов>, <РазделительУчета>)

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

SelectOpersAndEntries

Параметры:

<НачалоПериода>		Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого устанавливается начало выборки операций.
<КонецПериода>		Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки операций.
<Фильтр>		Необязательный параметр. Строка — условие отбора проводок.
<ПланСчетов>		Необязательный параметр. Значение типа «План Счетов». Если параметр не указан — по всем планам счетов.
<РазделительУчета>		Необязательный параметр. Значение разделителя учета. Если параметр не указан — по всем значениям разделителя учета.
<Счет>		Необязательный параметр. Счет — счет, по которому будут отбираться проводки.
<КорСчет>		Необязательный параметр. Счет — корреспондирующий счет, по которому будут отбираться проводки. Параметр имеет смысл, если указан параметр <Счет>.
<Флаг>		Необязательный параметр. Число — признак вида оборота. Параметр может принимать значения: 1 — отбирать проводки только по дебету счета; 2 — отбирать проводки только по кредиту счета; 3 — отбирать проводки и по дебету, и по кредиту. По умолчанию 3.
<Валюта>		Необязательный параметр. Значание типа «справочник» (вида справочника используемого для валютного учета) — признак отбора проводок по валюте.

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

Число: 1 — действие выполнено и в выборке есть хотя бы одна проводка;

0 — действие не выполнено или в выборке нет ни одной проводки.

Описание:

Метод ВыбратьОперацииСПроводками служит для выбора проводок операций за период. Параметрами могут являеться различные условия отбора проводок.

После вызова данного метода метод ПолучитьПроводку выбирает очередную проводку из выборки удовлетворяющую заданным условиям, а метод ПолучитьОперацию выбирает первую проводку слудующей операции удовлетворяющую заданным условиям.

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

В параметре <Фильтр> задаются критерии отбора проводок для включения в выборку. Если параметр не заполнен, в выборку включаются все проводки. В общем случае в параметре <Фильтр> могут находиться одна или несколько корреспонденции счетов или символьных строк, разделяемых точкой с запятой «;». Символьные строки представляют собой наборы символов, заключенные в кавычки (при передаче строки в явном виде в параметре внутри строки двойные кавычки задаются двумя символами двойных кавычек). Корреспонденции имеют вид:

n — проводки со счетом n;

n, m — проводки в дебет счета n с кредита счета m.

Здесь в качестве n и m может указываться звездочка («*»), она обозначает любой счет. Например, *,51 — все проводки с кредита 51 счета.

В выборку включаются все проводки, удовлетворяющие следующим условиям:

Если в параметре <Фильтр> указаны корреспонденции счетов, то проводка должна соответствовать одной из этих корреспонденции.

Если параметре <Фильтр> указаны строки символов, то в проводке должна содержаться хотя бы одна из этих строк — либо в содержании операции, либо представлениях значений субконто и реквизитов проводки и операции.

Примеры:

50	— все проводки со счетом 50;
50, *	— все проводки в дебет 50 счета;
* , 51	— все проводки с кредита 51 счета;
50, 51	— все проводки в дебет 50 счета с кредита 51;
51; 52	— все проводки со счетом 51 или счетом 52;
46, 68.2	— все проводки в дебет 46 счета с кредита 68.2;
"бумага"	— все проводки, содержащие в содержании операции или в субконто или в реквизитах слово «бумага»;
"бумага"; "картон"	— все проводки, содержащие в содержании операции или в субконто или в реквизитах слово «бумага» или слово «картон»;
*, 46; "бумага"	— все проводки по кредиту 46 счета, содержащие в содержании операции или в субконто или в реквизитах слово «бумага»;

Кроме того, в обоих вариантах задаются дополнительные условия: валюта, план счетов, разделитель учета.

Параметр <Валюта> является значением типа «Справочник» вида, определенного при настройке валютного учета в метаданных. Если параметр указан, в отбор будут включены проводки только по указанной валюте. При этом пустое значение типа «Справочник» соответствующего вида считается указанием отбора по пустой валюте. Для того, чтобы отбор по валюте не производился нужно либо опустить данный параметр, либо передать туда значение иного типа, например, пустую сроку.

Параметр <ПланСчетов> является значением типа «План Счетов». Если параметр указан, в отбор будут включены проводки только по указанному плану счетов.

Параметр <РазделительУчета> является значением объекта метаданных, выбранного в качестве разделителя учета.

Если указан параметр <РазделительУчета>, в отбор будут включены проводки с указанным значением разделителя учета.

Параметры <Счет> и <КорСчет> задают условние отбора проводок по счетам.

Если указан параметр <Счет>, будут отбраны проводки только по указанному счету. Дополнительным условие отбора является значением параметра <Флаг>.

Если указаны параметр <Счет> и <КорСчет>, будут отобораны проводки только по указанной креспонденции счетов.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.ВыбратьОперацииСПроводками(ДатаНач, ДатаКон, "50, 51; ""По Чеку"" ");

Пока Опер.ПолучитьПроводку() = 1 Цикл

Сообщить("Сумма " + Опер.Сумма);

КонецЦикла;

ВыбратьПериод

Выбрать записи, введенные в журнал в определенном расчетном периоде.

Синтаксис:

ВыбратьПериод(<Дата>)

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

SelectPeriod

Параметры:

<Дата>

Дата, лежащая в выбираемом периоде.

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

Число: 1 — если операция успешно выполнена и выборка не пуста, т. е. содержит хотя бы одну запись; 0 — в противном случае.

Описание:

Метод открывает выборку записей журнала расчетов. Выбираются все записи за тот расчетный период, в который попадает <Дата>. Выбираются именно те записи, которые введены в заданном периоде, но не записи, имеющие дату начала и дату окончания, лежащие в заданном периоде. Следовательно, метод ВыбратьПериод отличается от метода ВыбратьЗаписи лишь тем, что осуществляет выборку в другом временном разрезе. В первом случае — это выбор записей по времени их появления (регистрации) в системе, т. е. по расчетным периодам, во втором случае — это выбор записей по времени их действия. Как правило, применяется перед циклом, выполняющим перебор записей журнала расчетов при помощи метода ПолучитьЗапись.

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

Пример:

// Расчет суммы амортизации по результатам всех расчетов

// в текущем периоде

// журнал расчета амортизации

ЖР = СоздатьОбъект("ЖурналРасчетов.Амортизация");

ЖР.ВыбратьПериод(ЖР.НачалоТекущегоПериода());

Пока ЖР.ПолучитьЗапись()>0 Цикл

Сумма = Сумма + ЖР.Результат;

КонецЦикла;

См. также: методы ВыбратьПериодПоОбъекту, ВыбратьЗаписи, атрибут ПериодРегистрации

ВыбратьПериодПоОбъекту

Выбрать записи по одному объекту расчета, зарегистрированные в определенном расчетном периоде журнала расчетов.

Синтаксис:

ВыбратьПериодПоОбъекту(<Объект>, <Дата>)

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

SelectPeriodByObject

Параметры:

<Объeкт>

Объект расчета, записи которого выбираются.

<Дaтa>

Дата, лежащая в выбираемом периоде.

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

Описание:

Метод открывает выборку записей журнала расчетов. Работает так же, как метод ВыбратьПериод, за исключением того, что выбираются все записи для того объекта расчета, который задан параметром <Объект>.

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

Пример:

Процедура Начислено(Сотрудник)

Начисл = 0;

ПН = 0;

ЖрнЗарплата.ВыбратьПериодПоОбъекту (Сотрудник, ДатаАктуальности);

Пока ЖрнЗарплата.ПолучитьЗапись() = 1 Цикл

Если ЖрнЗарплата.ВидРасч.ВходитВГруппу(ГруппаРасчетов.ВсеНачисления)-1 Тогда

Начисл = Рез + ЖрнЗарплата.Результат;

ИначеЕсли ЖрнЗарплата.ВидРасч = ВидРасчета.ПодоходныйНалог

Тогда ПН = ПН+ЖрнЗарплата.Результат;

КонецЕсли;

КонецЦикла;

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

// расчет начального сальдо

ЖрнЗарплата.ВыбратьПериодПоОбъекту(Сотрудник, НТП - 1);

Сальдо = 0;

Пока ЖрнЗарплата.ПолучитьЗапись() = 1 Цикл

Если ЖрнЗарплата.ВидРасч.ВходитВГруппу(ГруппаРасчетов.ВсеУдержания) = 1 Тогда

Сальдо = Сальдо-ЖрнЗарплата.Результат;

// выплаты с деполнента и выплаты дивидендов — не считатем!

ИначеЕсли ВыплатаЗрп(ЖрнЗарплата.ВидРасч, ЖрнЗарплата.Документ) = 1 Тогда

Сальдо = Сальдо - ЖрнЗарплата.Результат;

ИначеЕсли ЖрнЗарплата.ВидРасч.

ВходитВГруппу(ГруппаРасчетов.ПоложительноеСальдо) = 1 Тогда

Сальдо = Сальдо + ЖрнЗарплата.Результат;

КонецЕсли;

КонецЦикла;

Если Сальдо <> 0 Тогда

ЖрнЗарплата.ЗаписатьРасчет(Сотрудник,

ВидРасчета.НачальноеСальдо, НТП, КТП, Сальдо);

КонецЕсли;

См. также: методы ВыбратьПериод, ВыбратьтЗаписи, атрибут Объект

ВыбратьПериоды

Открывает выборку периодов.

Синтаксис:

ВыбратьПериоды(<ФлагВсе>, <ФлагДК>, <Номер>, <РазвСальдо>)

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

SelectPeriods

Параметры:

<ФлагВсе>

Необязательный параметр.

0 — отбирать те периоды, которые имели итоги на этом уровне обхода итогов запроса;

1 — включить в выборку все периоды, которые имели итоги в данном запросе;

-1, -2 ... — включить в выборку периоды, которые имели итоги в группировке n-го вышестоящего уровня.

По умолчанию — 0.

<ФлагДК>

Необязательный параметр.

1 — включать в выборку периоды только с дебетовыми оборотами;

2 — включать в выборку периоды только с кредитовыми оборотами.

0 — включать в выборку периоды вне зависимости от дебетовых/кредитовых оборотов.

По умолчанию 0.

<Номер>

Необязательный параметр. Положительное целое число — номер выборки. Если параметр не указан, выборке приваивается номер 0.

<РазвСальдо>

Необязательный параметр. Признак необходимости рассчитывать развернутое сальдо по субконто. Используется только если в запросе участвуют субконто.

1 — рассчитывать развернутое сальдо;

0 — не рассчитывать развернутое сальдо.

По умолчанию 0.

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

Число: 1 — если действие выполнено и в выборке есть хотя бы один период;

0 — если действие не выполнено или в выборке нет ни одного периода.

Описание:

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

Дополнительные условия на содержание выборки могут накладываться параметрами <ФлагВсе> и <ФлагДК>.

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

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

Выборке, открываемой методом ВыбратьПериоды, может быть присвоен номер — «метка» выборки. Номер может использоваться для обращения к результатам выборки при помощи метода ПолучитьПериод. Использование этой метки необходимо, если требуется получить две группировки по периоду. Это позволяет получить две группировки но с одной периодичностью.

Пример:

БухИтоги.ВыполнитьЗапрос(Дата1, Дата2, , , , , "Месяц");

БухИтоги.ВыбратьСчета();

Пока БухИтоги.ПолучитьСчет() = 1 цикл

БухИтоги.ВыбратьПериоды();

Пока БухИтоги.ПолучитьПериод() = 1 цикл

Деб = БухИтоги.ДО();

Кред = БухИтоги.КО();

КонецЦикла;

ВыбратьПодчиненныеДокументы

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

Синтаксис:

ВыбратьПодчиненныеДокументы(<НачалоВыборки>, <КонецВыборки>, <Докум>)

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

SelectChildDocs

Параметры:

<НачалоВыборки>

<КонецВыборки>

<Докум>

Выражение типа «документ», содержащее значение документа-владельца, подчиненные которому будут включаться в выборку.

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

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

Описание:

Метод ВыбратьПодчиненныеДокументы открывает выборку всех документов, подчиненных заданному документу <Докум> в интервале с <НачалоВыборки> по <КонецВыборки>. Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возрастания даты и времени записи документов (если не задан обратный порядок методом ОбратныйПорядок).

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

Пример:

//Проверка того, что по Счету были документы отгрузки

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

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

ДокТест.ВыбратьПодчиненныеДокументы('01.01.80', '31.12.99', ПоСчету);

// получение документа

Если ДокТест.ПолучитьДокумент() = 1 Тогда

Предупреждение("По данному Счету были отгрузки!");

КонецЕсли;

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

ВыбратьПоДокументу

Открыть выборку всех изменений периодических реквизитов справочника, сделанных документом.

Синтаксис:

ВыбратьПоДокументу(<Документ>)

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

SelectByDoc

Параметры:

<Документ>

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

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

Число: 1 — если вызов метода закончился успешно, 0 — если нет.

Описание:

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

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

См. также: УстановитьРеквизитСправочника, ТекущийОбъект, ТекущийРеквизит, ПолучитьЗначение

Пример:

Процедура ПечатьУстановокДокумента(Док)

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

Возврат;

КонецЕсли;

Таб = СоздатьОбъект("Таблица");

Таб.ИсходнаяТаблица("ПечатьИстории");

Таб.ВывестиСекцию("Отчет" );

Ист = СоздатьОбъект ("Периодический");

Ист.ВыбратьПоДокументу(Док);

Пока Ист.ПолучитьЗначение() = 1 Цикл

Таб.ВывестиСекцию("Строка");

КонецЦикла;

Таб.Опции(0, 0, 0, 0);

Таб.ТолькоПросмотр(1);

Таб.Показать("Отчет");

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

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

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

Синтаксис:

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

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

SelectByNum

Параметры:

<Номер>

Строковое выражение, содержащее значение номера искомых документов.

<Дата>

Выражение типа «дата».

<ИдентВида>

Необязательный параметр. Строковое выражение, содержащее идентификатор вида документа или идентификатор Нумератора.

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

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

Описание:

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

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

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

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

Пример:

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

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

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

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

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

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

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

КонецЦикла;

КонецЕсли;

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

ВыбратьПоПоследователыюсти

Открыть выборку документов по заданной последовательности.

Синтаксис:

ВыбратьПоПоследовательности(<НачПериода>, <КонПериода> , <Последоват>)

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

SelectBySequence

Параметры:

<НачПериода>

<КонПериода >

<Последоват>

Строковое выражение, содержащее идентификатор используемой Последовательности.

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

Описание:

Метод ВыбратьПоПоследовательности открывает выборку документов по заданной последовательности.

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

Пример:

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

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

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

Док.ВыбратьПоПоследовательности(НачД, ПолучитьДокументТА(), "Упр");

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

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

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

КонецЦикла;

КонецЕсли;

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

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

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

Синтаксис:

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

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

SelectByValue

Параметры:

<НачалоВыборки>

<КонецВыборки>

<ИмяОтбора>

Строковое выражение, которое содержит либо название «общего реквизита» документов, либо название «графы отбора» журналов, как они заданы в конфигураторе.

<3нач>

Значение отбора, по которому строится выборка документов.

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

Описание:

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

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

Пример:

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

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

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

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

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

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

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

КонецЦикла;

КонецЕсли;

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

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

Открывает выборку операций или проводок, отобранных по значению отбора.

Синтаксис:

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

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

SelectByValue

Параметры:

<НачалоПериода>		Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого устанавливается начало выборки операций.
<КонецПериода>		Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки операций.
<ВидОтбора>		Необязательный параметр. Символьная строка — название вида отбора (см. ниже).
<3начение0тбора>		Необязательный параметр. Значение отбора вида, указанного в параметре <ВидОтбора>.

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

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

Описание:

Метод ВыбратьПоЗначению открывает выборку, содержащую операции или проводки за указанный период.

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

Параметр <ВидОтбора> должен содержать название вида отборав виде символьной строки.

Параметр <ВидОтбора> для отбора операций может принимать следующие значения (в скобках указан английский синоним):

"СуммаОперации"

("OperSum")

Отбор по сумме операции. Доступно если в метаданных включен отбор по сумме операции.

"Содержание"

("Description")

Отбор по содержанию операции. Доступно если в метаданных включен отбор по содержанию операции.

<РеквизитОперации>

Отбор по дополнительному реквизиту операции. Идентификатор реквизита должен быть указан так, как это задано в метаданных. Доступно если в метаданных включен отбор по реквизиту операции.

Параметр <ВидОтбора> для отбора проводок может принимать следующие значения (в скобках указан английский синоним):

"Счет" ("Account")	Отбор по счету дебета или счету кредита проводки. Доступно если в метаданных включен отбор по счетам проводок.
"СчетДт" ("AccountDt")	Отбор по счету дебета проводки. Доступно если в метаданных включен отбор по дебету/кредиту счетов проводок.
"СчетКт" ("AccountKt")	Отбор по счету кредита проводки. Доступно если в метаданных включен отбор по дебету/кредиту счетов проводок.
"Валюта" ("Currency")	Отбор по валюте проводки. Доступно если в метаданных включен отбор по валюте проводок.
<ВидСубконто>	Отбор по виду субконто. Идентификатор вида субконто должен быть указан так, как он задан в метаданных. Доступно если в метаданных включен отбор по этому виду субконто.
<РеквизитПроводки>	Отбор по дополнительному реквизиту проводки. Идентификатор реквизита должен быть указан так, как он задан в метаданных. Доступно если в метаданных включен отбор по этому реквизиту проводки.

Параметр <3начениеОтбора> задает значение отбора.

После выполнения данного метода обход операций (проводок) осуществляется методами ПолучитьОперацию и ПолучитьПроводку.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.ВыбратьПоЗначению(ДатаНач, ДатаКон, "Счет", СчетПоКоду("60"));

Пока Опер.ПолучитьПроводку() = 1 Цикл

Сообщить("Сумма " + Опер.Сумма);

КонецЦикла;

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

Осуществляет выборку записей по значению в графе отбора.

Синтаксис:

ВыбратьПоЗначению(<ИмяГрафы>, <ЗначениеОтбора>, <ПериодНачала>,

<ПериодОкончания>)

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

SelеctByValue

Параметры:

<ИмяГрафы>

Строковое значение. Наименование графы отбора, как она определена при конфигурировании.

<ЗначениеОтбора>

Отбираемое значение.

<ПериодНачала>

Значение типа «период журнала расчетов» -первый расчетный период отбора.

<ПериодОкончания>

Значение типа «период журнала расчетов» -последний расчетный период отбора.

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

Число: 1 — если отбор успешно установлен; 0 — в противном случае.

Описание:

Метод предназначен для выборки записей журнала расчетов, которые содержат в графе отбора <ИмяГрафы> заданное <ЗначеяиеОтбора>, период регистрации которых лежит в пределах, заданных параметрами <ПериодНачала> и <ПериодОкончания>.

Если первый параметр задан неверно — т. е. нет такой графы отбора, выборка не будет выполнена и метод возвратит 0. Если заданное <ЗначениеОтбора> не содержится ни в одной строке журнала расчетов, выборка окажется пустой (т. е. в нее не попадет ни одна запись журнала расчетов), но метод возвратит значение 1.

Метод используется так же, как и другие методы создающие выборки записей в журнале расчетов, такие как ВыбратьЗаписи, ВыбратьПериод и т. д. Как и все остальные методы выборки журнала расчетов, как правило, применяется перед циклом, в котором перебираются записи. Работает только для переменных, созданных функцией СоздатьОбъект.

Замечание. Наименованиями граф отбора журнала расчетов могут служить реквизиты справочника объектов расчета, заданного для журнала расчетов, а также значения «Владелец» и «Родитель» этого справочника. Это значит, что в общем случае, в качестве первого параметра, методу могут передаваться предопределенные имена «Родитель» и «Владелец», а также названия реквизитов справочника.

Какие именно графы отбора задействованы в журнале расчетов, задается при конфигурировании.

Данный метод работает так же как и метод формы журнала расчетов УстановитьОтбор, но, разумеется не осуществляет визуального управления формой журнала.

Пример:

// Рассчитаем все записи текщего расчетного периода по

// подразделению (переменная Подр)

Процедура РасчетПодразделения(Подр)

ЖР = СоздатьОбъект("ЖурналРасчетов.Зарплата");

ТекПер = ЖР.ТекущийПериод();

ЖР.ВыбратьПоЗначению("Подразделение", Подр, ТекПер.ТекПер);

Пока ЖР.ПолучитьЗапись() > 0 Цикл

ЖР.Рассчитать();

КонецЦикла;

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

См. также: УстановитьОтбор

ВыбратьПроводки

Открывает выборку проводок текущей операции.

Синтаксис:

ВыбратьПроводки()

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

Select Entries

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

Число: 1 — действие выполнено и в выборке есть хотя бы одна проводка;

0 —действие не выполнено или в выборке нет ни одной проводки.

Описание:

Метод ВыбратьПроводки открывает выборку проводок текущей операции. Данный метод предназначен для организации перебора проводок операции и используется вмесет с методом ПолучитьПроводку.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Опер.ВыбратьПроводки();

Пока Опер.ПолучитьПроводку() = 1 Цикл

Сообщить("Проводка " + Опер.Дебет.Счет + " - " + Опер.Кредит.Счет);

КонецЦикла;

ВыбратьСчета

Метод открывает выборку счетов из текущего плана счетов для последующей обработки.

Синтаксис:

ВыбратьСчета()

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

SelectAccounts

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

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

Описание:

Метод ВыбратьСчета открывает выборку счетов для текущего плана счетов. Вызов данного метода позволяет затем перебрать счета. Непосредственно извлечение счетов из выборки осуществляется при помощи метода ПолучитьСчет. Счета извлекаются в порядке возрастания кода счета.

Пример:

Процедура Сформировать()

Сч = СоздатьОбъект("Счет.Основной");

Сч.ВыбратьСчета();

Пока Сч.ПолучитьСчет() = 1 Цикл

Сообщить(Сч.Код);

КонецЦикла;

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

ВыбратьСчета

Открывает выборку счетов, для которых были получены итоги методом ВыполнитьЗапрос.

Синтаксис:

ВыбратьСчета(<ФлагВсе>, <ФлагДК>, <Номер>, <РазвСальдо>)

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

SelеctAccounts

Параметры:

<ФлагВсе>

Необязательный параметр.

0 — отбирать те счета, которые имели итоги на этом уровне обхода итогов запроса;

1 — включить в выборку все счета, которые имели итоги в данном запросе;

-1, -2 ... — включить в выборку счета, которые имели итоги в группировке n-го вышестоящего уровня.

По умолчанию — 0.

<ФлагДК>

Необязательный параметр.

1 — включать в выборку счета только с дебетовыми оборотами;

2 — включать в выборку счета только с кредитовыми оборотами.

0 — включать в выборку счета вне зависимости от дебетовых/кредитовых оборотов.

По умолчанию 0.

<Номер>

<РазвСальдо>

1 — рассчитывать развернутое сальдо.

0 — не рассчитать развернутое сальдо;

По умолчанию 0.

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

Число: 1 — если действие выполнено и в выборке есть хотя бы один счет;

0 — если действие не выполнено или в выборке нет ни одного счета.

Описание:

Метод ВыбратьСчета должен использоваться после получения итогов методом ВыполнитьЗапрос. Метод открывает выборку счетов, вошедших в запрос.

Дополнительные условия на содержание выборки могут накладываться параметрами <ФлагВсе> и <ФлагДК>.

Непосредственно извлечение счетов из выборки осуществляется при помощи метода ПолучитьСчет. Счета извлекаются в порядке возрастания кода счета.

Выборке, открываемой методом ВыбратьСчета, может быть присвоен номер — положительное целое число. Номер — это «метка» выборки. Номер может использоваться для обращения к результатам выборки при помощи метода ПолучитьСчет. Использование этой метки необходимо, если требуется получить две группировки по счету.

Пример:

БухИтоги.Запрос(Дата1, Дата2);

БухИтоги.ВыбратьСчета();

Пока БухИтоги.ПолучитьСчет() = 1 Цикл

Деб = БухИтоги.ДО();

Кред = БухИтоги.КО();

КонецЦикла;

ВыбратьСтроки

Открыть выборку строк многострочной части документа.

Синтаксис:

ВыбратьСтроки()

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

SelectLines

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

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

Описание:

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

Пример:

Процедура ОбработкаПроведения()

Регистр.ТовЗап.Склад = Склад;

// откроем выборку строк спецификации документа

ВыбратьСтроки();

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

Пока ПолучитьСтроку() > 0 Цикл

Регистр.ПривязыватьСтроку(НомерСтроки);

Регистр.ТовЗап.Товар = Товар;

Регистр.ТовЗап.Количество = Количество;

Регистр.ТовЗап.Стоимость = Стоимость;

Регистр.ТовЗап.ДвижениеРасходВыполнить();

КонецЦикла;

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

ВыбратьСтроки

Открывает выборку строк таблицы значений.

Синтаксис:

ВыбратьСтроки()

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

SelectLines

Описание:

Метод ВыбратьСтроки предоставляет возможность перебирать строки таблицы значений (открывает выборку). Дальнейшая выборка осуществляется при помощи метода ПолучитьСтроку.

Пример:

Табл.ВыбратьСтроки();

Пока Табл.ПолучитьСтроку() = 1 Цикл

...

КонецЦикла;