Koşullu biçimlendirme ekleme

Koşullu biçimlendirme , rapor oluşturucusunda renklerin sayısal bir değere göre raporda nasıl görüntüleneceğini belirtmesine olanak tanır.

Bu makalede, Power BI görselinize koşullu biçimlendirme işlevinin nasıl ekleneceği açıklanmaktadır.

Koşullu biçimlendirme yalnızca aşağıdaki özellik türlerine uygulanabilir:

• Color
• Metin
• Icon
• Web URL'si

Projenize koşullu biçimlendirme ekleme

Bu bölümde, var olan bir Power BI görseline koşullu biçimlendirmenin nasıl ekleneceği gösterilmektedir. Bu makaledeki örnek kod, SampleBarChart görselini temel alır. Kaynak kodu barChart.ts inceleyebilirsiniz.

Biçim bölmesine koşullu renk biçimlendirme girdisi ekleme

Bu bölümde, biçim bölmesindeki bir veri noktasına koşullu renk biçimlendirme girdisi eklemeyi öğreneceksiniz.

1. dizininde, tarafından powerbi-visuals-apikullanıma sunulan dizisini propertyInstanceKindVisualObjectInstancekullanacaksınız. İlk adımınız, dosyanızın şu içeri aktarmayı içerdiğini doğrulamaktır:

   import powerbiVisualsApi from "powerbi-visuals-api";
   

2. Uygun biçimlendirme türünü (Constant, ConstantOrRule veya Rule) belirtmek için sabit listesini VisualEnumerationInstanceKinds kullanacaksınız. Dosyanıza aşağıdaki içeri aktarmayı ekleyin:

   import VisualEnumerationInstanceKinds = powerbiVisualsApi.VisualEnumerationInstanceKinds;
   

3. Biçimlendirme özelliği örneği türünü ayarlama

getFormattingModel API yöntemi

Koşullu biçimlendirmeyi destekleyen özellikleri biçimlendirmek için, içinde descriptorgerekli örnek türünü ayarlayın.

 public getFormattingModel(): powerbi.visuals.FormattingModel {
    // ...
    formattingGroup.slices.push(
        {
            uid: `colorSelector${barDataPoint_indx}_uid`,
            displayName: barDataPoint.category,
            control: {
                type: powerbi.visuals.FormattingComponent.ColorPicker,
                properties: {
                    descriptor: {
                        objectName: "colorSelector",
                        propertyName: "fill",                
                        selector: dataViewWildcard.createDataViewWildcardSelector(dataViewWildcard.DataViewWildcardMatchingOption.InstancesAndTotals),
                        altConstantValueSelector: barDataPoint.selectionId.getSelector(),
                        instanceKind: powerbi.VisualEnumerationInstanceKinds.ConstantOrRule // <=== Support conditional formatting
                    },
                    value: { value: barDataPoint.color }
                }
            }
        }
    );
    // ...
 }

enumerateObjectInstances API yöntemi - kullanım dışı

Koşullu biçimlendirmeyi desteklemek istediğiniz tüm özellikleri dizi altında propertyInstanceKind listeleyin. Yönteminde enumerateObjectInstances bu özellikleri tanımlayın.

public enumerateObjectInstances(options: EnumerateVisualObjectInstancesOptions): VisualObjectInstanceEnumeration {
        …
        case 'colorSelector':
            …
                objectEnumeration.push({
                    objectName: objectName,
                    displayName: barDataPoint.category,
                    properties: {
                        fill: {
                            solid: {
                                color: barDataPoint.color
                            }
                        }
                    },
                    selector: dataViewWildcard.createDataViewWildcardSelector(dataViewWildcard.DataViewWildcardMatchingOption.InstancesAndTotals),
                    altConstantValueSelector: barDataPoint.selectionId.getSelector(),

                    // List your conditional formatting properties
                    propertyInstanceKind: {
                        fill: VisualEnumerationInstanceKinds.ConstantOrRule
                    }
                });
            }
        …
}

