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

ПриВыбореЗакладки


Предопределенная процедура смены закладки формы.

Синтаксис:

ПриВыбореЗакладки(<НомерЗакладки>, <Значение3акладки>)

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

OnTabCtrlPosChanged

Параметры:



<НомерЗакладки>

Числовое значение — номер выбранной за­кладки формы.

<Значение3акладки>

Значение выбранной закладки формы.

Описание:

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

Параметры <НомерЗакладки> и <Значение3акладки> используется в теле процедуры для обработки передаваемого системой события смены заклад­ки формы.

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

Пример:

Процедура ЗакладкаОбщиеВидимость(ФлагВидимости)

   Форма.Название.Видимость(ФлагВидимости);

   Форма.Наименование.Видимость(ФлагВидимости);

   Форма.Код.Видимость(ФлагВидимости);

   Форма.Статус.Видимость(ФлагВидимости);

   Форма.Адрес.Видимость(ФлагВидимости);

   Форма.Телефон.Видимость(ФлагВидимости);

   Активизировать("Наименование", 0);

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

Процедура ЗакладкаЗаметкиВидимость(ФлагВидимости)

   Форма.Заметки.Видимость(ФлагВидимости);

   Активизировать("Заметки", 0);

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

Процедура ПриВыбореЗакладки(НомерЗакладки, ЗначениеЗакладки)

   Если Значение3акладки = 1 Тогда

      Закладка.Заметки.Видимость(0);

      Закладка.Общие.Видимость(1);

   ИначеЕсли ЗначениеЗакладки = 2 Тогда

      Закладка.Общие.Видимость(0);

      Закладка.Заметки.Видимость(1);

   КонецЕсли;

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

См. также: ИспользоватьЗакладки, Закладки, СтатусВозврата



ПриВыклВклПроводокОперации


Предопределенная процедура, выполняемая при выключении или включении проводок.

Синтаксис:

ПриВыклВклПроводокОперации(<Документ>)

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

OnOperEntryOffOn

Параметры:

<Документ>

Значение типа «Документ» — документ, которому принадлежит операция.

Описание:

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

Если в данной процедуре установить статус возврата 0, то действие не будет выполнено.

Данная предопределенная процедура может располагаться только в гло­бальном программном модуле.

Пример:

Процедура ПриВыклЗклПроводокОперации(Док)

   Если Док.Вид() <> "Операция" Тогда

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

   КонецЕсли;

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

См. также: СтатусВозврата




ПриЗакрытии


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

Синтаксис:

ПриЗакрытии()

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

OnClose

Описание:

Вызов предопределенной процедуры ПриЗакрытии производится самой системой 1С:Предприятие неявно при интерактивном закрытии формы. Если в данной предопределенной процедуре установить статус возврата — 0 (напри­мер, если неверно или не полностью заполнены реквизиты объекта), закрытие формы не будет выполнено.

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

Пример:

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

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

      Предупреждение("Укажите Счет-Фактуру", 4);

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

   КонецЕсли;

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

См. также: СтатусВозврата



ПриЗаписи


Предопределенная процедура при записи элемента справочника.

Синтаксис:

ПриЗаписи(<СписокПериодРекв>)

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

OnWrite

Параметры:

<СписокПериодРекв>

Строковое значение — список разделенных за­пятыми изменяемых периодических реквизитов справочника. В данный параметр система 1С:Предприятие передает перечень периодиче­ских реквизитов, которые были интерактивно выбраны пользователем для обновления в окне диалога выбора. В теле процедуры значение данного параметра может быть изменено, что позволяет в данной процедуре непосредственно управлять списком записываемых значений периодических реквизитов.

Описание:

Вызов предопределенной процедуры ПриЗаписи производится системой 1С:Предприятие при интерактивной записи элемента справочника. Если в дан­ной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя изменять некоторые элементы справочни­ка), то запись элемента справочника не будет выполнена.

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

Пример:

Процедура ПриЗаписи (СписокРекв)

   Если НазваниеНабораПрав() = "Продавец" Тогда

      Если ТекущийЭлемент() = Константа.НашаФирма Тогда

         Предупреждение("У вас нет права менять реквизиты!", 2);

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

      КонецЕсли;

   КонецЕсли;

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

См. также: СтатусВозврата



ПриЗаписи


Предопределенная процедура при записи строки списка справочника.

Синтаксис:

ПриЗаписи(<СписокПериодРекв>)

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

OnWrite

Параметры:

<СписокПериодРекв>

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

Описание:

Вызов предопределенной процедуры ПриЗаписи производится системой 1С:Предприятие при интерактивной записи строки списка справочника. Если в данной предопределенной процедуре установить статус возврата — 0 (напри­мер, если данному пользователю нельзя изменять некоторые элементы спра­вочника), то запись строки списка справочника не будет выполнена.

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

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

Пример:

