Power BI görsellerinin yetenekleri ve özellikleri

Her görselin, yeni bir görsel oluşturmak için pbiviz new <visual project name> komutunu çalıştırdığınızda otomatik olarak oluşturulan bir capabilities.json dosyası vardır. capabilities.json dosyası görseli ana bilgisayara tanımlar.

capabilities.json dosyası, konağa görselin ne tür veriler kabulettiğini, özellikler bölmesine ne tür özelleştirilebilir öznitelikler koyacağını ve görseli oluşturmak için gereken diğer bilgileri bildirir. API v4.6.0'dan başlayarak, yetenek modelinde yer alan tüm özellikler isteğe bağlıdır , ancak privilegesbunlar gereklidir.

capabilities.json dosyası kök nesneleri aşağıdaki biçimde listeler:

{
    "privileges": [ ... ],
    "dataRoles": [ ... ],
    "dataViewMappings": [ ... ],
    "objects":  { ... },
    "supportsHighlight": true|false,
    "advancedEditModeSupport": 0|1|2,
    "sorting": { ... }
    ...
}

Yeni bir görsel oluşturduğunuzda, varsayılan capabilities.json dosyası aşağıdaki kök nesneleri içerir:

• Ayrıcalık
• dataRoles
• dataViewMappings
• Nesneler

Yukarıdaki nesneler, veri bağlama için gereken nesnelerdir. Görseliniz için gerektiği şekilde düzenlenebilirler.

Aşağıdaki diğer kök nesneler isteğe bağlıdır ve gerektiğinde eklenebilir:

• araç ipuçları
• supportsHighlight
• Sıralama
• detaya gitme
• expandCollapse
• klavye odağını destekler
• supportsSynchronizingFilterState
• advancedEditModeSupport
• supportsLandingPage
• supportsEmptyDataView
• çoklu görsel seçimini destekler
• Ara toplamlar
• keepAllMetadataColumns
• göç

Tüm bu nesneleri ve bunların parametrelerini capabilities.json şemasında bulabilirsiniz

ayrıcalıklar: Görselinizin gerektirdiği özel izinleri tanımlayın

Ayrıcalıklar, görselinizin çalışması için erişmesi gereken özel işlemlerdir. Ayrıcalıklar, ayrıcalıkların tüm özelliklerini tanımlayan privilege nesnelerinden oluşan bir diziyi kabul eder. Aşağıdaki bölümlerde Power BI'da kullanılabilen ayrıcalıklar açıklanmaktadır.

Not

API v4.6.0'dan ayrıcalıkların capabilities.json dosyasında belirtilmesi gerekir. Önceki sürümlerde uzaktan erişim otomatik olarak sağlanır ve dosyalara indirme yapılamaz. Hangi sürümü kullandığınızı öğrenmek için pbiviz.json dosyasına bakın.apiVersion

Ayrıcalıkları tanımlama

JSON ayrıcalık tanımı şu bileşenleri içerir:

• name - (dize) Ayrıcalığın adı.
• essential - (Boole) Görsel işlevselliğin bu ayrıcalığı gerektirip gerektirmediğini gösterir. değeri true , ayrıcalığının gerekli olduğu, false ayrıcalığı zorunlu olmadığı anlamına gelir.
• parameters - (dize dizisi)(isteğe bağlı) Argümanlar. Eksikse parameters , boş bir dizi olarak kabul edilir.

Tanımlanması gereken ayrıcalık türleri şunlardır:

• Dış kaynaklara erişme
• Dosyaya indir
• Yerel depolama ayrıcalıkları

Not

Görselde bu ayrıcalıklar tanınmış olsa bile, yöneticinin kuruluşundaki kişilerin bu ayarlardan yararlanabilmesi için yönetici ayarlarında anahtarı etkinleştirmesi gerekir.

Web erişimine izin ver

Görselin dış kaynağa veya web sitesine erişmesine izin vermek için bu bilgileri özellikler bölümüne ayrıcalık olarak ekleyin. Ayrıcalık tanımı, görselin erişmesine izin verilen URL'lerin, http://xyz.com veya https://xyz.com biçimindeki isteğe bağlı bir listesini içerir. Her URL, alt alan adlarını belirtmek için bir joker karakter de içerebilir.

Aşağıdaki kod, dış kaynaklara erişime izin veren bir ayrıcalık ayarı örneğidir:

{
    "name": "WebAccess",
    "essential": true,
    "parameters": [ "https://*.microsoft.com", "http://example.com" ]
}

Yukarıdaki WebAccess ayrıcalık, görselin etki alanının herhangi bir alt etki microsoft.com alanına yalnızca HTTPS protokolü aracılığıyla ve example.com HTTP üzerinden alt etki alanları olmadan erişmesi gerektiği ve bu erişim ayrıcalığının görselin çalışması için gerekli olduğu anlamına gelir.

Dosyaya indir

Kullanıcının görseldeki verileri bir dosyaya aktarmasına izin vermek için ExportContentolarak ayarlayıntrue.

Bu ExportContent ayar, görselin verileri dosyalara aşağıdaki biçimlerde dışarı aktarmasını sağlar:

• .txt
• .csv
• .json
• .tmplt
• .xml
• .pdf
• .xlsx

