Автоматически управляет свойством ОтметкаНезаполненного при добавлении и удалении строк таблицы. Если нет ни одной строки - ставит ОтметкаНезаполненного в Истина, иначе Ложь.
Полное описание, параметры и ограничения
ТаблицаФормы.АвтоОтметкаНезаполненного (FormTable.AutoMarkIncomplete)
ТаблицаФормы (FormTable)
АвтоОтметкаНезаполненного (AutoMarkIncomplete)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Автоматически управляет свойством ОтметкаНезаполненного при добавлении и удалении строк таблицы.
Если нет ни одной строки - ставит ОтметкаНезаполненного в Истина, иначе Ложь.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Изменение свойства на клиенте может потребовать обращения к серверу.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Автоматически отмечать пустую учебную таблицу
АвтоОтметкаНезаполненного управляет отметкой при добавлении/удалении строк. Это визуальная помощь, не запрет сохранения и не проверка количества товара.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Проверяйте в настольном тонком/толстом или веб-клиенте 8.5.1.1343, не в мобильном приложении. Для каждого урока отдельная учебная форма с пустым модулем.
Изменение учебных строк остаётся только в открытой форме. При её новом открытии снова создаются Книга/3 и Ручка/1. Настройки таблицы не являются правами доступа к данным.
Кнопка очищает свои строки, включая ручные правки. Не применяйте её к реквизиту рабочего документа.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
Таблица.АвтоОтметкаНезаполненного = Истина;
Таблица.ОтметкаОбязательногоЗаполнения = Истина;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Очистить / вернуть свою Книгу";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Таблица = Элементы.ТаблицаТоваров;
Таблица.ЗакончитьРедактированиеСтроки(Ложь);
Если ЭтаФорма.Товары.Количество() = 0 Тогда
Книга = ЭтаФорма.Товары.Добавить();
Книга.Код = "A-01";
Книга.Наименование = "Книга";
Книга.Количество = 3;
Иначе
ЭтаФорма.Товары.Очистить();
КонецЕсли;
Сообщить(СтрШаблон("Строк %1; отметка пустоты %2",
ЭтаФорма.Товары.Количество(), Таблица.ОтметкаНезаполненного));
КонецПроцедуры
Разбор по шагам
Автоматическую отметку и визуальную обязательность включаем отдельно от автоввода новых строк.
Кнопка намеренно очищает только собственный реквизит Товары этой формы. Несохранённые ручные правки в нём будут потеряны.
Следующее нажатие создаёт одну собственную Книгу/3; прежние ручные строки не восстанавливаются.
Платформа переключает ОтметкаНезаполненного по наличию строк, не по правильности кода или количества.
Как проверить результат
Первое нажатие: строк 0, отметка Истина. Второе: строк 1, отметка Ложь, Книга/3.
Поставьте у Книги количество 0: строка всё равно есть. Пустота таблицы и допустимость количества — разные проверки.
Ожидаемый результат
Показана автоматическая отметка пустого контейнера без выдачи её за валидацию документа.
На что обратить внимание
Команда теряет ручные данные собственной формы; используйте только отдельную учебную EPF.
Для сохранения рабочего документа нужны отдельные проверки и права.
Отметка не доказывает, что каждая строка заполнена правильно.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Показать ручную отметку даже у непустой таблицы
Выключаем автоматику и вручную переключаем ОтметкаНезаполненного. Пример показывает, почему нельзя судить о данных только по рамке или отметке.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Проверяйте в настольном тонком/толстом или веб-клиенте 8.5.1.1343, не в мобильном приложении. Для каждого урока отдельная учебная форма с пустым модулем.
Изменение учебных строк остаётся только в открытой форме. При её новом открытии снова создаются Книга/3 и Ручка/1. Настройки таблицы не являются правами доступа к данным.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
Таблица.АвтоОтметкаНезаполненного = Ложь;
Таблица.ОтметкаОбязательногоЗаполнения = Истина;
Таблица.ОтметкаНезаполненного = Истина;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Переключить только отметку";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Таблица = Элементы.ТаблицаТоваров;
Таблица.ОтметкаНезаполненного = Не Таблица.ОтметкаНезаполненного;
Сообщить(СтрШаблон("Отметка %1; строк %2; количество %3",
Таблица.ОтметкаНезаполненного, ЭтаФорма.Товары.Количество(), ЭтаФорма.Товары.Итог("Количество")));
КонецПроцедуры
Разбор по шагам
АвтоОтметкаНезаполненного=Ложь не даёт автоматике переопределять ручное состояние.
Начальная отметка Истина установлена намеренно, хотя есть две заполненные строки.
Кнопка меняет только визуальное свойство. Данные не очищаются и не пересчитываются.
Сравниваем отметку с отдельными Количество() и Итог: визуальное состояние не заменяет эти вычисления.
Как проверить результат
Сразу есть две строки и ручная отметка. Первое нажатие: Ложь, строк 2, количество 4.
Второе: Истина, 2, 4. Состав и значения товаров не изменились.
Ожидаемый результат
Отделено ручное оформление от фактической пустоты и проверки значений.
На что обратить внимание
Не используйте ручную отметку как единственный критерий разрешения записи.
В рабочей форме ручной режим должен сопровождаться понятным алгоритмом проверки и снятия отметки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.