Power BI özel görsellerindeki biçimlendirme bölmesi

Geliştiriciler, API sürüm 5.1 ve üzerini kullanarak Biçim bölmesiyle görseller oluşturabilir. Geliştiriciler, özel görsellerindeki herhangi bir özellik için kartları ve kategorilerini tanımlayarak rapor oluşturucularının bu görselleri kullanmasını kolaylaştırabilir.

API, format ve analiz bölmelerinin bölümlerini özelleştirmek için FormattingModel yöntemini kullanır.

İpucu

getFormattingModel yöntemi, önceki API sürümlerindeki enumerateObjectInstances yönteminin yerini alır.

, getFormattingModel görselin biçimlendirme ve analiz bölmesinin nasıl göründüğünü tanımlayan bir FormattingModel döndürür.

Biçimlendirme modeli , tüm eski biçimlendirme bölmesi özelliklerine ek olarak geçerli biçim bölmesi özelliklerini, özelliklerini ve hiyerarşilerini destekler.

Biçimlendirme bölmesinin ekran görüntüsü.

En son Biçim bölmesini destekleyen bir görsel oluşturma

Özel görsele Biçim bölmesi desteği eklemeye yönelik genel adımlar:

apiVersion dosyanızdaki öğesini 5.1 veya daha sonraki bir sürüme ayarlayın.
objects dosyanızda tüm özelleştirilebilirleri tanımlayın. Bu nesneler daha sonra biçimlendirme bölmesinin özelliklerine eşlenir . Her nesne için aşağıdaki özellikler gereklidir:
- nesne adı
- özellik adı
- mülk türü
DisplayName ve description dahil olmak üzere diğer tüm özellikler artık isteğe bağlıdır.
Aşağıdakilerden birini yaparak özel görsel FormattingModel'i oluşturun:
- Biçimlendirme modeli yardımcı programı kullanın. (Önerilen)
- Bu yardımcı program olmadan yalnızca API'leri kullanın.

Özel görsel biçimlendirme modelinizin özelliklerini tanımlayın ve kodu (JSON değil) kullanarak oluşturun.

API'yi getFormattingModel özel görsel biçimlendirme modeli döndüren özel görsel sınıfına uygulayın. (Bu API, önceki sürümlerde kullanılanın yerini alır enumerateObjectInstances ).

Biçimlendirme modeli uygulama örneği

Biçimlendirme modeli yardımcı programı örneği kullanılarak model biçimlendirildi. (Önerilen)
Modeli yalnızca API'ler kullanarak biçimlendirme örneği.

Harita biçimlendirme özellikleri

Eski bir API ile oluşturulmuş özel bir görsele sahipseniz ve bunu biçim bölmesiyle güncelleştirmek istiyorsanız veya yeni bir özel görsel oluşturuyorsanız:

apiVersion dosyanızdaki öğesini 5.1 veya daha sonraki bir sürüme ayarlayın.
capabilities.jsoniçindeki her nesne adı ve özellik adı için eşleşen bir biçimlendirme özelliği oluşturun. Biçimlendirme özelliğinde, objectName içindeki nesne adı ve özellik adıyla eşleşen propertyName ve içeren bir tanımlayıcı olmalıdır.

objects Özellikler dosyasındaki özellikler hala aynı biçime sahiptir ve değiştirilmesi gerekmez.

Örneğin, circle dosyanızdaki nesne şu şekilde tanımlanmışsa:

"objects": {
    "circle": {
        "properties": {
            "circleColor": {
                "type": {
                    "fill": {
                        "solid": {
                            "color": true
                        }
                    }
                }
            },
        }
    }
}

Modelinizdeki biçimlendirme özelliği türünde ColorPicker olmalı ve şu şekilde görünmelidir:

control: {
    type: "ColorPicker",
    properties: {
        descriptor: {
            objectName: "circle",
            propertyName: "circleColor"
        },
        value: {
            value: this.visualSettings.circle.circleColor
        }
    }
}

Aşağıdaki koşullardan biri doğruysa bir hata alırsınız:

Yetenek dosyasındaki nesne veya özellik adı biçimlendirme modelindeki adla eşleşmiyor
Yetenek dosyasındaki özellik türü, biçimlendirme modelindeki türle eşleşmiyor

Biçimlendirme modeli

Biçimlendirme modeli, biçim bölmenizin tüm özelliklerini açıkladığınız ve özelleştirdiğiniz yerdir.

Model bileşenlerini biçimlendirme

Biçimlendirme modelinde, özellik bileşenleri mantıksal kategorilerde ve alt kategorilerde birlikte gruplandırılır. Bu gruplar modeli taramayı kolaylaştırır. En büyükten en küçüğe beş temel bileşen vardır:

Biçimlendirme modeli Bölmenin ön arabirimini biçimlendirmek için kullanılan en büyük bölme kapsayıcısı. Biçimlendirme kartlarının listesini içerir.
Biçimlendirme kartı Biçimlendirme özellikleri için en üst düzey özellikler gruplandırma kapsayıcısı. Her kart, burada gösterildiği gibi bir veya daha fazla biçimlendirme grubundan oluşur.
Biçimlendirme grubu
İkincil düzey özellikler gruplandırma kapsayıcısı. Biçimlendirme grubu, dilimleri biçimlendirmek için bir gruplandırma kapsayıcısı olarak görüntülenir.
Kapsayıcıyı biçimlendirme
İkincil düzey özellikler gruplandırma kapsayıcısı. Biçimlendirme kapsayıcısı, dilimleri ayrı kapsayıcı öğeleri halinde gruplandırır ve açılan liste kullanarak bunlar arasında geçiş yapılmasını sağlar.
Dilim biçimlendirme
Özellik kapsayıcısı. İki tür dilim vardır:
- Basit bölüm: Bireysel özellik kapsayıcısı
- Bileşik dilim: Tek bir biçimlendirme diliminde gruplandırılmış birden çok ilgili özellik kapsayıcısı
Aşağıdaki görüntüde farklı dilim türleri gösterilmektedir. "Yazı Tipi", yazı tipi ailesi, boyutu ve kalın, italik ve altı çizili ayarlardan oluşan bileşik bir bileşendir. "Color", "display units" ve diğer dilimler, her biri tek bileşenden oluşan basit dilimlerdir.

Görselleştirme bölmesi biçimlendirme özellikleri

Biçimlendirme modelindeki her özellik capabilities.json dosyasındaki bir nesne türüyle eşleşmelidir.

Aşağıdaki tabloda ,capabilities.json dosyasındaki biçimlendirme özelliği türleri ve modern biçimlendirme modeli özelliklerinde eşleşen tür sınıfı gösterilmektedir:

Türü	YetenekLer Değer Türü	Biçimlendirme Özelliği
Boolean (Boole Mantığı)	Boole	Geçiş Anahtarı
Sayı	Sayısal tam sayı	NumUpDown Kaydırıcı
Numaralandırma listesi	numaralandırma:[]	ItemDropdown ÖğeBayraklarıSeçimi Otomatik Açılan Liste AutoFlagsSelection ^* Aşağıdaki nota bakın
Renk	Doldurmak	ColorPicker
Gradyan	Doldurma Kuralı	GradientBar: özellik değeri aşağıdakilerden oluşan bir dize olmalıdır: `minValue[,midValue],maxValue`
Metin	Metin	TextInput Metin Alanı

Nesneleri Biçimlendirme Özellikleri

Türü	YetenekLer Değer Türü	Biçimlendirme Özelliği
Yazı tipi boyutu	Yazı Boyutu	NumUpDown
Yazı tipi ailesi	Yazı Tipi Ailesi	FontPicker
Satır Hizalama	Hizalama	AlignmentGroup
Etiket Görüntüleme Birimleri	Etiket Gösterim Birimleri	AutoDropDown

^* Numaralandırma listesi biçimlendirme özelliği, biçimlendirme modelinde ve yetenek dosyasında farklıdır.

Numaralandırma öğelerinin listesi de dahil olmak üzere biçimlendirme ayarları sınıfında aşağıdaki özellikleri bildirin:
- Öğe Açılır Listesi
- Öğe İşaretleri Seçimi
Numaralandırma öğelerinin listesi olmadan biçimlendirme ayarları sınıfında aşağıdaki özellikleri bildirin. Numaralandırma öğeleri listesini uygun nesnenin altında capabilities.json bildirin. (Bu türler önceki API sürümlerindekiyle aynıdır):
- Otomatik Açılan Liste
- Otomatik Bayrak Seçimi

Bileşik kesit özellikleri

Biçimlendirme bileşik dilimi, birden çok ilgili özelliği bir arada içeren bir biçimlendirme dilimidir.

Şimdilik iki bileşik dilim türüne sahibiz:

FontControl
Bu, yazı tipiyle ilgili tüm özellikleri bir arada tutar. Aşağıdaki özelliklerden oluşur:

Yazı Tipi Ailesi
Yazı Tipi Boyutu
Kalın [isteğe bağlı]
italik [isteğe bağlı]
Altı çizili [isteğe bağlı]

Yazı tipi ailesi, yazı tipi boyutu, kalın, italik ve altı çizili seçenekleri içeren yazı tipi bileşik diliminin ekran görüntüsü.

Bu özelliklerin her birinin capabilities dosyasında karşılık gelen bir nesnesi olmalıdır:

Mülkiyet	Yetenek Türü	Biçimlendirme Türü
Yazı Tipi Ailesi	Biçimlendirme: { fontFamily}	FontPicker
Yazı Tipi Boyutu	Biçimlendirme: {fontSize}	NumUpDown
Kalın	Boole	ToggleSwitch
İtalik	Boole	ToggleSwitch
Altını çizmek	Boole	ToggleSwitch

MarginPadding Kenar boşluğu doldurma, görseldeki metnin hizalamasını belirler. Aşağıdaki özelliklerden oluşur:
- Sol
- Doğru
- Yukarı
- Alt
Bu özelliklerin her birinin capabilities dosyasında karşılık gelen bir nesnesi olmalıdır:

Mülkiyet Yetenek Türü Biçimlendirme Türü

Sol Sayısal NumUpDown

Doğru Sayısal NumUpDown

Yukarı Sayısal NumUpDown

Alt Sayısal NumUpDown

Mülkiyet	Yetenek Türü	Biçimlendirme Türü
Sol	Sayısal	NumUpDown
Doğru	Sayısal	NumUpDown
Yukarı	Sayısal	NumUpDown
Alt	Sayısal	NumUpDown

GitHub kaynakları

Tüm biçimlendirme modeli arabirimleri GitHub'da bulunabilir - microsoft/powerbi-visuals-api: Power BI özel görseller API'sinde "formatting-model-api.d.ts"
GitHub'daki en son biçimlendirme modeli yardımcı araçlarını kullanmanızı öneririz microsoft/powerbi-visuals-utils-formattingmodel: Power BI görselleri için biçimlendirme modeli yardımcı araçlar
API sürüm 5.1.0'ı kullanan ve en son biçimlendirme modeli yardımcı programları kullanılarak uygulanmış özel bir görsel örneği olan SampleBarChart'ı getFormattingModel.

Başka sorunuz var mı? Power BI Topluluğuna sorun.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-12-15