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

Открыть окно для интерактивного выбора строки в таблице значений.

Синтаксис:

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

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

ChooseLine

Параметры:

<Строка>	Необязательный параметр. Идентификатор переменной, куда помещается значение — номер выбранной строки. При вызове метода здесь можно передавать значение начального номера строки.
<3аголовок>	Необязательный параметр. Строковое выражение, значение которого отображается в заголовке диалогового окна. Может использоваться для подсказки пользователю.
<Таймаут>	Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя. Если не задано, то время ожидания бесконечно.

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

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

Описание:

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

Пример:

Перем НомСтроки;

Табл.ВыбратьСтроку(НомСтроки, "Выберите строку");

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

Открывает выборку по субконто.

Синтаксис:

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

                     <Сортировка>, <РежимОбхода>)

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

SelectSubconto

Параметры:

<Индекс>	Необязательный параметр. Число — порядковый номер вызова метода ИспользоватьСубконто.
<ФлагВсе>	Необязательный параметр. 0 — отбирать те суб­конто, которые имели итоги на этом уровне обхо­да итогов запроса; 1 — включить в выборку все субконто, которые имели итоги в данном запросе; -1, -2 ... — включить в выборку субконто, которые имели итоги в группировке n-го вышестоящего уровня. По умолчанию — 0.
<ФлагДК>	Необязательный параметр. 1 — включать в вы­борку субконто только с дебетовыми оборотами; 2 — включать в выборку субконто только с креди­товыми оборотами. 0 — включать в выборку субконто вне зависимо­сти от дебетовых/кредитовых оборотов. По умолчанию 0.
<Номер>	Необязательный параметр. Положительное целое число — номер выборки. Если параметр не ука­зан, выборке приваивается номер 0.
<РазвСальдо>	Необязательный параметр. Признак необходимо­сти рассчитывать развернутое сальдо. 0 —не рассчитать развернутое сальдо; 1 — рассчитывать развернутое сальдо. По умолчанию 0.
<Сортировка>	Необязательный параметр. Строка — идентифи­катор реквизита субконто (если субконто — спра­вочник или документ или счет), который будет использован для упорядочивания обхода субкон­то методом ПолучитьСубконто. Если значение пустое — используется стандартное представле­ние.
<РежимОбхода>	Необязательный параметр. Положительное целое число — порядок выборки результатов: 0 — вы­борка в прямом порядке, 1 — выборка в обратном порядке; По умолча­нию 0.

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

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

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

Описание:

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

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

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

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

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

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

Пример:

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

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

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

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

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

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

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

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

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

   КонецЦикла;

КонецЦикла;

ВыбратьВалюты

Открывает выборку валют.

Синтаксис:

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

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

Select Currencies

Параметры:

<ФлагВсе>	Необязательный параметр. 0 — отбирать те валюты, которые имели итоги на этом уровне обхода итогов запроса; 1 — включить в выборку все валюты, которые имели итоги в данном запросе; -1, -2 ... — включить в выборку валюты, которые имели итоги в группировке n-го вышестоящего уровня. По умолчанию — 0.
<ФлагДК>	Необязательный параметр. 1 — включать в выборку валюты только с дебетовы­ми оборотами; 2 — включать в выборку валюты только с кредито­выми оборотами. 0 — включать в выборку валюты вне зависимости от дебетовых/кредитовых оборотов. По умолчанию 0.
<Номер>	Необязательный параметр. Положительное целое число — номер выборки. Если параметр не ука­зан, выборке присваивается номер 0.
<РазвСальдо>	Необязательный параметр. Признак необходимо­сти рассчитывать развернутое сальдо по субкон­то. Используется только если в запросе участву­ют субконто. 1 — рассчитывать развернутое сальдо. 0 — не рассчитать развернутое сальдо; По умолчанию 0.
<Сортировка>	Необязательный параметр. Строка — идентифика­тор реквизита справочника валют, который будет использован для упорядочивания обхода валют методом ПолучитьВалюту. Если значение пустое — используется представление справочника.

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

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

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

Описание:

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

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

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

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

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

Пример:

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

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

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

   БухИтоги.ВыбратьВалюты();

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

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

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

   КонецЦикла;

КонецЦикла;

ВыбратьЗаписи

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

Синтаксис:

ВыбратьЗаписи(<Начало>, <Окончание>}

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

SelectRecords

Параметры:

<Начало>	Дата начала периода.
<Окончание>	Дата окончания периода.

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

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

Описание:

Метод открывает выборку записей журнала расчетов. Выбираются все запи­си, период действия которых хоть на один день затрагивается тем периодом, который задан параметрами <Начало> и <Окончание>. Это значит, например, что если запись журнала расчетов имеет даты начала и окончания '15.12.96' и '25.12.96' то она попадет в выборку, открытую при помощи любого из следующих методов:

ВыбратьЗаписи(•10.10.96', •15.12.96')

ВыбратьЗаписи('25.12.96', '01.01.97')

ВыбратьЗаписи('17.12.96', '17.12.96').

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

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

Пример:

// Расчет количества дней, отработанных всеми сотрудниками

// за прошлый период

//

// журнал расчета зарплаты

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

// дата начала прошлого периода

ДатаНачала = ЖР.НачалоПериодаПоДате(ЖР.НачалоТекущегоПериода() - 1);

ЖР.ВыбратьЗаписи(ДатаНачала, ЖР.КонецПериодаПоДате(ДатаНачала));

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

   Сумма = Сумма + ЖР.ДНИ;

КонецЦикла;

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

ВыбратьЗаписиПоДокументу

Выбрать записи по документу-основанию.

Синтаксис:

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

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

SelееtRecordsByDocument

Параметры:

<Документ>

Документ расчета, который является докумен­том-основанием для отбираемых записей.

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

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

Описание:

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

Важно! Документом-основанием записи журнала расчетов может являться:

документ, непосредственно породивший записи в систему за счет при­менения методов ВвестиРасчет и ЗаписатьРасчет;

документ, ссылка на который передана в качестве параметра одному из методов: ВвестиРасчетНаОсновании или ЗаписатьРасчетНаОсновании.

Пример:

// Рассчитаем все записи по наряду (процедура выполняется

// в контексте журнала расчетов)

// Журнал расчетов

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

ЖР.ВыбратьЗаписиПоДокументу(Документ);

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

   ЖР.Рас считать();

КонецЦикла;

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

ВыбратьЗаписиПоОбъекту

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

Синтаксис:

ВыбратьЗаписиПоОбъекту(<Объект>, <Начало>, <Окончание>)

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

SelectRecordsByObject

Параметры:

<Объект>	Объект расчета, записи которого выбираются.
<Начало>	Дата начала периода.
<Окончание>	Дата окончания периода.

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

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

