Menambahkan ikon peringatan tampilan ke visual Anda

Dalam visual Power BI, ikon peringatan tampilan dapat memberi tahu pengguna tentang kemungkinan masalah atau kesalahan. Ikon peringatan tampilan dapat berguna dalam banyak kasus, seperti:

• Visual peta dapat menampilkan ikon peringatan saat nilai berada di luar rentang valid garis lintang atau bujur.

• Visual bagan pai bisa menampilkan ikon peringatan saat menampilkan nilai negatif yang dicampur dengan yang positif.

• Bagan kartesius dapat menampilkan ikon peringatan saat nilai tak terbatas dihitung. Misalnya, jika Y adalah nol, saat membalai X dengan Y, hasilnya adalah tak terbatas.

Saat ikon muncul, pengguna dapat mengarahkan mouse ke atasnya untuk melihat judul pesan peringatan.

Saat pengguna memilih ikon peringatan, pesan yang menjelaskan masalah muncul di jendela pop-up.

Membuat ikon peringatan

Anda dapat membuat ikon peringatan dengan pesan yang dikustomisasi untuk visual kustom. Keputusan apakah akan menaikkan ikon peringatan atau tidak terserah Anda. Seperti yang ditunjukkan contoh-contoh ini, visual terus berfungsi ketika ikon peringatan ditampilkan.

Menambahkan panggilan ke metode pembaruan

Untuk menambahkan ikon peringatan tampilan ke visual Anda, panggil displayWarningIcon metode . Metode ini adalah bagian dari IVisualHost dan diekspos menggunakan powerbi-visuals-api.

Tambahkan impor berikut ke file Anda:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Setelah Anda menambahkan impor, tambahkan kondisi yang menentukan kapan harus menampilkan ikon peringatan. Gunakan contoh dalam artikel ini untuk melihat dua kondisi opsional.

Contoh 1: Periksa kompatibilitas bahasa

Lokalisasi digunakan untuk menampilkan visual dalam bahasa asli pelanggan, yang merupakan penolakan oleh pengaturan sistem operasi.

Dalam contoh ini, visual membandingkan bahasa visual, yang diatur ke bahasa Inggris AS, dengan bahasa sistem operasi. Jika bahasa tidak cocok, ikon peringatan akan ditampilkan.

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.'); 
        }

Contoh 2: Membandingkan warna dalam kolom yang berdekatan

Dalam contoh ini, ikon peringatan tampilan muncul ketika dua kolom yang berada di samping satu sama lain memiliki warna yang sama.

Metode getColumnColorByIndex ini melakukan iterasi melalui semua kolom. Jika dua kolom yang berdekatan memiliki warna yang sama, ikon peringatan akan ditampilkan.

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.'); 
    } 

} 

Pertimbangan dan batasan

• Beberapa kesalahan dan peringatan tidak disebabkan oleh visual. Misalnya, Terlalu banyak nilai. Tidak menampilkan semua kesalahan data berasal dari layanan Power BI. Kesalahan dan peringatan tersebut disebarluaskan sebelum panggilan visual Anda. Mereka lebih diutamakan daripada kesalahan yang berasal dari kode visual Anda. Jika terjadi kesalahan saat memuat data, sebelum kode visual dijalankan dan kondisi ikon peringatan tampilan terpenuhi, visual menampilkan kesalahan tersebut alih-alih menampilkan kesalahan ikon peringatan.

• Peringatan tampilan dibersihkan selama setiap penyajian visual, misalnya, saat data baru diseret ke dalam visual. Metode update() visual dipanggil setelah visual dirender. Jika peringatan visual dinaikkan berdasarkan kondisi yang diperiksa dalam metode pembaruan, setiap kali visual dirender, jika kondisi terpenuhi, visual akan menampilkan peringatan lagi.

• Mengubah ukuran visual tidak memengaruhi ikon peringatan.

Batasan berikut mengacu pada teks ikon tampilan:

• Panjang maksimum judul adalah 70 karakter

• Panjang maksimum teks adalah 2.000 karakter

• Teks hanya ditampilkan sebagai teks biasa

Konten terkait

DataViewUtils