Предыдущие выпуски (1.5–1.9)

1.9.0 (2026-03-16)

Этот выпуск посвящён улучшению структуры кода для подготовки новых возможностей и упрощения сопровождения. Работы ещё много, но изменения дают более удобную основу для дальнейшего развития.

Проведён масштабный рефакторинг, при этом пользовательский интерфейс и возможности Deneb должны остаться такими же, как раньше. В ходе работы также удалось повысить производительность и исправить ряд ошибок; подробности приведены ниже.

Изменения интерфейса расширенного редактора

Часть улучшений производительности касается внутренней логики редактора, в том числе расчёта расположения элементов. Это ускоряет переход между просмотром и редактированием и приводит к некоторым видимым изменениям в расширенном редакторе, который также должен стать отзывчивее:

• Чтобы редактор было легче найти, теперь есть два способа его открыть:
  • Выбрать Edit... в заголовке визуала.
  • Перейти в режим фокусировки при редактировании в Power BI Desktop или Service.
• Изменение размеров панелей редактора, отладки и предварительного просмотра переведено на современный компонент с более надёжной поддержкой. Границы между областями стали аккуратнее, а изменение размеров — отзывчивее.

Небольшие улучшения

• Свойство Discrete ordinal colors больше не требуется для порядковой шкалы с цветовыми схемами pbiColorOrdinal, pbiColorLinear или pbiColorDivergent и удалено. Deneb автоматически интерполирует цвета по уникальным значениям шкалы.
• Порядок сигналов по умолчанию теперь естественный, как в Vega Editor (#490). Сортировка по имени по возрастанию или убыванию по-прежнему доступна по щелчку заголовка столбца.
• Документация элементов автодополнения, открываемая кнопкой «>», если она есть, теперь правильно отображает Markdown (#569).

Производительность и стабильность

• Пользовательские визуалы не могут загружаться так же быстро, как встроенные, но инициализация существенно улучшена. Deneb открывается для пользователей отчётов обычно на 15–40% быстрее, в зависимости от сложности визуала и набора данных.

• Процесс создания и управления идентификаторами выбора Power BI для интерактивности переписан и улучшен:

  • Идентификаторы больше не добавляются в основной набор данных, где раньше скрывались в интерфейсе.
  • Это убирает глубоко вложенные объекты из каждой строки, уменьшает расход памяти и ускоряет компиляцию спецификаций.
  • Обработка набора данных в целом также существенно оптимизирована. В некоторых случаях после передачи результата запроса Power BI наблюдалось улучшение на 200–300%.

• Пакет визуала стал на 5% меньше, чем в предыдущем выпуске, и на 12% меньше версии 1.7. Это ускоряет загрузку и инициализацию.

• Интерфейс переведён с React 17 на React 19.2. Это даёт некоторые промежуточные улучшения производительности и позволит использовать современные механизмы React в следующих выпусках.

Документация

• Руководство PBIR объясняет работу с Deneb в расширенном формате отчётов Power BI (PBIR). В нём подробно описана внутренняя система свойств Deneb и их влияние на результат отрисовки. Это полезно для автоматизации создания визуалов — самостоятельно или совместно с большой языковой моделью (LLM).

Исправления ошибок

• При создании шаблона поля набора данных без назначенных псевдонимов показывались и экспортировались как пустые строки (#564).
• Открытие просмотра сигналов, содержавших методы, приводило к критическому сбою (#570).

1.8.2 (2025-10-08)

Обновления Vega

• Vega обновлена до 6.2.0 с 6.1.2.
• Vega-Lite обновлена до 6.4.1 с 6.1.0.

Файл отчёта с примерами

• Многие примеры дополнены комментариями в JSON-спецификациях, объясняющими решения и возможности языка, использованные при создании визуализаций. Спасибо Imran Haq!

Улучшения удобства работы

• Внутри контейнера визуала курсор установлен в auto, чтобы понятнее показывать назначение элементов (#552).

Исправления ошибок

• В сертифицированной версии AppSource изображения с data URL больше не должны вызывать сообщение Remote resources cannot be loaded (#555).
• Настройки width, height или autosize в конфигурации, конфликтующие с внутренними изменениями Deneb, больше не приводят к зависанию визуала при разборе или изменении размеров (#514).

1.8.1 (2025-08-08)

Исправления ошибок

• Автодополнение теперь правильно обновляется при вводе (#551). Причиной были изменения SDK визуалов, связанные с упаковкой для сертификации. Исправление также должно уменьшить другие замеченные задержки при вводе в редакторе.

1.8.0 (2025-07-16)

Обновления платформы

Microsoft ввела более строгие требования к сертификации пользовательских визуалов. Необходимые изменения применены во всём коде Deneb, включая улучшения безопасности и переход к новейшим API визуалов. Видимых изменений быть не должно, но создайте обращение, если заметите нежелательные последствия этих обновлений.

Обновления Vega

• Vega обновлена до 6.1.2 с 5.30.0.
• Vega-Lite обновлена до 6.1.0 с 5.19.0.

При тестировании участники сообщества обнаружили особый случай, когда визуал перестал работать. Причиной были предупреждения в спецификации и более строгая проверка, введённая в Vega-Lite 5.21.0. Если ранее рабочая спецификация перестала работать, сначала проверьте предупреждения, устраните их и повторите проверку, прежде чем создавать обращение.

Удаление сопоставления полей при редактировании спецификации

С момента появления сопоставление полей вызывало у части пользователей проблемы. Они мешали разработке, когда набор данных менялся вне визуала — обычно при удалении или переименовании поля в интерфейсе Power BI. В последнее время проблемы участились и проявлялись у пользователей по-разному, что затрудняло отладку и поддержку.

В версии 1.7 появился более развитый редактор JSON с поиском и заменой (Ctrl + F / Ctrl + H), поэтому такие ситуации по-прежнему можно достаточно удобно решать. Это избавляет разработчиков от сопровождения функции интерфейса, которая многим мешала. Поскольку также идёт подготовка к прекращению развития ветки Deneb v1.x с дальнейшим упором на долгосрочную стабильность, потенциально ненадёжную функцию решено удалить.

Небольшие улучшения

• При включённом интерфейсе взаимодействия непосредственно с объектом (on-object interaction) Power BI Desktop двойной щелчок по Deneb переводил визуал в режим форматирования. Это действие подавлено.

Исправления ошибок

• Специальные символы в имени поля всё ещё попадали в результаты автодополнения (#548).

1.7.2 (2024-09-04)

Небольшие улучшения

• Оформление элементов ввода приведено к Vega Editor, что улучшает их расположение.

Исправления ошибок

• Внутренние гиперссылки Monaco command:// больше не вызывают API Microsoft для открытия URL (#491).
• Deneb теперь работает в среде без защищённого соединения (HTTP) (#488, #493).

1.7.1 (2024-08-05)

Обновления Vega

• Vega-Lite обновлена до 5.20.1 с 5.19.0.

Небольшие улучшения

• Сигнал pbiContainer теперь доступен и обновляется при прокрутке фасетных и повторяющихся спецификаций (#474).

Исправления ошибок

• pbiFormat неправильно вычислял значения некоторых числовых полей подсказок (#483).
• Область отображения не обновлялась в режиме фокусировки для спецификаций Vega (#481).
• Гиперссылки, оформленные моноширинным шрифтом, не открывались в подсказках документации (#473).
• При прокрутке высота и ширина сигнала pbiContainer получали значения полной высоты и ширины содержимого с учётом прокрутки (#475).

1.7.0 (2024-07-10)

Обновления Vega

• Vega обновлена до 5.30.0 с 5.26.1.
• Vega-Lite обновлена до 5.19.0 с 5.16.3.

Тёмная тема

Теперь расширенный редактор Deneb можно показывать в светлой теме, используемой по умолчанию, или в тёмной.

• Изменить тему можно одним из способов:

  • Нажать кнопку темы справа вверху на панели инструментов расширенного редактора.
  • Использовать сочетание [Ctrl + Shift + Alt + T].
  • Задать свойство Advanced editor > Interface > Theme на панели форматирования.

• Значение Dark свойства Theme меняет оформление интерфейса, например:

  

• Область предварительного просмотра остаётся белой, потому что это текущий фон отчёта. Так вы видите, как визуализация будет выглядеть на странице отчёта.

• Чтобы сделать область предварительного просмотра тёмной, установите Advanced editor > Preview area > Apply background settings to preview area в Off. Учтите, что это может ухудшить доступность при редактировании, например:

  

Редактор Monaco для JSON

Пользовательские визуалы Power BI имеют серьёзные ограничения на встраиваемые компоненты. Работа в версии 1.6 и этом выпуске позволила включить Monaco Editor — компонент из Vega Editor, Visual Studio Code и многих частей Power BI Desktop — для редактирования JSON! 🚀

Теперь доступны многие преимущества редактирования спецификаций в Vega Editor. Основные из них описаны ниже.

Комментарии

Редактор и система шаблонов теперь поддерживают JSON с комментариями (JSONC)! 🎉🎉

• Комментарии можно использовать для пояснения спецификации или отключения её частей при отладке.
• Поддерживаются строчные (//) и блочные (/* */) комментарии.
• Для этих операций есть сочетания клавиш:
  • [Ctrl + /] — переключить строчный комментарий.
  • [Shift + Alt + A] — переключить блочный комментарий.

Автодополнение

JSON-схемы Vega и Vega-Lite встроены в автодополнение редактора, поэтому нужные свойства легче находить. Оно запускается при вводе или вручную сочетанием [Ctrl + Space].

Встроенная документация

Разработчики Vega-Lite добавили подробные сведения о многих ключевых словах. При наведении на элемент с такой документацией она отображается во всплывающем окне, например:

Ссылки в этой документации можно нажать, чтобы открыть соответствующую страницу в новой вкладке браузера.

Улучшенное выделение проблем

Предупреждения и ошибки схемы теперь заметнее отмечаются в редакторе, например:

При наведении на отметку показываются подробности проблемы.

Перенос команды форматирования

Форматирование больше не вызывается кнопкой панели инструментов. Теперь используется встроенный механизм Monaco, доступный в контекстном меню или прежним сочетанием [Ctrl + Alt + R]:

Выход из редактора для навигации по интерфейсу

Сочетание [Ctrl + M] переключает Tab между обычной вставкой отступа и навигацией по интерфейсу, позволяя перейти из редактора к другим элементам.

Сохранение состояния редактора

Раньше изменения вида редактора — например свёрнутые участки — терялись при выходе или форматировании JSON. Теперь они сохраняются в текущем сеансе: до ухода с текущей страницы отчёта с повторной инициализацией визуала либо закрытия и повторного открытия файла отчёта.

Изменения pbiFormat

Vega-Lite допускает разные значения свойства format для пользовательских типов форматирования. Теперь можно передать объект или нужную строку форматирования. Подробнее — на странице «Форматирование значений».

Тип форматирования pbiFormatAutoUnit

Этот тип удобен для воспроизведения единиц Auto, часто используемых в других визуалах Power BI. Он применяет ту же логику Power BI для преобразования значений в K, M, Bn и т. п. Подробнее — на странице «Форматирование значений».

Сигнал pbiContainer

В представлении Vega появился сигнал pbiContainer, предоставляющий сведения о контейнере визуала в выражениях, например:

Его можно применять для отслеживания прокрутки контейнера. Подробности приведены на странице «Прокрутка и выход за границы».

Расширенная перекрёстная фильтрация

• Разработчики, использующие Vega, получают больше контроля над перекрёстной фильтрацией между спецификацией и Power BI.

• Настройка Cross-filtering (selection) of data points переименована в Expose cross-filtering values for dataset rows. При её включении доступны два режима:

  

  • Simple:
    • Deneb, как и раньше, пытается сопоставить точки данных с примитивами и передаёт выбор в Power BI.
    • Поддерживается для Vega и Vega-Lite; рекомендуется для простого управления перекрёстной фильтрацией.
    • Ограничения остаются, поскольку это относительно простое дополнение к представлению Vega со стороны Deneb.
  • Advanced:
    • Deneb не отслеживает щелчки по примитивам: всеми событиями перекрёстной фильтрации управляет автор.
    • Этот режим нельзя выбрать для спецификаций Vega-Lite.

• В режиме Advanced для сигналов Vega доступны две новые функции выражений:

  • pbiCrossFilterApply(event, filter?, options?): для текущей цели события фильтрует исходный набор данных Power BI по заданным правилам и просит Power BI применить перекрёстную фильтрацию по полученному результату.
  • pbiCrossFilterClear(): явно просит Power BI очистить текущий выбор перекрёстной фильтрации.

• Эта сложная тема требует более подробной документации, чем примечания к выпуску. Настройка и возможности описаны на странице «Расширенная перекрёстная фильтрация».

Другие улучшения

• Именам сигналов на панели отладки выделено больше места, поэтому они реже обрезаются. Если имя всё же обрезано, наведите на него указатель, чтобы увидеть полное имя в подсказке (#400).

Производительность и стабильность

• Проверка спецификации по схеме теперь выполняется только при открытом редакторе. Обычно это сокращает время начальной отрисовки на странице отчёта на 400–500 мс для Vega-Lite и 200–300 мс для Vega.
• Некоторые рекурсивные функции не требовали выполнения для каждой строки набора данных. Они переработаны и вынесены из повторяющейся обработки, чтобы запускаться только при необходимости, что ускоряет обработку в целом.

Исправления ошибок

• Поля с одинаковым началом имени, например Sales PY и Sales FC, теперь различаются при создании шаблона (#276).
• Обработчик подсказок Power BI ошибочно показывал false вместо числа, которое должно было отображаться как текст (#429).
• Цвет полосы прокрутки сбрасывался при изменении отступов контейнера визуала (#384).
• При повторном импорте шаблона с автоматическим назначением полей неправильно проверялось состояние назначения (#445).
• Значения null полей datetime неправильно приводились к нужному типу при обработке (#446).

1.6.2 (2023-12-08)

Обновления Vega

• Vega обновлена до 5.26.1 с 5.25.0.
• Vega-Lite обновлена до 5.16.3 с 5.16.1.

Изменения панели отладки

• Значение Rows per page строки состояния теперь сохраняется между сеансами редактирования, при переходе к другим наборам данных и к вкладке Signals.
• Оно также доступно на карточке форматирования Editor > Debug pane панели свойств Power BI.
• Число Rows per page по умолчанию увеличено до 50.
• В список Rows per page добавлены варианты 100 и 200 строк.

Исправления ошибок

• Восстановлен показ подсказок Power BI после проблемы упаковки и публикации версии 1.6.1 (#407).
• Слишком частые обновления набора данных могли вызывать проблемы интерфейса при обработке (#391).
• Включение или выключение перекрёстной фильтрации не обновляло набор данных панели отладки (#396).
• Набор данных с vega_id на панели отладки вызывал сбой редактора (#397).

1.6.1 (2023-11-27)

Исправления ошибок

• Сообщение Initializing показывалось, когда в наборе данных были столбцы или меры, но не было строк (#393).

1.6.0 (2023-11-01)

Этот выпуск улучшает производительность и архитектуру для следующих обновлений. Многие изменения планировались для версии 2, но объём оказался слишком большим для одного выпуска. Поэтому версия 2 будет сосредоточена на возможностях, способных нарушить совместимость шаблонов, а ближайшие обновления — на давно ожидаемых или часто запрашиваемых улучшениях интерфейса и работы авторов визуалов.

Поддерживаемые версии Power BI

Для ускорения загрузки и доступа к новым возможностям Power BI Visuals API обновлён до 5.3.0. Требуется Power BI Desktop не старше апреля 2023 года или Power BI Desktop for Report Server не старше мая 2023 года.

Для более ранних Power BI Desktop можно установить прежние версии Deneb как организационный визуал в клиенте Power BI. Сборки приложены к соответствующим выпускам репозитория GitHub; имена файлов соответствуют образцу Deneb_AppSource*.pbiviz.

Обновления Vega

• Vega обновлена до 5.25.0 с 5.23.0.
• Vega-Lite обновлена до 5.16.1 с 5.6.1.

Изменения разбора и проверки

Обычно такие изменения относятся к производительности и стабильности, но здесь существенно переработаны разбор содержимого редактора и отрисовка спецификаций. Это ускоряет вывод, улучшает согласованность панели отладки с результатом и устраняет лишние отрисовки в интерфейсе.

Основные изменения для авторов и пользователей:

• Переход со страницы отчёта в расширенный редактор и обратно стал существенно быстрее.
• Вместе с набором данных результаты разбора спецификации и конфигурации кешируются и вычисляются заново только при соответствующем изменении. Полный список событий, влияющих на кеширование:
  • Применение содержимого Specification или Config, отличающегося от последнего сохранённого значения.
  • Изменение набора данных визуала: добавление и удаление столбцов или мер, применение фильтров — всё, что вызывает новый запрос и меняет результат.
  • Включение или выключение перекрёстной фильтрации точек данных или перекрёстного выделения значений, меняющих набор данных.
  • Изменение Discrete ordinal colors в меню Report theme integration, требующее заново создать связанную с ним порядковую шкалу Vega.
  • Включение или выключение обработчика подсказок Power BI.
  • Изменение поставщика, например Vega-Lite на Vega.
  • Изменение средства отрисовки, например SVG на Canvas.
  • Изменение уровня журнала на вкладке Logs.
  • Завершение изменения размеров контейнера визуала на странице отчёта.
• При ошибках разбора или представления Vega после отрисовки визуал больше не заменяется статусом ошибки и остаётся пустым. Все проблемы показываются на вкладке Logs, если уровень не установлен в None.
• Раньше ошибки разбора Vega не попадали на вкладку Logs. Это исправлено.

Общие изменения интерфейса

Расширенный редактор полностью переведён с Fluent UI v8 на v9. Некоторые изменения подробнее описаны далее; основные таковы:

• Меню панели настроек перемещено в верхнюю часть визуала и занимает всю ширину. Редактор JSON получил примерно на 11% больше места по вертикали за счёт небольшого уменьшения области предварительного просмотра.
• Стартовая страница переработана, чтобы подробнее знакомить новых пользователей с работой.
• Основной цвет темы обновлён вслед за изменениями Power BI.

Изменения диалога создания спецификации и встроенных шаблонов

Диалог Create new specification получил ряд улучшений:

• Изменено расположение элементов: справа больше места для выбранного или загруженного шаблона.
• По умолчанию выбирается использование существующего шаблона.
• Кнопка импорта заменена областью для перетаскивания:
  • Нажмите её для выбора файла вручную или перетащите допустимый файл, если включён WebView2.
  • Также поддерживается вставка файлов и текста из буфера обмена, если они содержат допустимый шаблон Deneb.
  • Для спецификаций Vega и Vega-Lite без метаданных Deneb рекомендуется создать пустую спецификацию соответствующего языка и вставить содержимое в редактор.
• На начальный экран добавлены ссылки на страницу сообщества Deneb, галерею примеров Vega и галерею примеров Vega-Lite для поиска примеров и идей.
• Встроенные шаблоны переработаны:
  • По умолчанию они больше не используют оформление Power BI, поскольку оно не обязательно соответствует лучшим практикам визуализации данных.
  • Для Vega и Vega-Lite добавлен шаблон [empty (with Power BI theming)] с конфигурацией, воспроизводящей стандартное оформление Power BI.
  • Шаблоны столбчатых диаграмм разделены на два варианта: (1) стандартный с базовыми визуальными кодированиями и (2) интерактивный, показывающий простую настройку интерактивности Power BI.
  • Остальные простые шаблоны удалены.

Изменения создания JSON-шаблона

• Вместо трёх панелей процесса экспорта используется одна.
• Шаблон можно скачать непосредственно в файл .deneb.json, если администратор клиента разрешил скачивание из пользовательских визуалов.
• Если скачивание запрещено, шаблон по-прежнему можно скопировать в буфер обмена.

Улучшения панели отладки

Вместе с изменениями разбора и отрисовки панель отладки переписана с обновлённой логикой и интерфейсом.

Основные изменения:

• Выбор набора данных на вкладке Data и уровня журнала на вкладке Logs перемещён в нижнюю строку состояния, освобождая место по вертикали.

• Таблицы Data и Signals используют новый компонент с улучшенным постраничным просмотром и выбором 10, 25, 50 или 100 строк на странице.

• Улучшен алгоритм отслеживания изменений данных и сигналов в представлении Vega: значения Data и Signals должны быть актуальными. Раньше они иногда отставали на одно обновление.

• Максимальный масштаб увеличен до 400%.

• Кнопка Reset Zoom заменена всплывающим окном у значения масштаба для выбора готового или собственного значения:

  

  Сочетание сброса масштаба к 100% — [Ctrl+Alt+0] — продолжает работать.

Динамические строки форматирования групп вычислений и мер

Deneb всегда мог работать с группами вычислений в наборе данных, но не предоставлял доступ к динамическим строкам форматирования. С апреля 2023 года Power BI поддерживает их и для мер, поэтому эта возможность становится более распространённой.

В этом выпуске появились дополнительные поля набора данных для доступа к таким значениям, если они присутствуют в результате запроса Power BI.

Подробное объяснение — на странице «Форматирование значений».

Настройка оформления полос прокрутки

В меню Rendered visual панели форматирования добавлены свойства для управления полосами прокрутки результата:

• Scrollbar color — цвет полосы. По умолчанию чёрный (#000000).
• Scrollbar opacity (%) — непрозрачность. По умолчанию 20%, чтобы визуал оставался виден сквозь полосу.
• Scrollbar radius (px) — скругление концов полосы. По умолчанию 0, то есть прямоугольная форма.

В меню Advanced editor также появилась настройка Show scrollbars on overflow, позволяющая предварительно просматривать полосы в редакторе, если визуал выходит за границы области отображения.

Подробнее — на странице «Прокрутка и выход за границы».

Другие улучшения

• Панель свойств переведена на новые карточки форматирования, недавно появившиеся у встроенных визуалов.
• Шрифту DIN назначен более понятный псевдоним. Он известен внутри как wf_standard-font, а при использовании теперь можно указывать «DIN».

Исправления ошибок

• Подсказка с сигналом item больше не вызывает ошибку превышения размера стека (#273).
• При выходе из расширенного редактора спецификации Vega восстанавливаются с правильными размерами визуала (#286).
• Стартовая страница больше не показывается ненадолго при инициализации визуала в Service (#325).
• Обработчик сочетаний клавиш больше не открывает модальные диалоги при Alt+F или Alt+N в чешской локали (#262).

Производительность и стабильность

• Просмотр данных на панели отладки теперь обрабатывает данные асинхронно. Интерфейс не ждёт завершения обработки и становится отзывчивее.
• Вкладки Data и Signals используют моноширинный шрифт. Это повышает читаемость и ускоряет расчёт ширины столбцов, выполняемый при каждом изменении содержимого.
• Благодаря этим улучшениям свойства Performance Tuning и Recalculate during resize удалены с панели форматирования.

1.5.0 (2023-03-29)

Улучшения

• Ограничение длины имени поля шаблона увеличено с 30 до 150 символов.

• У функции выражений pbiFormat появился необязательный третий параметр с дополнительными настройками, доступными разработчикам пользовательских визуалов.

  Подробнее — на странице «Форматирование значений».

• Функция выражений pbiColor теперь поддерживает следующие именованные цвета:

  

  Имена заключаются в одинарные кавычки. Допустимые значения:

  • Цвета расходящейся схемы:
    • min
    • middle
    • max
  • Цвета смысловой оценки:
    • negative или bad.
    • neutral
    • positive или good.

  Подробнее — на странице «Цвета темы и цветовые схемы».

Исправления ошибок

• При импорте шаблонов Vega поставщик ошибочно устанавливался в Vega-Lite (#278).
• Цвет «middle» расходящейся схемы ошибочно использовал «neutral» (#283).

Производительность и стабильность

• Vega обновлена до 5.23.0 с 5.22.1. Изменения описаны в примечаниях к выпуску Vega.
• Vega-Lite обновлена до 5.6.1 с 5.4.0. Из-за множества промежуточных изменений удобнее просмотреть историю коммитов между версиями, чем каждый отдельный выпуск.
• Размер опубликованного визуала уменьшен на 8% — с 1,42 МБ до 1,32 МБ.