Шаг 161 - Изучаем документ – Запрещаем создавать новый

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

СтатусВозврата
Установить/определить статуса возврата предопределенной процедуры.

Синтаксис:

СтатусВозврата([<Статус>])

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

ReturnStatus

Параметры:
<Статус> Необязательный параметр. Числовое выражение. Если задано значение 1, то устанавливается статус возврата — Выполнить Действие. Если задано значение 0, то устанавливается статус возврата — Отменить Действие. Если параметр опущен, то статус возврата предопределенной процедуры не меняется.

Возвращаемое значение:
Число 1 — если статус возврата — Выполнить Действие;
Число 0 — если статус возврата — Отменить Действие.

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

Вот мы ей и воспользуемся.

Процедура ВводНового()
	Предупреждение("Документ создается только на основании другого ");
	СтатусВозврата(0);
КонецПроцедуры

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

161_1.gif (4691 b)

Появится табличка с информацией и документ не создастся. Что и нужно.


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем.