Получает количество элементов в коллекции.
Синтаксис
Количество()Полное описание, параметры и ограничения
ФиксированнаяКоллекция.Количество (FixedCollection.Count)
ФиксированнаяКоллекция (FixedCollection)
Количество (Count)
Доступен, начиная с версии 8.0.
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число.
Описание:
Получает количество элементов в коллекции.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Проверить роли и типы полей сводной диаграммы
Товар строковый и является измерением, Сумма числовая и является ресурсом. Читаем реальные описания полей после назначения источника.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Источник = Новый ТаблицаЗначений;
Источник.Колонки.Добавить("Товар", Новый ОписаниеТипов("Строка"));
Источник.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
Источник.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число"));
СтрокаТовара = Источник.Добавить();
СтрокаТовара.Товар = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара.Сумма = 750;
СтрокаТовара = Источник.Добавить();
СтрокаТовара.Товар = "Ручка";
СтрокаТовара.Количество = 1;
СтрокаТовара.Сумма = 50;
Менеджер = Новый МенеджерВременныхТаблиц;
Запрос = Новый Запрос;
Запрос.МенеджерВременныхТаблиц = Менеджер;
Запрос.УстановитьПараметр("Источник", Источник);
Запрос.Текст = "ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
|ПОМЕСТИТЬ ВТУчебныеТовары ИЗ &Источник КАК Д;
|ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
|ИЗ ВТУчебныеТовары КАК Д
|ИТОГИ СУММА(Количество), СУММА(Сумма) ПО Товар";
Попытка
Пакет = Запрос.ВыполнитьПакет();
Результат = Пакет.Получить(1);
Исключение
Менеджер.Закрыть();
ВызватьИсключение;
КонецПопытки;
Менеджер.Закрыть();
Диаграмма = Новый СводнаяДиаграмма;
Диаграмма.ТипСводнойДиаграммы = ТипСводнойДиаграммы.Гистограмма;
Диаграмма.ИсточникДанных = Результат;
Диаграмма.Точки.Добавить("Товар");
Диаграмма.Ресурсы.Добавить("Количество");
Диаграмма.Ресурсы.Добавить("Сумма");
Диаграмма.ОбластьЗаголовка.Текст = "Учебные товары: количество и сумма — разные единицы";
Диаграмма.Обновить();
Товар = Диаграмма.Поля.Найти("Товар");
Сумма = Диаграмма.Поля.Найти("Сумма");
Если Товар = Неопределено Или Сумма = Неопределено Тогда
ВызватьИсключение "В собственном результате не найдены Товар и Сумма";
КонецЕсли;
Сообщить(Товар.Имя = "Товар");
Сообщить(Товар.Измерение);
Сообщить(Сумма.Ресурс);
Сообщить(Не Товар.Реквизит);
Сообщить(Товар.ТипЗначения.СодержитТип(Тип("Строка")));
Сообщить(Сумма.ТипЗначения.СодержитТип(Тип("Число")));
Сообщить("Уровней: " + Строка(Товар.КоличествоУровней()));
Сообщить("Открытых уровней: " + Строка(Товар.КоличествоОткрытыхУровней));
Сообщить("Реквизитов поля: " + Строка(Товар.Реквизиты.Количество()));
Сообщить(Диаграмма.Поля.Найти("ОтсутствующееУчебноеПоле") = Неопределено);
Изображение = Диаграмма.ПолучитьКартинку(900, 500, ФорматКартинки.PNG);
Сообщить(ТипЗнч(Изображение) = Тип("Картинка"));
Рисунок = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Картинка);
Рисунок.Картинка = Изображение;
Рисунок.АвтоРазмер = Ложь;
Рисунок.Лево = 5;
Рисунок.Верх = 12;
Рисунок.Ширина = 180;
Рисунок.Высота = 100;
ТабДок.Область(1, 1).Текст = "Только учебные данные: книга 3/750, ручка 1/50; количество 4, сумма 800";
ТабДок.ТолькоПросмотр = Истина;
Возврат ТабДок;
КонецФункции
Разбор по шагам
Поля — коллекция всех полей источника; Точки и Ресурсы — выбранные роли.
Найти проверяем до чтения свойств, чтобы отсутствующее поле не вызвало непонятную ошибку.
ТипЗначения описывает допустимые значения, Измерение/Ресурс/Реквизит — их роль в результате.
Число уровней читаем из объекта: наш строковый товар не превращаем в иерархический справочник.
Как проверить результат
Семь явных сравнений Истина: роли, типы, имя и отсутствие неизвестного поля.
Реквизиты и уровни показаны отдельно; никакое свойство роли не переписывается.
Ожидаемый результат
Понятны тип и роль полей для настройки осей и ресурсов.
На что обратить внимание
Не выбирайте ресурс лишь по имени Сумма: проверьте итоги запроса.
КоличествоОткрытыхУровней не равно количеству товарных строк.
СводнаяДиаграмма доступна на сервере/в толстом клиенте. Здесь тонкому клиенту возвращается обычный табличный документ с картинкой, не интерактивная сводная диаграмма.
Количество и сумма имеют разные единицы: совместная учебная шкала не подходит для достоверного бизнес-сравнения величин.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прочитать роль, тип и уровни полей сводной таблицы
Имя поля приходит из запроса, а не из подписи ячейки. Сравниваем измерение Товар и ресурс Сумма, проверяя наличие до обращения к свойствам.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Источник = Новый ТаблицаЗначений;
Источник.Колонки.Добавить("Товар", Новый ОписаниеТипов("Строка"));
Источник.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
Источник.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число"));
СтрокаТовара = Источник.Добавить();
СтрокаТовара.Товар = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара.Сумма = 750;
СтрокаТовара = Источник.Добавить();
СтрокаТовара.Товар = "Ручка";
СтрокаТовара.Количество = 1;
СтрокаТовара.Сумма = 50;
Менеджер = Новый МенеджерВременныхТаблиц;
Запрос = Новый Запрос;
Запрос.МенеджерВременныхТаблиц = Менеджер;
Запрос.УстановитьПараметр("Источник", Источник);
Запрос.Текст = "ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
|ПОМЕСТИТЬ ВТУчебныеТовары ИЗ &Источник КАК Д;
|ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
|ИЗ ВТУчебныеТовары КАК Д
|ИТОГИ СУММА(Количество), СУММА(Сумма) ПО Товар";
Попытка
Пакет = Запрос.ВыполнитьПакет();
Результат = Пакет.Получить(1);
Исключение
Менеджер.Закрыть();
ВызватьИсключение;
КонецПопытки;
Менеджер.Закрыть();
Сводная = ТабДок.ВстроенныеТаблицы.Добавить(Тип("СводнаяТаблица"), ТабДок.Область(2, 1));
Сводная.Имя = "УчебныеТовары";
Сводная.ИсточникДанных = Результат;
Сводная.Строки.Добавить("Товар");
Сводная.Данные.Добавить("Количество");
Сводная.Данные.Добавить("Сумма");
Сводная.Обновить();
Товар = Сводная.Поля.Найти("Товар");
Сумма = Сводная.Поля.Найти("Сумма");
Если Товар = Неопределено Или Сумма = Неопределено Тогда
ВызватьИсключение "В собственном результате ожидаются Товар и Сумма";
КонецЕсли;
Сообщить(Товар.Имя = "Товар");
Сообщить(Товар.Измерение);
Сообщить(Сумма.Ресурс);
Сообщить(Не Товар.Реквизит);
Сообщить(Товар.ТипЗначения.СодержитТип(Тип("Строка")));
Сообщить(Сумма.ТипЗначения.СодержитТип(Тип("Число")));
Сообщить("Уровней товара: " + Строка(Товар.КоличествоУровней()));
Сообщить("Открытых уровней: " + Строка(Товар.КоличествоОткрытыхУровней));
Сообщить("Реквизитов товара: " + Строка(Товар.Реквизиты.Количество()));
Сообщить(Сводная.Поля.Найти("НесуществующееПоле") = Неопределено);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Коллекция Поля описывает все поля источника, а Строки/Данные — выбранные роли отображения.
Найти может вернуть Неопределено; сначала проверяем оба поля.
ИТОГИ запроса сделали Сумма ресурсом, а Товар измерением; реквизит — отдельная роль.
Уровни и открытые уровни читаем из фактического объекта, не принимаем строку товара за иерархический справочник.
Как проверить результат
Семь сравнений Истина: имена/роли/типы и отсутствие неизвестного поля.
Числа уровней и реквизитов изучите в выводе; собственный Товар — обычная строка, не ссылка.
Ожидаемый результат
Понятны разные роли поля запроса и его типизированное значение.
На что обратить внимание
Роль ресурса задаётся итогами запроса, не названием Сумма самим по себе.
Найти ищет имя поля запроса, а не текст произвольной ячейки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.