Возвращает количество используемых внутри настроек (у которых установлено свойство Использование). Для расчета используется количество включенных элементов.
Синтаксис
ПолучитьКоличествоИспользуемых()Полное описание, параметры и ограничения
ПользовательскиеНастройкиКомпоновкиДанных.ПолучитьКоличествоИспользуемых (DataCompositionUserSettings.GetUsedCount)
ПользовательскиеНастройкиКомпоновкиДанных (DataCompositionUserSettings)
ПолучитьКоличествоИспользуемых (GetUsedCount)
Доступен, начиная с версии 8.5.1.
Синтаксис:
ПолучитьКоличествоИспользуемых()
Возвращаемое значение:
Тип: Число.
Описание:
Возвращает количество используемых внутри настроек (у которых установлено свойство Использование).
Для расчета используется количество включенных элементов.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.5.1.
Методическая информация
Практические примеры
Отличить число пользовательских настроек от числа включённых
Собственный контейнер содержит два порога. Настройки здесь не привязаны к основной схеме и не фильтруют запрос; это упражнение по хранению пользовательских значений.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В отдельной учебной базе 8.5.1.1343 создайте серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и вызовите своей учебной командой.
Схема СКД строится программно, макет в конфигурации не нужен. Источник Local выполняет запрос из двух собственных константных строк, без справочников, документов и регистров.
Каждое упражнение запускайте отдельно. Книга: 3 × 250 = 750; Ручка: 1 × 50 = 50; общая сумма 800. Результат хранится в памяти, не записывается в файл или базу.
Для исследования поставьте точку останова перед последними проверками. ТаблицаЗначений и процессоры СКД здесь создаются и используются на сервере; напрямую в тонкий клиент таблица не возвращается.
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныйИсточник";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "УчебныеТовары";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 250 КАК Цена,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Ручка"", 1, 50, 50";
Настройки = Схема.НастройкиПоУмолчанию;
Для Каждого ИмяПоля Из СтрРазделить("Наименование,Количество,Цена,Сумма", ",") Цикл
Выбранное = Настройки.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных(ИмяПоля);
Выбранное.Использование = Истина;
КонецЦикла;
Детали = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
Детали.Использование = Истина;
АвтоВыбор = Детали.Выбор.Элементы.Добавить(Тип("АвтоВыбранноеПолеКомпоновкиДанных"));
АвтоВыбор.Использование = Истина;
Пользовательские = Новый ПользовательскиеНастройкиКомпоновкиДанных;
Первый = Пользовательские.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
Первый.ИдентификаторПользовательскойНастройки = "УчебныйПорог";
Первый.Использование = Истина;
Первый.ПравоеЗначение = 1;
Второй = Пользовательские.Элементы.Вставить(0, Тип("ЭлементОтбораКомпоновкиДанных"));
Второй.ИдентификаторПользовательскойНастройки = "УчебныйВторойПорог";
Второй.Использование = Ложь;
Второй.ПравоеЗначение = 2;
Пользовательские.ДополнительныеСвойства.Вставить("УчебнаяЗадача", "Пороги количества");
Сообщить(Пользовательские.Элементы.Количество() = 2);
Сообщить(Пользовательские.ПолучитьКоличествоИспользуемых() = 1);
Сообщить(Пользовательские.Элементы.Найти("УчебныйПорог") = Первый);
Сообщить(Пользовательские.Элементы.Найти("НетТакойНастройки") = Неопределено);
Сообщить(Пользовательские.Элементы.Получить(0) = Второй);
Сообщить(Пользовательские.Элементы.Индекс(Первый) = 1);
Сообщить(Пользовательские.ДополнительныеСвойства.УчебнаяЗадача = "Пороги количества");
Дополнительные = Пользовательские.ДополнительныеНастройки;
Если Дополнительные <> Неопределено Тогда
Сообщить("Дополнительных настроек: " + Строка(Дополнительные.Элементы.Количество()));
КонецЕсли;Разбор по шагам
Добавить/Вставить создают пользовательские элементы отбора. ЛевоеЗначение здесь не задаётся: оно недоступно для редактирования пользовательской копии и должно приходить из основных настроек.
Первый порог включён, второй отключён. Оба остаются в коллекции.
Найти использует строковый пользовательский идентификатор; отсутствие возвращает Неопределено.
ДополнительныеСвойства содержит свою служебную метку. ДополнительныеНастройки читаем с проверкой отсутствия и не приписываем ему фиксированное количество.
Как проверить результат
Семь сравнений Истина. Всего элементов 2, включённых 1; возможный дополнительный счётчик диагностический.
Измените только Второй.Использование на Истина: включённых станет 2, общая численность останется 2.
Ожидаемый результат
Показаны пользовательские значения и раздельные показатели общего/активного состава.
На что обратить внимание
Метод ПолучитьКоличествоИспользуемых добавлен в 8.5.1; здесь целевая платформа именно этой версии.
Без основных настроек и их связи эти пороги не образуют законченный отбор отчёта.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Адресовать и удалить только собственные пользовательские пороги
Идентификатор объекта настройки и его пользовательская строковая метка — разные значения. Проверяем обратное получение, затем порядок и локальную очистку.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В отдельной учебной базе 8.5.1.1343 создайте серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и вызовите своей учебной командой.
Схема СКД строится программно, макет в конфигурации не нужен. Источник Local выполняет запрос из двух собственных константных строк, без справочников, документов и регистров.
Каждое упражнение запускайте отдельно. Книга: 3 × 250 = 750; Ручка: 1 × 50 = 50; общая сумма 800. Результат хранится в памяти, не записывается в файл или базу.
Для исследования поставьте точку останова перед последними проверками. ТаблицаЗначений и процессоры СКД здесь создаются и используются на сервере; напрямую в тонкий клиент таблица не возвращается.
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныйИсточник";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "УчебныеТовары";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 250 КАК Цена,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Ручка"", 1, 50, 50";
Настройки = Схема.НастройкиПоУмолчанию;
Для Каждого ИмяПоля Из СтрРазделить("Наименование,Количество,Цена,Сумма", ",") Цикл
Выбранное = Настройки.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных(ИмяПоля);
Выбранное.Использование = Истина;
КонецЦикла;
Детали = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
Детали.Использование = Истина;
АвтоВыбор = Детали.Выбор.Элементы.Добавить(Тип("АвтоВыбранноеПолеКомпоновкиДанных"));
АвтоВыбор.Использование = Истина;
Пользовательские = Новый ПользовательскиеНастройкиКомпоновкиДанных;
Первый = Пользовательские.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
Первый.ИдентификаторПользовательскойНастройки = "УчебныйПорог";
Первый.Использование = Истина;
Первый.ПравоеЗначение = 1;
Второй = Пользовательские.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
Второй.ИдентификаторПользовательскойНастройки = "УчебныйВторойПорог";
Второй.Использование = Истина;
Второй.ПравоеЗначение = 2;
Идентификатор = Пользовательские.ПолучитьИдентификаторПоОбъекту(Первый);
Если Идентификатор = Неопределено Тогда
ВызватьИсключение "Не найден собственный пользовательский порог";
КонецЕсли;
Сообщить(Пользовательские.ПолучитьОбъектПоИдентификатору(Идентификатор) = Первый);
Пользовательские.Элементы.Сдвинуть(Второй, -1);
Сообщить(Пользовательские.Элементы.Получить(0) = Второй);
Пользовательские.Элементы.Удалить(Второй);
Сообщить(Пользовательские.Элементы.Количество() = 1);
Сообщить(Пользовательские.Элементы.Найти("УчебныйПорог") = Первый);
Пользовательские.Элементы.Очистить();
Сообщить(Пользовательские.Элементы.Количество() = 0);
Сообщить(Пользовательские.ПолучитьКоличествоИспользуемых() = 0);Разбор по шагам
Получаем идентификатор через контейнер, проверяя его до обратного получения.
Второй сдвигаем на -1: это одна позиция к началу, не отрицательный индекс Получить.
Удалить получает конкретный созданный объект. Оставшийся Первый находится по своей строковой метке.
Очистить очищает только собственный объект Пользовательские в памяти; типовые настройки хранения не затрагиваются.
Как проверить результат
Шесть сравнений Истина; после удаления остаётся 1, после очистки 0.
В коде нет сохранения варианта отчёта или вызова хранилища настроек.
Ожидаемый результат
Проверены адресация, перестановка, удаление и очистка собственной коллекции.
На что обратить внимание
После удаления не используйте старую объектную ссылку как доказательство наличия элемента в контейнере.
Этот отдельный контейнер не подменяет Редактор.ПользовательскиеНастройки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.