Share via

Power BI görsellerinin özellikleri ve özellikleri

  • Makale

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:

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

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

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.

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 verilir ve dosyalara indirilemez. 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ığı 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:

Not

Görselde verilen bu ayrıcalıklarla bile, yöneticinin kuruluşlarındaki kişilerin bu ayarlardan yararlanmasına izin vermek 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 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ğıda, dış kaynaklara erişime izin veren bir ayrıcalık ayarı örneği verilmiştir:

{
    "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ğıda, bir dosyaya indirmeye izin veren bir ayrıcalık ayarı örneği verilmiştir:

"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 aşağıdaki özelliklerle tanımlanır:

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

Data role fields

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