Описание:

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

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

Пример:

// Проходя по справочнику акционеров, проведем по некоторому

// условию полный расчет дивидендов

// Готовим справочник акционеров

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

Акционеры.ПорядокКодов();

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

// Журнал расчетов дивидендов

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

// Начало и конец текущего периода

Нач = ЖР.НачалоТекущегоПериода();

Кон = ЖР.КонецТекущегоПериода();

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

   Если Акционеры.Статус = 2 Тогда

      ЖР.ВыбратьЗаписиПоОбъекту(Акционеры.ТекущийЭлемент(), , );

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

         ЖР.Рассчитать();

      КонецЦикла;

   КонецЕсли;

КонецЦикла;

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

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

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

Синтаксис:

ВыбратьЗначение(<Значение>, <3аголовок>, <Позиция> , <Таймаут>, <Спосо6Выбора>)

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

ChooseValue

Параметры:

<Значение>	Идентификатор переменной, куда помещается значение — результат выбора.
<3аголовок>	Строковое выражение, значение которого отображается в заголовке диалогового окна. Может использоваться для подсказки пользователю.
<Позиция>	Идентификатор переменной, куда помещается номер позиции выбранного значения в списке.
<Таймаут>	Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя.
<СпособВыбора>	Необязательный параметр. Числовое выражение, значение которого задает способ выбора значения: 0 — в виде диалога; 1 — выбор производится в виде меню, которое подстраивается по месту текущего элемента диалога или ячейки таблицы, откуда вызвано; 2 — выбор маленьким списком (список похож на выбор значения перечисления), также привязанным к позиции элемента диалога. Значение по умолчанию — 0.

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

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

Описание:

Метод ВыбратьЗначение вызывает диалоговое окно для интерактивного выбора значения из заранее подготовленного списка. Возвращаемое числовое значение: 1 — если выбор произведен, 0 — если нет. Параметр <Значение> указывает на значение того элемента списка, на котором будет установлен курсор при открытии окна выбора. В этот же параметр возвращается выбранное значение. В параметр <Позиция> возвращается номер позиции выбранного значения в списке. Если выбор отменен, то значение параметров не меняются.

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

Пример:

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

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

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

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

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

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

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

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

   КонецЦикла;

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

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

   КонецЕсли;

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

ВыбратьЗначения

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

Синтаксис:

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

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

Selectltems

Параметры:

<ДатаНачала>	Необязательный параметр. Выражение типа «дата» — дата начала периода выборки периодических значений. Если параметр не задан, то выборка начинается с самой ранней имеющейся даты.
<ДатаКонца>	Необязательный параметр. Выражение типа «дата» — дата конца периода выборки периодических значений. Если параметр не задан, то выборка заканчивается самой последней имеющейся датой.

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

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

Описание:

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

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

Пример:

Процедура КурсыВалюты(КодВалюты)

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

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

   Вал.НайтиПоКоду(КодВалюты);

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

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

   Иначе

      Предупреждение("Не найдена валюта!");

      Возврат;

   КонецЕсли;

   ПерВал = СоздатьОбъект("Периодический");

   ПерВал.ИспользоватьОбъект("Текуш_курс", Доллар);

   ПерВал.ОбратныйПорядок(1);

   ПерВал.ВыбратьЗначения();

   Пока ПерВал.ПолучитьЗначение() = 1 Цикл

      Сообщить("Курс: " + Строка(ПерВал.ДатаЗнач) + ПерВал.Значение);

   КонецЦикла;

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

См. также: ПолучитьЗначение, ИспользоватьОбъект

? (Вычислить выражение по условию)

Вычислить выражение по условию.

Синтаксис:

?(<Логич_выраж>, <Выраж1>, <Выраж2>)

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

?

Параметры:

<Логич_выраж>	Логическое выражение.
<Выраж1>	Выражение.
<Выраж2>	Выражение.

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

Результирующее значение.

Описание:

Функция ? вычисляет значение <Логич_выраж> и если его значение — истина, то возвращает вычисленное значение <Выраж1>. Если значение <Логич_выраж> — ложь, то возвращает вычисленное значение <Выраж2>.

Пример:

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

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

   Состояние(Спр.Наименование);

   Сообщить(Спр.Наименование);

   Sec = ?(Спр.ЭтоГруппа = 1, "Folder", "DL");

   Таб.ВывестиСекцию(Sес + "-V1");

   Таб.ПрисоединитьСекцию(Sec + "-V3");

КонецЦикла;

Выгрузить

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

Синтаксис:

Выгрузить(<Знач>, <НачПоз>, <Колич>)

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

Unload

Параметры:

<Знач>	Значение типа «Таблица значений» или «Список значений», в которое нужно выгрузить данные. При выгрузке в таблицу значений, в ней добавляется новая колонка. Если переданное значение пустое, тогда система сама создаст объект типа «Список значений».
<НачПоз>	Необязательный параметр. Номер начальной позиции, с которой надо начинать выгрузку. Значение по умолчанию 1.
<Колич>	Необязательный параметр. Количество выгружаемых значений, если не указан то все.

Описание:

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

Пример:

СтарСписок.Выгрузить(НовСписок);

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

Выгрузить

Выгрузить данные из таблицы значений.

Синтаксис:

Выгрузить(<Знач>, <НачСтрока>, <КонСтрока>, <Колонки>)

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

Unload

Параметры:

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

Описание:

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

Пример:

НовТабл = СоздатьОбъект("ТаблицаЗначений");

СтарТабл.Выгрузить(НовТабл, 1, 5, "1,3,5,7");

Выгрузить

Выгружает значения и имена для всех предназначенных для ввода ячеек в объект типа «Список значений».

Синтаксис:

Выгрузить(<СписокЗначений>)

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

Load

Параметры:

<СписокЗначений>

Идентификатор объекта типа «Список значений», куда выгружаются парами значения и имена для всех предназначенных для ввода ячеек.

Описание:

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

Пример:

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

Таблица.Выгрузить(Список);

Выгрузить

Выгружает результаты запроса в таблицу значений.

Синтаксис:

Выгрузить(<ТаблЗнач>, <Флаг>, <Итоги>)

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

Unload

Параметры:

<ТаблЗнач>	Таблица значений, куда выгружаются результаты запроса.
<Флаг>	Необязательный параметр. Число: 0 — значения групп и функций (по умолчанию); 1 — значения групп и функций, дополнительных переменных; 2 — значения упорядочиваний групп и функций; 3 — значения упорядочиваний групп и функций, дополнительных переменных; Строка — "Товар(1), Товар(2), Товар, Склад, Приход, Расход" , где Товар(1) — значение первого упорядочивания группировки "Товар".
<Итоги>	Необязательный параметр. Число: 0 — итоги по группировкам не выводить; 1 — итоги по группировкам выводить сверху (по умолчанию); 2 — итоги по группировкам выводить снизу; 3 — итоги по группировкам выводить сверху и снизу.

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

