Определяет, был ли изменен объект после считывания из базы данных.
Синтаксис
Модифицированность()Примеры платформы
Если Объект.Модифицированность() Тогда
Объект.Записать();
КонецЕсли;Полное описание, параметры и ограничения
СправочникОбъект.<Имя справочника>.Модифицированность (CatalogObject.<Catalog name>.Modified)
СправочникОбъект.<Имя справочника> (CatalogObject.<Catalog name>)
Модифицированность (Modified)
Доступен, начиная с версии 8.0.
Синтаксис:
Модифицированность()
Возвращаемое значение:
Тип: Булево.
Истина - объект изменен; Ложь - в противном случае.
Описание:
Определяет, был ли изменен объект после считывания из базы данных.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Метод не позволяет определить, был ли изменен объект другими пользователями.
Пример:
Если Объект.Модифицированность() Тогда
Объект.Записать();
КонецЕсли;
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Создать товар в памяти и убедиться, что записи ещё нет
Новый объект справочника можно заполнить до записи. Различаем объект, ссылку и дополнительную служебную структуру.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.
Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
КонецЕсли;
Товар = Справочники.УчебныеТовары.СоздатьЭлемент();
Товар.Наименование = "Учебная книга";
Товар.Артикул = "A-01";
Товар.Цена = 250;
Товар.ДополнительныеСвойства.Вставить("ИсточникУчебныхДанных", "Пример в памяти");
Сообщить(Товар.ЭтоНовый());
Сообщить(Товар.Ссылка.Пустая());
Сообщить(Не Товар.ЭтоГруппа);
Сообщить(Не Товар.ПометкаУдаления);
Сообщить(Товар.Метаданные().Имя = "УчебныеТовары");
Сообщить(Товар.Наименование);
Сообщить(Товар.ДополнительныеСвойства.ИсточникУчебныхДанных);
Сообщить(Товар.Модифицированность());
Сообщить("Записать не вызывался: товар существует только как объект в памяти");Разбор по шагам
СоздатьЭлемент создаёт объект, но не выполняет запись. Наименование, Артикул и Цена присваиваются его реквизитам в памяти.
До записи у этого нового объекта ссылка пустая. ЭтоНовый проверяет состояние объекта, Пустая — состояние ссылки.
ДополнительныеСвойства — служебная Структура, не новый реквизит справочника и не автоматическое сохранение в базе.
Модифицированность показывает изменения этого экземпляра, не проверяет параллельные действия других пользователей.
Как проверить результат
ЭтоНовый, Пустая ссылки, проверки группы/пометки и имени метаданных дают Истина.
В сообщениях Учебная книга и Пример в памяти; экземпляр заполнен.
Откройте список УчебныеТовары: новая строка не появилась, поскольку Записать отсутствует.
Ожидаемый результат
Заполнен один новый объект справочника без изменения данных базы.
На что обратить внимание
Создание экземпляра не выполняет бизнес-проверки записи и не гарантирует, что объект можно сохранить.
Нельзя вызывать Прочитать у нового объекта: в базе пока нет строки для чтения.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Перечитать свой товар и отбросить несохранённое изменение
Прочитать загружает данные из базы в существующий экземпляр. Различаем локальную правку, записанное значение и непрозрачную строку ВерсияДанных.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.
Запускайте строго в новой пустой базе Учебная85, с пустыми модулями объектов и без подписок. Здесь временно записываются только созданные самим примером объекты.
Отмена транзакции выполняется и при успехе, и при ошибке. Не заменяйте её фиксацией и не запускайте внутри транзакции вызывающего кода.
Откат базы не отменяет письма, HTTP-запросы и другие внешние действия обработчиков. Поэтому копия рабочей конфигурации с неизвестными обработчиками не заменяет эту подготовку.
Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
КонецЕсли;
Если ТранзакцияАктивна() Тогда
ВызватьИсключение "Запустите учебную задачу вне чужой транзакции";
КонецЕсли;
Ссылка = Справочники.УчебныеТовары.ПолучитьСсылку(Новый УникальныйИдентификатор);
НачатьТранзакцию();
Попытка
Товар = Справочники.УчебныеТовары.СоздатьЭлемент();
Товар.УстановитьСсылкуНового(Ссылка);
Товар.Наименование = "Записанная учебная книга";
Товар.Артикул = "A-01";
Товар.Цена = 250;
Товар.Записать();
Наблюдаемый = Ссылка.ПолучитьОбъект();
Если Наблюдаемый = Неопределено Тогда
ВызватьИсключение "Собственный записанный товар не найден";
КонецЕсли;
ВерсияДо = Наблюдаемый.ВерсияДанных;
Наблюдаемый.Наименование = "Только в памяти";
Сообщить(Наблюдаемый.Модифицированность());
Наблюдаемый.Прочитать();
Сообщить(Наблюдаемый.Наименование = "Записанная учебная книга");
Сообщить(Не Наблюдаемый.Модифицированность());
Сообщить(Наблюдаемый.ВерсияДанных = ВерсияДо);
Сообщить(ТипЗнч(ВерсияДо) = Тип("Строка"));
ОтменитьТранзакцию();
Исключение
Если ТранзакцияАктивна() Тогда
ОтменитьТранзакцию();
КонецЕсли;
ВызватьИсключение;
КонецПопытки;
Сообщить(Не ТранзакцияАктивна());
Сообщить(Ссылка.ПолучитьОбъект() = Неопределено);Разбор по шагам
Записываем только собственный новый объект в отменяемой транзакции и получаем отдельный экземпляр по его ссылке.
Сохраняем строку версии как непрозрачное значение. Это не дата и не номер выпуска конфигурации.
Присваивание Наименование изменяет объект в памяти; Записать для этой правки не вызывается.
Прочитать заменяет локальные значения записанными. В этом уроке других записей между чтениями нет, поэтому версия остаётся прежней.
Как проверить результат
Пять сравнений внутри транзакции Истина; после отката собственный товар отсутствует.
Несохранённое Только в памяти исчезло, записанное наименование восстановлено.
Ожидаемый результат
Показано перечитывание существующего учебного объекта без сохранения локальной правки.
На что обратить внимание
Не вызывайте Прочитать до записи нового объекта: строки в базе ещё нет.
Прочитать может уничтожить несохранённые изменения пользователя; в интерфейсе это требует явного решения.
Сравнение версий здесь не моделирует гонку двух реальных сеансов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.