Редактор визуала

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

Открытие редактора

Редактор доступен только при редактировании отчёта — в Power BI Desktop или в службе Power BI. При обычном просмотре отчёта в службе или другом приложении редактирование недоступно, поэтому конечные пользователи не увидят соответствующие команды.

Сначала передайте визуалу данные: добавьте нужные столбцы и меры в область Values.

После этого откройте меню заголовка визуала — многоточие — и выберите Edit («Изменить»):

Визуал перейдёт в режим фокусировки, и появится редактор для создания или изменения спецификации.

Устройство интерфейса

Редактор состоит из трёх основных частей:

1. Панель редактора — создание визуализации.
2. Панель предпросмотра — отображение будущего результата в отчёте.
3. Панель отладки — инструменты разработки.

Панель редактора

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

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

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

Учитывайте следующее:

• Перетаскивая разделитель, можно увеличить панель максимум до 60% видимого холста.
• Двойное нажатие на разделитель возвращает стандартный размер — 40% видимого холста.

Положение панели редактора

Если удобнее расположить редактор справа, выберите Editor → Position → Right на панели форматирования Power BI:

Размер шрифта JSON-редактора

Чтобы изменить размер шрифта при редактировании JSON, выберите Editor → JSON Editor Font Size на панели форматирования Power BI:

Перенос строк

По умолчанию текст, выходящий за ширину редактора, переносится на новую строку. Отключив Editor → Word Wrap на панели форматирования Power BI, можно оставить содержимое на одной строке; при необходимости редактор покажет горизонтальную полосу прокрутки.

Поле слева и номера строк

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

• Чтобы скрыть это поле, отключите Editor → Line Gutter на панели форматирования Power BI.
• Либо оставьте поле, чтобы можно было сворачивать и разворачивать разделы JSON, но скройте номера строк, отключив Editor → Line Numbers.

Панель команд

Команды расположены слева направо в следующем порядке.

Применение — Ctrl + Enter

• Применяет изменения вкладок Specification и Config, обновляя визуал.
• Команда отключена, если включено автоматическое применение изменений.

Переключение автоматического применения — Ctrl + Shift + Enter

• Применяет изменения в редакторах Specification и Config во время ввода.
• При включении команда Apply становится недоступной.

Исправление и форматирование JSON — Ctrl + Alt + R

• Пытается исправить простые опечатки в JSON и отформатировать его с отступами.
• Инструмент исправляет очевидные ошибки, но в некоторых случаях восстановить JSON автоматически не удаётся. Тогда над редактором появится сообщение и потребуется исправление вручную.
• В таких случаях нажмите сведения об ошибке справа внизу, чтобы изучить её и использовать полученную информацию для исправления. Например:

Изменение сопоставления полей спецификации — Ctrl + Alt + F

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

Новая спецификация — Ctrl + Alt + N

• Открывает окно Create New Specification.
• Оно позволяет заменить текущие Specification и Config минимальным набором JSON или выбрать один из простых встроенных шаблонов.
• Шаблоны сейчас поставляются с визуалом. Импорт пока не поддерживается, но авторы надеются добавить его в дальнейшем.

Создание JSON-шаблона — Ctrl + Alt + E

• Открывает окно Generate JSON Template.
• В нём можно создать экспортируемую версию спецификации. Подробнее см. в разделе «Создание шаблона».

Справка — Ctrl + Alt + H

• Power BI предложит подтвердить открытие сайта документации. После нажатия OK он откроется в новой вкладке браузера.

Редактор спецификации

• Здесь вводится и изменяется JSON спецификации.
  • Справочник спецификаций Vega.
  • Справочник спецификаций Vega-Lite.
• Чтобы увидеть результат, нажмите Apply или включите автоматическое применение при вводе.
• JSON должен соответствовать выбранному языку — Vega или Vega-Lite.
• Редактор проверяет спецификацию по схеме выбранного языка и показывает предупреждения:

Редактор конфигурации

• Здесь вводится и изменяется JSON конфигурации визуала.
  • Справочник конфигурации Vega.
  • Справочник конфигурации Vega-Lite.
• Для просмотра результата нажмите Apply или включите автоматическое применение.
• JSON должен быть допустимой конфигурацией выбранного языка.
• Рекомендуется выносить в Config общие настройки оформления и хранить их отдельно от спецификации: так их проще переносить между визуалами. Например:

Панель настроек

• Панель задаёт поведение Deneb при формировании результата:

  

• Provider выбирает язык спецификации и конфигурации — Vega или Vega-Lite.

  • Vega-Lite проще для начинающих: записи короче, многие настройки выполняются автоматически.
  • Vega даёт больше контроля, но требует более глубокого изучения.

• Render Mode выбирает механизм отрисовки Vega при компиляции, разборе и построении визуализации.

  • Canvas создаёт растровое изображение.
  • SVG строит результат из векторных элементов.
  • Особенности выбора описаны в разделе «Производительность».

• Vega → Power BI Interactivity включает интерактивные возможности.

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

Автодополнение столбцов и мер

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

Неприменённые изменения

Если после редактирования нажать Back to report, не применив изменения, появится предупреждение:

Панель предпросмотра

Перед открытием редактора Deneb запоминает размеры визуала и показывает его в масштабе 100%. Это позволяет оценить, как диаграмма будет выглядеть после возвращения на холст отчёта:

Если визуал не помещается целиком, используйте масштабирование панели отладки, сверните эту панель или измените размер панели редактора.

Обозначение границы

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

Чтобы скрыть обозначение границы, выберите Editor → Show Boundary Marker → OFF на панели форматирования Power BI:

Панель отладки

Панель содержит инструменты проверки и отладки визуализации и информацию о представлении Vega или Vega-Lite:

Её элементы расположены слева направо в следующем порядке.

Панель данных — Data

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

• По умолчанию выбран dataset — данные, переданные в Deneb из модели. В них включены дополнительные поля, которые Deneb добавляет для интерактивности. Здесь их значения проще проверить, чем через подсказки объекта datum.

• Сложные объекты отображаются целиком, только если достаточно малы. Более крупные сокращаются до {...}. Их содержимое можно подробнее изучить в подсказке, наведя указатель на заполнитель:

  

• Для значений интерактивности и заголовков столбцов также предусмотрены поясняющие подсказки:

  

• Для производительности, поскольку поток данных может содержать сложные объекты, на странице показывается не более 10 строк. Используйте постраничную навигацию под таблицей, чтобы найти нужные записи. Нажатие на заголовок сортирует столбец.

Сигналы — Signals

Показывает состояние сигналов Vega. В Vega-Lite они часто создаются автоматически, например для параметров.

Таблица работает практически так же, как в панели Data.

Журнал — Logs

Показывает сообщения журнала Vega. Выбранный уровень применяется при очередном разборе спецификации.

• По умолчанию используется уровень warn.
• Уровень debug недоступен в Deneb из-за большого объёма сообщений.

Библиотека и версия

Здесь повторно указаны выбранная библиотека — Vega или Vega-Lite — и встроенная версия.

Масштабирование

Эти инструменты помогают работать с деталями в ограниченной области пользовательского визуала Power BI:

• Уменьшение масштаба предпросмотра на 10%.
• Ползунок масштаба от 10% до 300%.
• Увеличение масштаба на 10%.
• Предпросмотр в исходном размере.
• Вписывание предпросмотра в доступную область.

Сворачивание и разворачивание панели отладки

Этот переключатель показывает или скрывает панель отладки.