ПриСменеРасчетногоПериода
Предопределенная процедура, вызываемая при смене текущего расчетного периода журнала расчетов.
Синтаксис:
ПриСменеРасчетногоПериода(<ЖурналРасчетов>, <Период>)
Англоязычный синоним:
OnРег1odChange
Параметры:
<ЖурналРасчетов> |
Журнал расчетов, период которого изменяется (агрегатный объект типа «ЖурналРасче-тов»). |
<Период> |
Устанавливаемый расчетный период (значение типа «ПериодРасчета»). |
Описание:
Вызов предопределенной процедуры ПриСменеРасчетногоПериода на исполнение производится системой 1C:Предприятие неявно при попытке смены текущего расчетного периода любого журнала расчетов. Если в данной предопределенной процедуре установить статус возврата — 0, то текущий расчетный период не будет изменен.
Данная предопределенная процедура может располагаться только в глобальном программном модуле.
Пример:
Процедура ПриСменеРасчетногоПериода(ЖР, Период)
Если ЖР.Вид() = "Зарплата" Тогда
Предупреждение("Это смена текущего расчетного периода для журнала
| Зарплата");
КонецЕсли;
Если Период.ДатаНачала <= ЖР.НачалоТекущегоПериода Тогда
//не позволяем откатывать период назад
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПрисоединитьСекцию
Присоединить секцию исходной таблицы-шаблона к результирующей таблице.
Синтаксис:
ПрисоединитьСекцию(<Секция>)
Англоязычный синоним:
AttachSection
Параметры:
<Секция> Выражение типа строка, задающее имя выводимой секции, или значение типа секция, полученное при помощи метода ПолучитьСекцию.
Возвращаемое значение: Нет.
Описание:
Метод ПрисоединитьСекцию выполняет присоединение именованной секции из исходной таблицы-шаблона к результирующей таблице. Имя секции задается строковым выражением следующего формата:
ИдентификаторСекции1[<|>|-][|ИдентификаторСекции2[<|>|-]]
Символы "<" , ">" , "-" после идентификатора секции указывают на то, что выбирается только часть секции:
< |
заголовочная часть (с начала секции до начала вложенной секции). |
> |
подвальная часть (с конца вложенной секции до конца секции). |
— |
средняя часть (собственно вложенная секция). |
В выражении <Секция> можно задавать имена двух секций, разделенных знаком "|". При этом перенесена будет область исходной таблицы, являющаяся пересечением первой и второй указанных секций. При этом одна секция может быть горизонтальной (состоять из строк), а другая — вертикальной (состоять из колонок). В результате перенесется прямоугольная область таблицы.
Если в качестве параметра метода задано строковое значение имени секции, то при переносе ячейки таблицы, имеющие тип «Шаблон» и «Выражение», будут заполнены соответствующими данными.
Метод ПрисоединитьСекцию помещает новую секцию в следующей колонке, правее последней ранее выведенной секции. При этом секция, передаваемая в качестве параметра метода ПрисоединитьСекцию, должна иметь прямоугольную форму, т. е. задаваться как пересечение горизонтальных и вертикальных секций.
Пример:
См. предыдущий пример.
ПриУдаленииДокумента
Предопределенная процедура при удалении документа и при отмене пометки на удаление.
Синтаксис:
ПриУдаленииДокумента(<УдалДокум>, <Режим>)
Англоязычный синоним:
OnDeleteDoc
Параметры:
<УдалДокум> |
Значение удаляемого документа. |
<Режим> |
Значение флага непосредственного удаления: 1 — непосредственное удаление; 0 — пометка на удаление. |
Описание:
Вызов предопределенной процедуры ПриУдаленииДокумента производится системой 1С:Предприятие неявно при интерактивном удалении документа и в случае отмены пометки на удаление. В этом случае, условия вызова можно узнать методом ПометкаУдаления документа. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если не истек срок хранения документа), то удаление документа не будет выполнено.
Данная предопределенная процедура может располагаться только в глобальном программном модуле.
Пример:
Процедура ПриУдаленииДокумента(Док, Реж)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если (Док.Вид() = "РасходнаяНакл") И (Реж = 1) Тогда
Предупреждение("У вас нет права удалять накладную!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУдаленииИстории
Предопределенная процедура при удалении в окне «История» значения периодического реквизита элемента справочника или константы.
Синтаксис:
ПриУдаленииИстории(<ТипОбъекта>, <Объект>, <3начение>, <ДатаИстории>)
Англоязычный синоним:
OnDeleteHistory
Параметры:
<ТипОбъекта> |
Название периодического объекта конфигурации, как оно задано в конфигураторе (например, "Справочник.Валюты.ТекущийКурс" или " Константа. ИмяДиректора"). Строковое название агрегатного типа данных может передаваться системой в русском или англоязычном написании (Справочник или Reference, Константа или Const) — в зависимости от установки флага основного языка системы (см. ОсновнойЯзык). |
<Объект> |
Элемент справочника, для которого выполняется изменение периодического реквизита. Имеет смысл только для периодических реквизитов справочников, а не для констант. |
<3начение> |
Значение периодической записи. |
<ДатаИстории> |
Дата периодической записи. |
Описание:
Вызов предопределенной процедуры ПриУдаленииИстории производится системой 1С:Предприятие неявно при интерактивном удалении периодической записи в окне «История». Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю запрещено изменение периодических реквизитов), то удаления периодического значения не будет выполнено.
Данная предопределенная процедура может располагаться только в глобальном программном модуле.
Пример:
Процедура ПриУдаленииИстории(ТипОб, Об, Значен, ДатаИстор)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если (ТипОб = "Справочник.Валюты.ТекКурс") И
(Об=Константа.ОсновнаяВалюта) И (ДатаИстор < РабочаяДата() - 7) Тогда
// Удаляется курс для валюты, которая записана в Константе
Предупреждение("У вас нет права удалять прошлый курс!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата, ОсновнойЯзык
ПриУдаленииЭлемента
Предопределенная процедура при удалении элемента справочника и при отмене пометки на удаление.
Синтаксис:
ПриУдаленииЭлемента(<УдалЭлем>, <Режим>)
Англоязычный синоним:
OnDeleteItem
Параметры:
<УдалЭлем> |
Значение удаляемого элемента справочника. |
<Режим> |
Значение флага непосредственного удаления: 1 — непосредственное удаление; 0 — пометка на удаление. |
Описание:
Вызов предопределенной процедуры ПриУдаленииЭлемента производится системой 1С:Предприятие неявно при интерактивном удалении элемента справочника и в случае отмены пометки на удаление. В этом случае, условия вызова можно узнать методом ПометкаУдаления элемента справочника. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если нарушается ссылочная целостность системы), то удаление элемента справочника не будет выполнено.
Данная предопределенная процедура может располагаться только в глобальном программном модуле.
Пример:
Процедура ПриУдаленииЭлемента(Элем, Реж)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если (Элем.Вид() = "Товар") И (Реж = 1) Тогда
Предупреждение("У вас нет права удалять Товар!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУдаленииСчета
Предопределенная процедура, выполняемая при удалении бухгалтерского счета.
Синтаксис:
ПриУдаленииСчета(<УдалСчет>, <Режим>)
Англоязычный синоним:
OnDeleteAccount
Параметры:
<УдалСчет> |
Значение типа «Счет» — удаляемый бухгалтерский счет. |
<Режим> |
Режим удаления. Может принимать значения: 1 — счет будет удален; 0 — счет будет помечен на удаление. |
Описание:
Вызов предопределенной процедуры ПриУдаленииСчета производится системой 1С:Предприятие неявно при интерактивном удалении счета из плана счетов. В качестве параметров в процедуру передаются значение удаляемого счета и режим удаления: непосредственное удаление или пометка на удаление.
Если в данной процедуре установить статус возврата 0 (например, если нарушается ссылочная целостность системы), то счет не будет удален (или помечен на удаление).
Данная предопределенная процедура может располагаться только в глобальном программном модуле.
Пример:
Процедура ПриУдаленииСчета(УдСчет)
Если УдСчет.Валютный() = 1 Тогда
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУдаленииСтроки
Предопределенная процедура при удалении строки многострочной части документа.
Синтаксис:
ПриУдаленииСтроки()
Англоязычный синоним:
OnDeleteLine
Описание:
Вызов предопределенной процедуры ПриУдаленииСтроки производится в системе 1С:Предприятие при интерактивном удалении строки многострочной части документа. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя изменять документ), удаление строки документа не будет выполнено.
Данная предопределенная процедура может располагаться только в Модулях формы документов (см. «Виды программных модулей»).
Пример:
Процедура ПриУдаленииСтроки()
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права удалять строки!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУдаленииСтроки
Предопределенная процедура при удалении проводки или корреспонденции операции.
Синтаксис:
ПриУдаленииСтроки()
Англоязычный синоним:
OnDeleteLine
Описание:
Вызов предопределенной процедуры ПриУдаленииСтроки производится в системе 1С:Предприятие при интерактивном удалении проводки или корреспонденции операции.
Если в данной предопределенной процедуре установить статус возврата 0 (например, если данному пользователю нельзя редактировать проводки операции), удаление проводки или корреспонденции операции не будет выполнено.
Данная предопределенная процедура может располагаться только в модуле формы операции (см. «Виды программных модулей»).
Пример:
Процедура ПриНачалеРедактированияСтроки()
Если НазваниеНабораПрав() = "Оператор" Тогда
Предупреждение("У вас нет права изменять проводки!");
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУстановкеГраницыПросмотра
Предопределенная процедура, вызываемая при установке границы (по периоду регистрации записи) просматриваемых в журнале расчетов записей.
Синтаксис:
ПриУстановкеГраницыПросмотра(<Период>)
Англоязычный синоним:
OnSetViewBound
Параметры:
<Период> |
Значение типа «Период журнала расчетов». Период, устанавливаемый пользователем как граница просмотра записей. |
Описание:
Вызов этой предопределенной процедуры производится системой 1С:Предприятие неявно при интерактивной попытке установить другую границу просмотра записей в журнале расчетов. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя просматривать расчеты определенной «давности»), установка не будет выполнена.
Данная предопределенная процедура может располагаться только в модуле формы журнала расчетов.
Пример:
Процедура ПриУстановкеГраницыПросмотра(Период)
Если НазваниеНабораПрав() = "Расчетчик" Тогда
ТП = ТекущийПериод();
// не позволим смотреть более чем на три периода назад
МинПер = ТП.ПрибавитьПериод(-3);
Если (Период.ДатаНачала<МинПер.ДатаНачала) Тогда
Предупреждение("Недостаточно прав 1", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата, ГраницаПросмотра
ПриУстановкеИнтервала
Предопределенная процедура при установке интервала журнала.
Синтаксис:
ПриУстановкеИнтервала(<ДатаНач>, <ДатаКон>)
Англоязычный синоним:
OnSetRange
Параметры:
<ДатаНач> |
Дата начала интервала журнала. |
<ДатаКон> |
Дата конца интервала журнала. |
Описание:
Вызов предопределенной процедуры ПриУстановкеИнтервала производится системой 1C:Предприятие неявно при интерактивной попытке установить интервал в журнале документов. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя изменять интервал журнала), установка не будет выполнена.
Пример:
Процедура ПриУстановкеИнтервала(ДатаНач, ДатаКон) Если
НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права изменять интервал журнала! , 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
![](image/jelementjazyka_1.gif)
This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.
ПриУстановкеИнтервала
Предопределенная процедура при установке интервала журнала.
Синтаксис:
ПриУстановкеИнтервала(<ДатаНач>, <ДатаКон>)
Англоязычный синоним:
OnSetRange
Параметры:
<ДатаНач> |
Дата начала интервала журнала. |
<ДатаКон> |
Дата конца интервала журнала. |
Описание:
Вызов предопределенной процедуры ПриУстановкеИнтервала производится системой 1С:Предприятие неявно при интерактивной попытке установить интервал в журнале документов. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя изменять интервал журнала), установка не будет выполнена.
Пример:
Процедура ПриУстановкеИнтервала(ДатаНач, ДатаКон)
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права изменять интервал журнала!", 2);
СтатусВозврата(0);
КюнецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
![](image/jelementjazyka_1.gif)
This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.
ПриУстановкеИнтервала
Предопределенная процедура при установке интервала журнала.
Синтаксис:
ПриУстановкеИнтервала(<ДатаНач>, <ДатаКон>)
Англоязычный синоним:
OnSetSelectInJournal
Параметры:
<ДатаНач> |
Дата начала интервала журнала. |
<ДатаКон> |
Дата конца интервала журнала. |
Описание:
Вызов предопределенной процедуры ПриУстановкеИнтервала производится системой 1С:Предприятие неявно при интерактивной попытке установить интервал в журнале документов. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя изменять интервал журнала), установка не будет выполнена.
Пример:
Процедура ПриУстановкеИнтервала(ДатаНач, ДатаКон)
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права изменять интервал журнала!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУстановкеОтбора
Предопределенная процедура при установке отбора.
Синтаксис:
ПриУстановкеОтбора(<ИмяРеквизОтбора>, <3начение>)
Англоязычный синоним:
OnSetSelectInJournal
Параметры:
<ИмяРеквизОтбора> |
Строковое значение — название общего реквизита документа (как оно задано в конфигураторе), по которому производится отбор (например, "Автор"). |
<3начение> |
Значение реквизита отбора. Допустим, у документов существует общий реквизит "Автор", по которому решено провести отбор, значит в этом параметре будет передано конкретное значение этого реквизита, по которому решено провести отбор (например, "Сидоров И.А."). |
Описание:
Вызов предопределенной процедуры ПриУстановкеОтбора производится самой системой 1С:Предприятие неявно при интерактивной попытке установить отбор документов в журнале. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя устанавливать данное значение отбора документов), установка не будет выполнена.
Данная предопределенная процедура может располагаться в глобальном программном модуле и модуле формы журнала. Если данная процедура присутствует в модуле формы соответствующего журнала, то будет вызвана она, если нет, то будет вызвана процедура из глобального модуля.
Пример:
Процедура ПриУстановкеОтбора(ИмяОтбора, ЗначОтбора)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если (Имя0тбора = "Автор") И (ЗначОтбора <> ТекущПользователь) Тогда
Предупреждение("У вас нет права просматривать чужие документы!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУстановкеОтбора
Предопределенная процедура при установке отбора справочника.
Синтаксис:
ПриУстановкеОтбора(<ТипОтбора>, <3начение0тбора>)
Англоязычный синоним:
OnSetSelectInJournal
Параметры:
<ТипОтбора> |
Строковое значение — тип устанавливаемого отбора (имя реквизита справочника по которому устанавливается отбор). |
<3начение0тбора> |
Устанавливаемое значение отбора. |
Описание:
Вызов предопределенной процедуры ПриУстановкеОтбора производится в системе 1С:Предприятие при интерактивной установке отбора любым способом (отбор, быстрый отбор, отбор по значению, история отбора) и при отключении отбора. Если в данной предопределенной процедуре установить статус возврата — 0, то установка отбора справочника не будет произведена.
Данная предопределенная процедура может располагаться только в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриУстановкеОтбора(ВыбСпособ)
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("Нельзя устанавливать отбор;", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
![](image/jelementjazyka_1.gif)
This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.
ПриУстановкеОтбора
Предопределенная процедура при установке отбора.
Синтаксис:
ПриУстановкеОтбора(<ИмяРеквизОтбора>, <3начение>)
Англоязычный синоним:
OnSetSelectInJournal
Параметры:
<ИмяРеквизОтбора> |
Строковое значение — название общего реквизита документа (как оно задано в конфигураторе), по которому производится отбор (например, "Автор"). |
<3начение> |
Значение реквизита отбора. Допустим, у документов существует общий реквизит "Автор", по которому решено провести отбор, значит в этом параметре будет передано конкретное значение этого реквизита, по которому решено провести отбор (например, "Сидоров И. А."). |
Описание:
Вызов предопределенной процедуры ПриУстановкеОтбора производится системой 1С:Предприятие неявно при интерактивной попытке установить отбор документов в журнале. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя устанавливать данное значение отбора документов), установка не будет выполнена.
Данная предопределенная процедура может располагаться в модуле формы журнала и в глобальном программном модуле. Если данная процедура присутствует в модуле формы соответствующего журнала, то будет вызвана она, если нет, то будет вызвана процедура из глобального модуля.
Пример:
Процедура ПриУстановкеОтбора(ИмяОтбора, ЗначОтбора) Если
НазваниеНабораПрав() = "Продавец" Тогда
Если (Имя0тбора = "Автор") И (ЗначОтбора <> ТекущПользователь) Тогда
Предупреждение("У вас нет права просматривать чужие документы!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУстановкеОтбора
Предопределенная процедура при установке отбора в журнале операций.
Синтаксис:
ПриУстановкеОтбора(<ИмяОт6ора>, <Значение>)
Англоязычный синоним:
OnSetSelectInJournal
Параметры:
<ИмяОтбора> |
Строковое выражение — имя отбора. |
<ЗначениеОтбора> |
Значение отбора. |
Описание:
Вызов предопределенной процедуры ПриУстановкеОтбора производится системой 1С:Предприятие неявно при интерактивной попытке установить отбор в журнале операций.
Если в данной предопределенной процедуре установлен статус возврата 0 (например, если данному пользователю нельзя устанавливать данное значение отбора операций), установка отбора не будет выполнена.
Данная предопределенная процедура может располагаться в модуле формы журнала операций и в глобальном программном модуле. Если данная процедура присутствует в модуле формы журнала операций, то будет вызвана она, если нет, то будет вызвана процедура из глобального модуля.
Пример:
Процедура ПриУстановкеОтбора(ИмяОтбора, ЗначОтбора)
Если НазваниеНабораПрав() = "Оператор" Тогда
Если (ИмяОтбора = "Автор") И (ЗначОтбораоТекПольз) Тогда
Предупреждение("У вас нет права просматривать чужие Операции!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУстановкеОтбора
Предопределенная процедура при установке отбора в журнале проводок.
Синтаксис:
ПриУстановкеОтбора(<ИмяОтбора>, <Значение>)
Англоязычный синоним:
OnSetSelectInJournal
Параметры:
<ИмяОтбора> |
Строковое выражение — имя отбора. |
<ЗначениеОтбора> |
Значение отбора. |
Описание:
Вызов предопределенной процедуры ПриУстановкеОтбора производится системой 1С:Предприятие неявно при интерактивной попытке установить отбор в журнале проводок.
Если в данной предопределенной процедуре установлен статус возврата 0 (например, если данному пользователю нельзя устанавливать данное значение отбора проводок), установка отбора не будет выполнена.
Данная предопределенная процедура может располагаться в модуле формы журнала проводок и в глобальном программном модуле. Если данная процедура присутствует в модуле формы журнала проводок, то будет вызвана она, если нет, то будет вызвана процедура из глобального модуля.
Пример:
Процедура ПриУстановкеОтбора(ИмяОтбора, ЗначОтбора)
Если (ИмяОтбора = "Счет") И (ЗначОтбора.Валютный = 1) Тогда
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриУстановкеОтбора
Предопределенная процедура, вызываемая при установке отбора в форме журнала расчетов.
Синтаксис:
ПриУстановкеОтбора(<ИмяОтбора>, <ЗначениеОтбора>)
Англоязычный синоним:
OnSetSelection
Параметры:
<ИмяОтбора> |
Строковое значение. Наименование графы отбора, которая выбрана пользователем при интерактивной установке отбора. |
<ЗначениеОтбора> |
Значение отбора, которое выбрано пользователем при интерактивной установке отбора. |
Описание:
Вызов предопределенной процедуры ПриУстановкеОтбора производится системой 1С:Предприятие неявно при интерактивной попытке установить отбор записей в журнале расчетов. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя устанавливать данное значение отбора документов), установка не будет выполнена.
Данная предопределенная процедура может располагаться только в модуле формы журнала расчетов.
Пример:
Процедура ПриУстановкеОтбора(ИмяОтбора, ЗначОтбора)
Если НазваниеНабораПрав() = "Расчетчик" Тогда
Если (ИмяОтбора = "Владелец") И (ЗначОтбора <> ТекущийРасчетчик) Тогда
Предупреждение("Недостаточно прав!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата, УстановитьОтбор, ПолучитьОтбор
ПриУстановкеПредставления
Предопределенная процедура, вызываемая при установке режима представления журнала расчетов (по всем объектам расчетов, по одному объекту расчета, по одному документу расчета).
Синтаксис:
ПриУстановкеПредставления(<Режим>}
Англоязычный синоним:
OnSetPresentation
Параметры:
<Режим> |
Числовое значение — режим представления записей журнала расчетов, устанавливаемый пользователем. |
Описание:
Вызов этой предопределенной процедуры производится системой 1С:Предприятие неявно при интерактивной попытке установить другой режим представления записей в журнале расчетов. Если в данной предопределенной процедуре установить статус возврата 0 (например, если данному пользователю нельзя использовать определенный режим), установка не будет выполнена.
Параметр <Режим> может принимать следующие значения:
1. Записи по всем объектам расчета.
2. Записи по одному объекту расчета.
3. Записи по одному документу-основанию.
Данная предопределенная процедура может располагаться только в модуле формы журнала расчетов.
Пример:
Процедура ПриУстановкеПредставления(Режим)
Если НазваниеНабораПрав() = "Расчетчик" Тогда
Если (Режим = 1) Тогда
Предупреждение("Недостаточно прав!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата, УстановитьПредставление
![](image/jelementjazyka_1.gif)
This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.
ПривязыватьСтроку
Записывать номер строки документа в движениях документа.
Синтаксис:
ПривязыватьСтроку(<НомерСтроки>)
Англоязычный синоним:
LinkLine
Параметры:
<НомерСтроки> |
Выражение, содержащее номер строки документа. |
Описание:
Метод ПривязыватьСтроку устанавливает, что при выполнении всех последующих движений регистров, при записи значений периодических реквизитов справочников с привязкой к документу, а также при записи бухгалтерских проводок движения будут записываться с номером строки <НомерСтроки>.
Метод ПривязыватьСтроку может быть использован как системная процедура: тогда он будет устанавливать номер строки для всех регистров по которым выполняются движения, или как метод конкретного регистра: тогда он будет устанавливать номер строки только для данного регистра.
Данный метод доступен только в контексте Модуля документа в предопределенной процедуре ОбработкаПроведения.
Пример:
Процедура ОбработкаПроведения()
ПривязыватьСтроку(НомерСтроки);
Регистр.ТовЗап.Склад = Склад;
ВыбратьСтроки();
Пока(ПолучитьСтроку() > 0) Цикл
Регистр.ТовЗап.Товар = Товар;
Регистр.ТовЗап.Количество = Количество;
Регистр.ТовЗап.Стоимость = Стоимость;
Регистр.ТовЗап.ДвижениеРасходВыполнить();
КонецЦикла;
КонецПроцедуры
ПривязыватьСтроку
Записать номер строки документа в движении регистра.
Синтаксис:
ПривязыватьСтроку(<НомерСтроки>)
Англоязычный синоним:
LinkLine
Параметры:
<НомерСтроки> Выражение, содержащее номер строки документа
Описание:
Метод ПривязыватьСтроку устанавливает, что при выполнении всех последующих движений регистров, движения будут записываться с номером строки <НомерСтроки>.
Метод ПривязыватьСтроку может быть использован как системная процедура: тогда он будет устанавливать номер строки для всех регистров по которым выполняются движения, или как метод конкретного регистра: тогда он будет устанавливать номер строки только для данного регистра.
Данный метод доступен только в контексте Модуля документа в предопределенной процедуре ОбработкаПроведения (см. Гл. «Работа с Документами»).
Пример:
Процедура ОбработкаПроведения()
Регистр.ТовЗап.Склад = Склад;
ВыбратьСтроки();
Пока(ПолучитьСтроку() > 0) Цикл
Регистр.ТовЗап.ПривязыватьСтроку(НомерСтроки);
Регистр.ТовЗап.Товар = Товар;
Регистр.ТовЗап.Количество = Количество;
Регистр.ТовЗап.Стоимость = Стоимость;
Регистр.ТовЗап.ДвижениеРасходВыполнить();
КонецЦикла;
КонецПроцедуры
ПриВводеСтроки
Предопределенная процедура при вводе новой строки списка справочника.
Синтаксис:
ПриВводеСтроки()
Англоязычный синоним:
OnNewLine
Описание:
Вызов предопределенной процедуры ПриВводеСтроки производится в системе 1С:Предприятие при интерактивном вводе новой строки (до начала ввода) в форме списка справочника. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя вводить новые строки списка справочника), то новая строка списка справочника не будет инициирована.
Данная предопределенная процедура может располагаться в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриВводеСтроки()
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права добавлять строки!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриВводеСтроки
Предопределенная процедура при вводе новой строки многострочной части документа.
Синтаксис:
ПриВводеСтроки()
Англоязычный синоним:
OnNewLine
Описание:
Вызов предопределенной процедуры ПриВводеСтроки производится в системе 1С:Предприятие при интерактивном вводе новой строки многострочной части документа. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя изменять документ), то новая строка не будет инициирована.
Данная предопределенная процедура может располагаться в Модулях формы документов (см. «Виды программных модулей»).
Пример:
Процедура ПриВводеСтроки()
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права добавлять строки!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриВводеСтроки
Предопределенная процедура при вводе новой строки списка счетов
Синтаксис:
ПриВводеСтроки()
Англоязычный синоним:
OnNewLine
Описание:
Вызов предопределенной процедуры ПриВводеСтроки производится в системе 1С:Предприятие при интерактивном вводе новой строки (до начала ввода) в форме списка счетов. Если в данной предопределенной процедуре установить статус возврата 0 (например, если данному пользователю нельзя вводить новые строки списка счетов), то новая строка списка счетов не будет инициирована.
Данная предопределенная процедура может располагаться в Модуле формы списка счетов (см. «Виды программных модулей»).
Пример:
Процедура ПриВводеСтроки()
Если НазваниеНабораПрав() = "Оператор" Тогда
Предупреждение("У вас нет права добавлять счета!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриВводеСтроки
Предопределенная процедура при вводе новой проводки или корреспонденции операции.
Синтаксис:
ПриВводеСтроки()
Англоязычный синоним:
OnNewLine
Описание:
Вызов предопределенной процедуры ПриВводеСтроки производится в системе ЮПредприятие при интерактивном вводе новой проводки или корреспонденции операции. Если в данной предопределенной процедуре установить статус возврата 0 (например, если данному пользователю редактировать операции), то новая строка не будет инициирована.
Данная предопределенная процедура может располагаться в модуле формы операции (см. «Виды программных модулей»).
Пример:
Процедура ПриНачалеРедактированияСтроки()
Если НазваниеНабораПрав() = "Оператор" Тогда
Предупреждение("У вас нет права добавлять проводки!");
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриВыбореЯчейкиТаблицы
Предопределенная процедура обработки ячейки таблицы в режиме ввода данных.
Описание:
ПриВыбореЯчейкиТаблицы(<ИмяИлиАдрес>, <Значение>)
Англоязычный синоним:
OnSelectSheetCell
Параметры:
<ИмяИлиАдрес> |
Здесь в процедуру системой передается строковое значение имени области таблицы, если выбранная ячейка помечена в таблице как отдельная область, или адрес ячейки в формате «R1C1:R2C2». |
<Значение> |
Здесь в процедуру системой передается значение даной ячейки, а если диаграмма — значение выбранного элемента. |
Описание:
Вызов процедуры ПриВыбореЯчейкиТаблицы на исполнение производится в системе 1С:Предприятие по двойному щелчку мыши или по нажатию клавиши «Enter» на выбранной ячейке в таблице
Внимание! Данная предопределенная процедура вызывается в модуле формы при выборе ячейки только для таблиц в режиме ввода данных.
Замечание ПриВыбореЯчейкиТаблицы — предопределенная процедура. Она не является встроенной процедурой языка. Для нее определено только название и синтаксис. Тело процедуры должно быть написано пользователем, осуществляющим конфигурирование, в программном модуле формы, в которой используется таблица в режиме ввода данных.
Пример:
Процедура ПриВыбореЯчейкиТаблицы(ИмяЯчейки, Знач)
// Тело процедуры
// ...
КонецПроцедуры
![](image/jelementjazyka_1.gif)
This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.
ПриВыбореРодителя
Предопределенная процедура выбора родительской группы справочника.
Синтаксис:
ПриВыбореРодителя(<Элемент>)
Англоязычный синоним:
OnSetParent
Параметры:
<Элемент> |
Значение элемента справочника, который интерактивно устанавливается в качестве родителя. |
Описание:
Вызов предопределенной процедуры ПриВыбореРодителя производится в системе 1С:Предприятие при интерактивной смене родительской группы справочника (выбор следующего или предыдущего уровня). Если в данной предопределенной процедуре установить статус возврата — 0, то выбор родительской группы не будет произведен.
Данная предопределенная процедура может располагаться только в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриВыбореРодителя(Родитель)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если Родитель = ЗапрещеннаяГруппа Тогда
Предупреждение("Вам запрещено просматривать эту группу!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриВыбореРодителя
Предопределенная процедура выбора родительской группы счета.
Синтаксис:
ПриВыбореРодителя(<Счет>)
Англоязычный синоним:
OnSetParent
Параметры:
<Счет> |
Значение счета, который интерактивно установлен в качестве родителя. |
Описание:
Вызов предопределенной процедуры ПриВыборе Родителя производится в системе 1С:Предприятие при интерактивной смене родительской группы счета (выбор следующего или предыдущего уровня). Если в данной предопределенной процедуре установить статус возврата — 0, то выбор родительской группы не будет произведен.
Данная предопределенная процедура может располагаться только в Модуле формы списка счетов.
Пример:
Процедура ПриВыбореРодителя(Родитель)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если Родитель = ЗапрещеннаяГруппа Тогда
Предупреждение("Вам запрещено изменять счет!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриВыбореСтроки
Предопределенная процедура при выборе строки списка.
Синтаксис:
ПриВыбореСтроки()
Англоязычный синоним:
OnSelectLine
Описание:
Вызов предопределенной процедуры ПриВыбореСтроки производится в системе 1С:Предприятие при интерактивном выборе строки списка в форме списка справочника, журнала документов, счетов, журнала операций, журнала проводок. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя вводить новые строки списка справочника), то строка списка не будет выбрана.
Замечание: Режим обработки выбора строки (двойной щелчок мыши или клавиша Enter) предопределенной процедурой ПриВыбореСтроки включается в форме списка справочника, журнала, счетов, журнала операций, журнала проводок при помощи метода Форма.ОбработкаВыбораСтроки(1)
Данная предопределенная процедура может располагаться в Модуле формы списка справочника, журнала, счетов, журнала операций, журнала проводок (см. «Виды программных модулей»).
Пример:
Процедура ПриВыбореСтроки()
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права просмотра строки!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата, ОбработкаВыбораСтроки
ПриВыбореВладельца
Предопределенная процедура выбора владельца подчиненного справочника.
Синтаксис:
ПриВыбореВладельца(<Элемент>)
Англоязычный синоним:
OnSetOwner
Параметры:
<Элемент> |
Значение элемента справочника, который интерактивно устанавливается в качестве владельца подчиненного справочника. |
Описание:
Вызов предопределенной процедуры ПриВыбореВладельца производится в системе ЮПредприятие при интерактивном выборе владельца подчиненного справочника (при интерактивной смене владельца, т. е. смене позиции в справочнике-владельце, которая приводит к смене отображаемых в подчиненном справочнике элементов). Если в данной предопределенной процедуре установить статус возврата — 0, то выбор владельца подчиненного справочника не будет произведен.
Данная предопределенная процедура может располагаться только в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриВыбореВладельца(Владелец)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если Владелец = ЗапрещенныйВладелец Тогда
Предупреждение("Нельзя просматривать эти элементы!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриВыбореВладельца
Предопределенная процедура выбора элемента справочника по которому будут выведены расчеты.
Синтаксис:
ПриВыбореВладельца(<Владелед>)
Англоязычный синоним:
OnSetOwner
Параметры:
<Владелец> |
Значение устанавливаемого владельца — т. е. элемент справочника по которому будут выведены расчеты. |
Описание:
Вызов предопределенной процедуры ПриВыбореВладельца производится в системе 1С:Предприятие при интерактивном выборе владельца журнала расчетов (при интерактивной смене владельца, т. е. смене позиции в справочнике-владельце, которая приводит к смене отображаемых расчетов). Если в данной предопределенной процедуре установить статус возврата — 0, то выбор владельца не будет произведен.
Внимание! Процедура выполняется только в том случае, когда журнал расчетов выводится «по объекту», т. е. в нем отображаются записи по одному объекту расчета. Вызов процедуры происходит в момент смены текущего элемента в «главном» справочнике, для которого создан журнал расчетов.
Данная предопределенная процедура может располагаться только в модуле формы журнала расчетов.
Пример:
Процедура ПриВыбореВладельца(Владелец)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если Владелец = ЗапрещенныйВладелец Тогда
Предупреждение("Нельзя изменять объект расчетов;", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
ПриВыбореЗакладки
Предопределенная процедура смены закладки формы.
Синтаксис:
ПриВыбореЗакладки(<НомерЗакладки>, <Значение3акладки>)
Англоязычный синоним:
OnTabCtrlPosChanged
Параметры:
<НомерЗакладки> |
Числовое значение — номер выбранной закладки формы. |
<Значение3акладки> |
Значение выбранной закладки формы. |
Описание:
Вызов предопределенной процедуры ПриВыбореЗакладки производится в системе 1С:Предприятие неявно в момент интерактивного выбора пользователем закладки в форме. При вызове процедуры, система подставляет фактические значения параметров, характеризующие выбранную закладку.
Параметры <НомерЗакладки> и <Значение3акладки> используется в теле процедуры для обработки передаваемого системой события смены закладки формы.
Данная предопределенная процедура может располагаться только в программном модуле формы.
Пример:
Процедура ЗакладкаОбщиеВидимость(ФлагВидимости)
Форма.Название.Видимость(ФлагВидимости);
Форма.Наименование.Видимость(ФлагВидимости);
Форма.Код.Видимость(ФлагВидимости);
Форма.Статус.Видимость(ФлагВидимости);
Форма.Адрес.Видимость(ФлагВидимости);
Форма.Телефон.Видимость(ФлагВидимости);
Активизировать("Наименование", 0);
КонецПроцедуры
Процедура ЗакладкаЗаметкиВидимость(ФлагВидимости)
Форма.Заметки.Видимость(ФлагВидимости);
Активизировать("Заметки", 0);
КонецПроцедуры
Процедура ПриВыбореЗакладки(НомерЗакладки, ЗначениеЗакладки)
Если Значение3акладки = 1 Тогда
Закладка.Заметки.Видимость(0);
Закладка.Общие.Видимость(1);
ИначеЕсли ЗначениеЗакладки = 2 Тогда
Закладка.Общие.Видимость(0);
Закладка.Заметки.Видимость(1);
КонецЕсли;
КонецПроцедуры
См. также: ИспользоватьЗакладки, Закладки, СтатусВозврата
ПриВыклВклПроводокОперации
Предопределенная процедура, выполняемая при выключении или включении проводок.
Синтаксис:
ПриВыклВклПроводокОперации(<Документ>)
Англоязычный синоним:
OnOperEntryOffOn
Параметры:
<Документ> |
Значение типа «Документ» — документ, которому принадлежит операция. |
Описание:
Вызов предопределенной процедуры ПриВыклВклПроводокОперации производится системой 1С:Предприятие неявно при интерактивном выключении или включении проводок. В качестве параметра в процедуру передается значение документа, которому принадлежит операция.
Если в данной процедуре установить статус возврата 0, то действие не будет выполнено.
Данная предопределенная процедура может располагаться только в глобальном программном модуле.
Пример:
Процедура ПриВыклЗклПроводокОперации(Док)
Если Док.Вид() <> "Операция" Тогда
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
![](image/jelementjazyka_1.gif)
This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.
ПриЗакрытии
Предопределенная процедура при закрытии формы.
Синтаксис:
ПриЗакрытии()
Англоязычный синоним:
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
Параметры:
<СписокРеквизитов> |
Строка со списком идентификаторов (через запятую) тех реквизитов, просмотр истории которых допускается. |
Возвращаемое значение:
Текущий (на момент до вызова метода) список реквизитов, просмотр истории которых допускается просмор истории.
Описание:
Метод ПросмотрИстории позволяет установить список реквизитов для которых допускается просмор истории .
Замечание. Данный метод доступен только в контексте Модуля формы элемента справочника (см. «Виды программных модулей»). Действие данного метода относится только к текущему элементу справочника, который доступен в локальном контексте Модуля формы элемента справочника.
Пример:
Процедура ПриОткрытии()
ПросмотрИстории;"Оклад, Тариф, Подразделение");
КонецПроцедуры