Görselinize görüntü uyarısı simgesi ekleme

Power BI görselinde görüntü uyarısı simgesi, kullanıcıya olası bir sorunu veya hatayı bildirebilir. Uyarı simgelerini görüntüleme, aşağıdakiler gibi birçok durumda yararlı olabilir:

• Değerler enlem veya boylam geçerli aralığın dışında olduğunda harita görseli bir uyarı simgesi görüntüleyebilir.

• Pasta grafik görseli, pozitif değerlerle karıştırılmış negatif değerler görüntülerken bir uyarı simgesi görüntüleyebilir.

• Sonsuzluk değerleri hesaplandığında kartezyen grafik bir uyarı simgesi görüntüleyebilir. Örneğin, Y sıfırsa, X'i Y'ye bölerken sonuç sonsuzdur.

Simge göründüğünde, kullanıcı uyarı iletisinin başlığını görmek için üzerine gelebilir.

Kullanıcı uyarı simgesini seçtiğinde, bir açılır pencerede sorunu açıklayan bir ileti görüntülenir.

Uyarı simgesi oluşturma

Özel bir görsel için özelleştirilmiş ileti içeren bir uyarı simgesi oluşturabilirsiniz. Uyarı simgesinin yükseltilip yükseltilmeyeceğine karar vermek size bağlı. Bu örneklerde gösterildiği gibi, uyarı simgesi görüntülendiğinde görsel çalışmaya devam eder.

Güncelleştirme yöntemine çağrı ekleme

Görselinize görüntü uyarısı simgesi eklemek için yöntemini çağırın displayWarningIcon . yöntemi öğesinin IVisualHost bir parçasıdır ve kullanılarak powerbi-visuals-apikullanıma sunulur.

Dosyanıza aşağıdaki içeri aktarmayı ekleyin:

import powerbiVisualsApi from "powerbi-visuals-api"; 

İçeri aktarmayı ekledikten sonra, uyarı simgesinin ne zaman görüntüleneceğini belirleyen bir koşul ekleyin. İsteğe bağlı iki koşulu görüntülemek için bu makaledeki örnekleri kullanın.

Örnek 1: Dil uyumluluğunu denetleme

Yerelleştirme, görselleri işletim sisteminin ayarları tarafından caydırılan müşterinin yerel dilinde görüntülemek için kullanılır.

Bu örnekte görsel, ABD İngilizcesi olarak ayarlanan görselin dilini işletim sisteminin diliyle karşılaştırır. Diller eşleşmiyorsa uyarı simgesi görüntülenir.

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

Örnek 2: Bitişik sütunlardaki renkleri karşılaştırma

Bu örnekte, yan yana olan iki sütun aynı renge sahip olduğunda görüntü uyarısı simgesi görüntülenir.

getColumnColorByIndex yöntemi tüm sütunlar arasında yinelenir. Bitişik iki sütun aynı renge sahipse bir uyarı simgesi görüntülenir.

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

} 

Dikkat edilecekler ve sınırlamalar

• Bazı hatalar ve uyarılar görselden kaynaklanmamıştır. Örneğin, Çok fazla değer. Tüm veri hatası gösterilmiyor hatası Power BI hizmeti türetildi. Bu tür hatalar ve uyarılar görselinizin çağrılarına önceden yayılır. Görselinizin kodundan kaynaklanan hatalardan önceliklidir. Veri yüklenirken bir hata oluşursa, görselin kodu çalıştırılıp görüntü uyarısı simgesi koşulu karşılanmadan önce görsel, görüntü uyarısı simgesi hatası yerine bu hatayı görüntüler.

• Görüntü uyarısı, görselin her işlenmesi sırasında, örneğin görsele yeni veriler sürüklendiğinde temizlenir. Görsel update() işlendikten sonra görselin yöntemi çağrılır. Görselin uyarısı güncelleştirme yönteminde denetlenen bir koşula göre oluşturulursa, görsel her işlendiğinde koşul karşılanırsa, görsel uyarıyı yeniden görüntüler.

• Görseli yeniden boyutlandırmak uyarı simgesini etkilemez.

Aşağıdaki sınırlamalar görüntü simgesi metnine başvurur:

• Başlığın uzunluğu üst sınırı 70 karakterdir

• Metnin uzunluk üst sınırı 2.000 karakterdir

• Metin yalnızca düz metin olarak görüntülenir

İlgili içerik

DataViewUtils