Число: 1 — если выгрузка произошла успешно, иначе — 0.

Описание:

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

Пример:

// Текст запроса

Текст3апроса = "

| ...

|Группировка Должность;

|Группировка Категория;

| ...

|";

// Текст процедуры обработки запроса

Если Запрос.Выполнить(ТекстЗапроса) = 0 Тогда

   Возврат;

КонецЕсли;

ТаблЗнач = Создать("ТаблицаЗначений");

Запрос.Выгрузить(ТаблЗнач, 0, 0);

ВыгрузитьИтоги

Выгрузить все итоги регистра с текущим фильтром в таблицу значений.

Синтаксис:

ВыгрузитьИтоги(<Та6лЗнач>, <ВключатьИзмерФильтра>, <ПредварительноОчищать>)

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

RetrieveTotals

Параметры:

<ТаблЗнач>	Объект типа ТаблицаЗначений, куда система выгрузит все итоги регистра.
<ВключатьИзмерФильтра>	Необязательный параметр. Число: 1 — в получаемую таблицу включаются измерения, закрепленные фильтром; 0 — не включаются. Значение по умолчанию — 0.
<ПредварительноОчищать>	Необязательный параметр. Число: 1 — перед выгрузкой таблица значений очищается; 0 — не очищается. Значение по умолчанию — 1.

Описание:

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

Пример:

Функция ВыбратьКредит(ВыбКлиент)

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

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

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

   Рег.ВыгрузитьИтоги(Список, 1);

   Возврат Список;

КонецФункции

См. также: УстановитьФильтр

ВыгрузитьТабличнуюЧасть

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

Синтаксис:

ВыгрузитьТабличнуюЧасть(<3нач>, <Реквизиты>)

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

UnloadTable

Параметры:

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

Описание:

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

Пример:

ВыбДокум.ВыгрузитьТабличнуюЧасть(ТаблЗнач, "Товар, Сумма, НДС, Цена");

Выполнить

Выполнить запрос.

Синтаксис:

Выполнить(<ТекстЗапроса>)

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

Execute

Параметры:

<ТекстЗапроса>

Строковое выражение, содержащее текст запроса на языке запросов (см. Главу «Язык запросов»).

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

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

Описание:

Метод Выполнить анализирует описание запроса, содержащееся в тексте запроса <ТекстЗапроса>, выполняет выборку данных, формирует временный выходной набор данных (выборку), вычисляет значения функций запроса (см. главу «Язык запросов»).

Язык запросов предназначен для описания запросов к базе данных. Написанный на языке запросов текст описания передается методу Выполнить в качестве параметра. Метод Выполнить непосредственно выполняет запрос, о результате его выполнения формируется временный выходной набор данных, который в дальнейшем используется для заполнения формы отчета.

Пример:

Процедура Сформировать()

   // сформируем данные на начало месяца

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

   _Дата = ЖР.НачалоТекущегоПериода();

   // Создание объектов типа "Запрос"

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

   ЗапросКат = СоздатьОбъект("Запрос");

   флаг1 = Запрос.Выполнить(

   "//({ЗАПРОС(Двойной)

   |Период с _Дата по _Дата;

   |Оклад = Справочник.Сотрудники.Оклад;

   |Пдр = Справочник.Сотрудники.МестоРаботы.Владелец;

   |Ктг = Справочник.Сотрудники.Категория;

   |Условие((Ктг.Выбран() = 1) И (Пдр.Выбран() = 1));

   |Группировка Пдр без групп;

   |Группировка Ктг без групп;

   |Функция Всего = Сумма(Оклад);

   |"//}} ЗАПРОС

   );

   Флаг2 = ЗапросКат.Выполнить(

   "//{{ЗАПРОС(Одинарный)

   |Период с _Дата по _Дата;

   |Оклад = Справочник.Сотрудники.Оклад;

   |Ктг = Справочник.Сотрудники.Категория;

   |Условие(Ктг.Выбран() = 1);

   |Группировка Ктг без групп;

   |Функция Всего = Сумма(Оклад);

   |"//}}ЗАПРОС

   );

   // Если ошибка в запросе, то выход из процедуры

   Если ((Флаг1 = 0) ИЛИ (Флаг2 = 0)) Тогда

      Сообщить("Ошибка в запросе!");

      Возврат;

   КонецЕсли;

   // Подготовка к заполнению выходных форм данными запроса

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

   // Выводим заглавие таблицы

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

   Пока ЗапросКат.Группировка("Ктг") = 1 Цикл

      Таб.ПрисоединитьСекцию("Документ<|Осн2");

   КонецЦикла;

   Таб.ПрисоединитьСекцию("Документ<|ДокументВерт>");

   // Выводим колонтитул таблицы

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

   Пока ЗапросКат.Группировка("Ктг") = 1 Цикл

      Таб.ПрисоединитьСекцию("КолонТитул|Осн2");

   КонецЦикла;

   Таб.ПрисоединитьСекцию("КолонТитул|ДокументВерт>");

   Продолжать = 1;

   Пока Запрос.Группировка("Пдр") = 1 Цикл

      // Заполнение полей

      Пдр Таб.ВывестиСекцию("Осн1|ДокументВерт<");

      Далее = 1;

      Пока Продолжать = 1 Цикл

         // Заполнение полей Ктг

         СлКат = ЗапросКат.Группировка("Ктг");

         Если Далее = 1 Тогда

            ОК = Запрос.Группировка("Ктг");

         КонецЕсли;

         Если СлКат = 0 Тогда

            Прервать;

         КонецЕсли;

         Если ЗапросКат.Ктг = Запрос.Ктг Тогда

            Таб.ПрисоединитьСекцию("Осн1|Осн2");

            Далее = 1;

         Иначе

            Таб.ПрисоединитьСекцию("Осн1|Пусто");

            Далее = 0;

         КонецЕсли;

      КонецЦикла;

      Таб.ПрисоединитьСекцию("Осн1|ДокументВерт>");

   КонецЦикла;

   // Заполнение полей "Итого"

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

   Пока ЗапросКат.Группировка("Ктг") = 1 Цикл

      Таб.ПрисоединитьСекцию("Документ>|Осн2");

   КонецЦикла;

   Таб.ПрисоединитьСекцию("Документ>|ДокументВерт>");

   // Вывод заполненной формы Таб.Опции(0, 0, 0, 0);

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

   Таб.Показать("Результат", );

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

ВыполнитьРасчет

Выполнить расчет текущей записи журнала расчетов.

