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


Провести


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

Синтаксис:

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

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

MakeActions

Параметры:

<Режим>

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

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



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

<3нач>

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

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

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

Описание:

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

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

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

Пример:

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

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

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

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

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

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

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

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

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



Содержание раздела