Получает количество элементов в коллекции.
Синтаксис
Количество()Полное описание, параметры и ограничения
КоллекцияЭлементовУсловногоОформленияКомпоновкиДанных.Количество (DataCompositionConditionalAppearanceItemCollection.Count)
КоллекцияЭлементовУсловногоОформленияКомпоновкиДанных (DataCompositionConditionalAppearanceItemCollection)
Количество (Count)
Доступен, начиная с версии 8.1.
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число.
Описание:
Получает количество элементов в коллекции.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Управлять коллекцией правил только собственной учебной формы
Вставляем и перемещаем отключённые черновики, удаляем их, затем очищаем и восстанавливаем единственное учебное правило.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
Правило = ЭтаФорма.УсловноеОформление.Элементы.Добавить();
Правило.Использование = Истина;
Правило.Представление = "Учебное малое количество";
Правило.Оформление.УстановитьЗначениеПараметра("ЦветФона", Новый Цвет(255, 239, 200));
Правило.Оформление.УстановитьЗначениеПараметра("ЦветТекста", Новый Цвет(100, 60, 0));
Условие = Правило.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
Условие.Использование = Истина;
Условие.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Товары.Количество");
Условие.ВидСравнения = ВидСравненияКомпоновкиДанных.Меньше;
Условие.ПравоеЗначение = 2;
Условие.Представление = "Количество меньше двух";
ПолеОформления = Правило.Поля.Элементы.Добавить();
ПолеОформления.Использование = Истина;
ПолеОформления.Поле = Новый ПолеКомпоновкиДанных("ТоварыКоличество");
Правила = ЭтаФорма.УсловноеОформление.Элементы;
Черновик = Правила.Добавить();
Черновик.Использование = Ложь;
Черновик.Представление = "Черновик в конце";
Вставленный = Правила.Вставить(0);
Вставленный.Использование = Ложь;
Вставленный.Представление = "Черновик в начале";
Сообщить(Правила.Количество() = 3);
Сообщить(Правила.Индекс(Черновик) = 2);
Правила.Сдвинуть(Черновик, -2);
Сообщить(Правила.Индекс(Черновик) = 0);
Сообщить(Правила.Получить(0).Представление = "Черновик в конце");
Правила.Удалить(Вставленный);
Правила.Удалить(Черновик);
Сообщить(Правила.Количество() = 1);
Сообщить(ЭтаФорма.УсловноеОформление.ПолучитьКоличествоИспользуемых() = 1);
// Очищаем только правила новой учебной формы и сразу восстанавливаем своё правило.
Правила.Очистить();
Сообщить(Правила.Количество() = 0);
Правило = ЭтаФорма.УсловноеОформление.Элементы.Добавить();
Правило.Использование = Истина;
Правило.Представление = "Учебное малое количество";
Правило.Оформление.УстановитьЗначениеПараметра("ЦветФона", Новый Цвет(255, 239, 200));
Правило.Оформление.УстановитьЗначениеПараметра("ЦветТекста", Новый Цвет(100, 60, 0));
Условие = Правило.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
Условие.Использование = Истина;
Условие.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Товары.Количество");
Условие.ВидСравнения = ВидСравненияКомпоновкиДанных.Меньше;
Условие.ПравоеЗначение = 2;
Условие.Представление = "Количество меньше двух";
ПолеОформления = Правило.Поля.Элементы.Добавить();
ПолеОформления.Использование = Истина;
ПолеОформления.Поле = Новый ПолеКомпоновкиДанных("ТоварыКоличество");
Сообщить(Правила.Количество() = 1);
Сообщить(Правила.Получить(0).Использование);
КонецПроцедуры
Разбор по шагам
Коллекция хранит порядок правил, а Использование определяет, включено ли конкретное правило.
Добавить помещает черновик в конец; Вставить(0) — в начало. В уроке оба черновика отключены.
Сдвинуть принимает элемент правила и смещение, не строку таблицы и не идентификатор товара.
Индекс и Получить проверяют новую позицию; Удалить получает элемент коллекции.
Очистить удаляет все правила собственной формы. В том же серверном обработчике снова создаётся исходная подсветка количества.
После очистки старые Правило/Условие/ПолеОформления не используются: переменные получают новые созданные элементы.
Как проверить результат
Промежуточные проверки показывают три, потом одно, потом ноль и снова одно правило.
Отключённые черновики не увеличивают число используемых правил.
После открытия действует исходная подсветка Ручки 1; обе строки товаров сохранены.
Ожидаемый результат
Все восемь методов коллекции правил показаны в ограниченном учебном жизненном цикле с восстановлением оформления.
На что обратить внимание
Очистить в рабочой форме может удалить штатное оформление конфигурации — данный урок для новой пустой формы.
Перемещение правил влияет на порядок применения; визуальный результат пересекающихся параметров проверяйте отдельно.
Удаление оформления не удаляет товары, но старые ссылки на удалённые правила уже недействительны.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Выделить Север цветом, не фильтруя остальные магазины
ЦветВДиаграмме задаём в условном оформлении серии при Магазин = Север. Отдельно задаём фон в правиле самой диаграммы и проверяем, что отбор данных остаётся пустым.
Где и как запускать
Полный код серверного общего модуля УчебныеДиаграммы85. ВыполнитьПример() вызывается из собственного серверного обработчика учебной команды. Код не запускается автоматически в справочнике.
Подготовка
Работайте в отдельной учебной базе на платформе 8.5.1.1343. Справочники, документы, регистры и готовые макеты не нужны.
Создайте общий модуль УчебныеДиаграммы85: Сервер — Да, Клиент — Нет, Привилегированный — Нет. Полностью вставьте код одного урока, а не оборачивайте его второй процедурой.
В своей учебной обработке добавьте команду. Из её серверного обработчика вызовите УчебныеДиаграммы85.ВыполнитьПример();. Не вызывайте серверные объекты СКД непосредственно из тонкого клиента.
Запрос содержит только три собственные константные строки: Север/Книга — 750, Север/Ручка — 50, Юг/Книга — 500. Продажи Севера — 800, Юга — 500, общая сумма — 1300.
Серии будут магазинами, точки — товарами, ресурс — суммой продаж. Значение Книга складывается до 1250, Ручка — до 50. Количество единиц по всем строкам — 6, а число строк источника — 3.
Каждый урок запускайте отдельно: он заново создаёт схему и настройки в памяти. Упражнения с настройками не формируют отчёт; отдельный урок показывает компоновку и вывод.
Для просмотра объектов поставьте точку останова перед последними Сообщить. ТабличныйДокумент результата урока вывода находится в серверной переменной Результат; код не печатает, не сохраняет файл и не открывает окно клиента.
Запуск в 1С здесь не проверялся. Приведены ожидаемые проверки собственной задачи, а не доказательство успешного формирования отчёта в любой конфигурации.
Процедура ВыполнитьПример() Экспорт
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныеПродажи";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "СвоиТриСтроки";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Север"" КАК Магазин,
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Север"", ""Ручка"", 1, 50
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Юг"", ""Книга"", 2, 500";
Для Каждого ИмяРесурса Из СтрРазделить("Сумма,Количество", ",") Цикл
Ресурс = Схема.ПоляИтога.Добавить();
Ресурс.ПутьКДанным = ИмяРесурса;
Ресурс.Выражение = "Сумма(" + ИмяРесурса + ")";
КонецЦикла;
Настройки = Схема.НастройкиПоУмолчанию;
Диаграмма = Настройки.Структура.Добавить(Тип("ДиаграммаКомпоновкиДанных"));
Диаграмма.Имя = "УчебныеПродажиПоМагазинам";
Диаграмма.Использование = Истина;
Выбранное = Диаграмма.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных("Сумма");
Выбранное.Использование = Истина;
Серия = Диаграмма.Серии.Добавить();
Серия.Имя = "Магазины";
Серия.Использование = Истина;
ПолеСерии = Серия.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеСерии.Поле = Новый ПолеКомпоновкиДанных("Магазин");
ПолеСерии.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеСерии.Использование = Истина;
Точка = Диаграмма.Точки.Добавить();
Точка.Имя = "Товары";
Точка.Использование = Истина;
ПолеТочки = Точка.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеТочки.Поле = Новый ПолеКомпоновкиДанных("Наименование");
ПолеТочки.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеТочки.Использование = Истина;
ПравилоСерии = Серия.УсловноеОформление.Элементы.Добавить();
ПравилоСерии.Использование = Истина;
ПравилоСерии.Оформление.УстановитьЗначениеПараметра("ЦветВДиаграмме", Новый Цвет(35, 105, 190));
УсловиеОформления = ПравилоСерии.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
УсловиеОформления.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Магазин");
УсловиеОформления.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
УсловиеОформления.ПравоеЗначение = "Север";
УсловиеОформления.Использование = Истина;
ПравилоДиаграммы = Диаграмма.УсловноеОформление.Элементы.Добавить();
ПравилоДиаграммы.Использование = Истина;
ПравилоДиаграммы.Оформление.УстановитьЗначениеПараметра("ЦветФона", Новый Цвет(245, 248, 252));
ЦветСерии = ПравилоСерии.Оформление.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("ЦветВДиаграмме"));
Если ЦветСерии = Неопределено Тогда
ВызватьИсключение "Не найден цвет собственной серии";
КонецЕсли;
Сообщить(ЦветСерии.Значение = Новый Цвет(35, 105, 190));
Сообщить(Серия.УсловноеОформление.Элементы.Количество() = 1);
Сообщить(Диаграмма.УсловноеОформление.Элементы.Количество() = 1);
Сообщить(ПравилоСерии.Отбор.Элементы.Количество() = 1);
Сообщить(Серия.Отбор.Элементы.Количество() = 0);
Сообщить(Настройки.Отбор.Элементы.Количество() = 0);
КонецПроцедурыРазбор по шагам
УсловноеОформление группы серий и диаграммы — отдельные контейнеры. В каждом добавляем собственное правило.
ЦветВДиаграмме предназначен для серии. Условие находится в ПравилоСерии.Отбор, а не в отборе продаж.
Север сравнивается со значением поля Магазин. Магазин Юг не должен исчезнуть только из-за этого правила цвета.
Найденный параметр оформления проверяем до чтения значения. Затем отдельно проверяем отсутствие отбора данных.
Фон в оформлении — не обещание окраски всей области диаграммы. Для фона графической области используйте описанный параметр вывода ТипДиаграммы.ЦветФона.
Как проверить результат
Ожидаются шесть сравнений Истина. У оформления один критерий, у отбора данных группировки — ни одного.
В учебном запуске перенесите правило серии перед компоновкой и осмотрите цвет Севера и наличие Юга. Проверка коллекций не доказывает визуальное применение цвета.
Ожидаемый результат
Создано адресное правило оформления, не исключающее данные другого магазина.
На что обратить внимание
Правило оформления с условием не равно фильтру источника.
ЦветВДиаграмме относится к серии; его нельзя переносить на точки с ожиданием того же поведения.
Другие правила оформления и параметры графической области могут влиять на вид результата; этот урок начинает с собственного пустого дерева.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.