Процедура ПриЗаписи (СписокРекв)

   Если НазваниеНабораПрав() = "Продавец" Тогда

      Если ТекущийЭлемент() = Константа.НашаФирма Тогда

         Предупреждение("У вас нет права менять реквизиты!", 2);

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

      КонецЕсли;

   КонецЕсли;

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

См. также: СтатусВозврата



ПриЗаписи


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

Синтаксис:

ПриЗаписи()

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

OnWrite

Описание:

Вызов предопределенной процедуры ПриЗаписи производится в системе 1С:Предприятие при интерактивной записи документа. Если в данной предо­пределенной процедуре установить статус возврата — 0 (например, если данно-wy пользователю нельзя изменять реквизиты документа), запись документа не будет выполнена.

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

Пример:

Процедура ПриЗаписи()

   Если НазваниеНабораПрав() = "Продавец" Тогда

      Предупреждение("У вас нет права изменять документ!", 2);

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

   КонецЕсли;

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

См. также: СтатусВозврата



ПриЗаписи


Предопределенная процедура при записи строки списка счетов.

Синтаксис:

ПриЗаписи(<СписокПериодРекв>)

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

OnWrite

Параметры:

<СписокПериодРекв>

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

Описание:

Вызов предопределенной процедуры ПриЗаписи производится системой 1С:Предприятие при интерактивной записи строки списка счетов. Если в дан­ной предопределенной процедуре установить статус возврата 0 (например, если данному пользователю нельзя изменять некоторые характеристики счета), то запись строки списка счетов не будет выполнена.

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

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

Пример:

Процедура ПриЗаписи(СписокРекв)

   Если Валютный = 1 Тогда

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

   КонецЕсли;

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

См. также: СтатусВозврата



ПриЗаписи


Предопределенная процедура при записи счета.

Синтаксис:

ПриЗаписи(<СписокПериодРекв>)

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

OnWrite

Параметры:

<СписокПериодРекв>

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

Описание:

Вызов предопределенной процедуры ПриЗаписи производится системой 1С:Предприятие при интерактивной записи счета. Если в данной предопреде­ленной процедуре установить статус возврата 0 (например, если данному поль­зователю нельзя изменять некоторые характеристики счета), то запись счета не будет выполнена.

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

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

Пример:

Процедура ПриЗаписи(СписокРекв)

   Если Валютный = 1 Тогда

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

   КонецЕсли;

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

См. также: СтатусВозврата




ПриЗаписи


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

Синтаксис:

ПриЗаписи()

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

OnWrite

Описание:

Вызов предопределенной процедуры ПриЗаписи производится в системе 1С:Предприятие при записи операции в форме операции. Если в данной предо­пределенной процедуре установить статус возврата — 0 (например, если не пра­вильно заполнены реквизиты операции), запись операции не будет выполнена.

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

Пример:

Процедура ПриЗаписи()

   Если ПустаяСтрока(Содержание) = 1 Тогда

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

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

   КонецЕсли;

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

См. также: СтатусВозврата



ПриЗаписиИстории


Предопределенная процедура при записи в окне «История» значения периодического реквизита элемента справочника или константы.

Синтаксис:

ПриЗаписиИстории(<ТипОбъекта>, <Объект>, <3начение>, <ДатаИстории>)

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

OnWriteHistory

Параметры:

<ТипОбъекта>

Название периодического объекта конфигурации, как оно задано в конфигураторе (например, "Справочник.Валюты.ТекущийКурс" или "Константа. ИмяДиректора"). Строковое назва­ние агрегатного типа данных может передаваться системой в русском или англоязычном написании (Справочник или Reference, Константа или Const) — в зависимости от установки флага ос­новного языка системы (см. ОсновнойЯзык).

<Объект>

Элемент справочника, для которого выполняется изменение периодического реквизита. Имеет смысл только для периодических реквизитов справочни­ков, а не для констант.

<3начение>

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

<ДатаИстории>

Дата периодической записи.

Описание:

Вызов предопределенной процедуры ПриЗаписиИстории производится системой 1С:Предприятие неявно при интерактивной записи нового периоди­ческого значения в окне «История». Если в данной предопределенной процеду­ре установить статус возврата — 0 (например, если данному пользователю за­прещено изменение периодических реквизитов), то запись нового периодиче­ского значения не будет выполнена.

Данная предопределенная процедура может располагаться только в гло­бальном программном модуле.

Пример:

Процедура ПриЗаписиИстории(ТипОб, Об, Значен, ДатаИстор)

   Если НазваниеНабораПрав() = "Продавец" Тогда

      Если (ТипОб = "Справочник.Валюты.ТекКурс") И

           (Об = Константа.ОсновнаяВалюта) И (ДатаИстор > РабочаяДата()) Тогда

         // Записывается курс для валюты, которая записана в Константе

         Предупреждение("У вас нет права устанавливать курс на будущую дату!", 2);

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

      КонецЕсли;

   КонецЕсли;

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

