Предыдущие выпуски (1.0–1.3)

1.3.0 (2022-07-06)

Область отладки (#7, #217)

Интерфейс редактора визуала изменён: в области, которая раньше называлась панелью инструментов предпросмотра, появились средства просмотра данных, сигналов и журналов. Как и в Vega Editor, они раскрывают больше информации о базовом представлении Vega и помогают авторам создавать и отлаживать спецификации в Power BI.

Панель инструментов предпросмотра теперь можно сворачивать и менять её размер, как у панели редактора. Поскольку её возможности значительно расширились, она переименована в панель отладки.

Изменение затрагивает многие страницы документации, поэтому соответствующие разделы дополнены описанием панели отладки. Краткий обзор:

• Панель Data показывает наборы данных представления Vega.

• Панель Signals показывает сведения о сигналах представления Vega, включая привязки параметров.

• Панель Logs показывает записи, сделанные системой журналирования Vega для выбранного уровня.

  • Допустимые уровни — None, Error, Warn (по умолчанию) и Info.
  • В ходе этой работы выяснилось, что некоторые ситуации, например дублирование параметров при их размещении на верхнем уровне многослойных диаграмм, не обрабатывались корректно и Deneb показывал пустой белый визуал.
  • Обработка таких ошибок стала надёжнее: визуал должен показывать соответствующее состояние ошибки, а панель Logs может содержать дополнительные подробности.

Отдельные цвета темы отчёта (#197)

Добавлено новое выражение pbiColor. Оно позволяет получать цвета темы отчёта по индексу, начинающемуся с нуля. Необязательный параметр позволяет затемнить или осветлить цвет на указанную величину, получая, например, такой результат:

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

Изображение предпросмотра в экспортируемом шаблоне (#228)

При экспорте шаблона теперь можно включить изображение предпросмотра, например:

Изображения создаются с помощью API представления Vega. Изображение соответствует текущему виду диаграммы в редакторе; его размер ограничен областью 150 × 150 пикселей: большая сторона вписывается в эту область с сохранением пропорций. Подробнее это описано на странице «Шаблоны». Основные особенности:

Созданное изображение включается в шаблон в кодировке base64. При этом следует учитывать:

• Размер JSON-шаблона может значительно увеличиться.
• Включённое изображение может раскрыть информацию о ваших данных.

Поэтому возможность по умолчанию отключена; её нужно включить самостоятельно.

Другие небольшие улучшения

• При Ctrl + щелчок Deneb теперь сохраняет контекст перекрёстной фильтрации и/или перекрёстного выделения для нескольких диаграмм (#213).
• При создании визуала Vega-Lite из шаблона [empty] теперь формируется спецификация с пустыми слоями ([]), а не примитивом null. Это предотвращает появление ошибок и даёт начинающему пользователю более удобное начальное состояние (#51).

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

• Vega обновлена до 5.22.1 с версии 5.21.0 (#221). Подробнее об изменениях — в примечаниях к выпускам Vega:

  • 5.22.0
  • 5.22.1

• Код и обработка событий пересмотрены и переработаны, чтобы повторная отрисовка Vega выполнялась только при необходимости (#222). Это должно заметно повысить общую производительность интерфейса.

1.2.0 (2022-04-21)

Поддержка перекрёстного выделения (#134)

До этого Deneb поддерживал только два вида взаимодействия с другими визуалами: Filter (по умолчанию) и None.

В этом выпуске добавлена поддержка взаимодействия Highlight. Как и перекрёстную фильтрацию, её нужно включать самостоятельно: примитивы должны иметь необходимые кодирования для исходных и выделенных значений при активном взаимодействии, например:

Чтобы начать работу, обратитесь к странице «Перекрёстное выделение». Встроенный шаблон Simple Bar Chart для Vega и Vega-Lite дополнен примером привязки и кодирования; соответствующие изменения внесены и в простой практический пример.

Более заметные версии Vega (#185)

Deneb включает библиотеки Vega и Vega-Lite, поэтому новые выпуски не становятся доступны автоматически: их нужно включить в пакет, протестировать и опубликовать через AppSource. Из-за этого поддержка языковых возможностей в Deneb может отставать от документации Vega или Vega-Lite. Пример — выпуск Vega-Lite 5.2.0 вскоре после публикации Deneb 1.0.0.

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

Пересчёт при изменении размера (#180)

Контейнеры визуалов Power BI имеют динамический размер. Любое его изменение может запускать обновление логики визуала и пересчёт спецификации. Для визуалов с небольшим числом примитивов это может быть незаметно, но у сложных диаграмм создаёт лишнюю нагрузку ради нечастой операции.

Для управления этим поведением добавлено меню свойств Performance Tuning с переключателем Recalculate during resize. В версии 1.2.0 это свойство по умолчанию выключено (OFF): Deneb откладывает дальнейшие вычисления до завершения изменения размера визуала, например:

Описание этой возможности также добавлено на страницу «Производительность».

Другие небольшие улучшения

• Deneb теперь сохраняет размер контейнера визуала в отчёте после последнего изменения. Если Deneb заново инициализируется при открытом редакторе, например при переключении на другой визуал и обратно, размер обычного представления визуала больше не теряется (#178).

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

Шаблоны

• При настройке соответствий полей спецификации заменялись ключи свойств, совпадающие с именами полей набора данных (#190).
• Экспортированные шаблоны нельзя было импортировать обратно без ручных исправлений (#198).
• После успешного импорта шаблона появлялось сообщение «Deneb has been updated» (#207).
• Если при импорте шаблона имя поля набора данных совпадает с именем поля-заполнителя, оно теперь отмечается как назначенное без ручного выбора (#210).

Подсказки

• Если для примитива Vega-Lite было задано "tooltip": false, а не опущено свойство tooltip, отображалась пустая подсказка (#191).
• Сигналы подсказок с одиночными значениями, а не парами «поле — значение», некорректно преобразовывались в подсказки Power BI (#201).
• При включённом обработчике подсказок обновление вызывало первоначальную ошибку или предупреждение в консоли (#218).

1.1.0 (2022-01-22)

Интеграция с темой отчёта (#124)

Реализована через цветовые схемы Vega.

• При кодировании scale доступны 4 схемы, которые связываются с текущей темой отчёта во время выполнения.
• Если изменить соответствующие этим схемам цвета темы отчёта, спецификация обновится вслед за ними.
• Подробнее это описано на странице «Цвета темы и цветовые схемы».

Соответствия полей спецификации (#160)

• Теперь можно переназначать любые столбцы и меры, привязанные к кодированиям или выражениям.

• Если поле удалено из роли данных Values, открывается диалог, позволяющий удобнее добавить и переназначить поле без ручного поиска.

• Подробнее это описано на странице «Набор данных».

  

Изменения шаблонов

• Поля-заполнители размещены компактнее, чтобы лучше использовать доступное пространство (#156).

• Если свойство шаблона usermeta.information.previewImageBase64PNG содержит корректное изображение в base64, оно теперь отображается в диалоге Create New Specification (#159).

• Встроенные шаблоны теперь содержат изображения предпросмотра (#159).

• Из полей-заполнителей убраны ограничения на использование столбцов или мер (#157).

  

Свойства редактора

Доступны в панели форматирования Power BI.

• В редактор визуала добавлено свойство Word Wrap (#154).
• В редактор визуала добавлены свойства Line Gutter и Line Numbers (#155).

Другие небольшие улучшения

• Сочетание клавиш для создания JSON-шаблона не работало в некоторых средах Windows, поэтому оно заменено на Ctrl + Alt + T (#153).

• Полосы прокрутки визуала стали менее навязчивыми (#164).

• Шрифт DIN, используемый во встроенных визуалах, доступен под именем wf_standard-font везде, где можно указать семейство шрифтов (#151).

• Чтобы было проще заметить обновление версии в отчётах, Deneb показывает уведомление в панели редактора при редактировании существующего визуала, созданного в предыдущей версии (#179), например:

  

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

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

• Vega-Lite обновлена до 5.2.0 (#158).

  • Подробнее об изменениях — в примечаниях к выпуску Vega-Lite.
  • В Deneb также добавлен шаблон Vega-Lite Grouped Bar Chart, иллюстрирующий изменения кодирований xOffset / yOffset.

• Ссылки на поля набора данных в выражениях переписываются при создании шаблона (#139).

  • При создании JSON-шаблона или переназначении полей любое выражение со ссылкой вида datum.Field автоматически переписывается с использованием синтаксиса datum['Field'].
  • Благодаря этому замена полей или их преобразование в заполнители поддерживает имена, содержащие пробелы.

• Улучшено кодирование opacity в шаблоне Vega-Lite Simple Bar Chart (#152).

  • Теперь оно включает явное значение opacity, если поле __selected__ записи не равно "off".
  • Это сохраняет логику, если автор усложнит композицию представления, состоявшего из одного примитива.

• Обработка событий интерактивности за пределами основной области диаграммы требовала нестандартных и потенциально затратных изменений DOM Vega при каждом обновлении визуала. Механизм переработан для работы со стандартным DOM (#181).

• Хранилище Redux заменено на Zustand и переработано (#147).

Известные проблемы

Все известные на тот момент проблемы запланированы к исправлению в версии 1.2. Обходные решения описаны в соответствующих задачах GitHub.

• Экспортированные шаблоны нельзя импортировать обратно без ручных исправлений (#198).
• При настройке соответствий полей спецификации заменяются ключи свойств, совпадающие с именами полей набора данных (#190).

1.0.0 (2021-11-13)

Важные примечания

• Код предварительной версии перенесён в официальный выпуск AppSource 🎉🎉🎉🎉.
• Загрузка по удалённым URL, например для примитивов изображений, отключена для соблюдения требований сертификации Power BI. Это ограничение можно обойти, скачав отдельную сборку.
• Крупных изменений в этом выпуске нет; внесены только изменения для проверки качества.

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

• Смена положения редактора приводила к сбою его интерфейса (#137).

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

• Улучшена область пустого пространства, по которой можно щёлкнуть для сброса активного выбора (#140).
• События отрисовки визуала синхронизированы с API представления Vega (#141).

Более ранние версии

Чтобы журнал изменений оставался относительно компактным, сведения о старых версиях время от времени переносятся в архив. Каждый архив доступен как подстраница этого раздела; для продолжения чтения можно воспользоваться навигацией внизу.