1С Предприятие 8.0. Описание встроенного языка
         

Возникает при нажатии на надпись,


Нажатие (Click)
Синтаксис:
Нажатие()
Описание:
Возникает при нажатии на надпись, если у надписи свойство Ссылка имеет значение Истина.
См. также:
Надпись, свойство Гиперссылка.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Возникает при изменении положения


ПриИзменении (OnChange)
Синтаксис:
ПриИзменении()
Описание:
Возникает при изменении положения переключателя.
Примечание:
Событие всегда связано с первым в группе элементом.



«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

с одной закладки на


ПриСменеСтраницы (OnPageChanged)
Синтаксис:
ПриСменеСтраницы (< Текущая страница> )
Параметры:
<Текущая страница>
Тип: Число. Страница, на которую переключена панель.
Описание:
Возникает при переключении с одной закладки на другую.

Событие возникает


ПриИзменении (OnChange)
Синтаксис:
ПриИзменении()
Описание:
Событие возникает после изменения значения поля ввода, то есть при переходе на другой элемент управления, если значение текста было изменено; после отработки выбора из списка выбора, после отработки выбора из календаря, калькулятора и других модаль­ных выборов, кроме программного назначения; после отработки автоматического приема немодального выбора (например, из спи­ска справочника).
НачалоВыбора (BeginChoice)
Синтаксис:
НачалоВыбора(<Стандартная обработка>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Событие возникает в момент нажатия кнопки выбора или клави­ши F4.
НачалоВыбораИзСписка (BeginListChoice)
Синтаксис:
НачалоВыбораИзСписка(<Стандартная обработка>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Событие возникает в момент нажатия кнопки выбора из списка.
Очистка (Clear)
Синтаксис:
Очистка(<Стандартная обработка>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Событие возникает в момент нажатия кнопки очистки.
Регулирование (Regulation)
Синтаксис:
Регулирование(<Направление>, <Стандартная обработка>)
Параметры:
<Направление>
Тип: Число. Позволяет определить, какая из кнопок регулирова­ния была нажата. При нажатии на увеличение (вверх) параметр равен 1, при нажатии на уменьшение (вниз) - равен -1.


<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Событие возникает в момент нажатия одной из кнопок регулиро­вания.
Открытие (Open)
Синтаксис:
Открытие(<Стандартная обработка>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет. Отказ от стандартной обработки не отменяет событие.
Описание:
Событие возникает в момент нажатия кнопки открытия.
ОбработкаВыбора (ProcessSelection)
Синтаксис:
ОбработкаВыбора(<Выбранное значение>, <Стандартная обработка>)
Параметры:
<Выбранное значение>
Тип Произвольный.
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет. Фактически это означает, что выбор произведен не будет.
Описание:
Событие возникает после выполнения выбора при: обработке вы­бора из списка выбора; обработке выбора из всех модальных диа­логов выбора (например, календаря, калькулятора); обработке немодального выбора (например, из списка справочника).

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Возникает при изменении значения поля


ПриИзменении (OnChange)
Синтаксис:
ПриИзменении()
Описание:
Возникает при изменении значения поля выбора. В обработчике события нельзя отказаться от изменений, но можно выполнить необходимые действия при изменении значения поля.
Примечание:
Данное событие следует после событий изменения значения поля: ОбработкаВыбора, Очистка, Регулирование.
НачалоВыбора (BeginChoice)
Синтаксис:
НачалоВыбора(<Стандартная обработка>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Возникает при нажатии кнопки выбора или клавиши F4.
НачалоВыбораИзСписка (Begin ListChoice)
Синтаксис:
НачалоВыбораИзСписка (<Стандартная обработка> )
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Возникает при нажатии кнопки выбора из списка.
Очистка (Clear)
Синтаксис:
Очистка(<Стандартная обработка>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Возникает в момент нажатия кнопки очистки.
Регулирование (Regulation)
Синтаксис:
Регулирование(< Направление> , Стандартная обработка>)
Параметры:
<Направление>
Тип: Число. Направление регулирования. При нажатии на уве­личение (стрелка вверх) равен 1, при нажатии на уменьшение (стрелка вниз) равен -1.
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.


Описание:
Возникает при нажатии на кнопки регулирования.
Открытие (Open)
Синтаксис:
Открытие(<Стандартная обработка>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Возникает при нажатии на кнопку открытия. В обработчике дан­ного события можнэ провести открытие выбранного значения.
ОбработкаВыбора (ProcessSelection)
Синтаксис:
ОбработкаВыбора(< Выбранное значение> , <Стандартная обработка>)
Параметры:
<Выбранное значение>
Тип: Произвольный. Выбранное значение.
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Вызывается после осуществления выбора значения из списка вы­бора, но до помещения выбранного значения в элемент управле­ния. В процедуре-обработчике события можно отказаться от вы­бора.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

В момент возникновения этого события


ПриИзменении (OnChange)
Синтаксис:
ПриИзменении()
Описание:
Возникает после интерактивного перемещения "движка" полосы регулирования. В момент возникновения этого события значение элемента управления соответствует новому положению "движка".

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Признак отказа от записи объекта.


ПередЗаписью ( BeforeWrite )
Синтаксис:
ПередЗаписью(< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от записи объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись объекта выполнена не будет.
Описание:
Событие возникает перед выполнением записи. Процедура-обработчик вызывается перед началом транзакции записи.
ПриЗаписи ( OnWrite )
Синтаксис:
ПриЗаписи(< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от записи объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись объекта выполнена не будет.
Описание:
Событие возникает при записи. Процедура-обработчик вызывает­ся после записи, но до окончания транзакции.
ПослеЗаписи ( AfterWrite )
Синтаксис:
ПослеЗаписи()
Описание:
Событие возникает после окончания транзакции записи.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Признак изменения пометки удаления документа.


ПередУстановкойПометкиУдаления ( BeforeSetDeletingMark )

Синтаксис:
ПередУстановкойПометкиУдаления (<Отказ>)
Параметры;
<Отказ>
Тип: Булево. Признак изменения пометки удаления документа. Если в теле процедуры-обработчика установить данному пара­метру значение Истина, то пометка удаления изменена не будет.
Описание:
Событие возникает перед установкой пометки удаления в списке документов.
ПередПроведением ( BeforePosting )
Синтаксис:
ПередПроведением(<Отказ>)
Параметры:
<Отказ>
Тип: Булево. Признак проведения документа. Если в теле про­цедуры-обработчика установить данному параметру значение Истина, то проведение документа выполнено не будет.
Описание:
Событие возникает перед интерактивным проведением документа в списке.
ПередОтменойПроведения ( BeforeUnposting )
Синтаксис:
ПередОтменойПроведения (< Отказ>)
Параметры:
<Отказ>
Признак отмены проведения документа. Если в теле процедуры-обработчика установить данному параметру значение Истина, то отмена проведения документа выполнена не будет.
Описание:
Событие возникает перед интерактивной отменой проведения документа в списке.
ПередИзменениемДаты(ВеТогеРа1еСЬапде)

Синтаксис:
ПередИзменениемДаты (< Отказ>)
Параметры:
<Отказ>
Признак изменения даты и времени документа. Если в теле про­цедуры-обработчика установить данному параметру значение Истина, то изменение даты документа выполнено не будет.
Описание:
Событие возникает перед изменением даты документа при ис­пользовании интерактивной команды смены времени.

Признак изменения пометки удаления документа.


ПередУстановкойПометкиУдаления ( BeforeSetDeletingMark )
Синтаксис:
ПередУстановкойПометкиУдаления (< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак изменения пометки удаления документа. Если в теле процедуры-обработчика установить данному пара­метру значение Истина, то пометка удаления изменена не будет.
Описание:
Событие возникает перед установкой пометки удаления в списке
документов.
ПередПроведением ( BeforePosting )

Синтаксис:
ПередПроведением (< Отказ> )
Параметры:
<0тказ>
Тип: Булево. Признак проведения документа. Если в теле про­цедуры-обработчика установить данному параметру значение Истина, то проведение документа выполнено не будет.
Описание:
Событие возникает перед интерактивным проведением документа в списке.
ПередОтменойПроведения ( BeforeUnposting )

Синтаксис:
ПередОтменойПроведения (< Отказ>)
Параметры:
<0тказ>
Тип: Булево Признак отмены проведения документа. Если в теле процедуры-обработчика установить данному параметру зна­чение Истина, то отмена проведения документа выполнена не будет.
Описание:
Событие возникает перед интерактивной отменой проведения документа в списке.
ПередИзменениемДаты ( BeforeDateChange )

Синтаксис:
ПередИзменениемДаты (< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак изменения даты и времени документа. Если в теле процедуры-обработчика установить данному пара­метру значение Истина, то изменение даты документа выполне­но не будет.
Описание:
Событие возникает перед изменением даты документа при ис­пользовании интерактивной команды смены времени.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Возникает при нажатии на поле


Нажатие (Click)
Синтаксис:
Нажатие()
Описание:
Возникает при нажатии на поле картинки, если у него свойство Ссылка имеет значение Истина.
См. также:
ПолеКартинки, свойство Ссылка.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Возникает при выборе строки из


Выбор (Select)
Синтаксис:
Выбор(<Текущий элемент>)
Параметры:
<Текущий элемент>
Тип: ЭлементСпискаЗначений. Выбранный элемент списка.
Описание:
Возникает при выборе строки из поля списка.
ПриАктивизацииСтроки
Синтаксис:
ПриАктивизацииСтроки()
Описание:
Возникает при смене текущей строки поля списка.
ПриИзмененииПометки
Синтаксис:
ПриИзмененииПометки()
Описание:
Возникает при изменении пометки строки поля списка.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Выбранная строка табличного поля. Тип


Выбор (Select)
Синтаксис:
Выбор(<Выбранная строка> , <Колонка>, <Стандартная обработка>)
Параметры:
<Выбранная строка>
Выбранная строка табличного поля. Тип значения строки таблич­ного поля приведен в описаниях расширений табличного поля у соответствующий объектов
<Колонка>
Тип Колонка табличного поля. Выбранная колонка таб­личного поля
<Стандартная обработка>
Тип: Булево В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Возникает при двойном щелчке мыши (нажатии клавиши Enter) на ячейке табличного поля
ПриАктивизацииСтроки (OnActivateLine)
Синтаксис:
ПриАктивизацииСтроки()
Описание:
Возникает при активизации строки табличного поля.
См. также:
ТабличноеПоле, событие ПриАктивизацииКолонки.

ТабличноеПоле, событие ПриАктивизацииЯчейки.
ПриАктивизацииКолонки (OnActivateColumn)
Синтаксис:
ПриАктивизацииКолонки()
Описание:
Возникает при активизации колонки табличного поля.
См. также:
ТабличноеПоле, событие ПриАктивизацииСтроки.

ТабличноеПоле, событие ПриАктивизацииЯчейки.
ПриАктивизацииЯчейки (OnActivateCell)
Синтаксис:
ПриАктивизацииЯчейки()
Описание:
Возникает при активизации ячейки табличного поля.
Примечание:
Ячейка активизируется при изменении текущей строки и/или колонки. Последовательность возникновения событий: АктивизацияСтроки,
АктивизацияКолонки, АктивизацияЯчейки.
См. также:
ТабличноеПоле, событие ПриАктивизацииСтроки.

ТабличноеПоле, событие ПриАктивизацииКолонки.
ПередНачаломДобавления (BeforeAddLine)
Синтаксис:
ПередНачаломДобавления (<Отказ>, <Копирование>}
Параметры:
<Отказ>
Тип: Булево. Отказ от добавления строки. Если в теле процеду­ры-обработчика установить данному параметру значение Исти­на, строка не будет добавлена.
<Копирование>
Тип: Булево. Признак добавления строки копированием. Если происходит копирование, то значение параметра Истина.


Описание:
Возникает перед началом интерактивного добавления строки.
ПередНачаломИзменения (BeforeChangeLine)
Синтаксис:
ПередНачаломИзменения(<Отказ>)
Параметры:
<Отказ>
Тип Булево. Отказ от изменения. Если в теле процедуры-обработчика установить данному параметру значение Истина, интерактивное изменение строки не начнется.
Описание:
Возникает перед началом интерактивного изменения строки таб­личного поля.
ПередУдалением (BeforeDeleteLine)
Синтаксис:
ПередУдалением (<Отказ>)
Параметры:
<Отказ>
Тип Булево. Отказ от удаления Если в теле процедуры-обработчика установить данному параметру значение Истина, удаление строки табличного поля не будет выполнено
Описание:
Возникает перед удалением строки или группы строк табличного поля
ПриНачалеРедактирования (OnStartEdit)
Синтаксис:
ПриНачалеРедактирования(<Новая строка>)
Параметры:
<Новая строка>
Тип Булево. Признак редактирования новой строки Имеет зна­чение Истина, если строка была добавлена или скопирована.
Описание:
Возникает при начале редактирования старой или добавленной строки табличного поля. В процедуре - обработчике события нельзя отказаться от редактирования, но могут быть выполнены действия, необходимые при вводе новой строки, например уста­новка начальных значений.
Примечание:
Событие возникает, если редактирование производится непосред­ственно в табличном поле. Перед данным событием возникает событие ПрередНачаломИзменения.
См. также:
ТабличноеПоле, событие ПередНачаломИзменения.
ПриОкончанииРедактирования (OnFinishEdit)
Синтаксис:
ПриОкончанииРедактирования (< Новая строка> )
Параметры:
<Новая строка>
Тип: Булево. Признак редактирования новой строки. Имеет зна­чение Истина, если строка была добавлена или скопирована.
Описание:
Возникает после окончания редактирования строки табличного поля.
Примечание:
Событие возникает, если редактирование производится непосред­ственно в табличном поле.
См. также:


ТабличноеПоле, событие ПриНачалеРедактирования.
ПриСменеТекущегоРодителя (OnCurrentParentChanging)
Синтаксис:
ПриСменеТекущегоРодителя()
Описание:
Возникает при изменении текущего родителя в режиме иерархи­ческого списка.
См. также:
ТабличноеПоле, свойство ТекущийРодитель.
ПриВыводеСтроки (OnOutputLine)
Синтаксис:
ПриВыводеСтроки(<Оформление строки> , <Данные строки>)
Параметры:
<Оформление строки>
Тип: ОформлениеСтроки. Объект, содержащий оформление строки (шрифт, цвет) и коллекцию оформлений ячеек.
<Данные строки>
Данные выводимой строки. Параметр соответствует свойству ТекущиеДанные для выводимой строки.
Описание:
Возникает при выводе строки в табличном поле. В процедуре -обработчике события допускается изменение оформления как строки в целом, так и каждой ячейки в отдельности.
ВыборЗначения (ChooseValue)
Синтаксис:
Выбор3начения(<Стандартная обработка>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Возникает при двойном щелчке мыши (нажатии клавиши Enter) на ячейке табличного поля, а также при выборе строки в таблич­ном поле посредством команды "Выбрать значение" по кнопке или кнопке командного интерфейса.
Примечание:
При двойном щелчке мыши (нажатии клавиши Enter) на ячейке табличного документа данное событие следует после события Выбор. При этом если в обработчике события Выбор устано­вить параметру Стандартная обработка значение Ложь, то событие ПриВыбореЗначения не возникнет.
См. также:
ТабличноеПоле, событие Выбор.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

тип параметра соответствует типу элемента


<Имя события>
Синтаксис:
<Имя события>(<Элемент>, <...>)
Параметры:
<Элемент>
Тип: тип параметра соответствует типу элемента управления, ко­торый инициировал событие. В данный параметр передается эле­мент управления, инициировавший событие.
<...>
Остальные параметры события элементов управления указывают­ся после параметра <Элемент>.
Описание:
У всех событий элементов управления расположенных в таблич­ном поле присутствует общий первый параметр.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

В данный параметр передается признак


Выбор (Select)
Синтаксис:
Выбор(<Область>, <Стандартная обработка> )
Параметры:
<Область> (необязательный)
Тип: ОбластьЯчеекТабличногоДокумента. Область, с которой связано событие.
<Стандартная обработка>     (необязательный)
Тип: Булево. В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Возникает при двойном щелчке мыши (нажатии клавиши Enter) на ячейке или рисунке таблицы.
ОбработкаРасшифровки (ProcessDetails)
Синтаксис:
ОбработкаРасшифровки(<Расшифровка>, <Стандартная обработка>)
Параметры:
<Расшифровка>     (необязательный)
Тип: Произвольный. Значение расшифровки ячейки или рисунка.
<Стандартная обработка>     (необязательный)
Тип: Булево. В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная обработка события производиться не будет.
Описание:
Возникает при двойном щелчке мыши (нажатии клавиши Enter) на ячейке или рисунке, которые содержат значение расшифровки.

тип параметра соответствует типу элемента


<Имя события>
Синтаксис:
<Имя события>(<Элемент>, <...>)
Параметры:
<Элемент>
Тип. тип параметра соответствует типу элемента управления, ко­торый инициировал событие. В данный параметр передается эле­мент управления, инициировавший событие.
<...>
Остальные параметры события элементов управления указывают­ся после параметра <Элемент>
Описание:
У всех событий элементов управления расположенных в поле табличного документа присутствует общий первый параметр.

Возникает при


ПриИзменении (OnChange)
Синтаксис:
ПриИзменении()
Описание:
Возникает при установке/снятии флажка.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

В данный параметр передается признак


ПриУстановкеНовогоКода
Синтаксис:
ПриУстановкеНовогоКода(<Стандартная обработка> , <Префикс>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь стандартная генерация нового кода производиться не бу­дет.
<Префикс>
Тип: Строка. Префикс, который будет использоваться для гене­рации кода. Может быть изменен в процедуре-обработчике собы­тия.
Описание:
Событие возникает в момент, когда выполняется установка ново­го кода элемента справочника.
ПриКопировании (ОпСору)
Синтаксис:
ПриКопировании (< Объект копирования>)
Параметры:
<0бъект копирования>
Тип: СправочникОбъект. <Имя справочника>. Исходный элемент, который является источником копирования.
Описание:
Событие возникает при создании элемента справочника копиро­ванием.
ОбработкаЗаполнения ( ProcessFHIing )
Синтаксис:
ОбработкаЗаполнения (< Основание>)
Параметры:
<0снование>
Тип: Произвольный. Значение, которое используется как основание для заполнения.
Описание:
Событие возникает при вводе элемента справочника на основа­нии, а также при выполнении метода Заполнить. В процедуре- обработчике этого события должен быть описан сам алгоритм заполнения реквизитов элемента справочника на основании пере­данного значения.
ПередЗаписью ( BeforeWrite )
Синтаксис:
ПередЗаписью (< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от записи элемента. Если в теле процедуры-обработчика установить данному параметру значение Истина, запись элемента выполнена не будет.
Описание:
Событие возникает перед выполнением записи элемента справоч­ника. Процедура-обработчик вызывается после начала транзакции записи, но до начала записи элемента справочника.
ПриЗаписи ( OnWrite )
Синтаксис:
ПриЗаписи(< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от записи. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись выполнена не будет.
Описание:
Событие возникает после записи элемента справочника в инфор­мационную базу, но до окончания транзакции записи.
ПередУдалением ( BeforeDelete )
Синтаксис:
ПередУдалением (< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от удаления объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, удаление выполнено не будет.
Описание:
Событие возникает перед непосредственным удалением объекта из информационной базы.

Признак отказа от записи элемента.


ПередЗаписью ( BeforeWrite )
Синтаксис:
ПередЗаписью(< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от записи элемента. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись элемента выполнена не будет.
Описание:
Событие возникает перед выполнением записи объекта из формы. Процедура-обработчик данного события вызывается перед вызо­вом процедуры обработчика события ПередЗаписью объекта СправочникОбъект.
ПриЗаписи ( OnWrite )
Синтаксис:
ПриЗаписи(< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от записи. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись выполнена не будет.
Описание:
Событие возникает после записи объекта, но до окончания тран­закции. Процедура-обработчик данного события вызывается по­сле вызова процедуры обработчика события ПриЗаписи объек­та СправочникОбъект.
ПослеЗаписи ( AfterWrite )
Синтаксис:
ПослеЗаписи()
Описание:
Событие возникает после окончания транзакции записи объекта.

Признак отказа от изменения пометки


ПередУстановкойПометкиУдапения ( BeforeSetDeletingMark )
Синтаксис:
ПередУстановкойПометкиУдаления (< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от изменения пометки удаления объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то пометка удаления изменена не будет.
Описание:
Событие возникает перед установкой пометки удаления из фор­мы списка справочника.
Примечание:
Установка пометки на удаление приводит к записи объекта и, со­ответственно,    вызывает   события   ПередЗаписыо    и ПриЗаписи объекта СправочникОбъект.
ПередНачаломДобавления ( BeforeAddLine )
Синтаксис:
ПередНачаломДобавления (< Отказ>, <Копирование> , <Родитель>, <Группа>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от добавления строки. Если в теле процедуры-обработчика установить данному параметру значение Истина, то строка списка справочника добавлена не будет.
<Копирование>
Тип: Булево. Определяет режим копирования. Если Истина, то строка списка справочника добавляется копированием.
<Родитель>
Тип: СправочникСсылка. <Имя справочника;». Ссылка на элемент, который будет использован при добавлении в качестве родителя.
<Группа>
Тип: Булево. Определяет, что добавляется - группа или элемент справочника. Если Истина, то добавляется группа.
Описание:
Событие возникает перед добавлением строки списка справочни­ка. Данное событие для табличного поля справочника возникает "вместо" одноименного события объекта ТабличноеПоле.
Примечание:
Расширяется набор параметров по сравнению с одноименным со­бытием объекта ТабличноеПоле.
См. также:
ТабличноеПоле, событие ПередНачаломДобавления.

В данный параметр передается признак


ПриУстановкеНовогоНомера ( OnSetNewNumber )

Синтаксис:
ПриУстановкеНовогоНомера (< Стандартная обработкам, <Префикс>)
Параметры:
<Стандартная обработка>
Тип: Булево. В данный параметр передается признак выполне­ния стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная генерация нового номера производиться не будет.
<Префикс>
Тип: Строка. Префикс, который будет использоваться для гене­рации номера. Может быть изменен в процедуре-обработчике со­бытия.
Описание:
Событие возникает в момент, когда выполняется установка ново­го номера документа.
См. также:
ДокументОбъект.<Имя документа>, метод УстановитьНовыйНомер.
ПриКопировании (ОпСору)

Синтаксис:
ПриКопировании (<Объект копирования>)
Параметры:
<0бъект копирования>
Тип: ДокументОбъект. <Имя документа>. Исходный доку­мент, который является источником копирования.
Описание:
Событие возникает при создании документа копированием.
См. также:
ДокументСсылка.<Имя документа>, метод Скопиро­вать.
ОбработкаЗаполнения ( ProcessFilling)

Синтаксис:
ОбработкаЗаполнения (< Основание>)
Параметры:
<0снование>
Тип: Произвольный. Значение, которое используется как основание для заполнения.
Описание:
Событие возникает при вводе документа на основании, а также при выполнении метода Заполнить. В процедуре-обработчике этого события должен быть описан сам алгоритм заполнения рек­визитов документа на основании переданного значения.
См. также:
ДокументОбъект.<Имя документа>, метод Заполнить.
ПередЗаписью ( BeforeWrite )

Синтаксис:
ПередЗаписью (<Отказ>, <Режим записи>)
Параметры:
<0тказ>
Тип: Булево. Признак выполнения записи документа. Если в теле процедуры-обработчика установить данному параметру зна­чение Истина, то запись документа выполнена не будет.
<Режим записи>
Тип: РежимЗаписиДокумента. В данный параметр передается текущий режим записи документа. Позволяет определить в теле процедуры режим записи.


При определении значения параметра используется системное перечисление РежимЗаписиДокумента (DocumentWrifcingMode).
Описание:
Событие возникает перед выполнением записи объекта. Процеду­ра-обработчик вызывается после начала транзакции записи, но до начала записи документа.
См. также:
ДокументОбъект.<Имя документа>  метод Записать.
ПриЗаписи ( OnWrite )

Синтаксис:
ПриЗаписи{<Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак выполнения записи документа. Если в теле процедуры-обработчика установить данному параметру зна­чение Истина, то запись документа выполнена не будет.
Описание:
Событие возникает при записи объекта. Процедура-обработчик вызывается после записи документа, но до окончания транзакции записи.
См.также:
ДокументОбъект. <Имя документа>, метод Записать.
ПередУдалением ( BeforeDelete )
Синтаксис:
ПередУдалением (< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак удаления документа. Если в теле проце­дуры-обработчика установить данному параметру значение Истина, то удаление документа выполнено не будет.
Описание:
Событие возникает перед удалением объекта из базы.
ОбработкаПроведения ( ProcessPosting )

Синтаксис:
ОбработкаПроведения (< Отказ>, <Режим проведения>)
Параметры:
<0тказ>
Тип: Булево. Признак проведения документа. Если в теле про­цедуры-обработчика установить данному параметру значение Истина, то проведение документа выполнено не будет.
<Режим проведения>
Тип: РежимПроведения. В данный параметр передается теку­щий режим проведения.
При определении значения параметра используется системное перечисление РежимПроведения ( PostingMode).
Описание:
Событие возникает при проведении документа. Основное назна­чение процедуры-обработчика данного события - генерация дви­жений по документу.
Примечание:
Если для данного вида документа в конфигурации установлено автоматическое удаление движений, то перед возникновением события все движения по документу будут удалены.
См. также:
ДокументОбъект.<Имя документа>, метод Записать.
ОбработкаУдаленияПроведения ( ProcessUnposting)

Синтаксис:
ОбработкаУдаленияПроведения (< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отмены проведения документа. Если в теле процедуры-обработчика установить данному параметру зна­чение Истина, то отмена проведения документа произведена не будет.
Описание:
Событие возникает при отмене проведения документа.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

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


ПередЗаписью ( BeforeWrite )

Синтаксис:
ПередЗаписью(< Отказ>)
Параметры:
<Отказ>
Тип: Булево. Признак выполнения записи документа. Если в теле процедуры-обработчика установить данному параметру зна­чение Истина, то запись документа выполнена не будет.
Описание:
Событие возникает перед выполнением записи объекта. Процеду­ра-обработчик вызывается перед началом транзакции записи до­кумента.
Примечание:
Данное событие возникает до события ПередЗаписью объекта ДокументОбъект.
См. также:
ДокументОбъект. <Имя       документа>,  событие ПередЗаписью.
ПриЗаписи ( OnWrite )

Синтаксис:
ПриЗаписи{<Отказ>)
Параметры:
<Отказ>
Тип: Булево. Признак выполнения записи документа. Если в теле процедуры-обработчика установить данному параметру зна­чение Истина, то запись документа выполнена не будет.
Описание:
Событие возникает при записи объекта. Процедура-обработчик вызывается после записи документа, но до окончания транзакции записи.
Примечание:
Данное событие возникает после события ПриЗаписи объекта ДокументОбъект.
Си. также:
ДокументОбъект.<Имя документа> событие ПриЗаписи.
ПослеЗаписи ( AfterWrite )

Синтаксис:
ПослеЗаписи()
Описание:
Событие возникает после записи объекта. Процедура-обработчик вызывается после записи документа, и после окончания транзак­ции записи, то есть к моменту вызова этой процедуры запись до­кумента полностью завершена.

Признак отказа от записи объекта.


ПередЗаписью ( BeforeWrite )
Синтаксис:
ПередЗаписьо (< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от записи объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись объекта выполнена не будет.
Описание:
Событие возникает перед выполнением записи объекта. Процеду­ра-обработчик вызывается перед началом транзакции записи объ­екта.
ПриЗаписи ( OnWrite )
Синтаксис:
ПриЗаписи(< Отказ>)
Параметры:
<0тказ>
Тип: Булево. Признак отказа от записи объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись объекта выполнена не будет.
Описание:
Событие возникает при записи объекта. Процедура-обработчик вызывается после записи объекта, но до окончания транзакции записи.
ПослеЗаписи ( AjterWrite )

Синтаксис:
ПослеЗаписи()
Описание:
Событие возникает после окончания транзакции записи объекта.

Признак отказа от записи объекта.


ПередЗаписью ( BeforeWrite )

Синтаксис:
ПередЗаписью (< Отказ>)
Параметры:
<Отказ>
Тип: Булево. Признак отказа от записи объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись объекта выполнена не будет.
Описание:
Событие возникает перед выполнением записи объекта. Процеду­ра-обработчик вызывается перед началом транзакции записи объ­екта.
ПриЗаписи ( OnWrite )

Синтаксис:
ПриЗаписи(< Отказ>)
Параметры:
<Отказ>
Тип: Булево. Признак отказа от записи объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись объекта выполнена не будет.
Описание:
Событие возникает при записи объекта- Процедура-обработчик вызывается после записи объекта, но до окончания транзакции записи.
ПослеЗаписи ( AfterWrite )

Синтаксис:
ПослеЗаписи()
Описание:
Событие возникает после окончания транзакции записи объекта.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Признак отказа от записи объекта.


ПередЗаписью ( BeforeWrite )

Синтаксис:
ПередЗаписью(< Отказ>)
Параметры:
<Отказ>
Тип: Булево. Признак отказа от записи объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись объекта выполнена не будет.
Описание:
Событие возникает перед выполнением записи набора. Процеду­ра-обработчик вызывается перед началом транзакции записи объ­екта.
ПриЗаписи ( OnWrite )
Синтаксис:
ПриЗаписи(< Отказ>)
Параметры:
<Отказ>
Тип: Булево. Признак отказа от записи объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись объекта выполнена не будет.
Описание:
Событие возникает при записи набора. Процедура-обработчик вызывается после записи объекта, но до окончания транзакции записи.
ПослеЗаписи ( AfterWrite )
Синтаксис:
ПослеЗаписи()
Описание:
Событие возникает после окончания транзакции записи набора.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

СочетаниеКлавиш (Shortcut)


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

объектов, имеющих тип СочетаниеКлавиш.



Соответствие


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

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



Соответствие (Map)


Представляет доступ к соответствию.

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа КлючИЗначение. Для объекта доступен обход коллекции посредством оператора

Для каждого ... из ... Цикл. При обходе выбираются эле­менты соответствия.

См. также:

КлючИЗначение.



Совместное использование итогов и группировки


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

Пример:

ВЫБРАТЬ

Док.Товар, Док.Ссылка.Получатель, СУММА(Док.Количество)

ИЗ

    Документ.РасхНакл.Состав Док

СГРУППИРОВАТЬ ПО

    Док.Товар, Док.Ссылка.Получатель

ИТОГИ ПО

    Док.Товар

Результат запроса:

Товар Получатель Количество
Кран   84
Кран Урюпинскторг 32
Кран Маг. "Хозяин" 8
Кран Маг. "Гигант" 44
Вантус   20
Вантус Урюпинскторг 5
Вантус Маг. "Хозяин" 1
Вантус Маг. "Гигант" 14
Стол   26
Стол Урюпинскторг 1
Стол Маг. "Мебель" 15
Стол Маг. "Гигант" 10
Стул   108
Стул Урюпинскторг 16
Стул Маг. "Мебель" 55
Стул Маг. "Хозяин" 5
Стул Маг. "Гигант" 32



Создание базы данных, индекса, индексного файла


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



Специальные символы, используемые в исходном тексте


// Двумя знаками «косая черта» начинается комментарий. Комментарием считается весь текст от знака "//" до конца текущей строки.
| Вертикальная черта в начале строки используется только в строковых константах и означает, что данная строка является продолжением предыдущей (перенос строки).
~ Знаком тильда начинается метка оператора.
: Двоеточием заканчивается метка оператора.
; Точка с запятой является символом разделения операторов.
() В круглые скобки заключается список параметров методов, процедур, функций и конструкторов. Также они используются в выражениях встроенного языка.
[] С помощью оператора «квадратные скобки» производится обращение к свойствам объекта по строковому представлению имени свойства. Также возможно обращение к элементам коллекций по индексу или Другому параметру.
, Запятая разделяет параметры в списке параметров методов, процедур, функций и конструкторов.
"" В двойные кавычки заключаются строковые литералы. В одинарные кавычки заключаются литералы даты.
. Десятичная точка в числовых литералах. Разделитель, используемый для обращения к свойствам и методам объектов встроенного языка.
+ Символ «плюс» обозначает операцию сложения и конкатенации.
- Символ «минус» обозначает операцию вычитания.
* Символ «звездочка» обозначает операцию умножения.
/ Символ «косая черта» обозначает операцию деления.
> Правая угловая скобка обозначает логическую опера­цию «больше».
>= Логическая операция «больше или равно».
< Левая угловая скобка обозначает логическую операцию «меньше».
<= Логическая операция «меньше или равно».
= Знак равенства обозначает присвоение или логическую операцию «равно».
<> Две угловые скобки обозначают логическую операцию «не равно».

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»



Спецификации соединений


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

Пример:

Выбрать

Контрагенты.Ссылка Как Контрагент,

    Банки.Ссылка Как Банк

Из

    Справочник.Контрагенты Как Контрагенты,

    Справочник.Банки Как Банки

Результат запроса:

Контрагент Банк
Поставщики АКБ ИвестБанк
Поставщики АКБ ПромСтройБанк
Трикотажная фабрика «Заря» АКБ ИвестБанк
Трикотажная фабрика «Заря» АКБ ПромСтройБанк
Фабрика джинсовой одежды АКБ ИвестБанк
Фабрика джинсовой одежды АКБ ПромСтройБанк
Покупатели АКБ ИвестБанк
Покупатели АКБ ПромСтройБанк
Ярмарка одежды АКБ ИвестБанк
Ярмарка одежды АКБ ПромСтройБанк
Торговый дом «Буденовский» АКБ ИвестБанк
Торговый дом «Буденовский» АКБ ПромСтройБанк
Павильон 45 на оптовом рынке АКБ ИвестБанк
Павильон 45 на оптовом рынке АКБ ПромСтройБанк
Бавария - фарфор АКБ ИвестБанк
Бавария - фарфор АКБ ПромСтройБанк
Фабрика джинсовой одежды АКБ ИвестБанк
Фабрика джинсовой одежды АКБ ПромСтройБанк
АКБ ПромСтройБанк АКБ ИвестБанк
АКБ ПромСтройБанк АКБ ПромСтройБанк

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

Соединения бывают нескольких видов, они описываются сле­дующими правилами:

<Перечень соединений>

<Соединение> [<Перечень соединений>]

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




<Соединение>

[ВНУТРЕННЕЕ] СОЕДИНЕНИЕ <Описание источника> ПО <Условие отбора> |

ЛЕВОЕ [ВНЕШНЕЕ] СОЕДИНЕНИЕ <Описание источника> ПО <Условие отбора> |

ПРАВОЕ [ВНЕШНЕЕ] СОЕДИНЕНИЕ <Описание источника> ПО <Условие отбора> |

ПОЛНОЕ (ВНЕШНЕЕ] СОЕДИНЕНИЕ <Описание источника> ПО <Условие отбора>

<Описание источника> содержит описание исходной табли­цы - см. раздел « Описание источников запроса» на стр. 305.

<Условие отбора> содержит условия, в соответствии с кото­рыми в выборке необходимо соединить данные из исходных таб­лиц - источников запроса. Правила описания условий в языке запросов рассматриваются на стр. 357.

Ключевые слова ЛЕВОЕ, ПРАВОЕ и ПОЛНОЕ уточняют характер соединения. Слова ВНУТРЕННЕЕ или ВНЕШНЕЕ можно не указывать вообще, они повышают наглядность и удобочитаемость тек­ста запроса.

Соединяемые источники не равнозначны между собой, и в неко­торых случаях результат зависит от того, какая таблица указана первой, до ключевого слова СОЕДИНЕНИЕ (слева от него), а какая - второй (справа).

Внутреннее соединение

[ВНУТРЕННЕЕ] СОЕДИНЕНИЕ означает, что из обеих исходных таблиц - источников данных в результат запроса необходимо включить только те комбинации записей, которые соответствуют указанному условию. Остальные записи в результат не попадают.

Пример:

// Необходимо выяснить, какие банки является одновременно

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

//и в справочнике Контрагенты, и в справочнике Банки).

Выбрать

    Контрагенты.Ссылка Как Контрагент,

    Банки.Ссылка Как Банк

Из

    Справочник.Контрагенты Как Контрагенты

Внутреннее Соединение

    Справочник.Банки Как Банки

По

    Контрагенты.Наименование = Банки.Наименование

Результат запроса:

Контрагент Банк
АКБ ПромСтройБанк АКБ ПромСтройБанк
Левое внешнее соединение

ЛЕВОЕ [ВНЕШНЕЕ] СОЕДИНЕНИЕ означает, что в результат запроса надо включить комбинации записей из обеих исходных таблиц, которые соответствуют указанному условию. Но, в отли­чие от внутреннего соединения, в результат запроса надо вклю­чить также еще и записи из первого (указанного слева от слова СОЕДИНЕНИЕ) источника, для которых не найдено соответст­вующих условию записей из второго источника.



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

Пример:

//В отчет необходимо вывести всех контрагентов, а для тех,

// кто является также банком - указать ссылку на банк.

Выбрать

    Контрагенты.Ссылка Как Контрагент,

    Банки.Ссылка Как Банк

Из

    Справочник.Контрагенты Как Контрагенты

Левое Внешнее Соединение

    Справочник.Банки Как Банки

По

    Контрагенты.Наименование = Банки.Наименование

Результат запроса:

Контрагент Банк
Поставщики NULL
Трикотажная фабрика «Заря» NULL
Фабрика джинсовой одежды NULL
Покупатели NULL
Ярмарка одежды NULL
Торговый дом «Буденовский» NULL
Павильон 45 на оптовом рынке NULL
Бавария - фарфор NULL
Фабрика джинсовой одежды NULL
АКБ ПромСтройБанк АКБ ПромСтройБанк
Правое внешнее соединение

ПРАВОЕ [ВНЕШНЕЕ] СОЕДИНЕНИЕ означает, что в результат запроса надо включить комбинации записей из обеих исходных таблиц, которые соответствуют указанному условию. Кроме того, в результат запроса надо включить также еще и записи из второго (указанного справа от слова СОЕДИНЕНИЕ) источника, для кото­рых не найдено соответствующих условию записей из первого ис­точника.

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

Пример:

//В отчет необходимо вывести все банки, а для тех,



// кто является также и контрагентом - указать ссылку на контрагента.

ВЫБРАТЬ

    Контрагенты.Ссылка Как Контрагент,

    Банки.Ссылха Как Банк

ИЗ

    Справочник.Контрагенты Как Контрагенты

Правое Внешнее Соединение

    Справочник.Банки Как Банки

По

    Контрагенты.Наименование = Банки.Наименование

Результат запроса:

Контрагент Банк
NULL АКБ ИвестБанк
АКБ ПромСтройБанк АКБ ПромСтройБанк
Полное внешнее соединение

ПОЛНОЕ [ВНЕШНЕЕ] СОЕДИНЕНИЕ означает, что в результат запроса надо включить комбинации записей из обеих исходных таблиц, которые соответствуют указанному условию. Кроме того, в результат запроса надо включить также еще и те записи из обо­их источников, для которых не найдено соответствий.

Таким образом, в результат запроса будут включены все записи из обоих источников; они будут соединены друг с другом при вы­полнении указанного условия. Строки результата запроса, для которых не найдено соответствующих условию записей из какого-либо источника, будут содержать NULL в полях, формируемых на основании записей из этого источника.

Пример:

// В отчет необходимо вывести всех контрагентов и все банки,

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

Выбрать

    Контрагенты.Ссылка Как Контрагент,

    Банки.Ссылка Как Банк

Из

    Справочник.Контрагенты Как Контрагенты

Полное Внешнее Соединение

    Справочник.Банки Как Банки

По

    Контрагенты.Наименование = Банки.Наименование

Результат запроса:

Контрагент Банк
Поставщики NULL
Трикотажная фабрика «Заря» NULL
Фабрика джинсовой одежды NULL
Покупатели NULL
Ярмарка одежды NULL
Торговый дом «Буденовский» NULL
Павильон 45 на оптовом рынке NULL
Бавария - фарфор NULL
Фабрика джинсовой одежды NULL
АКБ ПромСтройБанк АКБ ПромСтройБанк
NULL АКБ ИвестБанк

Список значений


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

Условно можно представить себе список значений как таблицу, состоящую из пяти граф: индекс, пометка, значение, представле­ние значения и картинка. Индекс определяет позицию элемента в списке значений. Индекс формируется и отслеживается автома­тически, непосредственно недоступен для редактирования. Ин­декс первого элемента равен 0. В графе пометки содержится свя­занное с элементом списка значение пометки. В графе со значе­нием хранится собственно сохраняемое значение. В графе пред­ставления хранится строка с пользовательским представлением хранимого значения. Данное представление показывается во вре­мя визуального отображения списка в элементах управления формы или при выборе значения. Если представление не указано, то при визуальном отображении списка система сформирует стандартное представление отображаемого значения. В графе кар­тинка хранится визуальное представление, связанное с данным значением.



СписокЗначений (ValueList)


Используется для доступа к методам списка значений в целом.

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа ЭлементСпискаЗначений. Для объекта доступен обход кол­лекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются элементы коллекции.. Возможно обра­щение к элементу коллекции посредством оператора [...]. В качестве аргумента передается индекс элемента.

Пример:

// Пример перемещения элемента в поле списка формы

// вперед (вниз) на одну позицию.

Список = ЭлементыФормы.ПолеСпискаТиповЦен.Значение;

ТекЭлементСписка = ЭлементыФормы.ПолеСпискаТиповЦен.ТекущаяСтрока;

Если ТекЭлементСписка <> Неопределено Тогда

НомерСтроки = Список.Индекс(ТекЭлементСписка);

    Если НомерСтроки + 1 < Список.Количество() Тогда

        Список.Сдвинуть(ТекЭлементСписка, 1);

    Иначе

        Сообщить('Достигнут конец списка!") ;

    КонецЕсли;

Иначе

    Сообщить('Не выбрана строка списка типов цен!");

КонецЕсли;



Способы обхода результата запроса


Линейный обход результата

Первый, и самый простой способ обхода - линейный. При ли­нейном обходе выборка будет выдавать записи в той последова­тельности, в которой они располагаются в результате запроса. В нашем примере это будут записи с номерами 1, 2, 3, 4, 5 и так да­лее до записи с номером 20.

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

Пример:

СпособВыборки = ОбходРезультатаЗапроса.Прямой;

Выборка1 = РезультатЗапроса.Выбрать(СпособВыборки);

// что равнозначно записи

Выборка1 = РезультатЗапроса.Выбрать();

Иерархический обход результата

Следующий способ обхода результата - иерархический. При дан­ном обходе обходятся только записи, находящиеся на одном уровне. Для получения иерархической выборки из результата не­обходимо вызвать метод Выбрать объекта РезультатЗапроса с параметром ОбходРезультатаЗапроса.ПоГруппировкамСИерархией.

СпособВьборки = ОбходРезультатаЗапроса.ПоГруппировкамСИерархией;

Выборка2 = РезультатЗапроса.Выбрать(СпособВыборки);

Выборка из результата с иерархическим обходом в нашем приме­ре обойдет только записи с номерами 1 и 11, так как только эти две записи находятся на самом верхнем уровне. Проиллюстриру­ем это, представив наш результат в виде дерева, где узлами будут итоговые записи, а листьями дерева будут детальные записи. Вот что у нас получится:

1 Сантехника 104    
         
  2 Кран 84  
    3 Кран 10
    4 Кран 8
    5 Кран 44
    6 Кран 22
         
  7 Смеситель 20  
    8 Смеситель 5
    9 Смеситель 1
    10 Смеситель 14
         
11 Мебель 134    
         
  12 Стол 26  
    13 Стол 1
    14 Стол 15
    15 Стол 10
         
  16 Стул 108  
    17 Стул 55
    18 Стул 5
    19 Стул 32
    20 Стул 16



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

Возникает вопрос, как получать остальные записи результата за­проса. Для этого у объекта ВыборкаИзРезультатаЗапроса можно получить еще одну выборку, которая будет обходить под­чиненные записи текущей записи выборки. В нашем примере в момент, когда объект Выборка2 будет позиционирован на запись с номером 1, мы запросим у него иерархическую выборку. Таким образом, мы получим выборку, которая нам вернет записи с но­мерами 2, 7. А когда Выборка2 будет спозиционирована на записи с номером 11, то полученная у нее иерархическая выборка вернет записи с номерами 12, 16. Так реализуется иерархический обход результатов запроса Заметим, что у выборки можно получать вложенные выборки любого типа. Так, если бы мы запросили у Выборки2, спозиционированной на записи 1, линейную выборку, то с ее помощью мы бы получили записи с номерами записей со 2-го по 10-й. Проиллюстрируем описанную методику на примере.

Пример:

Процедура ВыдатьРекурсивно(Выборка) Далее;

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

    Запрос = Новый Запрос;

    Текст = "Выбрать Товар, Количество

        |    Из Документ.РасхНакя.Состав

        |    Упорядочить по Товар

        |    Итоги Сумма(Количество) По Товар, Товар Иерархия";

    РезультатЗапроса = Запрос.Выполнить();

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

    СпособВыборки = ОбходРезультатаЗапроса.ПоГруппировкамСИерархией;

    Выборка = РезультатЗапроса.Выбрать(СпособВыборки);

    ВыдатьРекурсивно(Выборка);

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

Процедура ВыдатьРекурсивно(Выборка)

    // Пока в выборке есть записи ...



    Пока Выборка. Следующий () Цикл

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

        Товар = Выборка.Наименование;

        Количество = Выборка.Количество;

        Сообщить("Товар: " + Товар + " Количество: " + Количество);

        // продолжим выборку подчиненных записей

        СпособВыборки = ОбходРезультатаЗапроса.ПоГруппировкамСИерархией;

        Выдать Рекурсивно(Выборка.Выбрать(СпособВыборки));

    КонецЦикла;

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

Обход результата по группам

Третий, и последний способ обхода результата - по группам. Он сходен с иерархическим обходом, но с одним различием: записи с иерархическими итогами при обходе в нем рассматриваются как детальные записи, а не как узловые. Для получения выборки по группам из результата запроса необходимо вызвать метод Выбрать

объекта РезультатЗапроса с

параметром ОбходРезультатаЗапроса.ПоГруппировкам.

Пример:

СпособВыборки = ОбходРезультатаЗапроса.ПоГруппировкам;

Вы6орка2 = РезультатЗапроса.Выбрать(СпособВыборки);

Перебрав в ней всё, мы получим записи с номерами 1, 2, 7, 11, 12, 16.

Пример:

Процедура ВыдатьДочерниеЗаписи(Выборка) Далее;

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

    Запрос = Новый Запрос;

    Текст = "Выбрать Товар, Количество

        |    Из Документ.РасхНакя.Состав

        |    Упорядочить по Товар

        |    Итоги Сумма(Количество) По Товар, Товар Иерархия";

    РезультатЗапроса = Запрос.Выполнить();

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

    СпособВыборки = ОбходРезультатаЗапроса.ПоГруппировкам;



    Выборка = РезультатЗапроса.Выбрать(СпособВыборки);

    // Пока в выборке есть записи ...

    Пока Выборка.Следующий() Цикл

        // ... выведем в окно сообщений доля из результата

        Товар = Выборка.Наименование;

        Количество = Выборка.Количество;

        Сообщить("Товар: " + Товар + " Итого по товару: " + Количество) ;

        ВыдатьДочерниеЗаписи(Выборка.Выбрать()) ;

    КонецЦикла;

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

Процедура ВыдатьДочерниеЗапися (Выборка)

    // Пока в выборке есть записи . . .

    Пока Выборка.Следующий() Цикл

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

        Товар = Выборка.Наименование;

        Количество = Выборка.Количество;

        Сообщить("Товар: " + Товар + " Количество: " + Количество);

    КонецЦикла;

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


Справочники


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

Пример:

// Пример создания нового элемента

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

НовыйОбъект.Код = "840";

НовыйОбъект.Наименование = "USD";

НовыйОбъект.ПолноеНаименование = "Доллары США";

НовыйОбъект.Записать() ;

// Пример обработки выборки справочника 

КПЗ = Справочники.Номенклатура;

ОтборМПЗ = Новый Структура("ТипНоменклатуры");

Пусто = Перечисления.ТипыНоменклатуры.ПустаяСсылка();

ОтборМПЗ.ТипНоменклатуры = Пусто;

ВыборкаМПЗ = МПЗ.ВыбратьЭлементы(,,ОтборМПЗ, "Наименование Убыв"):

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

    Пока ВыборкаМПЗ.Следующий() Цикл

        Объект = ВыборкаМПЗ.ПолучитьОбъект();

        Объект.ТипНоменклатуры = Перечисления.ТипыНоменклатуры.Товар.

        Объект.Записать() ;

    КонецДикла;

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



СправочникиМенеджер (CatalogsManager)


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

Данный объект является коллекцией значений. В качестве эле­мента      коллекции      выступает      значение      типа СправочникМенеджер. <Имя справочникам Для объекта доступен обход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются элементы коллекции.

Пример:

Для каждого СправМетаданные из Метаданные.Справочники Цикл 

    ИмяСправочника       = СправМетаданные .Имя;

    МенеджерСправочника = Справочники[ИмяСправочника];

    ВыборкаСправочника = МенеджерСправочника .Выбрать();

    Если ВыборкаСпразочника.Следующий() Тогда

        Предупреждение("В информационной базе есть " + " заполненные справочники") ;

        Возврат;

    КонецЕсли ;

КонецЦикла ;



СправочникМенеджер. < Имя справочника> (CatalogsManager.<Имя справочника>)


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



СправочникОбъект.<Имя справочника> (CatalogObject.<Имя справочника>)


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

Важно! У всех событий этого объекта назначены предопреде­ленные процедуры-обработчики. Имя процедур соответствует именам событий. Процедуры должны располагаться в модуле справочника.



СправочникСписок.<Имя справочника> ( CatalogList . < Имя справочника>)


Объект предназначен для управления списком элементов спра­вочника, отображаемым в табличном поле.

Пример:

СправочникСписок. Колонки. Добавить (" СтранаПроисхождения");

СправочникСписок. Порядок .Установить ("ЕдиницаИзмерения"); 

СправочникСписок. Отбор. СтранаПроисхождения .Установить ("Германия");



СправочникСсылка. <Имя справочника> ( CatalogRef .< Имя справочника>)


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



СправочникВыборка.<Имя справочника> (CatalogSelection.<Имя справочника>)


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

Пример:

Процедура УстановитьРеквизит(ИдСправочника, ИдРеквизита, ЗначениеРеквизита, СтруктураДляОтбора)

    ВыборкаСправочника = Справочники[ИдСправочника].Выбрать(,,СтруктураДляОтбора);

    Пока ВыборкаСправочника.Следующий() Цикл

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

        Объект(ИдРеквизита) = ЗначениеРеквизита;

        Объект.Записать();

    КонецЦикла;

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



Страница панели


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



Строка табличной части


Используется для доступа к свойствам и методам строки таблич­ной части.



СтрокаДереваЗначений


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



СтрокаТаблицыЗначений (ValueTableRow)


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

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа Произвольный. Для объекта доступен обход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются значения в колонке данной строки. Возможно обращение к значению колонки данной строки, посредством оператора [...]. В ка­честве аргумента передается индекс колонки.



Структура


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



Структура программного модуля


Структуру программного модуля можно подразделить на следующие разделы:

• раздел определения переменных;

• раздел процедур и функций;

• раздел основной программы.

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

Раздел определения переменных размещается от начала текста модуля до первого оператора Процедура или оператора Функция или любого исполняемого оператора. В этом разделе могут находиться только операторы объявления переменных Перем.

Раздел процедур и функций размещается от первого оператора Процедура или оператора Функция до любого исполняемого оператора вне тела описания процедур или функций.

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



Структура (Structure)


Представляет доступ к самой структуре.

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа КлючИЗначение. Для объекта доступен обход коллекции посредством оператора

Для каждого ... из ... Цикл. При обходе выбираются эле­менты коллекции.

См. также:

КлючИЗначение.



Управление интерфейсом. Используется для доступа


БиблиотекаСтилей (StyleLib)
Использование:
Только чтение.
Описание:
Тип: БиблиотекаСтилей. Используется для доступа к опреде­ленным в конфигурации стилям.
См. также:
БиблиотекаСтилей.
ВнешниеОбработки (External Processings)
Использование:
Только чтение.
Описание:
Тип: МенеджерВнешнихОбработок. Используется для досту­па к внешним обработкам.
См. также:
МенеджерВнешнихОбработок.
ГлавныйИнтерфейс (Mainlnterface)
Использование:
Только чтение.
Описание:
Тип: Управление интерфейсом. Используется для доступа к определенным в конфигурации пользовательским интерфейсам.
См. также:
Управление интерфейсом.
Документы (Documents)
Использование:
Только чтение.
Описание:
Тип: ДокументыМенеджер. Используется для доступа к опре­деленным в конфигурации документам.
См. также:
ДокументыМенеджер.
ЖурналыДокументов
Использование:
Только чтение.
Описание:
Тип: ЖурналыДокументовМенеджер. Используется для дос­тупа к определенным в конфигурации журналам документов.
См. также:
ЖурналыДокументовМенеджер.
ИспользованиеРабочейДаты (WorkingDateUse)
Использование:
Только чтение.
Описание:
Тип: системное пе­речисление РежимРабочейДаты. Определяет режим использования рабочей даты.
См. также:
Глобальный контекст, свойство РабочаяДата.
Константы (Constants)
Использование:
Только чтение.
Описание:
Тип: КонстантыМенеджер. Используется для доступа к опре­деленным в конфигурации константам.
См.также:
КонстантыМенеджер.
КритерииОтбора (Filters)
Использование:
Только чтение.
Описание:
Тип: КритерииОтбораМенеджер. Используется для доступа к определенным в конфигурации критериям отбора.
См.также:
КритерииОтбораМенеджер.
Метаданные (Metadata)
Использование:
Только чтение.
Описание:
Тип: Объект описания конфигурации. Используется для доступа к структуре метаданных конфигурации.
См. также:
Объект описания конфигурации.
Обработки (Processings)
Использование:
Только чтение.
Описание:
Тип: ОбработкиМенеджер. Используется для доступа к опре­деленным в конфигурации обработкам.


См. также:
ОбработкиМенеджер.
Отчеты (Reports)
Использование:
Только чтение.
Описание:
Тип: ОтчетыМенеджер. Используется для доступа к опреде­ленным в конфигурации отчетам.
См. также:
ОтчетыМенеджер.
Перечисления (Enums)
Использование:
Только чтение.
Описание:
Тип: ПеречисленияМенеджер. Используется для доступа к определенным в конфигурации перечислениям.
См.также:
ПеречисленияМенеджер.
ПланыВидовРасчета
Использование:
Только чтение.
Описание:
Тип: ПланыВидовРасчетаМенеджер. Используется для доступа к менеджеру всех планов видов расчета.
РабочаяДата (WorkingDate)
Использование:
Чтение и запись.
Описание:
Тип: Дата. Содержит рабочую дату, используемую в текущем сеансе работы с конфигурацией. Доступно для записи в случае, если свойство ИспользованиеРабочейДаты имеет значение Назначать.
См. также:
Глобальный контекст, свойство ИспользованиеРабочейДаты.
РегистрыНакопления (AccumulationRegisters)
Использование:
Только чтение.
Описание:
Тип: РегистрыНакопленияМенеджер. Используется для доступа к определенным в конфигурации регистрам накопления.
См. также:
РегистрыНакопленияМенеджер.
РегистрыРасчета
Использование:
Только чтение.
Описание:
Тип: РегистрыРасчетаМенеджер. Используется для доступа к менеджеру всех регистров расчета.
РегистрыСведений (InformationRegisters)
Использование:
Только чтение.
Описание:
Тип: РегистрыСведенийМенеджер. Используется для досту­па к определенным в конфигурации регистрам сведений.
См. также:
РегистрыСведенийМенеджер.
Справочники (Catalogs)
Использование:
Только чтение.
Описание:
Тип: СправочникиМенеджер. Используется для доступа к определенным в конфигурации справочникам.
См. также:
СправочникиМенеджер.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

При определении значения свойства используется


Вид (Kind)
Использование:
Только чтение.
Описание:
Тип: ВидКартинки. Содержит вид картинки.
При определении значения свойства используется системное пе­речисление ВидКартинки.