Ом. также: СтатусВозврата, ОсновнойЯзык



ПриЗаписиКонстанты


Предопределенная процедура при записи значения константы.

Синтаксис:

ПриЗаписиКонстанты(<ИмяКонстанты>, <3начение>)

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

OnWriteConst

Параметры:

<ИмяКонстанты>

Название константы, как оно задано в конфигура­торе (например, "СкладПоУмолчанию").

<3начение>

Новое значение константы.

Описание:

Вызов предопределенной процедуры ПриЗаписиКонстанты производится системой 1С:Предприятие неявно при интерактивной записи значения кон­станты. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данное значение константы запрещено), то запись кон­станты не будет выполнена.

Данная предопределенная процедура может располагаться только в гло­бальном программном модуле.

Пример:

Процедура ПриЗаписиКонстанты(ИмяКонстанты, Значение)

   Если ИмяКонстанты = "ТекущийПрефикс" Тогда

      Если НазваниеНабораПрав() = "Продавец" Тогда

         Предупреждение("У вас нет права менять префикс!", 2);

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

      КонецЕсли;

   КонецЕсли;

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

См. также: СтатусВозврата



ПриЗаписиПерепроводить


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

Синтаксис:

ПриЗаписиПерепроводить(<Режтл>)

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

ReMakeActionsWhenWrite

Параметры:

<Режим>

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

Описание:

Метод ПриЗаписиПерепроводить устанавливает режим обязательного пе­репроведения при записи ранее проведенного документа (интерактивный отказ от проведения документа или ошибка модуля приведет к отмене записи отре­дактированного документа).

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

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

   ПриЗаписиПерепроводить(1);

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



ПриЗавершенииРаботыСистемы


Предопределенная процедура при завершении работы задачи.

Синтаксис:

ПриЗавершенииРаботыСистемы()

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

OnFinishSystem

Описание:

Вызов предопределенной процедуры ПриЗавершенииРаботыСистемы про­изводится системой 1С:Предприятие неявно при завершении работы пользова­теля с системой. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если пользователь не выполнил какие-либо штатные операции), то работа системы не будет завершена, т. е. пользователь не сможет выйти из программы.

Данная предопределенная процедура может располагаться только в гло­бальном программном модуле.

Пример:

Процедура ПриЗавершенииРаботыСистемы()

   Предупреждение("До свидания !", 2);

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

См. также: СтатусВозврата



Процедура


Секция описания процедуры.

Синтаксис:

Процедура <Имя_проц>([[Знач] <Парам1>[=<ДефЗнач>],

... , [Знач] <ПapaмN>[=<ДeфЗнaч>]]) [Экспорт]

//Объявления локальных переменных;

//Операторы;

...

[Возврат;]

//Операторы;

...

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

Англоязычный Синтаксис:

Procedure <Имя_проц>([[Val] <Парам1>[=<ДефЗнач>],

... , [Val] <ПарамN>[=<ДефЗнач>]]) [Export]

//Объявления локальных переменных;

//Операторы;

...

[Return;]

//Операторы;

...

EndProcedure

Параметры:

<Имя_проц>

Назначает имя процедуры.

Знач

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

<Парам1>, ..., <ПарамN>

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

=<ДефЗнач>

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

Если параметр при вызове процедуры опущен, то он принимает либо установленное по умолчанию значение (если оно есть) либо принимает «пустое» значение (значение неопределенного типа).

Если параметру не задано значение по умолча­нию и он является последним в списке передавае­мых параметров, то при вызове процедуры его нельзя опускать.

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

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

Экспорт

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

//Объявления локальных переменных

Объявляются локальные переменные, на которые можно ссылаться только в рамках этой процедуры (см. оператор Перем).

//Операторы

Исполняемые операторы процедуры.

Возврат

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

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

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



Описание:

Ключевое слово Процедура начинает секцию исходного текста, выполнение которого можно инициировать из любой точки программного модуля, просто указав Имя_процедуры со списком параметров (если параметры не передают­ся, то круглые скобки, тем не менее, обязательны). Если в глобальном про­граммном модуле в теле описания функции использовано ключевое слово Экспорт, то это означает, что данная процедура является доступной из всех других программных модулей конфигурации. Ключевое слово Экспорт имеет смысл использовать только в глобальном программном модуле.

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

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

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

См. также: «Передача параметров»

Пример:

Перем Глоб;

// Описание процедуры

Процедура МояПроцедура(Пар1, Пар2, ПарЗ) Экспорт

Глоб = Глоб + Пар1 + Пар2 + ПарЗ;

Возврат;

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

Глоб = 123;

МояПроцедура(5, 6, 7);   // Вызов процедуры


Процедуры и функции компоненты «Бухгалтерский учет»


Процедуры и функции этого раздела используются только при наличии компоненты «Бухгалтерский учет».



