УстановитьРеквизитСправочника

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

Синтаксис:

УстановитьРеквизитСправочника(<ЭлементСправочника>, <НазваниеРеквизита>,

<3начение>, <ДатаУстановки>, <ИмяТипа>, <Длина>, <Точность>)

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

SetRefField

Параметры:

<ЭлементСправочника>

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

<НазваниеРеквизита>

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

<3начение>

Новое значение периодического реквизита.

<ДатаУстановки>

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

<ИмяТипа>

Необязательный параметр. Строковое выражение — название типа данных (или Вид субконто).

<Длина>

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

<Точность>

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

Описание:

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

Параметры <ИмяТипа>, <Длина> и <Точность> следует указывать при установке значения периодического реквизита справочника имеющего неопределенный тип.

Данный метод доступен только в контексте Модуля документа в предопределенной процедуре ОбработкаПроведения (см. Гл. «Системные предопределенные процедуры»).

Пример:

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

// является переменной типа "справочник",

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

// реквизита "Оклад" этого элемента

// справочника с привязкой к документу

Процедура ОбработкаПроведения();

// .....

Моклад = Константа.МаксимальныйОклад;

УстановитьРеквизитСправочника(Сотрудник, "Оклад", МОклад, ДатаДок);

// .....

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

УстановитьТАна

Изменить положение Точки Актуальности итогов. Данный метод используется только при наличии компоненты «Оперативный учет». Данный метод используется только в монопольном режиме доступа.

Синтаксис:

УстановитьТАна(<ПоложениеТА>]

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

SetAPToBeg

Параметры:

<ПоложениеТА>

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

Описание:

Метод УстановитьТАна изменяет положение Точки Актуальности итогов на начало даты или документа <ПоложениеТА>. Данный метод используется только в монопольном режиме доступа.

Пример:

УстановитьТАна(ВыбДокумент);

УстановитьТАпо

Синтаксис:

УстановитьТАпо(<ПоложениеТА>)

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

SetAPToEnd

Параметры:

<ПоложениеТА>

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

Описание:

Метод УстановитьТАпо изменяет положение Точки Актуальности итогов на конец даты или документа <ПоложениеТА>. Данный метод используется только в монопольном режиме доступа.

Пример:

УстановитьТАпо(ВыбДокумент);

УстановитьТекущийПериод

Устанавливает текущий период журнала расчетов.

Синтаксис:

УстановитьТекущийПериод(<Период>, <Способ>)

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

SetCurrentPeriod

Параметры:

<Период>

Значение типа «период журнала расчетов».

<Способ>

Необязательный параметр, число: 0 — не отрабатывать системные действия, связанные со сменой периода; 1 -отработать системные процедуры по умолчанию (например, отменить рассчитанность записей при откате назад или провести архивацию документов при смене периода «вперед»). В этом режиме метод ведет себя как интерактивная смена периода но без вопросов. Значение параметра по умолчанию 1.

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

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

Описание:

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

Пример:

//Установить следующий период

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

Пер = ЖР.ТекущийПериод();

Пер = Пер.ПрибавитьПериод(1);

Сообщение("Смена периода журнала займет некоторое время...");

ЖР.УстановитьТекущийПериод(Пер);

См. также: НачалоТекущегоПериода, ПериодДействия, ПериодРегистрации, КонецПериодаПоДате

УстановитьТип

Установить тип для элемента диалога неопределенного вида.

Синтаксис:

УстановитьТип(<Выражение>)

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

AssignType

Параметры:

<Выражение>

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

Описание:

Метод УстановитьТип позволяет установить тип для элемента диалога, которому в конфигураторе назначен тип «Неопределенный».

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

Пример:

Форма.ВыбЗнач.УстановитьТип(Товар);

См. также: НазначитьТип, ТипЗначения, ТипЗначенияСтр

УстановитьТип

Установить тип для значения ячейки неопределенного вида.

Синтаксис:

УстановитьТип(<Выражение>)

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

AssignType

Параметры:

<Выражение>

Выражение. Тип значения этого выражения будет присвоен значению ячейки.

Описание:

Метод УстановитьТип позволяет установить тип для значения ячейки, которому в конфигураторе назначен тип «Неопределенный».

