Устанавливает значение свойства Активность у всех записей, входящих в набор.
Синтаксис
УстановитьАктивность(<Активность>)Примеры платформы
НаборЗаписей.УстановитьАктивность(Истина);Полное описание, параметры и ограничения
РегистрНакопленияНаборЗаписей.<Имя регистра накопления>.УстановитьАктивность (AccumulationRegisterRecordSet.<Accumulation register name>.SetActive)
РегистрНакопленияНаборЗаписей.<Имя регистра накопления> (AccumulationRegisterRecordSet.<Accumulation register name>)
УстановитьАктивность (SetActive)
Доступен, начиная с версии 8.0.
Синтаксис:
УстановитьАктивность(<Активность>)
Параметры:
<Активность> (обязательный)
Тип: Булево.
Признак активности записей. Истина - записи учитываются в итогах регистра. Ложь - записи не учитываются в итогах регистра.
Описание:
Устанавливает значение свойства Активность у всех записей, входящих в набор.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Пример:
НаборЗаписей.УстановитьАктивность(Истина);
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Отключить активность своих движений и не спутать Записывать с защитой от записи
Неактивные движения остаются строками набора, но не участвуют в итогах. Записывать=Ложь относится к записи коллекции движений документа, а не к запрету прямого вызова Записать.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую базу, имя корневой конфигурации УчебныеОстатки85. Не добавляйте эти объекты в УТ/КА2/УНФ/БП. Режим управления блокировкой данных конфигурации — Управляемый.
Документы → Добавить: УчебноеДвижение85. Номер: Строка длиной 40, автонумерация выключена. Модули объекта и менеджера оставьте пустыми; не добавляйте обработчики, подписки и обязательные пользовательские реквизиты.
Регистры накопления → Добавить: УчебныеОстатки85. Вид регистра Остатки. Единственное измерение КодТовара: Строка 50, индексировать, проверка заполнения Показывать ошибку. Единственный ресурс Количество: Число 12,3, неотрицательное. Дополнительных реквизитов нет.
В списке регистраторов выберите только собственный документ УчебноеДвижение85. Оставьте модули регистра пустыми, использование итогов включённым. Планы обмена, разделители, историю данных и фоновые задания для урока не создавайте.
Обновите конфигурацию базы данных. Создайте серверный общий модуль УчебныеЗадачи и команду собственной обработки. Фрагмент вставьте внутрь ВыполнитьПример() Экспорт; запускайте задачи по отдельности.
Первые задачи работают с незаписанными наборами. Только задачи с пометкой «в собственной транзакции» временно записывают два собственных документа и движения, затем обязательно отменяют транзакцию. В рабочей базе этот код не запускайте.
Если Метаданные.Документы.Количество() <> 1
Или Метаданные.РегистрыНакопления.Количество() <> 1
Или Метаданные.Документы.Найти("УчебноеДвижение85") = Неопределено Тогда
ВызватьИсключение "Разрешены только собственный учебный документ и регистр";
КонецЕсли;
Описание = Метаданные.РегистрыНакопления.Найти("УчебныеОстатки85");
Если Описание = Неопределено Тогда
ВызватьИсключение "Сначала создайте собственный учебный регистр";
КонецЕсли;
Если Описание.ВидРегистра <> Метаданные.СвойстваОбъектов.ВидРегистраНакопления.Остатки
Или Описание.Измерения.Количество() <> 1
Или Описание.Ресурсы.Количество() <> 1
Или Описание.Реквизиты.Количество() <> 0
Или Описание.Измерения.Найти("КодТовара") = Неопределено
Или Описание.Ресурсы.Найти("Количество") = Неопределено Тогда
ВызватьИсключение "Нужен регистр остатков с КодТовара и Количество";
КонецЕсли;
Менеджер = РегистрыНакопления.УчебныеОстатки85;
Код = "TRAIN-" + Строка(Новый УникальныйИдентификатор);
СсылкаНаНесохраненный = Документы.УчебноеДвижение85.ПолучитьСсылку(Новый УникальныйИдентификатор);
Набор = Менеджер.СоздатьНаборЗаписей();
Набор.Отбор.Регистратор.Установить(СсылкаНаНесохраненный);
Приход = Набор.ДобавитьПриход();
Приход.Период = Дата(2026, 9, 15, 10, 0, 0);
Приход.Регистратор = СсылкаНаНесохраненный;
Приход.Активность = Истина;
Приход.КодТовара = Код;
Приход.Количество = 3;
Расход = Набор.ДобавитьРасход();
Расход.Период = Дата(2026, 9, 15, 11, 0, 0);
Расход.Регистратор = СсылкаНаНесохраненный;
Расход.Активность = Истина;
Расход.КодТовара = Код;
Расход.Количество = 1;
Набор.ДополнительныеСвойства.Вставить("ИсточникУрока", "Собственный незаписанный набор");
Сообщить(Набор.ДополнительныеСвойства.ИсточникУрока = "Собственный незаписанный набор");
Сообщить(Не Набор.ОбменДанными.Загрузка);
Сообщить(Не Набор.БлокироватьДляИзменения);
Сообщить(Не Набор.РасширенныеРежимыЗамещения);
Набор.Записывать = Ложь;
Сообщить(Не Набор.Записывать);
Набор.УстановитьАктивность(Ложь);
Сообщить(Набор.Количество() = 2);
Сообщить(Не Приход.Активность И Не Расход.Активность);
Сообщить(Набор.Итог("Количество") = 4);
ОстатокВПамяти = 0;
Для Каждого Движение Из Набор Цикл
Если Не Движение.Активность Тогда
Продолжить;
КонецЕсли;
Если Движение.ВидДвижения = ВидДвиженияНакопления.Приход Тогда
ОстатокВПамяти = ОстатокВПамяти + Движение.Количество;
Иначе
ОстатокВПамяти = ОстатокВПамяти - Движение.Количество;
КонецЕсли;
КонецЦикла;
Сообщить(ОстатокВПамяти = 0);Разбор по шагам
ДополнительныеСвойства содержит пояснение собственного объекта в памяти. Это не дополнительное измерение регистра.
Читаем исходные параметры: Загрузка выключена, управляемая блокировка при записи и расширенные режимы замещения не включены.
Записывать=Ложь не используем как защитный барьер: прямой Набор.Записать всё равно является отдельным действием. Его здесь нет.
УстановитьАктивность(Ложь) меняет все строки. Количество строк и простая сумма ресурса остаются 2 и 4.
Расчёт, пропускающий неактивные движения, теперь даёт 0. Изменено только собственное содержимое в памяти.
Как проверить результат
Девять сообщений Истина для нового набора с указанной подготовкой.
После отключения активности обе строки присутствуют, однако учебный остаток равен 0.
Ожидаемый результат
Четыре независимых понятия — наличие строки, активность, запись движений документа и режим замещения — не смешаны.
На что обратить внимание
Не включайте ОбменДанными.Загрузка для обхода ошибок: она ослабляет проверки при реальной записи.
Записывать=Ложь не запрещает прямую запись набора и не заменяет права доступа.
БлокироватьДляИзменения применим в управляемом режиме при записи; чтение текущего Ложь не проверяет конкурентную безопасность.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.