Добавление значка предупреждения отображения в визуальный элемент

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

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

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

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

Когда появится значок, пользователь может навести указатель мыши на него, чтобы увидеть заголовок предупреждения.

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

Создание значка предупреждения

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

Добавление вызова метода update

Чтобы добавить значок предупреждения отображения в визуальный элемент, вызовите displayWarningIcon метод. Метод является частью IVisualHost и предоставляется с помощью powerbi-visuals-api.

Добавьте следующий импорт в файл:

import powerbiVisualsApi from "powerbi-visuals-api"; 

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

Пример 1. Проверка совместимости языка

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

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

if (this.locale != 'en-US') { 

            this.host.displayWarningIcon('Language inconsistency', 'This visual supports only US English. For the visual to work as expected, set your browser's language to US English.'); 
        }

Пример 2. Сравнение цветов в смежных столбцах

В этом примере отображается значок предупреждения отображения, когда два столбца рядом друг с другом имеют одинаковый цвет.

Метод getColumnColorByIndex выполняет итерацию по всем столбцам. Если два смежных столбца имеют одинаковый цвет, отображается значок предупреждения.

let category = options.dataViews[0].categorical.categories[0]; 

let dataValue = options.dataViews[0].categorical.values[0]; 

let colorPalette = this.host.colorPalette; 

for (let i = 0, len = Math.max(category.values.length, dataValue.values.length); i < len-1; i++) { 

    const color1: string = getColumnColorByIndex(category, i, colorPalette); 

    const color2: string = getColumnColorByIndex(category, i+1, colorPalette); 

    if (color1 == color2) { 

        this.host.displayWarningIcon('Adjacent columns have the same color.', 'Columns that are next to each other have the same color. To change a column's color, use the data colors option in the Format tab.'); 
    } 

} 

Рекомендации и ограничения

• Некоторые ошибки и предупреждения не вызваны визуальным элементом. Например, слишком много значений. Не показывает, что все ошибки данных являются производными от служба Power BI. Такие ошибки и предупреждения распространяются до вызовов визуального элемента. Они имеют приоритет над ошибками, возникающими из кода визуального элемента. Если при загрузке данных возникает ошибка, перед запуском кода визуального элемента и состояние значка предупреждения отображения отображается, то визуальный элемент отображает ошибку вместо ошибки значка предупреждения отображения.

• Предупреждение отображения очищается во время каждой отрисовки визуального элемента, например при перетаскивании новых данных в визуальный элемент. Метод визуального элемента update() вызывается после отрисовки визуального элемента. Если предупреждение визуального элемента возникает на основе условия, которое проверка в методе обновления, при каждом отображении визуального элемента, если условие выполнено, визуальный элемент снова отображает предупреждение.

• Изменение размера визуального элемента не влияет на значок предупреждения.

Следующие ограничения относятся к тексту значка отображения:

• Максимальная длина заголовка составляет 70 символов.

• Максимальная длина текста составляет 2000 символов.

• Текст отображается только как обычный текст

Связанный контент

DataViewUtils