Журнал изменений

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).

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

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