Тип: Произвольный. Содержит значение, идентифицирующее серию в методе диаграммы УстановитьСерию. Строковое представление значения используется для представления серии, если свойство Текст не установлено.
Полное описание, параметры и ограничения
СерияДиаграммы.Значение (ChartSeries.Value)
СерияДиаграммы (ChartSeries)
Значение (Value)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Произвольный.
Содержит значение, идентифицирующее серию в методе диаграммы УстановитьСерию. Строковое представление значения используется для представления серии, если свойство Текст не установлено.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Отключить служебные подписи «СерияN» и задать понятные названия
Ключ серии sales остаётся техническим идентификатором, а её текст объясняет показатель читателю. Автоматические тексты не заменяют названия единиц измерения.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе создайте новую внешнюю обработку УчебнаяДиаграмма с пустой управляемой формой; назначьте форму основной.
Не создавайте реквизит График и поле ДиаграммаТоваров вручную: код создаёт их в ПриСозданииНаСервере.
В свойствах формы → События назначьте ПриСозданииНаСервере одноимённой процедуре. Сохраните EPF и откройте её в учебном тонком клиенте Windows.
Каждый урок использует отдельный модуль/копию формы. Данные вымышлены: план и факт в штуках за три месяца, не данные учёта.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("График", Новый ОписаниеТипов("Диаграмма")));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Диаграмма = Новый Диаграмма;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
Диаграмма.АвтоУстановкаИменСерий = Ложь;
Диаграмма.АвтоУстановкаИменТочек = Ложь;
Диаграмма.АвтоУстановкаТекстаСерий = Ложь;
Диаграмма.АвтоУстановкаТекстаТочек = Ложь;
Продажи = Диаграмма.УстановитьСерию("sales");
Продажи.Текст = "Продано, шт.";
Сентябрь = Диаграмма.УстановитьТочку("2026-09");
Сентябрь.Текст = "Сентябрь 2026";
Октябрь = Диаграмма.УстановитьТочку("2026-10");
Октябрь.Текст = "Октябрь 2026";
Диаграмма.УстановитьЗначение(Сентябрь, Продажи, 8);
Диаграмма.УстановитьЗначение(Октябрь, Продажи, 11);
ПовторнаяСерия = Диаграмма.УстановитьСерию("sales");
Сообщить(Диаграмма.Серии.Количество() = 1);
Сообщить(ПовторнаяСерия.Значение = "sales");
Сообщить(ПовторнаяСерия.Текст = "Продано, шт.");
Сообщить(Сентябрь.Значение = "2026-09" И Сентябрь.Текст = "Сентябрь 2026");
Диаграмма.ОбластьЗаголовка.Текст = "Понятная подпись не меняет устойчивый ключ";
ЭтаФорма.График = Диаграмма;
Поле = Элементы.Добавить("ДиаграммаТоваров", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеДиаграммы;
Поле.ПутьКДанным = "График";
Поле.РастягиватьПоГоризонтали = Истина;
Поле.РастягиватьПоВертикали = Истина;
КонецПроцедуры
Разбор по шагам
Настраиваем автоматическую генерацию до создания серий и точек. В API сохранены названия свойств Имен и Текста; пример показывает обе доступные формы.
Строка sales — устойчивый ключ для УстановитьСерию. Текст «Продано, шт.» служит отображению.
Ключи месяцев ISO-подобны и не зависят от языка подписей. Текст можно локализовать без смены ключа.
Повторный УстановитьСерию с тем же ключом получает существующую серию: её не следует создавать по изменяемому заголовку.
Проверяем одну серию, исходный ключ и явные пользовательские подписи.
Как проверить результат
Четыре сравнения Истина. На форме нет технических «СерияN» вместо названия показателя.
Измените только Текст на «Sales, pcs.» в собственной копии: ключ sales и количество серий остаются прежними.
Ожидаемый результат
Названия интерфейса отделены от ключей источника, повторный доступ не создаёт дубликат.
На что обратить внимание
Подпись не гарантированно уникальна и может меняться с языком. Не используйте её как идентификатор обмена.
Отключение автоматического текста требует явно заполнить подписи: пустая легенда не станет понятнее сама.
Ключ sales здесь принадлежит собственной диаграмме, не является полем запроса или именем регистра.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Построить диаграмму план/факт с ключами и расшифровкой
Три точки-месяца и две серии-показателя образуют шесть числовых значений. Подписи не заменяют устойчивые ключи.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе создайте новую внешнюю обработку УчебнаяДиаграмма с пустой управляемой формой; назначьте форму основной.
Не создавайте реквизит График и поле ДиаграммаТоваров вручную: код создаёт их в ПриСозданииНаСервере.
В свойствах формы → События назначьте ПриСозданииНаСервере одноимённой процедуре. Сохраните EPF и откройте её в учебном тонком клиенте Windows.
Каждый урок использует отдельный модуль/копию формы. Данные вымышлены: план и факт в штуках за три месяца, не данные учёта.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("График", Новый ОписаниеТипов("Диаграмма")));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Диаграмма = Новый Диаграмма;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
План = Диаграмма.УстановитьСерию("plan");
План.Текст = "План, шт.";
Факт = Диаграмма.УстановитьСерию("actual");
Факт.Текст = "Факт, шт.";
Месяцы = Новый Массив;
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-01", "Январь", 10, 8));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-02", "Февраль", 12, 11));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-03", "Март", 15, 16));
Для Каждого Месяц Из Месяцы Цикл
Точка = Диаграмма.УстановитьТочку(Месяц.Ключ);
Точка.Текст = Месяц.Название;
Диаграмма.УстановитьЗначение(Точка, План, Месяц.План);
Диаграмма.УстановитьЗначение(Точка, Факт, Месяц.Факт);
КонецЦикла;
План.Цвет = Новый Цвет(70, 110, 190);
Факт.Цвет = Новый Цвет(30, 140, 110);
План.Расшифровка = Новый Структура("Показатель", "plan");
Факт.Расшифровка = Новый Структура("Показатель", "actual");
Для Каждого Месяц Из Месяцы Цикл
Точка = Диаграмма.УстановитьТочку(Месяц.Ключ);
Точка.Расшифровка = Новый Структура("Месяц", Месяц.Ключ);
Точка.Цвет = Новый Цвет(120, 120, 120);
Точка.ПриоритетЦвета = Ложь;
Диаграмма.УстановитьЗначение(Точка, Факт, Месяц.Факт,
Новый Структура("Месяц,Показатель", Месяц.Ключ, "actual"),
СтрШаблон("%1: фактически %2 шт.", Месяц.Название, Месяц.Факт));
КонецЦикла;
Январь = Диаграмма.УстановитьТочку("2026-01");
ЗначениеЯнваря = Диаграмма.ПолучитьЗначение(Январь, Факт);
Сообщить(Диаграмма.КоличествоТочек = 3);
Сообщить(Диаграмма.КоличествоСерий = 2);
Сообщить(Январь.Значение = "2026-01");
Сообщить(Факт.Значение = "actual");
Сообщить(ЗначениеЯнваря.Значение = 8);
Сообщить(ЗначениеЯнваря.Расшифровка.Месяц = "2026-01");
Сообщить(ЗначениеЯнваря.Подсказка = "Январь: фактически 8 шт.");
Сообщить(ЗначениеЯнваря.Серия.Значение = "actual");
Сообщить(ЗначениеЯнваря.Точка.Значение = "2026-01");
Диаграмма.ОбластьЗаголовка.Текст = "Учебный план и факт, шт.";
ЭтаФорма.График = Диаграмма;
Поле = Элементы.Добавить("ДиаграммаТоваров", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеДиаграммы;
Поле.ПутьКДанным = "График";
Поле.РастягиватьПоГоризонтали = Истина;
Поле.РастягиватьПоВертикали = Истина;
КонецПроцедуры
Разбор по шагам
УстановитьСерию и УстановитьТочку находят существующий объект по ключу или создают новый. Повторный ключ не должен добавлять дубликат.
Текст — человекочитаемая подпись, Значение — ключ plan/actual или 2026-01. Эти роли не смешиваем.
В матрице шесть значений. ПолучитьЗначение возвращает объект со свойствами Значение, Серия, Точка, Подсказка и Расшифровка.
У серий свои цвета; ПриоритетЦвета точки Ложь сохраняет различие показателей. Серая настройка точки не должна маскировать план и факт.
Расшифровка — наши данные для будущего обработчика нажатия, не автоматически открываемый документ.
Как проверить результат
На форме три месяца с двумя столбцами: план 10/12/15, факт 8/11/16.
Все проверки объекта январского факта дают Истина: ключи, число 8, подсказка и расшифровка.
Наведение на январский факт показывает Январь: фактически 8 шт.; документ по нажатию не открывается, обработчик здесь не задан.
Ожидаемый результат
Создана полноценная диаграмма с независимыми ключами, подписями, цветами и собственными данными расшифровки.
На что обратить внимание
Значение диаграммы не является значением точки: 8 — факт, а 2026-01 — ключ месяца.
Ссылки на серию/точку перестают быть действительными после удаления соответствующего элемента.
Здесь нет денежной единицы и нет данных рабочей базы: подписываем именно штуки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.