VisualEnumerationInstanceKinds.ConstantOrRule , sabit biçimlendirme kullanıcı arabirimi öğesinin yanı sıra koşullu biçimlendirme kullanıcı arabirimi girdisini oluşturur.

Koşullu biçimlendirmenin nasıl davranacağını tanımlama

Biçimlendirmenin veri noktalarınıza nasıl uygulanacağını tanımlayın.

altında powerbi-visuals-utils-dataviewutilsbildirilen seçeneğini kullanarak createDataViewWildcardSelector koşullu biçimlendirmenin örneklere mi, toplamlara mı yoksa her ikisine mi uygulanacağını belirtin. Daha fazla bilgi için bkz . DataViewWildcard.

Koşullu biçimlendirme uygulamak istediğiniz özelliklerde aşağıdaki değişiklikleri yapın:

• selector değerini çağrısıyla dataViewWildcard.createDataViewWildcardSelector(dataViewWildcardMatchingOption) değiştirin. DataViewWildcardMatchingOption , koşullu biçimlendirmenin örneklere, toplamlara veya her ikisine de uygulanıp uygulanmadığını tanımlar.

• altConstantValueSelector özelliği için önceden tanımlanmış değeriyle selector özelliğini ekleyin.

getFormattingModel API yöntemi

Koşullu biçimlendirmeyi destekleyen biçimlendirme özellikleri için, içinde descriptorgerekli örnek türünü ayarlayın.

 
 public getFormattingModel(): powerbi.visuals.FormattingModel {
    // ...

    formattingGroup.slices.push(
        {
            uid: `colorSelector${barDataPoint_indx}_uid`,
            displayName: barDataPoint.category,
            control: {
                type: powerbi.visuals.FormattingComponent.ColorPicker,
                properties: {
                    descriptor: {
                        objectName: "colorSelector",
                        propertyName: "fill",                
                        // Define whether the conditional formatting will apply to instances, totals, or both
                        selector: dataViewWildcard.createDataViewWildcardSelector(dataViewWildcard.DataViewWildcardMatchingOption.InstancesAndTotals),

                        // Add this property with the value previously defined for the selector property
                        altConstantValueSelector: barDataPoint.selectionId.getSelector(),

                        instanceKind: powerbi.VisualEnumerationInstanceKinds.ConstantOrRule
                    },
                    value: { value: barDataPoint.color }
                }
            }
        }
    );

    // ...
 }
    

enumerateObjectInstances API yöntemi - kullanım dışı

Dizi altında koşullu biçimlendirmeyi desteklemek isteyen tüm özellikleri listeleyin propertyInstanceKind . Yönteminde enumerateObjectInstances bu özellikleri tanımlayın.

public enumerateObjectInstances(options: EnumerateVisualObjectInstancesOptions): VisualObjectInstanceEnumeration {
        …
        case 'colorSelector':
            …
                objectEnumeration.push({
                    objectName: objectName,
                    displayName: barDataPoint.category,
                    properties: {
                        fill: {
                            solid: {
                                color: barDataPoint.color
                            }
                        }
                    },
                    // Define whether the conditional formatting will apply to instances, totals, or both
                    selector: dataViewWildcard.createDataViewWildcardSelector(dataViewWildcard.DataViewWildcardMatchingOption.InstancesAndTotals),

                    // Add this property with the value previously defined for the selector property
                    altConstantValueSelector: barDataPoint.selectionId.getSelector(),

                    propertyInstanceKind: {
                        fill: VisualEnumerationInstanceKinds.ConstantOrRule
                    }
                });
            }
        …
}

Dikkat edilecekler ve sınırlamalar

Koşullu biçimlendirme aşağıdaki görseller için desteklenmez:

• Tablo tabanlı görseller

• Matris tabanlı görseller

Serilerle koşullu biçimlendirme kullanmamanızı öneririz. Bunun yerine, müşterilerin her seriyi ayrı ayrı biçimlendirmesine izin vererek serileri görsel olarak ayırt etmelerini kolaylaştırmalısınız. Serilerle birlikte kullanıma uygun görsellerin çoğu bu yaklaşımı paylaşır.

İlgili içerik

DataViewUtils