Синтаксис:

ВыполнитьРасчет()

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

RunCalculate

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

Числовое значение — 1, если расчет записи выполнен успешно, и 0 — в про­тивном случае (в том числе, при прерывании процедуры расчета пользователем путем нажатия клавиши <Esc>).

Описание:

Выполняет расчет текущей строки журнала расчетов.

Как правило, применяется в цикле, выполняющем перебор записей журнала расчетов при помощи метода ПолучитьЗапись. Работает точно так же, как и метод Рассчитать, но имеет возвращаемое значение. Применяется в том слу­чае, если при обработке в цикле записей журнала расчетов бывает необходимо прервать выполнение расчета.

Пример:

// процедура выполняет расчет по журналу Зарплата

Процедура Выполнить()

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

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

      Если Считать() = 1 Тогда

         Если ЖрнЗарплата.ВыполнитьРасчет()= 0 Тогда

            // прерываем процедуру, если расчет неудачен или

            // пользователь нажал Езс

            Прервать;

         КонецЕсли;

      КонецЕсли;

   КонецЦикла;

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

ВыполнитьВыбор

Осуществляет выбор из формы подбора.

Синтаксис:

ВыполнитьВыбор(<Знач>)

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

MakeChoise

Параметры:

<Знач>

Значение, которое выбирается в форме, открытой для подбора или выбора значения.

Описание:

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

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

Пример:

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

Форма.ВыполнитьВыбор(ТекущийДокумент);

ВыполнитьЗапрос

Выборка итогов в различных разрезах.

Синтаксис:

ВыполнитьЗапрос(<НачалоПериода>, <КонецПериода>, <ФильтрПоСчетам>,

       <ФильтрПоКоррСчет>, <Валюта>, <ТипИтогов>, <Периодичность>, <ТипСуммы>)

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

DoQuery

Параметры:

<НачалоПериода>		Необязательный параметр. Выражение типа дата, документ или позиция документа начала периода запроса. Если этот параметр не указан, будут вы­числяться начальные сальдо на момент, указан­ный в параметре <КонецПериода>
<КонецПериода>		Необязательный параметр. Выражение типа дата, документ или позиция документа конца периода запроса. Если этот параметр не указан, будут вычисляться начальные сальдо на момент, указанный в параметре  <НачалоПериода>.
<ФильтрПоСчетам>		Необязательный параметр. Счета, для которых будут отбираться итоги в запросе. Задается зна­чением типа «Счет» или объектом типа «Список-Значений», содержащим значения типа «Счет», либо строкой содержащей список кодов счетов, разделенных символом ", " или ";". Если параметр не указан, отбор будет выполняться по всем сче­там.
<ФильтрПоКоррСчет>		Необязательный параметр. Значение типа «Счет» — корреспондирующий счет, в корреспон­денции с которым будут отбираться итоги счета, указанного в параметре <ФильтрПоСчетам>. Задается значением типа «Счет» или объектом типа «СписокЗначений», содержащим значения типа «Счет», либо строкой содержащей список кодов счетов, разделенных символом "," или ";". Если параметр не указан, будут отбираться итоги в корреспонденции со всеми счетами.
<Валюта>		Необязательный параметр. Значение типа «Справочник.Валюты». Если параметр не указан итоги выдаются без учета валюты.
<ТипИтогов>		Необязательный параметр. Число — тип отбирае­мых итогов. Может принимать следующие значе­ния: 1 — остатки и обороты по счету в целом; 2 — обороты между счетами; Первое и второе вместе. По умолчанию — 1.
<Периодичность>		Необязательный параметр. Позволяет получить дополнительный разрез итогов по периодам. Чис­ло или символьная строка (См. ниже). По умол­чанию периодичность не задана.
<ТипСуммы>		Необязательный параметр. Число или строка — тип рассчитываемых итогов. Может принимать следующие значения (в скобках указаны строко­вые синонимы): 1 («С», «S») рассчитывать суммы; 2 («В», «С») рассчитывать валютные суммы; 4 («К», «А») рассчитывать количество. Если требуется одновременно рассчитывать раз­ные суммы, значение параметра получается путем сложения допустимых значений, например: 5 (1+4) — рассчитывать суммы и количество. При указании параметра строкой в ней указываются все символы, которые обозначают типы сумм, которые нужно рассчитывать. По умолчанию рассчитываются все типы сумм.

Параметр <Периодичность> может принимать следующие значения (в скобках указаны строковые синонимы):

1 («Период», «Period»)	Промежуточные итоги не рассчиты­ваются;
2 («Операция», «Entry»)	Промежуточные итоги рассчитыва­ются по операциям;
3 («Проводка», «Operation»)	По проводкам;
4 («День», «Day»)	По дням;
5 («Неделя», «Week»)	По неделям;
6 («Декада», «Decade»)	По декадам;
7 («Месяц», «Month»)	По месяцам;
8 («Квартал», «Quorter»)	По кварталам
9 («Год», «Year»)	По годам.

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

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

Описание:

Метод ВыполнитьЗапрос выполняет отбор и расчет итогов за период, за­даваемый параметрами <НачалоПериода> и <КонецПериода>.

В зависимости от переданных параметров итоги могут быть подготовлены методом ВыполнитьЗапрос в различных разрезах. Кроме того, на результат запроса влияют дополнительные установки, которые выполняются вызовами специальных методов объекта «Бухгалтерские Итоги».

Параметр <Периодичность> позволяет получить итоги запроса в разрезе периодов.

Метод ВключатьСубсчета позволяет получить итоги в разрезе субсчетов.

Применение метода ИспользоватьСубконто (перед вызовом ВыполнитьЗапрос) позволяет сформировать запрос в разрезе субконто.

После выполнения запроса обход запросов в различных разрезах выполня­ется соответствующими методами объекта.

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

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

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

Пример:

В монопольном режиме:

// модуль обработки

ИтРасчет.Актуальность(1);

   ...

   Док.ВыбратьДокументы();

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

      ИтРасчет.Рассчитать(, Док.ТекущийДокумент());

      ...

      Док.Провести();

   КонецЦикла;

   ...

// модуль документа

...

ИтЗапрос.ВыполнитьЗапрос(, Док.ТекущийДокумент(), СчетПоКоду("41"));

...

в данном случае ИтЗапрос.ВыполнитьЗапрос(...) воспользуется ре­зультатами временного расчета ИтРасчет. Данная возможность может исполь­зоваться при групповом перепроведении документов.

Пример:

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

ВыполнятьФормулуТолькоПриИзменении

Установка режима выполнения формулы.

Синтаксис:

ВыполнятьФормулуТолькоПриИзменении(<Режим>)

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

ProcessFormulaOnlyWhenChanged

Параметры:

<Режим>

Числовое выражение: 1 — устанавливает режим, при котором в табличной части документа формула («Свойства» — «Дополнительные» — «Формула») вызывается только при изменении значения поля, а не при переходе между полями; 0 — устанавливает режим, при котором в табличной части документа формула вызывается при изменении значения поля и при переходе между полями.

Описание:

Метод ВыполнятьФормулуТолькоПриИзменении позволяет изменить режим выполнения формулы выбранного поля табличной части документа. Доступ к данному методу возможен только в контексте Модуля формы.

Пример:

Форма.Цена.ВыполнятьФормулуТолькоПриИзменении(1);

Выражение и фильтр индекса

При работе с индексами во время исполнения 1С:Предприятия XBase-объекты производят вычисление выражения индекса и фильтра. Выражение индекса и фильтра — это строковые выражения, составленные на специальном языке объектов XBase.

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

Атрибуты (кроме "Ключ"), константы и функции могут быть использованы как части выражений. Части выражения могут объединяться с помощью других функций или операторов. Простейшим выражением может быть имя атрибута: "FULL_NAME". В таком случае тип выражения будет соответствовать типу атрибута.

Константы могут иметь числовой, строковый и булевый тип. Строковые константы заключаются в одиночные кавычки ('Строковая константа'). При необходимости включить в состав строковой константы символа двойной кавычки, его следует предварять обратной косой чертой, например, 'Фирма \"Вега\" '. Булевы константы записываются как .TRUE. или .Т. для обозначения истины и .FALSE. или .F. в противном случае.

Операторы используются для объединения частей выражения. Части выражения должны иметь тип, соответствующий оператору, например, оператор "/" (деление) работает с двумя числовыми значениями.

Порядок выполнения операторов в выражении соответствует общепринятому — с учетом скобок и приоритетов операторов. Например выражение "1+2*3" возвратит 7, а "(1+2)*3" возвратит 9.

Числовые операторы:

Имя оператора		Обозначение		Приоритет
Сложение		+		5
Вычитание		-		5
Умножение		*		6
Деление		/		6
В степень		** или ^		7

Строковые операторы:

Имя оператора	Обозначение	Приоритет
Объединение 1	+	5
Объединение 2	-	5

Оператор " Объединение 2" немного отличается тем, что пробелы в конце первой строки будут перемещены в конец результата. Например, результатом вычисления выражения " 'Иванов ' + 'И. И.' " будет "Иванов И. И.', а " 'Иванов ' - 'И. И.' " — 'ИвановИ.И.  '.

Операторы отношений:

Имя оператора	Обозначение	Приоритет
Равно	=	4
Не равно	<> или #	4
Меньше	<	4
Больше	>	4
Меньше или равно	<=	4
Больше или равно	>=	4
Содержит	$	4

Пример:

" 'CD' $ 'ABCD' " вернет ".Т."

" 8 < 7 " вернет ".F."

Логические операторы:

Имя оператора	Обозначение	Приоритет
Отрицание	.NOT.	3
И	.AND.	2
ИЛИ	.OR.	1

Выражения

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

ВысотаСекции

Определить высоту секции таблицы-шаблона.

Синтаксис:

ВысотаСекции(<ИмяСекции>)

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

SectionHeight

Параметры:

<ИмяСекции>

Строковое выражение — название секции таблицы.

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

Числовое значение, содержащее количество строк в секции таблицы-шаблона.

Описание:

Метод ВысотаСекции позволяет определить количество столбцов в секции таблицы-шаблона.

Пример:

ВысС = Таб.ВысотаСекции("ШапкаОтчета");

ВысотаСтроки

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

Синтаксис:

ВысотаСтроки(<Высота>)

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

RowHeight

Параметры:

<Высота>    Необязательный параметр. Число: высота строк, проходящих через область в пунктах с точностью до 0,25. Если параметр опущен, то высота строк области не изменяется.

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

Высота строк области в пунктах области (на момент до исполнения метода).

Описание:

Метод ВысотаСтроки устанавливает высоту строк, проходящих через область.

Пример:

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

Таб.Открыть("tabl_l.mxl");

ВыбОбласть = Таб.Область("R8C4");

ВыбОбласть.Шрифт("Arial");

ВыбОбласть.РазмерШрифта(10);

ВыбОбласть.Подчеркнутый(1);

ВыбОбласть.ГоризонтальноеПоложение(3);

ВыбОбласть.Контроль(4);

ВыбОбласть.ВысотаСтроки(3 );

ВысотаТаблицы

Определить текущую высоту результирующей таблицы.

Синтаксис:

ВысотаТаблицы()

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

TableHeight

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

Числовое значение, содержащее количество строк в результирующей таблице.

Описание:

Метод ВысотаТаблицы позволяет определить текущее количество строк в результирующей таблице.

Пример:

Выс = Таб.ВысотаТаблицы();

ВытесняетсяВидомРасчета

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

Синтаксис:

ВытесняетсяВидомРасчета(<ВидРасчета>)

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

DisplaceByCalc

Параметры:

<ВидРасчета>

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

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

Число: 1 — если вид расчета, метод которого вызывается, вытесняется видом расчета, заданным в качестве параметра <ВидРасчета>; 0 в противном случае.

Описание:

Метод предназначен для определения взаимного влияния видов расчета при вводе их в журнал расчетов.

См. также: ВытесняетВидРасчета

ВытесняетВидРасчета

Определяет, вытесняет ли данный вид расчета, заданный в качестве параметра.

Синтаксис:

ВытесняетВидРасчета(<ВидРасчета>)

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

DisplaceCalc

Параметры:

<ВидРасчета>

Вид расчета, для которого проверяется, вытесня­ется ли он текущим видом расчета.

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

Число: 1 — если вид расчета, метод которого вызывается, вытесняет заданный в качестве параметра <ВидРасчета>; 0 в противном случае.

Описание:

Метод предназначен для определения взаимного влияния видов расчета при вводе их в журнал расчетов.

Пример:

// ВР — реквизит документа типа "вид расчета",

// тогда при проведении документа

// Сотр — реквизит документа типа "элемент справочника Сотрудники".

// ДтНач, ДтОконч — реквизиты документа типа "дата"

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

ЖР.ВыбратьПоОбъекту(Сотр, ДтНач, ДтОконч);

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

   Если ЖР.ВидРасч.ВытесняетВидРасчета(ВР) = 0 Тогда

      // если нашли вид расчета, который мы не сможем вытеснить

      Сообщить("Невозможно корректное проведение документа");

      СтатусВозврата(0);

      Возврат;

   КонецЕсли;

КонецЦикла;

См. также: ВытесняетсяВидомРасчета

Вывести

Перенести всю исходную таблицу-шаблон в результирующую таблицу.

