ГруппировкаДиаграммыКомпоновкиДанных.ИдентификаторПользовательскойНастройки

Свойства · UserSettingID

Тип: Строка. Предназначен для идентификации пользовательской настройки. Если идентификатор не пустой, объект включается в состав пользовательских настроек.

Полное описание, параметры и ограничения

ГруппировкаДиаграммыКомпоновкиДанных.ИдентификаторПользовательскойНастройки (DataCompositionChartGroup.UserSettingID)

ГруппировкаДиаграммыКомпоновкиДанных (DataCompositionChartGroup)

ИдентификаторПользовательскойНастройки (UserSettingID)

Доступен, начиная с версии 8.2.

Использование:
Чтение и запись.
Описание:
Тип: Строка.
Предназначен для идентификации пользовательской настройки.
Если идентификатор не пустой, объект включается в состав пользовательских настроек.
Доступность:

Сервер, толстый клиент, внешнее соединение.

Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация

Практические примеры

Подписать пользовательские настройки, не подменяя идентификатор расшифровки

У диаграммы, серии и всей коллекции серий задаём разные собственные пользовательские идентификаторы. Идентификаторы расшифровки только читаем: в этих типах они не доступны для присваивания.

Где и как запускать

Полный код серверного общего модуля УчебныеДиаграммы85. ВыполнитьПример() вызывается из собственного серверного обработчика учебной команды. Код не запускается автоматически в справочнике.

Подготовка

  1. Работайте в отдельной учебной базе на платформе 8.5.1.1343. Справочники, документы, регистры и готовые макеты не нужны.

  2. Создайте общий модуль УчебныеДиаграммы85: Сервер — Да, Клиент — Нет, Привилегированный — Нет. Полностью вставьте код одного урока, а не оборачивайте его второй процедурой.

  3. В своей учебной обработке добавьте команду. Из её серверного обработчика вызовите УчебныеДиаграммы85.ВыполнитьПример();. Не вызывайте серверные объекты СКД непосредственно из тонкого клиента.

  4. Запрос содержит только три собственные константные строки: Север/Книга — 750, Север/Ручка — 50, Юг/Книга — 500. Продажи Севера — 800, Юга — 500, общая сумма — 1300.

  5. Серии будут магазинами, точки — товарами, ресурс — суммой продаж. Значение Книга складывается до 1250, Ручка — до 50. Количество единиц по всем строкам — 6, а число строк источника — 3.

  6. Каждый урок запускайте отдельно: он заново создаёт схему и настройки в памяти. Упражнения с настройками не формируют отчёт; отдельный урок показывает компоновку и вывод.

  7. Для просмотра объектов поставьте точку останова перед последними Сообщить. ТабличныйДокумент результата урока вывода находится в серверной переменной Результат; код не печатает, не сохраняет файл и не открывает окно клиента.

  8. Запуск в 1С здесь не проверялся. Приведены ожидаемые проверки собственной задачи, а не доказательство успешного формирования отчёта в любой конфигурации.