Пример:

ВыбОбласть.УстановитьТип(Товар);

См. также: НазначитьТип, ТипЗначения, ТипЗначенияСтр

УстановитьВремя

Установить время документа.

Синтаксис:

УстановитьВремя(<Часы>, <Минуты>, <Секунды>)

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

SetTime

Параметры:

<Часы>

Числовое выражение.

<Минуты>

Числовое выражение.

<Секунды>

Числовое выражение.

Описание:

Метод УстановитьВремя устанавливает время документа в соответствии с заданными параметрами <Часы>, <Минуты>, <Секунды>.

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

Пример:

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

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

Док.УстановитьВремя(13, 0, 0);

КонецЕсли;

См. также: ПриИзмененииВремениДокумента

УстановитьВремя

Задает время текущей операции.

Синтаксис:

УстановитьВремя(<Часы>, <Минуты>, <Секунды>)

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

SetTime

Пареметры:

<Часы>

Необязательный параметр. Число — час операции.

<Минуты>

Необязательный параметр. Число — минуты операции.

<Секунды>

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

Описание:

Метод УстановитьВремя изменяет время операции.

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

Пример:

Перем Час;

Перем Минута;

Перем Секунда;

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

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

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

Опер.ПолучитьВремя(Час, Минута, Секунда);

Опер.УстановитьВремя(Час + 1, Минута, Секунда);

КонецЦикла;

УстановитьЗначение

Установить значение в указанной позиции списка.

Синтаксис:

УстановитьЗначение(<Позиция>, <Знач>, <Строка>, <Колич>)

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

SetValue

Параметры:

<Позиция>

Числовое выражение — номер позиции в списке, начиная с которого будут установлены новые значения, т. е. «старые» будут заменены. Номер позиции может быть от 1 до РазмерСписка+1.

<Знач>

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

<Строка>

Необязательный параметр. Строковое выражение, содержащее задаваемое символьное представление добавляемого значения. По умолчанию принимает стандартное в системе 1С:Предприятие символьное представление объекта.

<Колич>

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

Описание:

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

Пример:

Спис.УстановитьЗначение(1, ВидРасчета.ДоплатаПроцентом, "Процентом");

УстановитьЗначение

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

Синтаксис:

УстановитьЗначение(<Строка>, <Колонка>, <Знач>)

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

SetValue

Параметры:

<Строка>

Номер строки.

<Колонка>

Номер или идентификатор колонки.

<Знач>

Устанавливаемое значение.

Описание:

Метод УстановитьЗначение устанавливает значение конкретной колонки в данной строке таблицы значений.

Пример:

Табл.УстановитьЗначение(3, 5, ВыбЗнач);

УстановитьЗначение

Установка значения в заданной точке и серии.

Синтаксис:

УстановитьЗначение(<НомерТочки>, <НомерСерии>, <Значен>, <Расшифровка>)

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

SetValue

Параметры:

<НомерТочки>

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

<НомерСерии>

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

<3начен>

Числовое значение — задаваемое значение диаграммы.

<Расшифровка>

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

Описание:

Метод УстановитьЗначение устанавливает значение серии <НомерСерии> в точке <НомерТочки> равным <Значен> с возможностью его последующей расшифровки.

Расшифровка может быть реализована при помощи предопределенной процедуры ОбработкаЯчейкиТаблицы. Вызов предопределенной процедуры ОбработкаЯчейкиТаблицы на исполнение производится в системе 1С:Предприятие по двойному щелчку мыши в табличном документе на выбранной точке диаграммы. При этом значение расшифровки <Расшифровка> этой точки диаграммы автоматически передается в качестве первого параметра в вызове предопределенной процедуры.

Пример:

Диаграмма.УстановитьЗначение(1, 5, 14);

См. также: ОбработкаЯчейкиТаблицы

УстановитьЗначениеФильтра

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

Синтаксис:

УстановитьЗначениеФильтра(<ИзмерИлиРеквизит>, <3начен>, <Вариант>)

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

SetFilterValue

Параметры:

<ИзмерИлиРеквизит>

Идентификатор измерения или реквизита.

<3начен>

Значение или список значений.

<Вариант>

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

Для варианта «2»:

