Power BI görsellerinin özellikleri ve özellikleri

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

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
• Nesne

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
• supportsKeyboardFocus
• supportsSynchronizingFilterState
• advancedEditModeSupport
• supportsLandingPage
• supportsEmptyDataView
• supportsMultiVisualSelection
• Alt toplam
• 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, tüm ayrıcalık özelliklerini tanımlayan bir nesne dizisi privilege alır. Aşağıdaki bölümlerde Power BI'da kullanılabilen ayrıcalıklar açıklanmaktadır.

Ayrıcalıkları tanımlama

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

• name - (dize) Ayrıcalığı 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ı) Bağımsız değişkenler. 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ı

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 veya https://xyz.combiçiminde http://xyz.com erişmesine izin verilen isteğe bağlı BIR URL listesi içerir. Her URL, alt etki alanları 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 trueolarak ayarlayınExportContent.

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 için özel izin gerekmiyorsa 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ğlanabilecek alanları tanımlamak için kullanırsınız dataRoles. dataRoles , gerekli tüm özellikleri tanımlayan bir nesne dizisidir DataViewRole . dataRoles Nesneler, Özellikler bölmesinde görüntülenen 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