Процедуры работы с транзакциями


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

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

Для начала транзакции используется процедура НачатьТранзацию. Для фиксации сделанных в процессе выполнения изменений применяется процеду­ра ЗафиксироватьТранзакцию. Для отмены изменений, сделанных в процес­се выполнения транзакции — процедура ОтменитьТранзакцию. Таким обра­зом, все действия с базой данных, выполняемые внутри скобок: НачатьТранзакцию — ЗафиксироватьТранзацию собственно и являются транзакцией.

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

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

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

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



Продолжить


Передача управления в начало цикла.

Синтаксис:

Продолжить;

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

Continue;

Описание:

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

Пример:

// Выведем строки текста начиная с 5

Выв = СоздатьОбъект("Текст");

Выв.Открыть("ТТТ");

Для i = 1 По Выв.КоличествоСтрок() Цикл

   Если i < 5 Тогда

      Продолжить;

   КонецЕсли;

   Сообщить(Выв.ПолучитьСтроку(i));

КонецЦикла;



Пропись


Задать образец вывода числа прописью.

Синтаксис:

Пропись(<Образец>)

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

Spelling

Параметры:

<Образец>

Необязательный параметр. В данном параметре можно передавать:

-строковое выражение, задающее имя файла про­писи (в поставляемом комплекте файлы прописей имеют расширение .SPL);

- объект типа «СписокЗначений» в котором в специальном формате задан образец прописей.

Если параметр <Образец> пустой или состоит из пробелов, то устанавливается образец прописей по умолчанию (файл 1CV7.spl).

Описание:

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

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

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