Bu ayar, kuruluşun dışarı aktarma ve paylaşma kiracı ayarlarında uygulanan indirme kısıtlamalarından ayrıdır ve bunlardan etkilenmez.

Aşağıdaki kod, bir dosyaya indirmeye izin veren bir ayrıcalık ayarı örneğidir:

"privileges": [
    {
        "name": "ExportContent",
        "essential": true
    }
]

Yerel depolama ayrıcalıkları

Bu ayrıcalık, özel bir görselin bilgileri kullanıcının yerel tarayıcısına depolamasına olanak tanır.

Aşağıda, yerel depolamanın kullanımına izin veren bir ayrıcalık ayarı örneği verilmiştir:

"privileges": [
    {
        "name": "LocalStorage",
        "essential": true
    }
]

Ayrıcalık gerekmez

Görsel herhangi bir özel izin gerektirmiyorsa dizi privileges boş olmalıdır:

  "privileges": []

Birden çok ayrıcalık

Aşağıdaki örnekte, özel bir görsel için çeşitli ayrıcalıkların nasıl ayarlanacağı gösterilmektedir.

"privileges": [
    {
        "name": "WebAccess",
        "essential": true,
        "parameters": [ "https://*.virtualearth.net" ]
    },
    {
        "name": "ExportContent",
        "essential": false
    }
]

dataroles: Görselinizin beklediği veri alanlarını tanımlayın

Verilere bağlayabileceğiniz alanları tanımlamak için kullanın dataRoles. dataRoles , gerekli tüm özellikleri tanımlayan bir nesne dizisidir DataViewRole . dataRoles öğeler, Özellikler bölmesinde görünen alanlardır.

Kullanıcı, veri alanlarını nesnelere bağlamak için veri alanlarını bunlara sürükler.

DataRole özellikleri

DataRoles'i aşağıdaki özelliklerle tanımlayın:

• name: Bu veri alanının iç adı (benzersiz olmalıdır).
• displayName: Özellikler bölmesinde kullanıcıya görüntülenen ad.
• tür: Alan türü:
  • Grouping: Ölçü alanlarını gruplandırmak için kullanılan ayrık değerler kümesi.
  • Measure: Tek sayısal değerler.
  • GroupingOrMeasure: Gruplandırma veya ölçü olarak kullanılabilecek değerler.
• description: Alanın kısa metin açıklaması (isteğe bağlı).
• requiredTypes: Bu veri rolü için gerekli veri türü. Eşleşmeyen değerler null (isteğe bağlı) olarak ayarlanır.
• preferredTypes: Bu veri rolü için tercih edilen veri türü (isteğe bağlı).

requiredTypes ve preferredTypes için geçerli veri türleri

• bool: Boole değeri
• integer: Tamsayı değeri
• sayısal: Sayısal bir değer
• metin: Metin değeri
• coğrafya: Coğrafi veriler

dataRoles örneği

"dataRoles": [
    {
        "displayName": "My Category Data",
        "name": "myCategory",
        "kind": "Grouping",
        "requiredTypes": [
            {
                "text": true
            },
            {
                "numeric": true
            },
            {
                "integer": true
            }
        ],
        "preferredTypes": [
            {
                "text": true
            }
        ]
    },
    {
        "displayName": "My Measure Data",
        "name": "myMeasure",
        "kind": "Measure",
        "requiredTypes": [
            {
                "integer": true
            },
            {
                "numeric": true
            }
        ],
        "preferredTypes": [
            {
                "integer": true
            }
        ]
    }
]
...
}

Önceki veri rolleri aşağıdaki görüntüde görüntülenen alanları oluşturur:

dataViewMappings: Verilerin nasıl eşlenmesini istiyorsunuz?

Nesneler, dataViewMappings veri rollerinin birbiriyle ilişkisini açıklar ve görüntülenen veri görünümleri için koşullu gereksinimleri belirtmenize olanak tanır.

Çoğu görsel tek bir eşleme sağlar, ancak birden çok dataViewMapping sağlayabilirsiniz. Her geçerli eşleme bir veri görünümü oluşturur.

"dataViewMappings": [
    {
        "conditions": [ ... ],
        "categorical": { ... },
        "table": { ... },
        "single": { ... },
        "matrix": { ... }
    }
]

Daha fazla bilgi için bkz. Power BI görsellerinde veri görünümü eşlemesini anlama.

objects: özellik bölmesi seçeneklerini tanımlama

Nesneler, görselle ilişkili özelleştirilebilir özellikleri açıklar. Bu bölümde tanımlanan nesneler, Biçim bölmesinde görüntülenen nesnelerdir. Her nesnenin birden çok özelliği olabilir ve her özelliğin kendisiyle ilişkilendirilmiş bir türü vardır.

"objects": {
    "myCustomObject": {
        "properties": { ... }
    }
}

Örneğin, özel görselinizde dinamik biçim dizelerini desteklemek için aşağıdaki nesneyi tanımlayın:

"objects": {
        "general": {
            "properties": {
                "formatString": {
                    "type": {
                        "formatting": {
                            "formatString": true
                        }
                    }
                }
            }
        },

Daha fazla bilgi için bkz . Power BI görsellerinin nesneleri ve özellikleri.

İlgili içerik

• Power BI görsellerinde veri görünümü eşlemesini anlama
• Power BI görsellerinin nesneleri ve özellikleri
• Power BI görselleri için sıralama seçenekleri