- если параметр <3начен> — это группа справочника, то осуществляется проверка вхождения в группу;

- если параметр <3начен> — это простой элемент справочника или другой тип значения, то осуществляется просто фильтрация по значению;

- для списка значений осуществляется проверка вхождения в список;

- если пустое значение или пустой список значений, то условие не проверяется.

Описание:

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

Пример:

* Для регистра с измерениями «Товар», «Склад», «МОЛ» запись

Рег.УстановитьЗначениеФильтра("Товар", ВыбГруппаТоваров, 2);

означает, что расчеты будут проводиться по товарам из группы ВыбГруппаТоваров.

УстановитьЗначениеПоля

Установить значение поля.

Синтаксис:

УстановитьЗначениеПоля(<НазваниеПоля>, <Значение>)

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

SetFieldValue

Параметры:

<НазваниеПоля>

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

<Значение>

Значение поля.

Описание:

Метод УстановитьЗначениеПоля позволяет установить новое значение атрибута объекта, соответствующего полю текущей записи. Для записи изменений в базу данных необходимо инициировать запись (см. «Назначение агрегатного типа данных Xbase»). Метод позволяет работать с базами данных неизвестной заранее структуры.

Пример:

ДБФ.УстановитьЗначениеПоля(НаименованиеПоля, 1234);

УстановитьЗначениеВПодборе

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

Синтаксис:

УстановитьЗначениеВПодборе(<ИмяРеквизита>, <Значение>)

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

SetValueInPermanentChoice

Параметры:

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

Строковое выражение, содержащее имя реквизита формы подбора значения.

<Значение>

Выражение, значение которого заносится в реквизит.

Описание:

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

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

Пример:

Процедура Подбор()

ГруппаДляВыбора = ТекуцийЭлемент();

Если ГруппаДляВыбора.ЭтоГруппа() = 0 Тогда

ГруппаДляВыбора = ГруппаДляВыбора.Родитель;

КонецЕсли;

ОткрытьПодбор("Справочник.Товары", "ДляПодбора", КонтПодб);

// установим в форме подбора реквизит "ГруппаВыбора"

// используя метод УстановитьЗначениеВПодборе

УстановитьЗначениеВПодборе("ГруппаВыбора", ГруппаДляВыбора);

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

См. также: ОткрытьПодбор, ОбработкаПодбора

УстТекКаталог

Устанавливает текущий каталог файлов.

Синтаксис:

УстТекКаталог(<ИмяКат>)

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

GetCurrentDirectory

Параметры:

<ИмяКат>

Строковое выражение с именем текущего каталога файлов.

Описание:

Метод УстТекКаталог устанавливает текущий каталог файлов.

Пример:

* В данном примере приведена процедура установки текущего каталога файлов

Процедура УстТекДир()

ФС.УстТекКаталог(ИмяВыбрДир);

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

См. также: ТекКаталог

Валюта

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

Синтаксис:

Валюта

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

Currency

Значение:

Значение типа «Справочник», вид которого определен в настройке валютного учета в конфигурации.

Описание:

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

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

Пример:

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

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

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

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

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

КонецЦикла;

Валюта

Валюта, по которой извлекаются результаты запроса.

Синтаксис:

Валюта

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

Currency

Описание:

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

Пример:

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

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

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

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

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