{"Speller",

{"Money",

{"Рубль", "Рубля", "Рублей", "Копейка", "Копейки", "Копеек", "М"}},

Ниже приводится фрагмент текста файла, содержащий образец прописи для валюты женского рода (добавляется параметр "F" в описание названия валю­ты):

{"Speller",

{"Money",

{"условная единица", "Условные единицы", "Условных единиц", "Сотая", "Сотые",

"Сотых", "F"}},

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

Money

Numbers

Date

DateRange

WeekDay

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

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

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

Пример:

Процедура Печать(Тип)

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

   // ...

   Пропись("1cue.spl");  // задаем имя файла прописи

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

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

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

   Пропись("");

   // возвращаем значение прописи по умолчанию

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



ПросмотрИстории


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

Синтаксис:

ПросмотрИстории(<СписокРеквизитов>)

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

ViewHistory

Параметры:

<СписокРеквизитов>

Строка со списком идентификаторов (через запя­тую) тех реквизитов, просмотр истории которых допускается.

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

Текущий (на момент до вызова метода) список реквизитов, просмотр исто­рии которых допускается просмор истории.

Описание:

Метод ПросмотрИстории позволяет установить список реквизитов для ко­торых допускается просмор истории .

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

Пример:

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

   ПросмотрИстории;"Оклад, Тариф, Подразделение");

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



ПросмотрИстории


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

Синтаксис:

ПросмотрИстории(<СписокРеквизитов>)

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

ViewHistory

Параметры:

<СписокРеквизитов>

Строка со списком идентификаторов (через запя­тую) тех реквизитов, просмотр истории которых допускается.

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

Текущий (на момент до вызова метода) список реквизитов, просмотр исто­рии которых допускается просмор истории.

Описание:

Метод ПросмотрИстории позволяет установить список реквизитов для ко­торых допускается просмор истории .

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

Пример:

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

   ПросмотрИстории("Оклад, Тариф, Подразделение");

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



Пров


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

Синтаксис:

Пров(<НомерПроводки>, <НомерКорреспонденции>)

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

Entry

Параметры:

<НомерПроводки>

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

<НомерКорреспонденции>

Необязатальный параметр. Число — номер корреспонденции в проводке. Параметр име­ет смысл, если указан параметр <НомерКорреспонденции>.

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

Ссылка на указанную проводку.

Описание:

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

Метод Пров позволяет обратится к атрибутам проводки Сумма, СуммаВал, Количество, Валюта, Дебет, Кредит, <Реквизит>.

Пример:

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

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

Сообщить(Пров(2, 3).Дебет.Счет);



Проведен


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

Синтаксис:

Проведен()

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

IsTransacted

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

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

Описание:

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

Пример:

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

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

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

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

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

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

      Если Док.Проведен() > 0 Тогда

         // для проведенных документов выведем сообщение

         Сообщить(Строка(Док.Вид())+" № "+Док.НомерДок+" от "+Док.ДатаДок);

      КонецЕсли;

   КонецЦикла;

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



Проверить


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

Синтаксис:

Проверить(<Докум>)

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

Validate

Параметры:

<Докум>

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

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

Число: 1 если последовательность непрерывна; 0 если есть проведенные до­кументы между ГП и документом.

Описание:

Метод Проверить проверяет, есть ли между ГП и данной точкой проведен­ные документы входящие в даную последовательность (т. е. является ли после­довательность непрерывной от ГП до этой точки).

Пример:

Если Последовательность.УправленческийУчет.Проверить(Док) = 1 Тогда

   Последовательность.УправленческийУчет.Установить(Док);

КонецЕсли;




ПроверитьПроводку


Проверить проводку на соответствие корректным проводкам.

Синтаксис:

ПроверитьПроводку()

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

CheckEntry

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

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

Описание:

Метод ПроверитьПроводку проверяет проводку на соответствие коррект­ным проводкам.

Пример:

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

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

Пока Опер.КоличествоПроводок() > 0 Цикл

   Опер.ПолучитьПроводкуПоНомеру(1);

   Если Опер.ПроверитьПроводку() = 0 Тогда

      Опер.УдалитьПроводку();

   КонецЕсли;

КонецЦикла;

Опер.Записать();



Провести


Выполнить проведение документа.

Синтаксис:

Провести(<Режим>, <3нач>)

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

MakeActions

Параметры:

<Режим>

Необязательный параметр. Числовое выраже­ние: 0 — проводить документ без сдвига ТА; 1 — проводить непроведенный документ реальным вре­менем (со сдвигом ТА); 2 — перепроводить прове­денный документ реальным временем (со сдвигом ТА); 3 —проводить любой (непроведенный, прове­денный) документ реальным временем (со сдвигом ТА). Значение по умолчанию — 0.

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

провести документ тем временем, каким он был записан, т. е. фактически задним временем (до ТА);

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

<3нач>

Необязательный параметр. Выражение произволь­ного типа. Значение данного параметра будет пере­дано системой в качестве параметра при запуске предопределенной процедуры ОбработкаПроведения. Использовать данное зна­чение можно, например, для того, чтобы в процеду­ре ОбработкаПроведения правильно отработать режим проведения, т. к. это программный, а не ин­терактивный и не групповой (см. ГрупповаяОбработка) способ проведения. По умолчанию передается пустое значение.

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

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

Описание:

Метод Провести запускает процедуру проведения документа. Возвращае­мое значение можно использовать, например, в качестве условия принятия ре­шения при завершении обработки транзакции.

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

Замечание. Если этот метод применяется в Модуле формы документа непо­средственно к документу локального контекста, то данный метод отраба­тывает те же действия, как интерактивное нажатие пользователем кнопки с формулой "#Провести". В этом случае, если параметр <Режим> опу­щен, то документ проводится в режиме, соответствующем установкам сис­темы меню «Сервис» - «Параметры».

Пример:

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

Док.АвтоВремяТекущее();

Док.Новый();

Док.УстановитьНовыйНомер("Прг-");

Док.Клиент = Константа.ОсновнойКлиент;

Док.Количество = 5;

Док.Записать();

Док.Провести(1, "Программно");

См. также: ОбработкаПроведения, ГруппроваяОбработка



ПроводитьПослеТА


Установить режим проведения документа после ТА.

Синтаксис:

ПроводитьПослеТА(<ФлагДляНеПровДокумента>, <ФлагДляПровДокумента>)

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

PostingAfterTA

Параметры:

<ФлагДляНеПровДокумента>

Режим проведения документа после ТА. Число: -1 (минус единица) — проводить документ всегда задним числом; 0 — при проведении запрашивать режим проведе­ния документа; 1 — проводить документ в реальном потоке времени, т. е. при про­ведении время документа автоматически устанавливается на время после ТА.

<ФлагДляПровДокумента>

Режим перепроведения документа после ТА. Числовое выражение: -1 (минус еди­ница) — проводить документ всегда зад­ним числом; 1 — проводить документ в потоке.

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

Текущее значение режим перепроведения документа в зависимости от про-веденности.

Описание:

Метод ПроводитьПослеТА устанавливает режим проведения документа после ТА. Этот метод относится к случаю проведения документа в пределах даты, в которой находится ТА. Дело в том, что при записи документа, документ кроме даты получает еще и время документа. В многопользовательском режиме часто возникает ситуация, когда в момент проведения документа, он уже ока­зывается не последним в потоке проводимых документов (провели документ с другого рабочего места), в этом случае система ЮПредприятие дает на выбор три варианта проведения:

провести документ тем временем, каким он был записан, т. е. фактически задним временем (до ТА);

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

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

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

Пример:

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

   ПроводитьПослеТА(1, 1);

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



ПроводкаВыбрана


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

Синтаксис:

ПроводкаВыбрана()

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

EntrySelected

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

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

Описание:

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

Пример:

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

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

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

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

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

   Сообщить("Нет проводок в операции");

КонецЕсли;



ПустаяСтрока


Проверить строку на наличие значащих символов.

Синтаксис:

ПустаяСтрока(<Строка>)

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

IsBlankString

Параметры:

<Строка>

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

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

Числовое значение. 1 — пустая строка или только пробелы. 0 — не пустая строка.

Описание:

Функция ПустаяСтрока проверяет переданный параметр <Строка> на наличие значащих символов (любых кроме пробелов) и возвращает число 1, если строка пустая или содержит только пробелы, 0 , если строка не пустая.

Пример:

Если ПустаяСтрока(Буфер) = 1 Тогда

   // если Буфер содержит только пробелы, то его удаляем

   Буфер = "";

КонецЕсли;



ПустоеЗначение


Проверить значение любого типа.

Синтаксис:

ПустоеЗначение(<3начение>)

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

Empty Value

Параметры:

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

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

Функция возвращает числовое значение: 1 — значение пустое; 0 — значение не пустое.

Описание:

Функция ПустоеЗначение определяет, является ли пустым переданное в параметре значение. При этом применяется следующее правило:

-             значение неопределенного типа — всегда пустое;

-             значение типа «строка» проверяется как в методе ПустаяСтрока;

-             значение типа «число» проверяется на равенство нулю;

-             значение типа «дата» проверяется на пустое значение;

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

Пример:

Если ПустоеЗначение(Код) = 1 Тогда

   Предупреждение("Задайте непустое значение Кода !!!");

КонецЕсли;



РабочаяДата


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

Синтаксис:

РабочаяДата(<Дата>, <РежимСменыРабДаты>)

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

WorkingDate

Параметры:

<Дата>

Необязательный параметр. Выражение типа «дата».

<РежимСменыРабДаты>

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

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

Значение текущей рабочей даты (на момент до выполнения функции).

Описание:

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

Пример:

// оклад сотрудника на текущую рабочую дату

Сотрудник.Оклад.Получить(РабочаяДата());



Работа с индексными файлами


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



Работа с основными итогами


Основными итогами

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

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

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

По умолчанию используется период, выбранный пользователем интерак­тивно через меню «Сервис»-«Параметры»- «Бухгалтерские итоги».



Работа с результатами запроса


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



Работа с временными итогами


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

Для получения временных итогов используются теже методы, что и для по­лучения основных итогов (СНД, СНК , СКД , СКК, ДО, КО, ОБ и другие). Параметры метода Рассчитать определяют итоги, которые будут доступны для получения этими методами.



Работа системы 1С:Предприятие в качестве DDE сервера


Другим способом обращения к данным 1С:Предприятие а из внешних про­грамм является режим DDE. Основное преимущество данного режима является динамическое обновление получаемых из 1С:Предприятие данных.

Система 1С:Предприятие является DDE сервером и предоставляет свой сер­вис в получении данных и уведомлении DDE клиента об их изменении.

В качестве DDE сервера 1С:Предприятие может возвращать значение неко­торого выражения, записанного на встроенном языке 1С:Предприятие. Возвра­щаемое значение является строкой. Для того, чтобы рассматривать результат выражения в качестве числа или даты, например в ячейке MS Excel, может потребоваться задание формата значения.

Для доступа к 1С:Предприятие посредством DDE следует использовать DDE-объект с именем 1CV7|DDE.

Пример:

* Ниже приведены примеры размещения в ячейках MS Excel DDE связей с программой 1С:Предприятие. Первое выражение в примере обращается к стандартной функции встроенного языка 1С:Предприятие. Второе выраже­ние в примере обращается к функции, записанной в глобальном модуле конфигурации программы 1С:Предприятие.

='1CV7'|DDE!'РабочаяДата()'

='1CV7'|DDE!'СуммаПоНарядам()'

Замечание 1: Для правильной интерпретации значения выражения в качестве числа или даты в MS Excel, нужно в операционной системе установить соответствующий формат представления даты и числа, как он принят в 1С:Предприятие.

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



Работа системы 1С:Предприятие в качестве OLE Automation сервера


Система 1С:Предприятие может быть запущена внешним приложением в качестве OLE Automation сервера и предоставляет доступ ко всем атрибутам и методам своего глобального контекста (см. «Контекст выполнения программно­го модуля»). Кроме того, OLE-сервер 1С:Предприятие имеет дополнительные методы, с помощью которых можно выполнить последовательность операторов или вычислить выражение, заданное на встроенном языке 1С:Предприятие.

Для запуска системы 1С:Предприятие в качестве OLE Automation сервера из внешнего приложения, выполняется следующая последовательность дейст­вий:

создается объект с OLE идентификатором:

o        V1СEnterprise.Application — версия независимый ключ;

o        V77.Application — версия зависимый ключ;

o        V77S.Application — версия зависимый ключ, SQL версия;

o        V77L.Application — версия зависимый ключ, локальная версия;

o        V77M.Application — версия зависимый ключ, сетевая версия.

выполняется инициализация системы 1С:Предприятие методом Initialize.

вызываются атрибуты и методы системы 1С:Предприятие как OLE Automation сервера

Замечание 1: Поскольку программа 1С:Предприятие является одновременно OLE Automation сервером и OLE Automation клиентом, то возможно из 1С:Предприятие обращаться к другой копии 1С:Предприятие (например, к другой конфигурации) для обмена данными. В основном все современ­ные программные продукты поддерживают механизм OLE Automation, это касается в частности MS Office, MS FoxPro и приложений на них на­писанных, DAO и т. п., поэтому программа 1С:Предприятие может полно­стью интегрироваться с ними.

Замечание 2: Не локализованные версии внешних программ, обращающихся к программе 1С:Предприятие посредством OLE Automation, могут непра­вильно интерпретировать русские идентификаторы объектов агрегатных типов данных, например, реквизитов справочников. Данное замечание не относится к продуктам MS Office и к программам, использующим в каче­стве языка обращения к OLE объектам Microsoft Visual Basic. Рекоменду­ется использовать локализованные версии программных продуктов, либо в конфигурации использовать идентификаторы без символов кириллицы. Для обращения к атрибутам и методам агрегатных типов данных системы 1С:Предприятие из внешних приложений рекомендуется использовать их англоязычные синонимы.

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



Работа в режиме запроса


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

После выполнения запроса с помощью специального набора методов объек­та «Бухгалтерские Итоги» осуществляется получение итогов, полученных дан­ным запросом. К этим методам относятся методы обхода итогов в различных разрезах (сформированных запросом) и методы для получения собственно ито­гов. Кроме того специальный набор атрибутов объекта «Бухгалтерские Итоги» позволяет обращаться процессе обхода результатов запроса к значениям полу­ченных группировок.



Рамка


Установить рамки всех ячеек области.

Синтаксис:

Рамка(<РамкаСлева>, <РамкаСверху>, <РамкаСправа>, <РамкаСнизу>)

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

Border

Параметры:

<РамкаСлева>

<РамкаСверху> <РамкаСправа> <РамкаСнизу>

Необязательные параметры. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если какой либо параметр опущен, то соответствующая рамка ячеек области не изменяется.

Описание:

Метод Рамка устанавливает рамки всех ячеек области.

Пример:

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

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

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

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

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

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

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

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

ВыбОбласть.Рамка(0, 3, 3, 3);



РамкаОбвести


Установить рамки по краям области.

Синтаксис:

РамкаОбвести(<Рамка Слева>, <РамкаСверху>, <РамкаСправа>, <РамкаСнизу>)

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

BorderOutline

Параметры:

<РамкаСлева>

<РамкаСверху> <РамкаСправа> <РамкаСнизу>

Необязательные параметры. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если какой либо параметр опущен, то соответствующая рамка ячеек области не изменяется.

Описание:

Метод РамкаОбвести устанавливает рамки по краям области.

Пример:

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

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

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

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

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

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

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

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

ВыбОбласть.РамкаОбвести(0, 3, 3, 3);



РамкаСлева


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

Синтаксис:

РамкаСлева(<Рамка>)

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

LeftBorder

Параметры:

<Рамка>

Необязательный параметр. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если пара­метр опущен, то рамка слева области не изменяется.

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

Рамка слева до исполнения метода.

Описание:

Метод РамкаСлева устанавливает рамку слева области.

Пример:

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

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

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

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

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

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

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

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

ВыбОбласть.РамкаСлева(3);



РамкаСнизу


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

Синтаксис:

РамкаСнизу(<Рамка>)

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

BottomBorder

Параметры:

<Рамка>

Необязательный параметр. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если пара­метр опущен, то рамка снизу области не изменяется.

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

Рамка снизу до исполнения метода.

Описание:

Метод РамкаСнизу устанавливает рамку снизу области.

Пример:

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

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

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

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

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

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

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

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

ВыбОбласть.РамкаСнизу(3 );



РамкаСправа


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

Синтаксис:

РамкаСправа(<Рамка>)

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

RightBorder

Параметры:

<Рамка>

Необязательный параметр. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если параметр опущен, то рамка справа области не изменяется.

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

Рамка справа до исполнения метода.

Описание:

Метод РамкаСправа устанавливает рамку справа области.

Пример:

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

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

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

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

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

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

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

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

ВыбОбласть.РамкаСправа(3);



РамкаСверху


Получить/установить рамку сверху области.

Синтаксис:

РамкаСверху(<Рамка>)

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

TopBorder

Параметры:

<Рамка>

Необязательный параметр. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если пара­метр опущен, то рамка сверху области не изменяется.

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

Рамка сверху до исполнения метода.

Описание:

Метод РамкаС верху устанавливает рамку сверху области.

Пример:

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

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

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

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

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

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

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

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

ВыбОбласть.РамкаСверху(3);



Расход


Флаг движения регистра «расход».

Синтаксис:

Расход

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

Outcome

Описание:

Атрибут Расход содержит значение флага записи движения регистра и ис­пользуется только при обращении к существующим записям движений регист­ров. Данный атрибут только для чтения. Атрибут Расход может принимать числовое значение 1 — если текущее движение регистра расход, 0 — если нет.

Данный атрибут не имеет смысла для оборотных регистров.

Пример:

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

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

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

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

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

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

         Продолжить;

      КонецЕсли;

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

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

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

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

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

      Иначе

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

      КонецЕсли;

   КонецЦикла;

КонецЕсли;



РасположениеФайла


Определить, где располагается данный внешний отчет.

Синтаксис:

РасположениеФайла(<Путь>, <Имя>)

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

FilePath

Параметры:

<Путь>

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

<Имя>

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

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

Строковое значение полного имени (вместе с путем) файла, где располага­ется данный внешний отчет.

Описание:

Метод РасположениеФайла позволяет узнать, где располагается данный внешний отчет.

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

Пример:

Имя = "";

Путь = "";

ПолноеИмя = РасположениеФайла(Путь, Имя);



Рассчитана


Признак того, что запись рассчитана.

Синтаксис:

Рассчитана

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

Calculated

Описание:

Атрибут типа «число», принимает два значения: 1 — для рассчитанных за­писей журнала расчетов и 0 — для нерассчитанных записей.

Запись журнала расчетов становится рассчитанной в результате удачного выполнения одной из соответствующих команд меню «Действия» или при вы­полнении методов журнала расчетов Рассчитать, ВыпролнитьРасчет.

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

Пример:

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

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

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

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

ПлохоДело=0;

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

   Если ЖрнЗарплата.Рассчитана = 0 Тогда

      ПолохоДело = 1;

      Прервать;

   КонецЕсли;

КонецЦикла;

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

   Предупреждение("Не проведен полный расчет сотрудника!

                   | Формирование отчета невозможно");

   Возврат;

КонецЕсли;

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

См. также: Исправлена, Фиксирована



Рассчитать


Расчет временных итогов.

Синтаксис:

Рассчитать(<НачалоПериода>, <КонецПериода> , <ФильтрПоСчетам>, <ТолькоСинтетика> , <ПланСчетов>, <РазделительУчета>)

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

Calculate

Параметры:

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

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

<ФильтрП, рСчетам> Необязательный параметр. Счета, для которых

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

<ТолькоСинтетика> Необязательный параметр:

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

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

<ПланСчетов> Необязательный параметр. Значение типа «План Счетов». Ограничение расчета одним планом сче­тов.

<РазделительУчета> Необязательный параметр. Значение разделителя учета. Ограничение расчета одним значением раз­делителя учета.

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

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

Описание:

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

Если из двух параметров периода задан только параметр начала периода, метод Рассчитать вычислит начальные остатки — без оборотов. Наоборот, если задан параметр конца периода, будут вычисленные конечные остатки.

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

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

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

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

Пример:

БухИтоги.Рассчитать(ДатаНач, ДатаКон);



Рассчитать


Провести расчет текущей записи.

Синтаксис:

Рассчитать()

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

Calculate

Описание:

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

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

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

Пример:

// Рассчитаем все основные средства категории определенного типа

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

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

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

   Если ЖР.Объект.Тип = Тип;

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

   КонецЕсли;

КонецЦикла;

См. также: ВыполнитьРасчет



РассчитатьРегистрыНа


Рассчитать все временные регистры на начало события.

Синтаксис:

РассчитатьРегистрыНа(<ГраницаРасчета>, <ГрафаОтбора>)

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

CalcRegsOnBeg

Параметры:

<ГраницаРасчета>

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

<ГpaфaOтбopa>

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

Описание:

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

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

Пример:

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

// регистра УчетРеализации

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

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

РассчитатьРегистрыНа(ТекущийДокумент());

Рег.Товар = Товар;

Рег.Клиент = Клиент;

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

ТекОстаток = Рег.ОстатокТовара;

ТекСтоимость = Рег.Стоимость;

ТекПродСтоимость = Рег.ПродСтоимость;



РассчитатьРегистрыНа


Рассчитать все временные регистры на начало события.

Синтаксис:

РассчитатьРегистрыНа(<ГраницаРасчета>, <ГрафаОтбора>)

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

CalcRegsOnBeg

Параметры:

<ГраницаРасчета>

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

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

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

Описание:

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

Пример:

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

// регистра УчетРеализации

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

Рег = СпецРег.УчетРеализации;

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

СпецРег.РассчитатьРегистрыНа(ТекущийДокумент());

Рег.Товар = Товар;

Рег.Клиент = Клиент;

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

ТекОстаток = Рег.ОстатокТовара;

ТекСтоимость = Рег.Стоимость;

ТекПродСтоимость = Рег.ПродСтоимость;