Установить время объекта (документа, бизнес-процесса, задачи) так, что бы он оказался первым на свою дату. Если при этом дата объекта совпадает с текущей по дню, то время объекта будет установлено не позже, чем текущее.
Полное описание, параметры и ограничения
РежимАвтоВремя.Первым (AutoTimeMode.First)
РежимАвтоВремя (AutoTimeMode)
Первым (First)
Доступен, начиная с версии 8.0.
Описание:
Установить время объекта (документа, бизнес-процесса, задачи) так, что бы он оказался первым на свою дату. Если при этом дата объекта совпадает с текущей по дню, то время объекта будет установлено не позже, чем текущее.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Применить РежимАвтоВремя.Первым к собственному объекту
Новому собственному документу задаётся день без времени; расширение его формы получает конкретный режим автоматической установки времени при записи.
Где и как запускать
Основной блок — серверное создание собственной управляемой формы документа. Дополнительный — отдельная клиентская команда той же формы.
Подготовка
В отдельной пустой учебной конфигурации создайте документ УчебнаяОперацияРежимов: строковый номер 12 с автонумерацией, разрешите проведение и оперативное проведение, добавьте Комментарий (Строка 100).
Движений по регистрам у этого собственного документа нет; обработчик проведения для данного опыта не нужен. Пример изучает состояние записи / проведения, а не реализует бухгалтерский учёт.
Создайте у документа управляемую форму УчебнаяФорма: основной реквизит Объект, поля Объект.Дата и Объект.Комментарий. Основной блок — только в её модуле, событие ПриСозданииНаСервере.
В этой форме создайте команду ЗаписатьСвойДокумент и кнопку, назначьте дополнительный клиентский обработчик. Откройте именно новую свою форму без параметра Ключ.
АвтоВремя в установленной справке доступно только для записи. Код его назначает, но не пытается прочитать обратно. Метод формы Записать вызывается без аргумента РежимЗаписиДокумента — это другой контракт.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Объект.Дата = НачалоДня(ТекущаяДата());
Объект.Комментарий = "Собственная проверка времени записи";
АвтоВремя = РежимАвтоВремя.Первым;
Сообщить("Способ установки времени нового документа: Первым");
КонецПроцедурыТа же собственная форма документа: обычная запись через форму
&НаКлиенте
Процедура ЗаписатьСвойДокумент(Команда)
Если ЭтаФорма.Записать() Тогда
Сообщить("Собственный документ записан с датой: " + Строка(Объект.Дата));
Иначе
Сообщить("Запись отменена");
КонецЕсли;
КонецПроцедурыРазбор по шагам
Создаём только собственные метаданные и конкретный объект / форму указанного типа.
Назначаем перечисление правильному свойству либо параметру метода.
Проверяем состояние собственного объекта, не интерпретируя синтаксический пример как рабочую учётную операцию.
Как проверить результат
Запишите своей кнопкой и прочитайте фактическую дату сохранённого нового документа.
Режим относится к установке времени при записи нового документа; не обещайте перенумерацию или изменение ранее существовавших документов.
Ожидаемый результат
Режим использован в настоящем контексте собственного документа или счёта.
На что обратить внимание
Не запускайте примеры создания / записи в рабочей базе.
Не смешивайте Записать объекта и Записать формы: состав параметров и возвращаемое значение различаются.
При сборке HTML записи, проведение, отмена проведения и код 1С не исполнялись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.