Сообщить(БухИтоги.Счет.Код + "/" + БухИтоги.Валюта + " ДО == " +

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

КонецЦикла;

Валютный

Признак ведения валютного учета.

Синтаксис:

Валютный

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

IsCurrency

Значение:

1 — валютный учет ведется по данному счету;

0 — валютный учет не ведется по данному счету;

Описание:

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

Пример:

Сч.Валютный = 1;

ВалСумма

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

Синтаксис:

ВалСумма

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

CurSum

Значение:

Значение типа «Число».

Описание:

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

Пример:

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

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

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

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

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

КонецЦикла;

ВертикальноеПоложение

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

Синтаксис:

ВертикальноеПоложение(<Положение>)

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

VerticalAlign

Параметры:

<Положение>

Необязательный параметр. Число: 1 — сверху; 2 — снизу; 3 — по центру. Если параметр опущен, то признак вертикального выравнивания текста области не изменяется.

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

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

Описание:

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

Пример:

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

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

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

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

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

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

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

ВходитВГруппу

Определяет входимость вида расчетов в группу видов расчета.

Синтаксис:

ВходитВГруппу(<Группа>)

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

BelongsToGroup

Параметры:

<Группа>

Группа расчетов, входимость в которую проверяется.

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

Число: 1 — если вид расчета входит в группу <Группа>; 0 в противном случае.

Описание:

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

Пример:

// В журнале расчетов зарплаты посчитаем все начисления

// для текущего сотрудника

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

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

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

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

Группа = Группа.ВсеНачисления;

Всего = 0;

ЖР.ВыбратьЗаписиПоОбъекту(Объект, НТП, КТП);

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

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

Всего = Всего + ЖР.Результат;

КонецЕсли;

КонецЦикла;

// ...

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

Если ЖрнЗарплата.ВидРасч = ВидРасчета.РайонныйКоэФйициент Тогда

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

КонецЕсли;

Если ЖрнЗарплата.ВидРасч = ВидРасчета.СевернаяНадбавка Тогда

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

КонецЕсли;

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

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

Если ТипРасчета = 1 Тогда

Дней = Дней + КалендОтп.Дней(ЖрнЗарплата.ДатаНачала,

ЖрнЗарплата.ДатаОкончания);

Иначе

Дней = Дней + ЖрнЗарплата.Дни;

КонецЕсли;

КонецЦикла;

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

Вид

Определить вид справочника.

Синтаксис:

Вид(<Название>)

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

Kind

Параметры:

<Название>

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

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

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

Описание:

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

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

Пример:

// отобразим вид справочника в строке состояния

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

Состояние(Cnpl.Вид());

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

Состояние(Спр2.Вид());

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

СпрЗ.Вид("Валюты");

Состояние(СпрЗ.Вид());

Вид

Определить название вида перечисления.

Синтаксис:

Вид()

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

Kind

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

Строковое значение, содержащее название вида перечисления.

Описание:

Метод Вид позволяет определить название вида перечисления, как оно задано в конфигураторе.

Пример:

// отобразим вид перечисления в строке состояния

Состояние(ИзмерениеТовара.Вид());

Вид

Название вида документа.

Синтаксис:

Вид()

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

Kind

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

Строковое значение, содержащее название вида документа, как он задан в конфи гураторе.

Описание:

Метод Вид возвращает название вида документа, как он задан в конфигураторе.

Пример:

Если (Док.Вид() = "ДоплатаПроцентом") ИЛИ (Док.Вид() = "ДоплатаСуммой") Тогда

Сотр = Док.Сотрудник;

Иначе

Предупреждение("Это не доплата!");

КонецЕсли;

Вид

Определить название вида регистра.

Синтаксис:

Вид()

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

Kind

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

Строковое значение, содержащее название вида регистра.

Описание:

Метод Вид позволяет определить название вида регистра, как он задан ь конфигураторе.

Пример:

// отобразим вид регистра в строке состояния

Состояние(Рег1.Вид());

Вид

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

Синтаксис:

Вид()

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

Kind

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

Символьная строка — идентификатор плана счетов, к которому относится данный счет.

Описание:

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

Пример:

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

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

Сообщить("Вид - " + Сч.Вид());

Вид

Название журнала расчетов.

Синтаксис:

Вид()

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

Kind

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

Строка — название журнала расчетов, как оно задано при конфигурировании.

Описание:

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

Пример:

Процедура ПриСменеРасчетногоПериода(ЖР, Период)

Если ЖР.Вид() = "Зарплата" Тогда

Предупреждение("Это смена текущего расчетного периода

| для журнала Зарплата");

КонецЕсли;

Если Период.ДатаНачала <= ЖР.НачалоТекущегоПериода Тогда

// не позволяем откатывать период назад

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

КонецЕсли;

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

Видимость

Установка режима отображения.

Синтаксис:

Видимость(<Режим>)

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

Visible

Параметры:

<Режим>

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

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

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

Описание:

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

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

Пример:

Форма.ИнформПоле.Видимость(0);

ВидимостьКолонки

Показать/скрыть колонки таблицы значений.

Синтаксис:

ВидимостьКолонки(<Колонки>, <Видимость>, <Позиция>)

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

ColumnVisibility

Параметры:

<Колонки>

Строковое выражение, которое определяет список колонок. Формат передаваемой строки — это разделенные запятыми номера или идентификаторы колонок, для которых применяется данный метод. Например: «Код, Цена, 8, 5».

<Видимость>

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

<Пoзиция>

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

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

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

Описание:

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

Пример:

ТаблДиалога.ВидимостьКолонки("Код, Цена, 8, 5");

ВидРасч

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

Синтаксис:

ВидРасч

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

CalculKind

Описание:

Атрибут типа «ВидРасчета». Ссылка на конкретный вид расчета, алгоритм которого будет использован при вычислении результата данной записи журнала расчетов (акта расчета).

Атрибут ВидРасч предназначен только для чтения.

Пример:

// Перечисление в банк

Процедура ПровестиРасчет()

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

// посчитаем сумму на руки

НаРуки = 0;

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

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

// если строка журнала расчетов имеет вид расчета,

// входящий в группу "Все начисления"

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

НаРуки = НаРуки + ЖР.Результат;

// ...или "Все удержания"

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

НаРуки = НаРуки - ЖР.Результат;

КонецЕсли;

КонецЦикла;

Если Документ.Сумма <> 0 Тогда

Результат = Окр(Мин(Документ.Сумма, НаРуки));

ИначеЕсли Документ.Процент <> 0 Тогда

НаРуки = 0;

Результат = Окр(НаРуки * Процент / 100);

КонецЕсли;

Если Документ.Банк.Выбран() Тогда

ПроцентУд = Документ.Банк.ПроцентУдержания;

Иначе

Сообщение("Не указан банк для перечисления средств!");

Возврат;

КонецЕсли;

ЖР.ВвестиРасчет(Объект, ВидРасчета.БанковскиеИздержки,

ДатаНачала, ДатаОкончания, Окр(Результат * ПроцентУд / 100));

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

ВидСубконто

Устанавливает/возвращает вид субконто счета.

Синтаксис:

ВидСубконто(<НомерСубконто>, <ВидСубконто>, <ТолькоОбороты>)

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

SubcontoKind

Параметры:

<НомерСубконто>

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

<ВидСубконто>

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

<ТолькоОбороты>

Необязательный параметр. Числовое значение: 1 или 0. Данный параметр снимает или устанавливает флаг «Только обороты» для данного субкон-то счета. Если параметр не используется, то флаг «Только обороты» не меняется.

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

Значение типа «Вид субконто».

Описание:

К любому счету или субсчету в плане счетов может быть «прикреплено» до 5 видов субконто. Максимальное количество видов субконто, которое можно «прикрепить» к счету, устанавливается в конфигураторе при редактировании свойств планов счетов. Количество субконто, которое реально прикреплено к счету, не превышает установленного максимального количества. Все виды субконто, прикрепленные к счету в плане счетов, имеют порядковые номера. Эти номера выдаются в названии колонок для видов субконто в окне редактирования плана счетов; «Субконто!», «Субконто2» ... «Субконто5».

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

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

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

Пример:

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

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

Для Инд = 1 По Сч.КоличествоСубконто() Цикл

Сообщить("Субконто " + Сч.ВидСубконто(Инд));

КонецЦикла;

Виды программных модулей

В системе 1С:Предприятие существуют следующие виды программных модулей (места размещения программных модулей в конфигурации задачи), доступных в конфигураторе:

Размещение

Момент запуска

Контекст выполнения

ВидыДляВыбора

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

Синтаксис:

ВидыДляВыбора(<СписокВидов>)

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

KindsForChoise

Параметры:

<СписокВидов>

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

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

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

Описание:

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

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

Пример:

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

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

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

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

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

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

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

Фрм.ВидыДляВыбора("Фирмы");

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

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

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

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

КонецЕсли;

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

См. также: Выбрать

ВидыДляВыбора

Установка выбираемых видов для объекта типа «документ» неопределенного вида.

Синтаксис:

ВидыДляВыбора(<СписокВидов>)

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

KindsForChoice

Параметры:

<СписокВидов>

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

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

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

Описание:

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

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

Пример:

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

// значение конкретного документа

Процедура УстДокОснования()

// Создадим объект типа «документ» неопределенного вида

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

Дкм.ВидыДляВыбора("РасходнаяНакл, Счет");

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

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

НаОсновании = Дкм.ТекущийЭлемент();

КонецЕсли;

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

См. также: Выбрать

ВидыОтбора

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

Синтаксис:

ВидыОтбора(<СписокИменОтборов>)

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

KindsOfSelection

Параметры:

<СписокИменОтборов>

Строка со списком (через запятую) имен тех реквизитов, отбор по которым допускается, или символ "*" — для всех видов отборов.

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

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

Описание:

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

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

Пример:

Процедура ПриОткрытии()

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

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

ВидыОтбора

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

Синтаксис:

ВидыОтбора(<СписокИменОтборов>)

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

KindsOfSelection

Параметры:

<СписокИменОтборов>

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

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

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

Описание:

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

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

Пример:

ВидыОтбора("Склад, Клиент, Автор");

ВидыОтбора

Установить доступные виды отборов для журнала операций.

Синтаксис:

ВидыОтбора(<СписокОтборов>)

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

KindsOfSelection

Параметры:

<СписокОтборов>

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

список имен отборов (через запятую) — в журнале операций будут доступны только указанные виды отборов;

символ «*» — для журнала используются все назначенные в Конфигураторе виды отборов;

пустая строка ("") — запрещаются все виды отборов.

Если параметр не указан, метод возвращает текущий список разрешенных отборов.

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

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

Описание:

Метод ВидыОтбора устанавливает доступные виды отборов журнала операций. Использование данного метода влияет на полноту списка видов отбора, который выдается пользователю в диалоге «Отбор» при работе с системой 1С:Предприятие.

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

Можно выделить 4 варианта использования данного метода.

1. Если параметр <СписокОтборов> не указан, метод возвращает текущий список отборов, установленных для журнала операций.

2. Чтобы ограничить использование отборов какими-либо конкретными видами отбора, список этих видов отбора следует передать методу в качестве параметра. Указывать в списке можно как имена отборов, автоматически задаваемые системой 1С:Предприятие, так и отборы, созданные в процессе конфигурирования: по реквизитам операции и по общим реквизитам документов.

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

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

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

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

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

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

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

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

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

Замечание. Ограничение списка отборов, выполненное при помощи метода ВидыОтбора, не исключает использование «запрещенного» отбора средствами встроенного языка. Например, методом ВидыОтбора("") можно запретить использование любых отборов в журнале операций, но тутже из языка установить отбор операций по конкретному содержанию операции. В этом случае пользователь будет просматривать операции с конкретным содержанием, но не будет иметь возможность отобрать операции с другим содержанием.

Пример:

ВидыОтбора("Клиент, Автор");

ВидыОтбора

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

Синтаксис:

ВидыОтбора(<СписокОтборов>)

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

KindsOfSelection

Параметры:

<СписокОтборов>

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

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

символ «*» — для журнала используются все назначенные в Конфигураторе виды отборов;

пустая строка "" — запрещаются все виды отборов.

Если параметр не указан, метод возвращает текущий список разрешенных отборов.

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

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

Описание:

Метод ВидыОтбора устанавливает доступные виды отборов журнала проводок. Использование данного метода влияет на полноту списка видов отбора, который выдается пользователю в диалоге «Отбор» при работе с системой 1С:Предприятие.

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

Можно выделить 4 варианта использования данного метода.

1. Если параметр <СписокОтборов> не указан, метод возвращает текущий список отборов, установленных для журнала проводок.

2. Чтобы ограничить использование отборов какими-либо конкретными видами отбора, список этих видов отбора следует передать методу в качестве параметра. Указывать в списке можно как имена отборов, автоматически задаваемые системой 1С:Предприятие, так и отборы, созданные в процессе конфигурирования: по реквизитам проводки и по субконто проводки.

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

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

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

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

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

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

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

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

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

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

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

3. Если параметр <СписокОтборов> равен «*», разрешаются все виды отборов, установленные для журнала проводок в конфигураторе. Вызов метода ВидыОтбора с таким параметром позволяет отключить ранее установленное ограничение на использование видов отборов.

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

Замечание. Ограничение списка отборов, выполненное при помощи метода ВидыОтбора, не исключает использование «запрещенного» отбора средствами встроенного языка. Например, методом ВидыОтбора("") можно запретить использование любых отборов в журнале проводок, но установить отбор проводок по конкретной организации. В этом случае пользователь будет просматривать проводки, относящиеся только к указанной организации, но не будет иметь возможность изменить организацию.

Пример:

ВидыОтбора("Склад, Клиент, Автор");

ВидыОтбора

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

Синтаксис:

ВидыОтбора(<СписокИмеяОтборов>)

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

KindsOfSelection

Параметры:

<СписокИменОтборов>

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

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

Описание:

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

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

Пример:

ВидыОтбора("Сотрудник, Расчетчик");

ВидыСубконто

Атрибут глобального контекста для получения существующих значений типа ВидСубконто.

Синтаксис:

ВидыСубконто

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

SubcontoKinds

Описание:

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

Атрибуты и методы:

Для получения конкретного значения типа «Вид субконто» следует через точку указать атрибут-идентификатор вида субконто.

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

Для получения значения типа «Вид субконто» по его номеру в метаданных следует через точку вызвать метод ЗначениеПоНомеру(<Число>), где <Число> — номер вида субконто в метаданных.

Пример:

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

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

// ...

КонецЕсли;

Для Инд = 1 По ВидыСубконто.КоличествоЗначений() Цикл

ВидСк = ВидыСубконто.ЗначениеПоНомеру(Инд);

// ...

КонецЦикла;

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

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

Синтаксис:

ВключатьПодчиненные(<Режим>]

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

IncludeChildren

Параметры:

<Режим>

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

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

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

Описание:

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

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

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

Пример:

// Это процедура формирования отчета - "Список Товаров"

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

// задается группа товаров для отображения.

//В процедуру передается параметр Режим, которым задается,

// отображать или нет вложенные подгруппы товаров выбранной группы

Процедура ВыводСпискаТоваров(Режим)

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

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

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

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

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

Заг = "По всем товарам.";

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

// если в диалоге выбрана группа товаров, то

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

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

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

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

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

      Тов.ВключатьПодчиненные(Режим);

   Иначе

      // если в диалоге выбран товар, то

      // формируем отчет только по этому товару

      Тов.НайтиЭлемент(ВыбТовар);

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

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

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

      Перейти ~MET;

   КонецЕсли;

   ЧислоСтрок = О;

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

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

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

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

      ЧислоСтрок = ЧислоСтрок + 1;

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

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

      Иначе

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

      КонецЕсли;

      Состояние("В отчет выведено " + ЧислоСтрок + " строк.");

   КонецЦикла;

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

~MET:

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

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

   Таб.Показать("Список товаров по каталогу", "");

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

См. также: ВыбратьЭлементы, ПолучитьЭлемент, СоздатьОбъект

ВключатьСубсчета

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

Синтаксис:

ВключатьСубсчета(<ФлагСчета>, <ФлагКоррСчета>}

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

IncludeSubAccounts

Параметры:

<ФлагСчета>

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

0 — не разворачить по субсчетам;

1 — разворачивать по субсчетам;

-1 (минус единица) — не выдавать итоги по счетам-группам.

Значение по умолчанию — 0.

<ФлагКоррСчета>

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

0 — не разворачить по субсчетам;

1 — разворачивать по субсчетам;

-1 (минус единица) — не выдавать итоги по корреспондирующим счетам-группам.

Значение по умолчанию — 0.

Описание:

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

Если метод не вызвался, разворот итогов по субсчетам не производится.

Пример:

БухИтоги.ВключатьСубсчета(1, 1);

ВключитьПроводки

Включает/выключает проводки операции.

Синтаксис:

ВключитьПроводки(<Флаг>)

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

EntriesOn

Пареметры:

<Флаг>

Необязательный параметр. 1 — включить проводки операции. 0 — выключить проводки операции. Если параметр не передан — состояние не изменяется.

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

Состояние на момент вызова метода. 1 — проводки операции включены; 0 — проводки операции выключениы.

Описание:

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

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

Пример:

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

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

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

Опер.ВключитьПроводки(0);

КонецЦикла;

ВКонце

Прочитать значение флага конца файла базы банных.

Синтаксис:

ВКонце()

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

EOF

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

Число: 1 — указатель в файле находится за последней записью; 0 — конец файла не достигнут.

Описание:

Метод ВКонце возвращает значение флага конца файла.

Пример:

Функция МаксимальнаяПокупка()

ДБФ.Первая();

Уплачено = 0;

Пока ДБФ.Вконце() = 0 Цикл

Если ДБФ.AMOUNT > Уплачено Тогда

Уплачено = ДБФ.AMOUNT;

КонецЕсли;

ДБФ.Следующая();

КонецЦикла;

Возврат Уплачено;

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

Владелец

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

Синтаксис:

Владелец

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

Owner

Описание:

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

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

Пример:

Функция ДатьВладельца(Элем)

// Справочник "Единицы" подчинен Справочнику "Товары"

// Получая в параметре функции значение Единицы измерения товара,

// надо выдать имя товара, для которого задана эта единица изм.

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

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

СпрЕ.НайтиЭлемент(Элем);

СпрТ.НайтиЭлемент(СпрЕ.Владелец);

Возврат "Это единица измерения товара " + СпрТ.Наименование;

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

ВНачале

Прочитать значение флага начала файла.

Синтаксис:

ВНачале()

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

BOF

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

Число: 1 — указатель в файле находится перед первой записью; 0 — начало файла не достигнуто.

Описание:

Метод ВНачале возвращает значение флага начала файла.

Пример:

Функция СреднСтоимПокупки()

ДБФ.Последняя();

Уплачено = 0;

Записей = 0;

Пока ДБФ.ВКонце() = 0 Цикл

Уплачено = Уплачено + ДБФ.AMOUNT;

Записей = Записей + 1;

ДБФ.Следующая();

КонецЦикла;

Если Записей > 0 Тогда

Уплачено = Уплачено / Записей;

КонецЕсли;

Возврат Уплачено;

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

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

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

Синтаксис:

ВНачалоВыборки()

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

ToSelectionBegin

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

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

Описание:

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

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

Пример:

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

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

| ...

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

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

| ...

|";

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

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

Возврат;

КонецЕсли;

Если Запрос.Получить(ВыбДолжн, ВыбКатег) = 0 Тогда

Если Запрос.Получить(ВыбДолжн, ) = 0 Тогда

// ...

КонецЕсли;

Запрос.ВНачалоВыборки();

Пока Запрос.Группировка(1, -1) цикл

// ...

Конеццикла;

Внешние переменные

Внешние переменные — это переменные из области видимости процедуры или функции программного модуля, в теле которого используется данный запрос. Внешние переменные в тексте описания запроса могут использоваться в операторах Период С и Условие.

Пример:

Перем ДатаНач, ДатаКон;

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

Если (Число(ДатаНач) = 0) ИЛИ (Число(ДатаКон) = 0) Тогда

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

Возврат;

КонецЕсли;

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

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

ТекстЗапроса =

"//{{ЗАПРОС(Сформировать)

| // используем внешние переменные ДатаНач и ДатаКон

|с ДатаНач по ДатаКон;

|Рез = ЖурналРасчетов.Зарплата.Результат;

|Сотр = ЖурналРасчетов.Зарплата.Объект;

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

|Группировка ПериодЖурнала;

|Функция Сум = Сумма(Рез);

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

;

// используем внешнюю переменную ВыбСотр

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

// используем в запросе внешнюю переменную ВыбСотр

ТекстЗапроса = ТекстЗапроса + "Условие(Сотр = ВыбСотр);";

КонецЕсли;

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

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

Возврат;

КонецЕсли;

...

КонецПроцедуры // ВыбСотр — это реквизит диалога

Внутренние переменные

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

Пример:

// имена внутренних переменных в описании запроса

_43842 // ОК

НачалоПериода // ОК

712piece // Ошибка: начинается с цифры

Week // Ошибка: ключевое слово зарезервировано

// применение имен внутренних переменных описания запроса

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

// выборки функцией Группировка

Сотр = НовЗапрос.Сотр;

Кат = НовЗапрос.Кат;

ИТОГ = НовЗапрос.Итого;