Синтаксис:

Вывести()

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

Put

Описание:

Метод Вывести целиком переносит исходную таблицу-шаблон в результирующую таблицу.

Пример:

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

Таб.ИсходнаяТаблица("catalog");

Таб.Вывести();

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

Таб.Показать("Каталог", "catalog.mxl");

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

ВывестиСекцию

Перенести секцию исходной таблицы-шаблона в результирующую таблицу.

Синтаксис:

ВывестиСекцию(<Секция>)

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

PutSection

Параметры:

<Ceкция>

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

Описание:

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

ИдентификаторСекции1[<|>|-][|ИдентификаторСекции2[<|>|-]]

Символы "<" , ">" , "-" после идентификатора секции указывают на то, что выбирается только часть секции:

<	заголовочная часть (с начала секции до начала вложенной секции).
>	подвальная часть (с конца вложенной секции до конца секции).
—	средняя часть (собственно вложенная секция).

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

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

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

Пример:

//Выводим заглавие таблицы

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

Пока ЗапросКат.Группировка("Ктг") = 1 Цикл

   Таб.ПрисоединитьСекцию("Документ<|Осн2");

КонецЦикла;

Таб.ПрисоединитьСекцию("Документ<|ДокументВерт>");

//Выводим колонтитул таблицы

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

Пока 3апросКат.Группировка("Ктг") = 1 Цикл

   Таб.ПрисоединитьСекцию("КолонТитул|Осн2");

КонецЦикла;

Таб.ПрисоединитьСекцию("КолонТитул|ДокументВерт>");

Продолжать = 1;

Пока Запрос.Группировка("Пдр") = 1 Цикл

   // Заполнение полей

   Пдр Таб.ВывестиСекцию("Осн1|ДокументВерт<");

   Далее = 1;

   Пока Продолжать = 1 Цикл

      // Заполнение полей Ктг

      СлКат = ЗапросКат.Группировка("Ктг");

      Если Далее = 1 Тогда

         ОК = Запрос.Группировка("Ктг");

      КонецЕсли;

      Если СлКат = 0 Тогда

         Прервать;

      КонецЕсли;

      Если ЗапросКат.Ктг = Запрос.Ктг Тогда

         Таб.ПрисоединитьСекцию("Осн1|Осн2");

         Далее = 1;

      Иначе

         Таб.ПрисоединитьСекцию("Осн1|Пусто");

         Далее = 0;

      КонецЕсли;

   КонецЦикла;

   Таб.ПрисоединитьСекцию("Осн1|ДокументВерт>");

КонецЦикла;

ВыводитьПиктограммы

Выводить в элементе диалога типа «ТаблицаЗначений» пиктограммы.

Синтаксис:

ВыводитьПиктограммы(<Колонка>, <Пиктограмма>)

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

Showlmages

Параметры:

<Колонка>	Номер или идентификатор колонки, которая содержит номера пиктограмм.
<Пиктограмма>	Необязательный параметр. Начальный номер пиктограммы. Значение по умолчанию: 1.

Описание:

Метод ВыводитьПиктограммы устанавливает режим, при котором в колонке выводится не текст, а пиктограмма. Пиктограмма будет браться из картинки, назначенной элементу диалога «ТаблицаЗначений» в закладке «Картинка» в конфигураторе. Картинка должна быть формата .bmp, содержать все пиктограммы для этой таблицы значений, и состоять из последовательности пиктограмм размером 16х15 пикселей. Пиктограммы будут выбираться из картинки по номеру, взятому из числового значения данной колонки в текущей строке. Параметр <Пиктограмма> позволяет установить для данной колонки начальный номер пиктограмм в картинке.

Пример:

ТаблДиалога.ВыводитьПиктограммы(1, 1);

WindowsКаталог

Возвращает имя Windows директории.

Синтаксис:

WindowsКаталог()

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

GetWindowsDirectory

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

Строковое значение — имя Windows директории.

Описание:

Метод WindowsКаталог возвращает имя Windows директории.

Пример:

WinKaT = ФC.WindowsКаталог();

Забалансовый

Признак забалансовости счета.

Синтаксис:

Забалансовый

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

IsSingle

Значение:

1 — выбранный счет является забалансовым счетом;

0 — выбранный счет является балансовым счетом.

Описание:

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

Пример:

Сч.Забалансовый = 1;

ЗаданВКонфигурации

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

Синтаксис:

ЗаданВКонфигурации()

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

DefinedInConfiguration

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

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

Описание:

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

Пример:

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

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

Если Сч.ЗаданВКонфигурации() = 1 Тогда

   Сообщить("Счет задан в Конфигурации ");

КонецЕсли;

ЗафиксироватьТранзакцию

Завершить успешную транзакцию.

Синтаксис:

ЗафиксироватьТранзакцию()

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

CoinmitTransation

Описание:

Процедура ЗафиксироватьТранзакцию завершает успешную транзакцию.

Пример:

Процедура УдалитьПустые()

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

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

   НачатьТранзакцию();

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

      Если Спр.Количество = 0 Тогда

         Спр.Удалить();

      КонецЕсли;

   КонецПока;

   ЗафиксироватьТранзакцию();

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

Заголовок

Установка заголовка окна формы.

Синтаксис:

Заголовок(<Название>, <Режим>)

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

Caption

Параметры:

<Название>	Строковое выражение — новый заголовок окна формы.
<Режим>	Числовое выражение: 0 — выводит заданный заголовок вместо стандартного заголовка окна; 1 — выводит заданный загловок вместе со стандартным заголовком окна.

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

Текущий заголовок окна формы, установленный этой функцией.

Описание:

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

Пример:

Форма.Заголовок("Накладная №" + Док.НомерДок, 0 );

Заголовок

Устанавливает/выдает заголовок элемента диалога.

Синтаксис:

Заголовок(<Название>)

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

Caption

Параметры:

<Название>

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

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

Текущий заголовок элемента диалога.

Описание:

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

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

Пример:

Форма.КолонкаЦены.Заголовок("Цена");

Заголовок

Заголовок диаграммы.

Синтаксис:

Заголовок

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

TitleText

Описание:

Атрибут Заголовок содержит текст заголовка диаграммы. По умолчанию имеет значение «Диаграмма».

Пример:

Диаграмма.Заголовок = "Пример использования диаграммы";

ЗаголовокСистемы

Получить/установить заголовок окна программы.

Синтаксис:

ЗаголовокСистемы(<3аголовок>)

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

SystemCaption

Параметры:

<Заголовок>

Строковое выражение.

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

Строковое значение — заголовок системы до исполнения метода.

Описание:

Метод ЗаголовокСистемы позволяет получить/установить заголовок окна программы.

Пример:

ЗаголовокСистемы("Оптово-розничная конфигурация")

Загрузить

Скопировать структуру и значения таблицы значений.

Синтаксис:

Загрузить(<ТаблицаЗначений>)

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

Load

Параметры:

<ТаблицаЗначений>

Значение типа «Таблица значений». Структура и значения для загрузки.

Описание:

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

Пример:

НовТабл = СоздатьОбъект("ТаблицаЗначений");

НовТабл.Загрузить(СтарТабл);

Загрузить

Загружает значения и имена для всех предназначенных для ввода ячеек из объекта типа «Список значений».

Синтаксис:

Загрузить(<СписокЗначений>)

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

Save

Параметры:

<СписокЗначений> Идентификатор объекта типа «Список значений», откуда загружаются парами значения и имена для всех предназначенных для ввода ячеек.

Описание:

Метод Загрузить загружает значения и имена для всех предназначенных для ввода ячеек таблицы из объекта типа «Список значений», причем представление списка значений становится именем ячейки, а значение записи становится значением ячейки.

Пример:

Процедура ОчиститьТаблицу()

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

   Таблица.Выгрузить(Список);

   ИмяЯчейки = "";

   Для Н = 1 По Список.РазмерСписка() Цикл

      ЗначЯчейки = Список.ПолучитьЗначение(Н, ИмяЯчейки);

      Список.УстановитьЗначение(Н, 0, ИмяЯчейки, 1);

   КонецЦикла;

   Таблица.Загрузить(Список);

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

Загрузить

Загрузить из файла.

Синтаксис:

Загрузить(<ИмяФайла>)

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

Load

Параметры:

<ИмяФaйлa>

Строковое выражение, которое может задавать или идентификатор картинки в библиотеке картинок конфигурации или имя файла картинки.

Описание:

Метод Загрузить загружает картинку из файла с указанным именем <ИмяФайла> или берет по идентификатору картинку из библиотеки картинок конфигураци. Файл может быть следующих форматов:

.wmf

.emf

.ico

.bmp

.dib

.rle

Пример:

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

Фото.Загрузить("с:\BMP\Boris.bmp");

#ЗагрузитьИзФайла

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

Синтаксис:

#ЗагрузитьИзФайла <ИмяФайла>

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

ftLoadFromFile

Параметры:

<ИмяФайла>

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

Описание:

Данная конструкция переключает загрузку программного модуля на загрузку из указанного файла. Специальная конструкция #ЗагрузитьИзФайла должна записываться в первой строке программного модуля с первой позиции. Ее использование рекомендуется для отладки, чтобы быстро отлаживать код какого-либо программного модуля без промежуточного сохранения всей конфигурации. Данная конструкция переключает загрузку программного модуля конфигурации на загрузку из указанного файла. Содержимое программного модуля конфигурации при этом игнорируется.

Для редактирования собственно файла, откуда загружается текст программного модуля, можно использовать встроенный текстовый редактор системы 1С:Предприятие , открывая его через главное меню «Файл» — «Открыть». Далее, если выбрать в главном меню «Действия» — «Текст модуля», то это позволит при редактировании использовать свойства контекстного выделения цветом синтаксических конструкций языка и установленную для программных модулей ширину табуляции.

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

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

Замечание: #ЗагрузитьИзФайла является не оператором, а специальной конструкцией, поэтому не должна заканчиваться точкой с запятой.

Пример:

#ЗагрузитьИзФайла NEW_MOD.TXT

ЗагрузитьТабличнуюЧасть

Загрузить многострочную часть документа из таблицы значений.

Синтаксис:

ЗагрузитьТабличнуюЧасть(<ТаблЗнач>)

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

LoadTable

Параметры:

<ТаблЗнач>

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

Описание:

Метод ЗагрузитьТабличнуюЧасть загружает многострочную часть документа из таблицы значений.

Пример:

ВыбДокум.ЗагрузитьТабличнуюЧасть(ТаблЗнач);

Закладки

Объект типа «СписокЗначений», содержащий описания закладок текущей формы.

Синтаксис:

Закладки

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

TabCtrl

Описание:

Атрибут объекта «Форма» Закладки представляет собой объект типа «СписокЗначений», содержащий описания закладок текущей формы. Данный атрибут предоставляет возможность программно манипулировать порядком и названиями закладок формы. В тексте программного модуля через точку после имени объекта «Форма» можно вызвать атрибут «Закладки», а далее через точку можно вызывать методы управления закладками как объектом типа «СписокЗначений».

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

Пример:

Процедура ОбработкаКлиектов()

   Если ФлагФранчайзи = 1 Тогда

      Если Форма.Закладки.НайтиЗначение(2) = 0 Тогда

         Форма.Закладки.ДобавитьЗначение(2, "Поставщики");

      КонецЕсли;

   Иначе

      Позиция = Форма.Закладки.НайтиЗначение(2);

      Если Позиция > 0 Тогда

         Форма.Закладки.УдалитьЗначение(Позиция);

      КонецЕсли;

   КонецЕсли;

   форма.Закладки.Сортировать();

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

См. также: ИспользоватьЗакладки, ПриВыбореЗакладки, «Работа со СпискомЗначений»

ЗакладкиОтбора

Установить в форме списка справочника закладки для интерактивного осуществления отбора.

Синтаксис:

ЗакладкиОтбора(<ИмяОтбора>, <3начение0тбора>)

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

TabCtrlSelection

Параметры:

<ИмяОтбора>	Строковое выражение, содержащее имя отбора.
<ЗначениеОтбора>	Значение отбора, который будет установлен первоначально.

Описание:

Метод ЗакладкиОтбора устанавливает в форме списка справочника закладки для интерактивного осуществления отбора.

Данный метод доступен только в контексте Модуля формы списка справочника (см. «Виды программных модулей»).

Пример:

ЗакладкиОтбора("Имя", "Коля");

ЗакладкиОтбора

Установить в форме журнала закладки для интерактивного осуществления отбора.

Синтаксис:

ЗакладкиОтбора(<ИмяОтбора>, <ФлагОтбораЗначенийВИнтервалеЖурнала>,

               <ФлагУстановкиЗначенияОтбора>, <3начение0тбора>)

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

TabCtrlSelection

Параметры:

<ИмяОтбора>	Строковое выражение, содержащее имя отбора.
<ФлагОтбораЗначенийВИнтервалеЖурнала>	Числовое выражение: 1 — текущие значения отбора для закладок выбираются только по документам в установленном интервале журнала; 0 — текущие значения отбора для закладок выбираются по всем документам журнала.
<ФлагУстановкиЗначенияОтбора>	Числовое выражение: 1 — для отображения сразу выбирается отбор по параметру <3начение0тбора>; 0 — текущее значение отображаемой закладки отбора устанавливается на первое существующее значение.
<3начение0тбора>	Значение отбора.