Процедура ВыполнитьПример() Экспорт
    Схема = Новый СхемаКомпоновкиДанных;
    Источник = Схема.ИсточникиДанных.Добавить();
    Источник.Имя = "УчебныеПродажи";
    Источник.ТипИсточникаДанных = "Local";
    Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
    Набор.Имя = "СвоиТриСтроки";
    Набор.ИсточникДанных = Источник.Имя;
    Набор.АвтоЗаполнениеДоступныхПолей = Истина;
    Набор.Запрос = "ВЫБРАТЬ
    |    ""Север"" КАК Магазин,
    |    ""Книга"" КАК Наименование,
    |    3 КАК Количество,
    |    750 КАК Сумма
    |ОБЪЕДИНИТЬ ВСЕ
    |ВЫБРАТЬ ""Север"", ""Ручка"", 1, 50
    |ОБЪЕДИНИТЬ ВСЕ
    |ВЫБРАТЬ ""Юг"", ""Книга"", 2, 500";
    Для Каждого ИмяРесурса Из СтрРазделить("Сумма,Количество", ",") Цикл
        Ресурс = Схема.ПоляИтога.Добавить();
        Ресурс.ПутьКДанным = ИмяРесурса;
        Ресурс.Выражение = "Сумма(" + ИмяРесурса + ")";
    КонецЦикла;
    Настройки = Схема.НастройкиПоУмолчанию;
    Диаграмма = Настройки.Структура.Добавить(Тип("ДиаграммаКомпоновкиДанных"));
    Диаграмма.Имя = "УчебныеПродажиПоМагазинам";
    Диаграмма.Использование = Истина;
    Выбранное = Диаграмма.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
    Выбранное.Поле = Новый ПолеКомпоновкиДанных("Сумма");
    Выбранное.Использование = Истина;
    Серия = Диаграмма.Серии.Добавить();
    Серия.Имя = "Магазины";
    Серия.Использование = Истина;
    ПолеСерии = Серия.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
    ПолеСерии.Поле = Новый ПолеКомпоновкиДанных("Магазин");
    ПолеСерии.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
    ПолеСерии.Использование = Истина;
    Точка = Диаграмма.Точки.Добавить();
    Точка.Имя = "Товары";
    Точка.Использование = Истина;
    ПолеТочки = Точка.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
    ПолеТочки.Поле = Новый ПолеКомпоновкиДанных("Наименование");
    ПолеТочки.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
    ПолеТочки.Использование = Истина;
    Диаграмма.ИдентификаторПользовательскойНастройки = "УчебнаяДиаграмма85";
    Диаграмма.ПредставлениеПользовательскойНастройки = "Продажи по магазинам";
    Диаграмма.РежимОтображения = РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Обычный;
    Серия.ИдентификаторПользовательскойНастройки = "УчебнаяГруппаМагазинов85";
    Серия.ПредставлениеПользовательскойНастройки = "Группировать продажи по магазину";
    Серия.РежимОтображения = РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Обычный;
    Серии = Диаграмма.Серии;
    Серии.ИдентификаторПользовательскойНастройки = "УчебныйСписокСерий85";
    Серии.ПредставлениеПользовательскойНастройки = "Список группировок магазинов";
    Серии.РежимОтображения = РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Обычный;
    Сообщить(Диаграмма.ИдентификаторПользовательскойНастройки <> Серия.ИдентификаторПользовательскойНастройки);
    Сообщить(Серия.ИдентификаторПользовательскойНастройки <> Серии.ИдентификаторПользовательскойНастройки);
    Сообщить(Диаграмма.ПредставлениеПользовательскойНастройки = "Продажи по магазинам");
    Сообщить(Серия.ПредставлениеПользовательскойНастройки = "Группировать продажи по магазину");
    Сообщить(Серии.ПредставлениеПользовательскойНастройки = "Список группировок магазинов");
    Сообщить(Диаграмма.РежимОтображения = Серия.РежимОтображения И Серия.РежимОтображения = Серии.РежимОтображения);
    Сообщить("Идентификатор расшифровки диаграммы: " + Диаграмма.Идентификатор);
    Сообщить("Идентификатор расшифровки серии: " + Серия.Идентификатор);
КонецПроцедуры

Разбор по шагам

  1. Имя уже задано для навигации по дереву. ПредставлениеПользовательскойНастройки — отдельная понятная человеку подпись.

  2. Непустой ИдентификаторПользовательскойНастройки отмечает настройку для включения в пользовательские настройки. Для трёх разных объектов выбираем разные ключи.

  3. Настройка коллекции Серии относится ко всему её списку, а настройка Серия — к одному элементу списка.

  4. Режим Обычный относится к отображению настройки, не задаёт тип гистограммы или порядок продаж.

  5. Идентификатор расшифровки диагностически выводим без ожидания определённой строки или непустоты. Пользовательский идентификатор не записываем в это свойство.

Как проверить результат

  1. Ожидаются шесть сравнений Истина и две строки с диагностическими идентификаторами.

  2. Переименуйте представление серии в Магазины для сравнения. Код продолжит различать её по собственному пользовательскому ключу; сам ключ и Имя не обязаны совпадать.

Ожидаемый результат

Разделены три назначения меток: имя узла, подпись пользовательской настройки и идентификатор расшифровки.

На что обратить внимание

  1. Идентификатор у этих объектов — только чтение. Присваивание, допустимое у обычной группировки другого типа, здесь не переносится автоматически.

  2. Код работает с основным деревом настроек, а не с копиями элементов в ПользовательскиеНастройкиКомпоновкиДанных.

  3. Само назначение ключей не открывает редактор настроек и не сохраняет вариант в хранилище.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.