Описание:

Метод ЗакладкиОтбора устанавливает в форме журнала закладки для интерактивного осуществления отбора.

Данный метод доступен только в контексте Модуля формы журнала документов (см. «Виды программных модулей»).

Пример:

ЗакладкиОтбора("Склады", 1, 1, Константа.ОснСклад);

ЗакладкиОтбора

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

Синтаксис:

ЗакладкиОтбора(<ИмяОтбора>, <ВИнтервалеЖурнала>, <УстановитьНаЗначение>,

                            <ЗначениеОтбора>)

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

TabCtrlSelection

Параметры:

<ИмяОтбора>	Строковое выражение: имя отбора.
<ВИнтервалеЖурнала>	исловое выражение: признак отбора только в интервале журнала. Может принимать зна­чения: 1 — текущие значения отбора для закладок выбираются только по проводкам в установ­ленном интервале журнала; 0 — текущие значения отбора для закладок выбираются по всем проводкам журнала. По умолчанию — 0.
<УстановитьНаЗначение>	Числовое выражение: признак выбора зна­чения отбора для показа. Параметр может принимать значения: 1 — для показа выбирается отбор по значе­нию, указанному в параметре <ЗначениеОтбора>; 0 — текущее значение отображаемой заклад­ки отбора устанавливается на первое суще­ствующее значение. По умолчанию — 0.
<ЗначениеОтбора>	Значение отбора.

Описание:

Метод ЗакладкиОтбора устанавливает в форме журнала операций заклад­ки для интерактивного осуществления отбора. При включении закладок в верхней части журнала появляются ярлыки, соответствующие значениям отбо­ра. Щелчком мыши по ярлыку можно открыть «страницу» журнала операций: такая «страница» будет содержать операции, отобранные по указанному значе­нию.

Для включения отбора необходимо в качестве параметра <ИмяОтбора> пе­редать методу имя отбора. Можно использовать как имена отборов, автомати­чески задаваемые системой 1С:Предприятие, так и отборы, созданные в процес­се конфигурирования: по реквизитам операции и по общим реквизитам доку­ментов.

«Системные» отборы задаются включением соответствующих опций в окне редактирования свойств операции в конфигураторе. Каждому виду отбора со­ответствует «системное» имя отбора — то, которое выдается пользователю в диалоге «Отбор», и которое можно использовать во встроенном языке.

Для журнала операций допустимы следующие «системные» имена отборов:

СуммаОперации — отбор по сумме операции;

Содержание — отбор по содержанию операции.

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

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

Также в жунале операций возможен отбор по видам документов, для кото­рых установлен признак «Бухгалтерский учет». Имена этих отборов определя­ются идентификаторами видов документов.

Данный метод доступен только в контексте модуля формы журнала опера­ций (см. «Виды программных модулей»).

Пример:

ЗакладкиОтбора("Автор", 1, , );

ЗакладкиОтбора

Установить в форме журнала проводок закладки для интерактивного отбора.

Синтаксис:

ЗакладкиОтбора(<ИмяОтбора>, <ВИнтервалеЖурнала>, <УстановитьНаЗначение>,

               <ЗначениеОтбора>)

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

TabCtrlSelection

Параметры:

<ИмяОтбора>	Строковое выражение: имя отбора.
<ВИнтервалеЖурнала>	Числовое выражение: признак отбора только в интервале журнала. Может принимать зна­чения: 1 — текущие значения отбора для закладок выбираются только по проводкам в установ­ленном интервале журнала; 0 — текущие значения отбора для закладок выбираются по всем проводкам журнала. По умолчанию — 0.
<УстановитьНаЗначение>	Числовое выражение: признак выбора зна­чения отбора для показа. Параметр может принимать значения: 1 — для показа выбирается отбор по значе­нию, указанному в параметре <ЗначениеОтбора>; 0 — текущее значение отображаемой заклад­ки отбора устанавливается на первое суще­ствующее значение. По умолчанию — 0.
<ЗначениеОтбора>	Значение отбора.

Описание:

Метод ЗакладкиОтбора устанавливает в форме журнала проводок заклад­ки для интерактивного осуществления отбора. При включении закладок в верхней части журнала проводок появляются ярлыки, соответствующие значе­ниям отбора. Щелчком мыши по ярлыку можно открыть «страницу» журнала проводок: такая «страница» будет содержать проводки, отобранные по указан­ному значению.

Для включения отбора необходимо в качестве параметра <ИмяОтбора> пе­редать методу имя отбора. Можно использовать как имена отборов, автомати­чески задаваемые системой 1С:Предприятие, так и отборы, созданные в процес­се конфигурирования: по реквизитам проводки и по субконто проводки.

«Системные» отборы задаются включением соответствующих опций в окне редактирования свойств проводки в конфигураторе. Каждому виду отбора со­ответствует «системное» имя отбора — то, которое выдается пользователю в диалоге «Отбор», и которое можно использовать во встроенном языке.

Для журнала проводок допустимы следующие «системные» имена отборов:

Сумма — отбор по сумме проводки;

ВалСумма — отбор по валютной сумме проводки;

Валюта — отбор по валюте проводки;

Количество — отбор по количеству проводки;

Счет — отбор по счетам проводки;

СчетДт — отбор по счетам дебета проводки;

СчетКт — отбор по счетам кредита проводки;

ПланСчетов — отбор по плану счетов.

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

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

Пример:

ЗакладкиОтбора("Склады", 1, 1, Константа.ОснСклад);

ЗакладкиОтбора

Установить в форме журнала расчетов закладки для интерактивного осуществления отбора.

Синтаксис:

ЗакладкиОтбора(<ИмяОтбора>, <ЗначениеОтбора>)

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

TabCtrlSelection

Параметры:

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

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

Число: 1 — если операция успешно выполнена; 0 — в противном случае.

Описание:

Метод ЗакладкиОтбора устанавливает в форме журнала расчетов закладки (tab control), позволяющие быстро переключаться между разными значениями по одному и тому же отбору.

Данный метод доступен только в контексте Модуля формы журнала расче­тов (см. «Виды программных модулей»).

Пример:

// в форме журнала расчетов "зарплата" установим закладки

// по умолчанию будет использована закладка, соответств.

// текущему расчетчику

ЗакладкиОтбора("Родитель", Расчетчик);

См. также: УстановитьОтбор, ПолучитьОтбор

Закрыть

Закрыть форму.

Синтаксис:

Закрыть(<ЗапрСохр>)

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

Close

Параметры:

<ЗапрСохр>

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

Описание:

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

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

Пример:

Форма.Закрыть();

---

---